阿里雲如何使用建立磁碟介面

　　建立磁碟

　　描述

　　建立磁碟需要通過實名認證。沒有通過實名認證的可以前往 阿里雲官網 中的使用者中心 —> 會員資訊中進行實名認證。

　　本介面是用於建立可卸載雲端硬碟的資料盤，包括普通雲端硬碟、高效雲端硬碟和SSD雲端硬碟，系統硬碟的快照不能用來建立資料盤。建立磁碟時，預設在刪除磁碟時刪除自動快照，即 DeleteAutoSnapshot=true，可以通過 修改磁碟屬性 修改該參數。通過該介面建立的盤Portable屬性為true。收費方式為隨用隨付。

　　請求參數中 Size 和 SnapshotId 必須選擇其中一項來指定磁碟的大小或使用快照建立磁碟。

　　請求參數

名稱	類型	是否必須	描述
Action	String	是	操作介面名，系統規定參數，取值：CreateDisk
RegionId	String	是	執行個體所屬的 Region ID
ZoneId	String	是	可用性區域 ID
DiskName	String	否	磁碟名稱，不填則為空白，預設值為空白，[2, 128] 英文或中文字元，必須以大小字母或中文開頭，可包含數字，”.”，”_”或”-”，磁碟名稱會展示在控制台。不能以 http:// 和 https:// 開頭。
Description	String	否	磁碟描述，不填則為空白，預設值為空白，[2, 256] 個字元，磁碟描述會展示在控制台。不能以 http:// 和 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	找不到指定的快照

　　樣本

　　請求樣本

　　https://ecs.aliyuncs.com/?action=CreateDisk&RegionId=cn-qingdao&ZoneId=cn-qingdao-b&Size=200&DiskName=ThisIsDiskName&Description=ThisIsDescription&&<公用請求參數>

　　返回樣本

　　XML格式：

　　 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

　　JSON格式：

　　{ "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"}