調(diào)用ModifyAutoSnapshotPolicyEx修改一條自動快照策略。修改自動快照策略后，之前已應(yīng)用該策略的云盤隨即執(zhí)行修改后的自動快照策略。已啟用快照跨地域復(fù)制且在未配置加密參數(shù)場景下，加密快照默認使用目的端服務(wù)密鑰進行加密拷貝。
調(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:ModifyAutoSnapshotPolicyEx | update | *Snapshot acs:ecs:{#regionId}:{#accountId}:snapshotpolicy/{#autoSnapshotPolicyId} |
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| regionId | string | 是 | 自動快照策略所在的地域 ID。您可以調(diào)用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
| autoSnapshotPolicyId | string | 是 | 目標自動快照策略 ID。您可以調(diào)用 DescribeAutoSnapshotPolicyEx 查看您可用的自動快照策略。 | sp-bp12m37ccmxvbmi5**** |
| autoSnapshotPolicyName | string | 否 | 自動快照策略的名稱。如果參數(shù)為空則代表不修改。 | SPTestName |
| timePoints | string | 否 | 自動快照的創(chuàng)建時間點。使用 UTC +8 時間，單位為小時。取值范圍為 0~23，代表 00:00 至 23:00 共 24 個時間點，如 1 表示 01:00。 當(dāng)一天內(nèi)需要創(chuàng)建多次自動快照時，可以傳入多個時間點：
| ["0", "1"] |
| repeatWeekdays | string | 否 | 自動快照的重復(fù)日期，單位為天，周期為星期。取值范圍為 1~7，如 1 表示周一。 當(dāng)一星期內(nèi)需要創(chuàng)建多次自動快照時，可以傳入多個時間點：
| ["1", "7"] |
| retentionDays | integer | 否 | 自動快照的保留時間，單位為天。取值范圍：
默認值為-1。 | 30 |
| EnableCrossRegionCopy | boolean | 否 | 是否允許自動跨地域復(fù)制。
| false |
| TargetCopyRegions | string | 否 | 跨地域復(fù)制快照的目標地域。目前支持設(shè)置一個目標地域。 | ["cn-hangzhou"] |
| CopiedSnapshotsRetentionDays | integer | 否 | 跨地域復(fù)制快照的保留時間，單位為天。取值范圍：
默認值為-1。 | 30 |
| CopyEncryptionConfiguration | object | 否 | 快照跨地域復(fù)制加密參數(shù)對象 | |
| Encrypted | boolean | 否 | 是否開啟快照跨地域加密復(fù)制。取值范圍：
默認值：false。 | false |
| KMSKeyId | string | 否 | 快照跨地域加密復(fù)制使用的 KMS 密鑰 ID。 | 0e478b7a-4262-4802-b8cb-00d3fb40826X |
| Arn | array<object> | 否 | 該參數(shù)暫未開放使用。 | |
| object | 否 | |||
| RoleType | string | 否 | 該參數(shù)暫未開放使用。 | hide |
| Rolearn | string | 否 | 該參數(shù)暫未開放使用。 | hide |
| AssumeRoleFor | long | 否 | 該參數(shù)暫未開放使用。 | 1000000000 |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidParameter.EncryptedIllegal | The specified parameter Encrypted must be true when kmsKeyId is not empty. | 設(shè)置參數(shù) KMSKeyId 后，您必須開啟加密屬性。 |
| 400 | InvalidParameter.KMSKeyId.CMKNotEnabled | The CMK needs to be enabled. | 加密云盤設(shè)置了 KMSKeyId 后，CMK必須處于啟用狀態(tài)。您可以調(diào)用密鑰管理服務(wù)的 DescribeKey 接口查詢指定CMK的相關(guān)信息。 |
| 400 | InvalidParameter.KmsNotEnabled | Failed to perform this operation because KMS is not activated. | 您需要開通KMS密鑰管理服務(wù)。 |
| 400 | InvalidParameter.Encrypted.KmsNotEnable | Failed to perform this operation because KMS is not activated. | 您需要開通KMS密鑰托管服務(wù)。 |
| 400 | InvalidParam.EncryptedMismatch | Creating encrypted disks with shared encrypted image requires replacing encryption keys. | 共享加密鏡像創(chuàng)建云盤必須更換加密密鑰. |
| 403 | ParameterInvalid | The specified RegionId parameter is invalid. | 指定的地域 ID 無效，請您檢查該地域是否正確。 |
| 403 | ParameterInvalid | The specified RepeatWeekDays parameter is invalid. | 指定的日期無效，請您檢查該日期是否正確。 |
| 403 | ParameterInvalid | The specified TimePoints parameter is invalid. | 指定的時間點不合法，請您查看該時間點是否填寫正確。 |
| 403 | ParameterInvalid | The specified AutoSnapshotPolicyId is invalid. | 指定的自動快照規(guī)則 ID 不合法。 |
| 403 | ParameterInvalid | The specified RetentionDays parameter is invalid. | 指定的保持天數(shù)不合法。 |
| 403 | InvalidParameter.TargetCopyRegions | The specified TargetCopyRegions is invalid. | - |
| 403 | InvalidParameter.CopiedSnapshotsRetentionDays | The specified CopiedSnapshotsRetentionDays is invalid. | - |
| 403 | InvalidParameter.KMSKeyId.CMKUnauthorized | The CMK needs to be added ECS tag. | CMK 未授權(quán) |
| 403 | InvalidParameter.KMSKeyId.KMSUnauthorized | ECS service have no right to access your KMS. | ECS 服務(wù)無權(quán)訪問您的 KMS。 |
| 403 | Abs.InvalidAction.RegionNotSupport | This region does not support this action. | 地域不支持該操作. |
| 403 | InvalidOperation.PolicyTypeUnsupported | The current policy type does not support this operation. Only custom policies are permitted. | 當(dā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 | InvalidParameter.KMSKeyId.NotFound | The specified KMSKeyId does not exist. | 指定的參數(shù) KMSKeyId 不存在。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-12-09 | OpenAPI 描述信息更新、OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2024-11-05 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2024-03-21 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2024-02-29 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2024-02-28 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2024-02-28 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |