阅读571 返回首页    go 微信

创建磁盘__磁盘相关接口_API 参考_云服务器 ECS-阿里云

描述

创建磁盘需要通过实名认证。没有通过实名认证的可以前往 阿里云官网 中的用户中心 —> 会员信息中进行实名认证。

本接口是用于创建可卸载云盘的数据盘，包括普通云盘、高效云盘和SSD云盘，系统盘的快照不能用来创建数据盘。创建磁盘时，默认在删除磁盘时删除自动快照，即 DeleteAutoSnapshot=true，可以通过 修改磁盘属性 修改该参数。通过该接口创建的盘Portable属性为true。收费方式为按量付费。

请求参数中 Size 和 SnapshotId 必须选择其中一项来指定磁盘的大小或使用快照创建磁盘。

请求参数

名称 类型 是否必须 描述
Action String 是 操作接口名，系统规定参数，取值：CreateDisk
RegionId String 是 实例所属的 Region ID
ZoneId String 是 可用区 ID
DiskName String 否 磁盘名称，不填则为空，默认值为空，[2, 128] 英文或中文字符，必须以大小字母或中文开头，可包含数字，”.”，”_”或”-”，磁盘名称会展示在控制台。不能以 https:// 和 https:// 开头。
Description String 否 磁盘描述，不填则为空，默认值为空，[2, 256] 个字符，磁盘描述会展示在控制台。不能以 https:// 和 https:// 开头。
DiskCategory String 否 数据盘的磁盘种类
可选值：
  • cloud – 普通云盘
  • cloud_efficiency – 高效云盘
  • cloud_ssd – SSD云盘
默认值：cloud
Size Integer 是 容量大小，以GB为单位：
  • cloud：5 ~ 2000
  • cloud_efficiency：20 ~ 32768
  • cloud_ssd：20 ~ 32768
指定该参数后，Size大小必须 ≥ 指定快照 SnapshotId 的大小。
SnapshotId String 否 创建数据盘使用的快照
指定该参数后 Size 会被忽略，实际创建的磁盘大小为指定快照的大小
2013 年 7 月 15 日（含）前的快照不能用来创建磁盘
ClientToken String 否 用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，最大不值过 64 个 ASCII 字符。
具体参见附录：如何保证幂等性。

返回参数

名称 类型 描述
DiskId String 磁盘 ID

错误码

错误代码 描述 Http 状态码 语义
MissingParameter The input parameter “RegionId” that is mandatory for processing this request is not supplied. 400 RegionId 参数未指定
MissingParameter The input parameter “ZoneId” that is mandatory for processing this request is not supplied. 400 缺少 ZoneId 值（实际情况也可能是该用户无权使用此 Zone）
InvalidRegionId.NotFound The specified region does not exist. 404 指定的 RegionId 不存在
InvalidZoneId.NotFound The specified zone does not exist. 404 指定的 ZoneId 不存在
InvalidSnapshotId.NotFound The specified snapshot does not exist. 404 指定的 SnapshotId 不存在
InvalidDiskName.Malformed The specified disk name is wrongly formed. 400 指定的 DiskName 格式不合法
InvalidDescription.Malformed The specified description is wrongly formed. 400 指定的 DescriptionName 格式不合法
InvalidParameter The specified parameter “Size” is not valid. 400 Size 参数不合法
InstanceDiskCategoryLimitExceed The total size of specified disk category in an instance exceeds. 403 指定的磁盘种类超过了单实例的最大容量
InvalidSnapshot.TooOld This operation is forbidden because the specified snapshot is created before 2013-07-15. 403 指定快照创建于 2013 年 7 月 15 日（含）之前，不能创建磁盘
InvalidSnapshot.TooLarge The capacity of snapshot exceeds 2000GB. 403 指定快照的容量超过磁盘种类的最大容量
OperationDenied The specified snapshot is not allowed to create disk. 403 指定快照不允许创建磁盘
QuotaExceed.PortableCloudDisk The quota of portable cloud disk exceeds. 403 可卸载普通云盘超过额度
MissingParameter The input parameter either “SnapshotId” or “Size” should be specified. 400 SnapshotId 或者 Size 参数未指定
InvalidDiskCategory.ValueUnauthorized The disk category is not authorized. 403 指定磁盘种类无权限
InvalidSnapshotId.NotReady The specified snapshot has not completed yet. 403 指定的快照未完成
InvalidSnapshotId.NotDataDiskSnapshot The specified snapshot is system disk snapshot. 403 指定的快照不是数据盘快照，不能创建数据盘
InvalidSnapshotId.NotFound The specified snapshot does not exist. 404 找不到指定的快照

示例

请求示例

  1. https://ecs.aliyuncs.com/?action=CreateDisk
  2. &RegionId=cn-qingdao
  3. &ZoneId=cn-qingdao-b
  4. &Size=200
  5. &DiskName=ThisIsDiskName
  6. &Description=ThisIsDescription&
  7. &<公共请求参数>

返回示例

XML格式：

  1. <CreateDiskResponse>
  2.     <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  3. </CreateDiskResponse>

JSON格式：

  1. {
  2.     "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
  3. }

最后更新：2016-12-02 10:48:28

  上一篇：go 设置实例自动释放时间__实例相关接口_API 参考_云服务器 ECS-阿里云
  下一篇：go 查询磁盘__磁盘相关接口_API 参考_云服务器 ECS-阿里云