為指定的磁盤創(chuàng)建快照。
接口說(shuō)明
快照是某一時(shí)間點(diǎn)磁盤數(shù)據(jù)狀態(tài)的備份文件，常用于日常數(shù)據(jù)備份、服務(wù)器數(shù)據(jù)誤操作恢復(fù)、網(wǎng)絡(luò)攻擊恢復(fù)、制作自定義鏡像等場(chǎng)景。
注意事項(xiàng)
- 單臺(tái)輕量應(yīng)用服務(wù)器最多可創(chuàng)建 3 個(gè)快照。
- 一個(gè)阿里云賬號(hào)可創(chuàng)建的快照數(shù)量上限為已創(chuàng)建的輕量應(yīng)用服務(wù)器數(shù)量的 3 倍，但最多不超過 15 個(gè)。
- 如果服務(wù)器到期釋放，該服務(wù)器對(duì)應(yīng)的快照會(huì)被清除。
- 重置系統(tǒng)或更換鏡像前創(chuàng)建的快照，在重置系統(tǒng)或更換鏡像后會(huì)保留但無(wú)法支持回滾操作。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語(yǔ)句的Action元素中使用，用來(lái)給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說(shuō)明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪問級(jí)別：是指每個(gè)操作的訪問級(jí)別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說(shuō)明如下：
- 對(duì)于必選的資源類型，用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| swas-open:CreateSnapshot | create |
|
| 無(wú) |
請(qǐng)求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 指定磁盤對(duì)應(yīng)的輕量應(yīng)用服務(wù)器所屬的地域 ID。 | cn-hangzhou |
| DiskId | string | 是 | 指定的磁盤 ID。 | d-bp18kjxg9ebrhsgi**** |
| SnapshotName | string | 是 | 快照名稱。長(zhǎng)度為 2~50 個(gè)字符，必須以大小字母或中文開頭，不能以 | test-SnapshotName |
| ClientToken | string | 否 | 保證請(qǐng)求冪等性。從您的客戶端生成一個(gè)參數(shù)值，確保不同請(qǐng)求間該參數(shù)值唯一。ClientToken 只支持 ASCII 字符，且不能超過 64 個(gè)字符。更多信息，請(qǐng)參見如何保證冪等性。 | 123e4567-e89b-12d3-a456-426655440000 |
| Tag | array<object> | 否 | 標(biāo)簽列表，最多包含 20 個(gè)子項(xiàng)。 | |
| object | 否 | 標(biāo)簽。 | ||
| Key | string | 否 | 為快照指定的標(biāo)簽鍵。N 的取值范圍：1~20。 一旦傳入該值，則不允許為空字符串。最多支持 64 個(gè)字符，不能以 aliyun 和 acs:開頭，不能包含 http://或者 https://。 | TestKey |
| Value | string | 否 | 為快照指定的標(biāo)簽值。N 的取值范圍：1~20。 一旦傳入該值，可以為空字符串。最多支持 64 個(gè)字符，不能包含 http://或者 https://。 | TestValue |
| ResourceGroupId | string | 否 | 指定的資源組 ID。 | rg-aek2bti7cf7**** |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"SnapshotId": "s-bp16oazlsold4dks****",
"RequestId": "20758A-585D-4A41-A9B2-28DA8F4F534F\t"
}錯(cuò)誤碼
| HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidRemark.ValueNotSupported | The specified parameter Remark is invalid. | 指定的快照備注不合法。 |
| 400 | InvalidRemark.Duplicate | The specified Remark already exists. | 指定的快照備注已存在。 |
| 400 | IncorrectStatus | The state of the disk or instance does not currently support snapshot creation. | 磁盤或?qū)嵗臓顟B(tài)目前不支持創(chuàng)建快照。 |
| 400 | InvalidSnapshotName.ValueNotSupported | The specified SnapshotName is invalid. | 指定的快照名稱不合法。 |
| 400 | InvalidSnapshotName.Duplicate | The specified SnapshotName already exists. | 指定的快照名稱已存在。 |
| 403 | SnapshotLimitExceed | The maximum number of snapshots in an instance is exceeded. | 快照總數(shù)超過實(shí)例限制。 |
| 403 | IncorrectDiskStatus.CreatingSnapshot | A snapshot is being created in the specified disk. Please try again later. | 當(dāng)前磁盤有創(chuàng)建中的快照，請(qǐng)您等待創(chuàng)建完成再試。 |
| 404 | InvalidDiskId.NotFound | The specified DiskId does not exist. | 指定的磁盤不存在，請(qǐng)您檢查磁盤ID是否正確。 |
| 500 | InternalError | An error occurred while processing your request. | 內(nèi)部錯(cuò)誤，請(qǐng)重試。如果多次嘗試失敗，請(qǐng)?zhí)峤还巍?/span> |
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-05-29 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2024-02-20 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2023-05-25 | OpenAPI 描述信息更新、OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |