接受云硬盘过户

功能介绍

通过云硬盘过户记录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

错误码

请参考错误码。