調(diào)用ApplyAutoSnapshotPolicy為一塊或者多塊云盤應(yīng)用自動快照策略。目標云盤已經(jīng)應(yīng)用了自動快照策略時,調(diào)用ApplyAutoSnapshotPolicy可以更換云盤當前應(yīng)用的自動快照策略。
接口說明
- 一塊云盤只能應(yīng)用一條自動快照策略。
- 一條自動快照策略能應(yīng)用到多塊云盤。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
ecs:ApplyAutoSnapshotPolicy | update | *Disk acs:ecs:{#regionId}:{#accountId}:disk/{#diskId} *AutoSnapshotPolicy acs:ecs:{#regionId}:{#accountId}:snapshotpolicy/{#snapshotpolicyId} |
| 無 |
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
regionId | string | 是 | 自動快照策略和云盤所在的地域 ID。您可以調(diào)用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
autoSnapshotPolicyId | string | 是 | 目標自動快照策略 ID。 | sp-bp14yziiuvu3s6jn**** |
diskIds | string | 是 | 一塊或多塊云盤的 ID。取值是 JSON 數(shù)組格式,云盤 ID 之間用半角逗號(,)隔開。 | ["d-bp14k9cxvr5uzy54****", "d-bp1dtj8v7x6u08iw****", "d-bp1c0tyj9tfli2r8****"] |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | DiskCategory.OperationNotSupported | The type of the specified disk does not support creating a snapshot. | 當前磁盤類型不支持此操作。 |
400 | PartofDiskCategory.OperationNotSupported | The types of some disks in the disk list do not support creating snapshots. | 部分指定的磁盤不支持此操作。 |
403 | ParameterInvalid | The specified RegionId parameter is invalid. | 指定的地域 ID 無效,請您檢查該地域是否正確。 |
403 | ParameterInvalid | The specified AutoSnapshotPolicyId parameter is invalid. | 指定的參數(shù)自動快照 ID 不合法。 |
403 | ParameterInvalid | The specified DiskIds are invalid. | 指定的磁盤 ID 不合法,請您檢查磁盤 ID 是否存在。 |
403 | InvalidAccountStatus.NotEnoughBalance | Your account does not have enough balance. | 賬號余額不足,請您先充值再進行該操作。 |
403 | InvalidAccountStatus.SnapshotServiceUnavailable | Snapshot service has not been opened yet. | 快照服務(wù)未開通,操作無法執(zhí)行。 |
403 | InvalidOperation.SnapshotAlreadyCreatedUnsupported | The current disk already has snapshots created by non-promotional activities. Snapshot policies bound to promotional activities are not supported. | 當前磁盤已有非促銷活動創(chuàng)建的快照,不支持綁定到促銷活動的快照策略。 |
404 | ParameterInvalid | The specified automatic snapshot policy does not exist. | 指定的自動快照策略不存在,請您檢查自動快照策略是否正確。 |
404 | ParameterInvalid | The specified automatic snapshot policy does not exist in the region. | 指定的自動快照策略不存在,請您檢查自動快照策略是否正確。 |
404 | InvalidDiskId.NotFound | The specified disk does not exist in the region. | 當前地域不存在指定的磁盤。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2024-12-02 | OpenAPI 描述信息更新、OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
2024-09-20 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |