ModifyAutoSnapshotPolicy--云服务器-火山引擎

文档中心

立即注册

导航

云服务器

ModifyAutoSnapshotPolicy

最近更新时间：2024.11.01 18:49:57首次发布时间：2022.06.02 15:47:48

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

调试

API Explorer

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

去调试

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	ModifyAutoSnapshotPolicy	要执行的操作，取值：ModifyAutoSnapshotPolicy。
Version	String	是	2020-04-01	API的版本，取值：2020-04-01。
AutoSnapshotPolicyId	String	是	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	错误码	错误信息
404	AutoSnapshotPolicyNotFound	未找到自动快照策略
400	AccountIdNotMatched	用户ID不匹配
500	InternalError	内部错误，请提工单解决