接口说明
调用该接口之前,请认真阅读创建自动快照策略。
调用该接口时,您需要注意:
-
一个阿里云账户在一个地域最多能创建 100 条自动快照策略。 当某块云盘的自动快照数量达到额度上限,系统在创建新的快照任务时,会删除由自动快照策略所生成的时间最早的自动快照点。
-
当 ECS 实例存在停止或者重启任务时,系统不会执行自动快照策略。
-
已启用快照跨地域复制且在未配置加密参数场景下,加密快照默认使用目的端服务密钥进行加密拷贝。跨地域复制快照的注意事项,请参见复制快照。
创建自动快照策略后,需要调用 ApplyAutoSnapshotPolicy 将策略应用到目标云盘。如果您需要调整自动快照策略的内容,请调用 ModifyAutoSnapshotPolicyEx 。
流控信息
授权信息
当前云产品暂无权限信息透出。
请求参数
字段名称 | 字段详情 |
---|---|
regionIdstring | 自动快照策略所属的地域。您可以调用 DescribeRegions 查看最新的阿里云地域列表。 示例值:cn-hangzhou |
autoSnapshotPolicyNamestring | 自动快照策略的名称。长度为 2~128 个英文或中文字符。必须以大小写字母或中文开头,不能以 http://或 https://开头。可以包含数字、半角冒号(:)、下划线(_)或者短划线(-)。展开详情 示例值:TestName |
timePointsstring | 自动快照的创建时间点。使用 UTC +8 时间,单位为小时。取值范围:0~23,代表 00:00 至 23:00 共 24 个时间点,例如 1 表示 01:00。格式说明:展开详情 示例值:["0", "1", … "23"] |
repeatWeekdaysstring | 自动快照的重复日期,单位为天,周期为星期。取值范围:1~7,例如 1 表示周一。格式说明:展开详情 示例值:["1","2"] |
retentionDaysinteger<int32> | 自动快照的保留时间,单位为天。取值范围:展开详情 示例值:30 |
EnableCrossRegionCopyboolean | 是否允许自动跨地域复制。展开详情 示例值:false |
TargetCopyRegionsstring | 跨地域复制快照的目标地域。目前支持设置一个目标地域。 示例值:["cn-hangzhou"] |
StorageLocationArnstring | 说明
该参数暂未开放使用。
示例值:null |
CopiedSnapshotsRetentionDaysinteger<int32> | 跨地域复制快照的保留时间,单位为天。取值范围:展开详情 示例值:30 |
Tagarray<object> | 自动快照策略标签列表。 子级条数 <= 20 |
ResourceGroupIdstring | 资源组 ID。 示例值:rg-aek2kkmhmhs****参考取值来源: DescribeSnapshotGroups |
CopyEncryptionConfigurationobject | 快照异地备份加密参数对象 |
返回参数
字段名称 | 字段详情 |
---|---|
AutoSnapshotPolicyIdstring | 自动快照策略 ID。 示例值:sp-bp12m37ccmxvbmi5**** |
RequestIdstring | 请求 ID。 示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |