创建磁盘（废弃）

功能介绍

本接口提供创建磁盘的功能。

URI

POST /v2.1/{project_id}/os-volumes

参数说明请参见表1。

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

请求消息

请求参数如表2所示。

表2 请求参数
参数	是否必选	参数类型	描述
availability_zone	否	String	指定要创建卷的AZ，若指定的AZ不存在，则创卷失败，卷状态为error。当前云服务需要指定AZ创建卷。
display_description	否	String	卷的描述。
snapshot_id	否	String	快照ID，指定该参数表示创卷方式为从快照创建卷。
size	是（如果卷快照创卷，size为可选。）	Integer	卷大小。单位为GiB。
display_name	否	String	卷名称。
volume_type	否	String	卷类型。
metadata	否	Object	卷的metadata数据。

响应消息

响应参数如表3所示。

表3 响应参数
参数	参数类型	描述
id	String	卷ID，UUID格式
displayName	String	卷名称
status	String	卷状态
attachments	Array of objects	挂卷信息
availabilityZone	String	卷所属AZ
createdAt	String	创建卷的时间
displayDescription	String	卷描述
volumeType	String	卷类型
snapshotId	String	快照ID
metadata	Object	元数据
size	Integer	卷大小

请求示例

POST https://{endpoint}/v2.1/b84c367e4d1047fc9b54f28b400ddbc2/os-volumes

{
    "volume": {
        "availability_zone": "az1-dc1",
        "display_description": "test1",
        "snapshot_id": null,
        "size": 1,
        "display_name": "test",
        "volume_type": "SSD",
        "metadata": {
            "testkey": "testvalue"
        }
    }
}

响应示例

{
  "volume": {
    "displayDescription": "test1",
    "volumeType": "SATA",
    "createdAt": "2018-05-18T01:17:03.871808",
    "metadata": {
      "testkey": "testvalue",
      "resourceSpecCode": "SATA"
    },
    "attachments": [
      {}
    ],
    "snapshotId": null,
    "size": 1,
    "displayName": "test",
    "id": "b4fb891c-c665-4478-92b0-8a7fa65a57cd",
    "availabilityZone": "az1.dc1",
    "status": "creating"
  }
}