為一塊或者多塊磁碟應用自動快照策略。目標磁碟已經應用了自動快照策略時,調用 ApplyAutoSnapshotPolicy 可以更換磁碟當前應用的自動快照策略。

描述

調用該介面時,您需要注意:

  • 一塊磁碟只能應用一條自動快照策略。

  • 一條自動快照策略能應用到多塊磁碟。

  • 如果某一時間點有大量自動快照任務,會有短暫的排隊等待時間,大約為零至三分鐘,因此不能保證該時間點的自動快照任務能同時進行。

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:ApplyAutoSnapshotPolicy
RegionId String 自動快照策略和磁碟所在的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
AutoSnapshotPolicyId String 目標自動快照策略 ID。
DiskIds String 目標磁碟 ID。當您需要將自動快照策略應用於多塊磁碟時,多塊磁碟 ID 用一個格式類似 ["d-xxxxxxxxx", "d-yyyyyyyyy", … "d-zzzzzzzzz"] 的 JSON 數組表示,磁碟 ID 之間用半形逗號(,)隔開。

返回參數

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

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=ApplyAutoSnapshotPolicy
&RegionId=cn-hangzhou
&AutoSnapshotPolicyId=p-233e6ylv0
&DiskIds=["d-233e6ylv0", "d-23vbpbi03", "d-23vasz3ds"]
&<公共請求參數>
返回樣本

XML 格式

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

錯誤碼

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

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
DiskCategory.OperationNotSupported The type of the specified disk does not support creating a snapshot. 400 本地碟無法建立快照。更多詳情,請參閱 本機存放區
DiskCategory.OperationNotSupported The types of some disks in the disk list do not support creating snapshots. 400 指定的磁碟列表 DiskIds 中含有本地碟,無法建立快照。
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 parameter is invalid. 404 指定的 AutoSnapshotPolicyId不合法。
ParameterInvalid The specified DiskIds are invalid. 404 指定的 DiskIds 不合法。
ParameterInvalid The specified RegionId parameter is invalid. 404 指定的 RegionId 不合法。