文档

CreateDisk - 创建数据盘

调用CreateDisk创建一块按量付费或包年包月数据盘。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
InstanceChargeTypestring

实例付费方式,当前仅支持 PostPaid(按量付费)。

PostPaid
EnsRegionIdstring

节点 ID。

cn-chengdu-telecom
Categorystring

磁盘种类。取值:

  • 高效云盘:cloud_efficiency
  • 全闪云盘:cloud_ssd
cloud_efficiency
Sizestring

磁盘大小,单位:GiB。

20
SnapshotIdstring

创建云盘使用的快照。

SnapshotId 参数和 Size 参数存在以下限制:

  • 如果 SnapshotId 参数对应的快照容量大于设置的 Size 参数值,实际创建的云盘大小为指定快照的大小。

  • 如果 SnapshotId 参数对应的快照容量小于设置的 Size 参数值,实际创建的云盘大小为指定的 Size 参数值。

s-897654321****
Encryptedboolean

是否加密云盘。取值范围:

  • true:是

  • false(默认值):否

false
KMSKeyIdstring

云盘使用的 KMS 密钥 ID。

说明 如果 Encrypted 置为 trueKMSKeyId 为空时则使用服务默认密钥。
0e478b7a-4262-4802-b8cb-00d3fxxxxx
DiskNamestring

磁盘名称。

yourDiskName

返回参数

名称类型描述示例值
object

返回结构体

RequestIdstring

请求 ID。

7030AB96-57CF-1C68-9FEE-D60E547FD79C
OrderIdstring

订单 ID,多个 ID 之间用半角逗号(,)分隔。

说明 只有预付费返回订单号,按量付费不返回。
21127020370****
InstanceIdsarray

实例 ID 集合。

string

实例 ID 列表。

d-5rpvziragkacvop665m3h****

示例

正常返回示例

JSON格式

{
  "RequestId": "7030AB96-57CF-1C68-9FEE-D60E547FD79C",
  "OrderId": "21127020370****",
  "InstanceIds": [
    "d-5rpvziragkacvop665m3h****"
  ]
}

错误码

HTTP status code错误码错误信息描述
400Invalid%sThe specified parameter %s is invalid.参数不正确
400Missing%sYou must specify the parameter %s.参数为必填
400NoPermissionPermission denied.没有足够的权限,请联系云账号管理员授予您相应权限。
400InvalidParameter.%sThe specified field %s invalid. Please check it again.-

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2023-11-21OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
入参OpenAPI 入参发生变更
    新增入参:DiskName
2021-10-28新增 OpenAPI看变更集
  • 本页导读 (1)
文档反馈