阿里云如何使用創(chuàng)建磁盤接口
來源:技術員聯(lián)盟┆發(fā)布時間:2017-12-06 00:02┆點擊:
創(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
找不到指定的快照
示例
請求示例