更新时间:2024-04-16 GMT+08:00

创建磁盘(废弃)

功能介绍

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

当前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"
  }
}

返回值

请参考通用请求返回值