為一塊 ECS 磁碟建立一份快照。
描述
調用該介面時,您需要注意:
-
一塊磁碟最多能建立 64 份快照。
-
磁碟掛載的實例必須處於 已停止(
Stopped
)或者 運行中(Running
)狀態,否則無法建立快照。 -
磁碟必須已經掛載到實例上,否則無法建立快照。
-
磁碟掛載的實例從未啟動過時,無法建立快照。
-
被 安全控制 的 ECS 實例的
OperationLocks
中標記了"LockReason" : "security"
時,實例掛載的磁碟無法建立快照。 -
新建一台Elastic Compute Service(RunInstances)、更換系統盤(ReplaceSystemDisk)或者根據快照新增數據盤(CreateDisk),由於尚未完成數據載入,無法建立快照。新建一台Elastic Compute Service 或者更換系統盤大約 1 小時後可以建立快照,新增一塊數據盤可建立快照的時間取決於磁碟數據的大小。
-
如果建立快照還未完成,您無法為該磁碟再次建立快照。
-
如果建立快照還未完成,這份快照無法用於建立自訂鏡像 (CreateImage)。
請求參數
名稱 | 類型 | 是否必需 | 描述 |
---|---|---|---|
Action | String | 是 | 系統規定參數。取值:CreateSnapshot |
DiskId | String | 是 | 磁碟 ID。 |
SnapshotName | String | 否 | 快照的顯示名稱。
|
Description | String | 否 | 快照的描述。
|
ClientToken | String | 否 | 用於保證請求的等冪性。由客戶端生成該參數值,要保證在不同請求間唯一。只支援 ASCII 字元,且不能超過 64 個字元。更多詳情,請參閱 如何保證等冪性。 |
返回參數
名稱 | 類型 | 描述 |
---|---|---|
SnapshotId | String | 快照 ID |
樣本
請求樣本
https://ecs.aliyuncs.com/?Action=CreateSnapshot
&DiskId=1033-60053321
&<公共請求參數>
返回樣本
XML 格式
<CreateSnapshotResponse>
<RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
<SnapshotId>s-923FE2BF0</SnapshotId>
</CreateSnapshotResponse>
JSON 格式
{
"RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
"SnapshotId": "s-923FE2BF0"
}
錯誤碼
以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心。
錯誤碼 | 錯誤資訊 | HTTP 狀態碼 | 說明 |
---|---|---|---|
DiskCategory.OperationNotSupported | The operation is not supported to the specified disk due to its disk category | 400 | 指定磁碟的磁碟類型不支援該操作。 |
IncorrectInstanceStatus | The current status of the resource does not support this operation. | 400 | 磁碟掛載的實例必須處於 已停止(Stopped )或者 運行中(Running )狀態。 |
InvalidSnapshotName.Malformed | The specified SnapshotName is wrongly formed. | 400 | 指定的參數 SnapshotName 不合法。 |
CreateSnapshot.Failed | The process of creating snapshot is failed. | 403 | 建立快照失敗。 |
DiskId.ValueNotSupported | The specified parameter diskid is not supported. | 403 | 指定的參數 DiskId 不能建立快照。 |
DiskInArrears | The specified operation is denied as your disk has expired. | 403 | 指定的磁碟已經欠費。請重新續費後重試。 |
IncorrectDiskStatus | The current disk status does not support this operation. | 403 | 磁碟必須處於 使用中(In_use )的狀態。 |
IncorrectDiskStatus.CreatingSnapshot | A previous snapshot creation is in process. | 403 | 指定的磁碟正在建立快照。請稍後再試。 |
IncorrectDiskStatus.NeverAttached | The specified disk has never been attached to any instance. | 403 | 磁碟必須已經掛載到實例上。 |
IncorrectDiskStatus.NeverUsed | The specified disk has never been used after creating. | 403 | 該磁碟未被使用,不能建立快照。 |
InstanceLockedForSecurity | The disk attached instance is locked due to security. | 403 | 指定的實例被安全鎖定。 |
InvalidAccountStatus.NotEnoughBalance | Your account does not have enough balance. | 403 | 您的賬戶餘額不足。請 儲值 後重試。 |
InvalidAccountStatus.SnapshotServiceUnavailable | Snapshot service has not been opened yet. | 403 | 您還未開通快照服務。請 提交工單 申請開通。 |
QuotaExceed.Snapshot | The maximum number of snapshots is exceeded. | 403 | 您已超出能建立的最大快照數量。一塊磁碟最多能建立 64 份快照。 |
InvalidDescription.Malformed | The specified description is wrongly formed. | 404 | 指定的參數 Description 不合法。 |
InvalidDiskId.NotFound | The specified DiskId does not exist. | 404 | 指定的磁碟不存在。 |