閱讀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-阿裏雲