创建云硬盘过户

功能介绍

指定云硬盘来创建云硬盘过户记录，创建成功后，会返回过户记录ID以及身份认证密钥。

云硬盘在过户过程中的状态变化如下：创建云硬盘过户后，云硬盘状态由“available”变为“awaiting-transfer”。当云硬盘过户被接收后，云硬盘状态变为“available”。

接口约束

只有当云硬盘状态为available时，支持创建过户，其他不支持过户的约束如下：

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

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

URI

• URI格式

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

• 参数说明

  参数	是否必选	描述
  project_id	是	项目ID。 获取方法请参见获取项目ID。

请求消息

• 请求参数

  参数	参数类型	是否必选	描述
  transfer	Object	是	标记创建云硬盘过户操作，请参见•transfer参数说明。

• transfer参数说明

  参数	参数类型	是否必选	描述
  volume_id	String	是	云硬盘ID。
  name	String	是	云硬盘过户记录的名称。最大支持255个字节。

• 请求样例

  {
      "transfer": {
          "volume_id": "c86b9af4-151d-4ead-b62c-5fb967af0e37", 
          "name": "first volume"
      }
  }

响应消息

• 响应参数

  参数	参数类型	描述
  transfer	Object	云硬盘过户信息，请参见•transfer参数说明。

• transfer参数说明

  参数	参数类型	描述
  auth_key	String	云硬盘过户的身份认证密钥。
  links	Array of Objects	云硬盘过户记录的链接。请参见•Link
  created_at	String	云硬盘过户记录的创建时间。 时间格式：UTC YYYY-MM-DDTHH:MM:SS.XXXXXX
  volume_id	String	云硬盘ID。
  id	String	云硬盘过户记录的ID。
  name	String	云硬盘过户记录的名称。

• Link

  参数	参数类型	描述
  href	String	对应的快捷链接。
  rel	String	快捷链接标记名称。 缺省值：next

• 响应样例

  {
      "transfer": {
          "id": "1a7059f5-8ed7-45b7-8d05-2811e5d09f24", 
          "created_at": "2015-02-25T03:56:53.081642", 
          "name": "first volume", 
          "volume_id": "c86b9af4-151d-4ead-b62c-5fb967af0e37", 
          "auth_key": "9266c59563c84664", 
          "links": [
              {
                  "href": "https://localhost/v2/firstproject/os-volume-transfer/3", 
                  "rel": "self"
              }, 
              {
                  "href": "https://localhost/firstproject/os-volume-transfer/3", 
                  "rel": "bookmark"
              }
          ]
      }
  }

状态码

• 正常

  202

错误码

请参考错误码。