功能介绍

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

当前API已废弃，请使用”创建云硬盘（OpenStack原生 v2）”。

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	卷大小。 单位为GB。
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"
  }
}

返回值

请参考通用请求返回值。

父主题： 磁盘管理（OpenStack Nova API）

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家