為一塊 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 快照的顯示名稱。
  • 長度為 [2, 128] 個英文或中文字元。
  • 必須以大小字母或中文開頭,可包含數字、半形冒號(:)、底線(_)或者短橫線(-)。
  • 為防止和 自動快照 的名稱衝突,不能以 auto 開頭。
  • 不能以 http:// 和 https:// 開頭。
Description String 快照的描述。
  • 長度為 [2, 256] 個英文或中文字元。
  • 不能以 http:// 和 https:// 開頭。
預設值:空
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 指定的磁碟不存在。