全部产品
云服务器 ECS

CreateAutoSnapshotPolicy

更新时间:2017-09-13 12:58:18   分享:   

描述

创建一条自动快照策略。

  • 一个账号在一个地域最多创建 100 条策略。
  • 创建的自动快照策略可以应用到任意磁盘。
  • 已创建的自动快照策略可以修改操作。
  • 如果磁盘数据量大,一次打快照时长超过两个自动快照时间点间隔,则下一个时间点不打快照自动跳过;比如:用户设置 9:00、10:00、11:00、12:00 为自动快照时间点,9:00 打快照的时候时长为 80 分钟,也就是 10:20 才打完,那 10:00 预设时间点将不打快照,下个快照时间点为 11:00。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数。取值:CreateAutoSnapshotPolicy
RegionId String 自动快照策略所属的 RegionId。RegionId 的列表详见 地域列表
AutoSnapshotPolicyName String 自动快照策略的名称。
  • 长度为 [2, 128] 个英文或中文字符,必须以大小字母或中文开头,可包含数字,下划线(_)或连字符(-)。
  • 不填则为空,默认值为空。
  • 磁盘名称会展示在控制台。
  • 不能以 http:// 和 https:// 开头。
TimePoints String 指定自动快照的创建时间点。
  • 单位为小时,取值范围:[0, 23]。00:00 ~ 23:00 共 24 个时间可选点,如 1 表示 01:00。
  • 允许选择多个时间点。
  • 传递参数为一个带有格式的 Json Array:[“0”, “1”, … “23”],最多 24 个时间点,用半角逗号字符隔开。
RepeatWeekdays String 指定自动快照的重复日期。
  • 选定周一到周日中需要创建快照的日期,取值范围:[1, 7]。如 1 表示周一。
  • 允许选择多个日期。
  • 传递参数为一个带有格式的 Json Array:[ “1”,“2”…“7”],最多 7 个时间点,用半角逗号字符隔开。
RetentionDays integer 指定自动快照的保留时间。单位:天。取值范围:
  • -1:永久保存。
  • [1, 65536]:指定保存天数。
默认值:-1
ClientToken String 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过不值过 64 个 ASCII 字符。
具体参见附录:如何保证幂等性

返回参数

名称 类型 描述
AutoSnapshotPolicyId String 自动快照策略 ID

错误码

错误代码 描述 Http 状态码 语义
AutoSnapshotPolicy.QuotaExceed The maximum number of automatic snapshot policy has been reached. 403 自动快照策略超过限额。
ParameterInvalid The specified RegionId parameter is invalid. 404 指定的参数 RegionId 无效。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 无效。

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=CreateAutoSnapshotPolicy
  2. &SettingTimePoints=[“0”, 11 ”, 21 ”]&SettingRepeatWeekdays=[“1 ,“2 ,“4 ,“7”] &RetentionDays=30
  3. &<公共请求参数>

返回示例

XML格式

  1. <CreateAutoSnapshotPolicyResponse>
  2. <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
  3. <AutoSnapshotPolicyId>p-233e6ylv0</AutoSnapshotPolicyId>
  4. </CreateAutoSnapshotPolicyResponse>

JSON格式

  1. {
  2. "RequestId":"F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
  3. "AutoSnapshotPolicyId":"p-233e6ylv0"
  4. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?