建立一條自動快照策略。建立的自動快照策略可以應用到任一磁碟（ApplyAutoSnapshotPolicy），成功建立的自動快照策略可以後續修改策略內容（ModifyAutoSnapshotPolicyEx）。

描述

調用該介面時，您需要注意：

  • 一個阿里雲賬戶在一個地域最多能建立 100 條自動快照策略。

  • 如果磁碟資料較多，單次建立自動快照的時長超過兩個時間點間隔，則自動跳過下一時間點。

    樣本：您設定了 09:00、10:00、11:00 和 12:00 為自動快照時間點。由於磁碟資料較多，09:00 開始建立快照，10:20 完成建立快照，實際耗時 80 分鐘。系統會跳過 10:00 時間點，等到 11:00 繼續為您建立自動快照。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：CreateAutoSnapshotPolicy
RegionId String 是 自動快照策略所屬的地域。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
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
AutoSnapshotPolicyName String 否 自動快照策略的名稱。
  • 長度為 [2, 128] 個英文或中文字元。
  • 必須以大小字母或中文開頭，可包含數字、半形冒號（:）、底線（_）或連字號（-）。
  • 不能以 http:// 和 https:// 開頭。
預設值：空
ClientToken String 否 用於保證請求的等冪性。由用戶端生成該參數值，要保證在不同請求間唯一。只支援 ASCII 字元，且不能超過 64 個字元。更多詳情，請參閱 如何保證等冪性。

返回參數

名稱 類型 描述
AutoSnapshotPolicyId String 自動快照策略 ID

樣本

請求樣本 
https://ecs.aliyuncs.com/?Action=CreateAutoSnapshotPolicy
&RegionId=cn-hangzhou
&TimePoints=[“0”, “11 ”, “21 ”]
&RepeatWeekdays=[“1” ，“2” ，“4” ，“7”]
&RetentionDays=30
&<公共請求參數>
返回樣本

XML 格式

<CreateAutoSnapshotPolicyResponse>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
    <AutoSnapshotPolicyId>p-233e6ylv0</AutoSnapshotPolicyId>
</CreateAutoSnapshotPolicyResponse>
JSON 格式 
{
    "RequestId":"F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
    "AutoSnapshotPolicyId":"p-233e6ylv0"
}

錯誤碼

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

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
AutoSnapshotPolicy.QuotaExceed The maximum number of automatic snapshot policy has been reached. 403 一個阿里雲賬戶在一個地域最多能建立 100 條自動快照策略。
ParameterInvalid The specified RegionId parameter is invalid. 404 指定的參數 RegionId無效。
ParameterInvalid The specified RepeatWeekDays parameter is invalid. 404 指定的參數 RepeatWeekDays 不合法。
ParameterInvalid The specified RetentionDays parameter is invalid. 404 指定的參數 RetentionDays 不合法。
ParameterInvalid The specified TimePoints parameter is invalid. 404 指定的參數 TimePoints 不合法。