阿里云如何使用創(chuàng)建磁盤接口

　　創(chuàng)建磁盤需要通過實名認證。沒有通過實名認證的可以前往 阿里云官網 中的用戶中心 —> 會員信息中進行實名認證。

　　本接口是用于創(chuàng)建可卸載云盤的數據盤，包括普通云盤、高效云盤和SSD云盤，系統(tǒng)盤的快照不能用來創(chuàng)建數據盤。創(chuàng)建磁盤時，默認在刪除磁盤時刪除自動快照，即 DeleteAutoSnapshot=true，可以通過 修改磁盤屬性 修改該參數。通過該接口創(chuàng)建的盤Portable屬性為true。收費方式為按量付費。

　　請求參數中 Size 和 SnapshotId 必須選擇其中一項來指定磁盤的大小或使用快照創(chuàng)建磁盤。

　　請求參數

名稱 類型 是否必須 描述
Action   String   是   操作接口名，系統(tǒng)規(guī)定參數，取值：CreateDisk  
RegionId   String   是   實例所屬的 Region ID  
ZoneId   String   是   可用區(qū) ID  
DiskName   String   否   磁盤名稱，不填則為空，默認值為空，[2, 128] 英文或中文字符，必須以大小字母或中文開頭，可包含數字，”.”，”_”或”-”，磁盤名稱會展示在控制臺。不能以 和 https:// 開頭。  
Description   String   否   磁盤描述，不填則為空，默認值為空，[2, 256] 個字符，磁盤描述會展示在控制臺。不能以 和 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   否   創(chuàng)建數據盤使用的快照
指定該參數后 Size 會被忽略，實際創(chuàng)建的磁盤大小為指定快照的大小
2013 年 7 月 15 日（含）前的快照不能用來創(chuàng)建磁盤  
ClientToken   String   否   用于保證請求的冪等性。由客戶端生成該參數值，要保證在不同請求間唯一，最大不值過 64 個 ASCII 字符。
具體參見附錄：如何保證冪等性。  

　　返回參數

名稱 類型 描述
DiskId   String   磁盤 ID  

　　錯誤碼

錯誤代碼 描述 Http 狀態(tài)碼 語義
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   指定快照創(chuàng)建于 2013 年 7 月 15 日（含）之前，不能創(chuàng)建磁盤  
InvalidSnapshot.TooLarge   The capacity of snapshot exceeds 2000GB.   403   指定快照的容量超過磁盤種類的最大容量  
OperationDenied   The specified snapshot is not allowed to create disk.   403   指定快照不允許創(chuàng)建磁盤  
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   指定的快照不是數據盤快照，不能創(chuàng)建數據盤  
InvalidSnapshotId.NotFound   The specified snapshot does not exist.   404   找不到指定的快照  

　　示例

　　請求示例