文档首页/弹性云服务器 ECS/API参考/历史API/磁盘管理（OpenStack Nova API）/创建磁盘（废弃）
更新时间：2025-08-18 GMT+08:00
查看PDF
分享

创建磁盘（废弃）

功能介绍

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

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

卷大小。

单位为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"
  }
}

返回值

请参考通用请求返回值。