更新时间:2024-03-25 GMT+08:00

接受云硬盘过户

功能介绍

通过云硬盘过户记录ID以及身份认证密钥来接受云硬盘过户。

接口约束

  • 云硬盘有对应的备份和快照时不支持过户。
  • 云硬盘有备份策略时不支持过户。

若使用以上不支持过户的云硬盘,则返回的错误码为400。

URI

  • URI格式

    POST /v3/{project_id}/os-volume-transfer/{transfer_id}/accept

  • 参数说明

    参数

    是否必选

    描述

    project_id

    项目ID。

    获取方法请参见获取项目ID

    transfer_id

    云硬盘过户记录ID。

请求消息

  • 请求参数

    参数

    参数类型

    是否必选

    描述

    accept

    Object

    标记接受云硬盘过户操作,请参见•accept参数说明

  • accept参数说明

    参数

    参数类型

    是否必选

    描述

    auth_key

    String

    云硬盘过户的身份认证密钥。

    创建云硬盘过户时会返回该身份认证密钥。

  • 请求样例
    {
        "accept": {
            "auth_key": "9266c59563c84664"
        }
    }

响应消息

  • 响应参数

    参数

    参数类型

    描述

    transfer

    Object

    云硬盘过户信息,请参见•transfer参数说明

  • transfer参数说明

    参数

    参数类型

    描述

    volume_id

    String

    云硬盘ID。

    id

    String

    云硬盘过户记录的ID。

    name

    String

    云硬盘过户记录的名称。

    links

    Array of Objects

    云硬盘过户记录的链接。请参见•Link参数说明

  • Link参数说明

    参数

    参数类型

    描述

    href

    String

    对应的快捷链接。

    rel

    String

    快捷链接标记名称。

    缺省值:next

  • 响应样例
    {
        "transfer": {
            "id": "cac5c677-73a9-4288-bb9c-b2ebfb547377", 
            "name": "first volume transfer", 
            "volume_id": "894623a6-e901-4312-aa06-4275e6321cce", 
            "links": [
                {
                    "href": "https://localhost/v2/firstproject/os-volume-transfer/1", 
                    "rel": "self"
                }, 
                {
                    "href": "https://localhost/firstproject/os-volume-transfer/1", 
                    "rel": "bookmark"
                }
            ]
        }
    }

状态码

  • 正常

    202

错误码

请参考错误码