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

创建云硬盘过户

功能介绍

指定云硬盘来创建云硬盘过户记录,创建成功后,会返回过户记录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

错误码

请参考错误码