CreateAutoSnapshotPolicy
在指定地域下创建一条自动快照策略。可以指定自动快照的重复周期、保留时间以及跨地域备份等策略,为系统盘或数据盘创建快照备份数据
服务地址:
华东1 金融云
输入参数
只看必填
regionId自动快照策略所属的地域
autoSnapshotPolicyName自动快照策略的名称
timePoints自动快照的创建时间点
repeatWeekdays自动快照的重复日期
retentionDays自动快照的保留时间
EnableCrossRegionCopy是否允许自动跨地域复制
请选择布尔值
TargetCopyRegions跨地域复制快照的目标地域
StorageLocationArn该参数暂未开放使用
CopiedSnapshotsRetentionDays跨地域复制快照的保留时间
Tag自动快照策略标签列表
0
Key自动快照策略的标签键
Value自动快照策略的标签值
ResourceGroupId资源组ID
CopyEncryptionConfiguration快照异地备份加密参数对象
Encrypted是否开启快照异地加密备份
请选择布尔值
KMSKeyId快照异地加密备份使用的 KMS 密钥 ID
Arn该参数暂未开放使用
0
RoleType该参数暂未开放使用
Rolearn该参数暂未开放使用
AssumeRoleFor该参数暂未开放使用
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

调用该接口之前,请认真阅读创建自动快照策略

调用该接口时,您需要注意:

  • 一个阿里云账户在一个地域最多能创建 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
变更历史
暂无变更历史