You need to enable JavaScript to run this app.
导航
云服务器
  • 文档首页
    • /
  • 云服务器

CreateVolume

最近更新时间：2024.04.19 14:02:37

首次发布时间：2021.11.17 14:15:55

我的收藏

调用CreateVolume接口创建云盘。

请求参数

名称类型是否必填示例值描述
ActionString是CreateVolume要执行的操作，取值：CreateVolume。

VolumeName

String

是

test-volume

云盘显示名称。命名规则如下：

  • 首字符仅支持中文、字母或下划线（_）。
  • 可包含中文、字母、数字、下划线（_）或中划线（-）。
  • 长度限制在1~128字符之间。

VolumeType

String

是

ESSD_PL0

云盘类型，取值说明如下：

  • ESSD_PL0：极速型SSD云盘，PL0规格。
  • ESSD_FlexPL: 极速型SSD云盘，FlexPL规格。

说明

关于云盘规格的详细说明，请参见云盘规格。

Kind

String

否

data

云盘属性，data表示数据盘。默认值为data。

说明

仅支持创建数据盘。

Size

Int

是

40

数据盘容量大小，单位为GiB。不同类型的数据盘容量范围如下：

  • ESSD_PL0：10~32,768 GiB
  • ESSD_FlexPL：10~32,768 GiB

SnapshotId

String

否

snap-ass6qd6tmm8gjme1****

快照ID。

说明

使用快照创建云盘时，需要设置该参数。

InstanceId

String

否

i-ybliv8vfkzlbzah6****

创建云盘的同时挂载的ECS实例ID。

注意

创建包年包月云盘时，该参数为必选参数，且挂载的ECS实例必须为包年包月实例。
包年包月云盘的地域和可用区需要与所挂载实例相同。当您同时设置了InstanceId和ZoneId参数后，如果实例所在的地域与ZoneId指定的地域不一致，则请求会失败。

ZoneId

String

否

cn-beijing-a

可用区ID。

注意

如果您没有设置InstanceId，则ZoneId为必填参数。当您同时设置了InstanceId和ZoneId参数后，如果实例所在的地域与ZoneId指定的地域不一致，则请求会失败。

DescriptionString否用于测试的云盘云盘的描述信息，默认为空，长度限制在1 ~ 255字符之间。

VolumeChargeType

String

否

PostPaid

付费方式，默认按量计费，取值说明如下：

  • PostPaid：按量计费
  • PrePaid：包年包月
ClientTokenString否123e4567-e89b-12d3-a456-42665544****用以保证请求幂等性。该字符串由您的客户端生成，用以保证不同请求之间的唯一性。ClientToken是一个大小写敏感、不超过64个ASCII字符的字符串。

ProjectName

String

否

default

云盘所要加入的Project（项目）名称。

说明

如果您在创建云盘时未设置ProjectName，则云盘默认会加入default项目。

Tags.N.Key

String

否

Tags.1.Key=tag

需要创建的标签键。

  • Tags.N.Key：N表示标签键的序号。取值范围：1～20。

  • 多个标签键之间用&分隔。

命名规则如下：

  • 不能以任何大小写形式的volc:或sys:开头，volc:或sys:开头为系统预留标签键，禁止创建。

  • 只能包含语言字符、数字、空格和特殊符号_.:/=+-@。

  • 长度限制在1～128个字符之间。

Tags.N.Value

String

否

Tags.1.Value=test

标签的标签值。

  • Tags.N.Value：N表示标签值的序号。取值范围：1～20。

  • 多个标签值之间用&分隔。

命名规则如下：

  • 只能包含语言字符、数字、空格和特殊符号_.:/=+-@。

  • 允许为空，长度限制在0～256个字符之间。

返回数据

名称类型示例值说明
VolumeIdStringvol-3tigy72q3u3vj0x2****创建的云盘的ID。

请求示例

GET /?Action=CreateVolume&Version=2020-04-01&ZoneId=cn-beijing-a&VolumeName=test&VolumeType=ESSD_PL0&Kind=data&Size=40&Description=test HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
ServiceName: storage_ebs

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20210702183508010225243153072A****",
        "Action": "CreateVolume",
        "Version": "2020-04-01",
        "Service": "storage_ebs",
        "Region": "cn-beijing"
    },
    "Result": {
        "VolumeId": "vol-3tj23cr2y23vj0wt****"
    }
}

错误码

HttpCode错误码错误信息
400InvalidVolumeSize云盘大小不合法
400InvalidVolumeType非法的云盘类型
400InvalidVolumeName非法的云盘名称
400InvalidVolumeKind云盘属性不合法
400MissingZoneID缺少可用区ID
400MissingVolumeName缺少云盘名称
400MissingVolumeType未指定云盘类型
400InvalidVolumeNameLen云盘名称长度不合法
400InvalidVolumeNameFormat云盘名称格式不合法
400NoAvailableVolumePool可用区中无支持该类型的存储池
400InvalidDescriptionLen云盘描述长度不合法
400InvalidDescriptionFormat描述格式不合法
400InvalidArgumentBalanceNotEnough:用户余额不足
400NoAvailableVolumePool资源不足
400FailedPrecondiation操作失败，request id: [xxxxx]，请提工单解决
400ChargeTypeNotSupport计费方式暂不支持
400ErrorCreateIdempotencyFailed创建幂等记录失败
400ErrorUpdtaeIdempotencyFailed更新幂等记录失败
400ErrorIdempotencyStatusFailed幂等请求已经失败
400ErrorIdempotencyStatusTimeout幂等请求重试超时
400ErrorInvalidIdempotencyParam幂等请求参数冲突
400ErrorInvalidIdempotencyAccount幂等请求账号冲突
400ErrorInvalidIdempotencyAction幂等请求Action冲突
400ErrorInvalidIdempotencyBusy幂等请求并发过多，稍后重试
400ErrorLoadIdempotencyFailed幂等请求回放加载失败
400InvalidProjectName指定的项目名不合法。