修改一條自動快照策略。修改自動快照策略後，之前已應用該策略的磁碟隨即執行修改後的自動快照策略。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：ModifyAutoSnapshotPolicyEx
RegionId String 是 自動快照策略所在的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
AutoSnapshotPolicyId String 是 目標自動快照策略 ID。您可以調用 DescribeAutoSnapshotPolicyEx 查看您可用的自動快照策略。
AutoSnapshotPolicyName String 否 自動快照策略的名稱。如果參數為空則代表不修改。
TimePoints String 否 自動快照的建立時間點，單位為小時。取值範圍：[0, 23]，代表 00:00 至 23:00 共 24 個時間點，如 1 表示 01:00。當一天內需要建立多次自動快照時，可以傳入多個時間點：
  • 最多傳入 24 個時間點。
  • 多個時間點用一個格式類似 ["0", "1", … "23"] 的 JSON 數組表示，時間點之間用半形逗號（,）隔開。
RepeatWeekdays String 否 自動快照的重複日期，單位為天，周期為星期。取值範圍：[1, 7]，如 1 表示周一。當一星期內需要建立多次自動快照時，可以傳入多個時間點：
  • 最多傳入 7 個時間點。
  • 多個時間點用一個格式類似 ["1", "2", … "7"] 的 JSON 數組表示，時間點之間用半形逗號（,）隔開。
RetentionDays Integer 否 自動快照的保留時間，單位為天。取值範圍：
  • -1：永久保存。
  • [1, 65536]：指定保存天數。
預設值：-1
ClientToken String 否 用於保證請求的等冪性。由用戶端生成該參數值，要保證在不同請求間唯一。只支援 ASCII 字元，且不能超過 64 個字元。更多詳情，請參閱 如何保證等冪性。

返回參數

全是公共返回參數。參閱 公共參數。

樣本

請求樣本 
https://ecs.aliyuncs.com/?Action=ModifyAutoSnapshotPolicyEx
&RegionId=cn-hangzhou
&AutoSnapshotPolicyId=p-233e6ylv0
&SettingTimePoints=[“0”, “11”, “21”]
&SettingRepeatWeekdays=[“1”, “2”, “4”, “7”]
&RetentionDays=30
&<公共請求參數>
返回樣本

XML 格式

<ModifyAutoSnapshotPolicyResponse>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ModifyAutoSnapshotPolicyResponse>
JSON 格式 
{
    "RequestId":"F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
ParameterInvalid The specified automatic snapshot policy does not exist. 404 指定的 AutoSnapshotPolicyId不存在。
ParameterInvalid The specified automatic snapshot policy does not exist in the region. 404 指定的 AutoSnapshotPolicyId不在指定的地域中。
ParameterInvalid The specified AutoSnapshotPolicyId is invalid. 404 指定的參數 AutoSnapshotPolicyId不合法。
ParameterInvalid The specified RegionId parameter is invalid. 404 指定的參數 RegionId 不合法。