You need to enable JavaScript to run this app.
导航
云服务器
  • 文档首页
    • /
  • 云服务器

ModifyAutoSnapshotPolicy

最近更新时间：2024.04.25 17:11:26

首次发布时间：2022.06.02 15:47:48

我的收藏

调用ModifyAutoSnapshotPolicy接口修改一条自动快照策略。修改自动快照策略后，之前已应用该策略的云盘随即执行修改后的自动快照策略。

调试

API Explorer
您可以通过API Explorer在线发起调用，无需关注签名生成过程，快速获取调用结果。
去调试

请求参数

名称类型是否必选
示例值
描述
ActionString是ModifyAutoSnapshotPolicy要执行的操作，取值：ModifyAutoSnapshotPolicy。
AutoSnapshotPolicyIdString是asp-anj249wubz9kakc8****需要修改的自动快照策略ID。

AutoSnapshotPolicyName

String

否

testName

自动快照策略名称，命名规范如下：

  • 首字符仅支持中文、字母或下划线（_）。
  • 可包含中文、字母、数字、下划线（_）或中划线（-）。
  • 长度限制在1~128个字符。

TimePoints.N

String

否

TimePoints.1=0&TimePoints.2=1

自动快照的创建时间点，取值说明如下：

  • 使用UTC +8时间，单位为小时。
  • 取值范围：0~23，代表00:00至23:00共24个时间点，例如1表示01:00。
  • 当一天内需要创建多次自动快照时，可以传入多个时间点，最多传入24个时间点。

RepeatWeekdays.N

String

否

RepeatWeekdays.1=1&RepeatWeekdays.2=7

按周重复创建快照，即在周一至周日之间选择一个或多个日期创建快照。说明如下：

  • 取值范围为1~7，例如1表示周一。
  • 当一星期内需要创建多次自动快照时，可以传入多个时间点，最多传入7个时间点。

RepeatDays

Integer

否

2

按天重复创建快照，即间隔一定天数创建快照，取值范围为[1, 30] 。

说明

修改自动快照策略的RepeatDays后，修改自动快照策略的当天视为第一天。

RetentionDays

Integer

否

30

自动快照的保留时间，单位为天，取值说明如下：

  • -1：永久保存。
  • 1~65536：指定保存天数。

注意

修改保留时间后，不会影响历史快照，只对新增快照生效。

返回数据

操作接口仅返回公共参数及错误码。

请求示例

GET /?Action=ModifyAutoSnapshotPolicy&AutoSnapshotPolicyId=asp-anj249wubz9kakc8****&AutoSnapshotPolicyName=testName&Version=2020-04-01&TimePoints.1=0&TimePoints.2=1&RepeatWeekdays.1=1&RepeatWeekdays.2=7 HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
ServiceName: storage_ebs

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2022050519574501021219921217C2****",
        "Action": "ModifyAutoSnapshotPolicy",
        "Version": "2020-04-01",
        "Service": "storage_ebs",
        "Region": "cn-beijing"
    },
    "Result": {}
}

错误码

HttpCode错误码错误信息
404AutoSnapshotPolicyNotFound未找到自动快照策略
400AccountIdNotMatched用户ID不匹配
500InternalError内部错误，请提工单解决