调用ModifyAutoSnapshotPolicyEx修改一条自动快照策略。修改自动快照策略后,之前已应用该策略的云盘随即执行修改后的自动快照策略。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyAutoSnapshotPolicyEx |
系统规定参数。取值:ModifyAutoSnapshotPolicyEx。 |
regionId | String | 是 | cn-hangzhou |
自动快照策略所在的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
autoSnapshotPolicyId | String | 是 | sp-bp12m37ccmxvbmi5**** |
目标自动快照策略ID。您可以调用DescribeAutoSnapshotPolicyEx查看您可用的自动快照策略。 |
autoSnapshotPolicyName | String | 否 | SPTestName |
自动快照策略的名称。如果参数为空则代表不修改。 |
timePoints | String | 否 | [“0”, “1”] |
自动快照的创建时间点。使用UTC +8时间,单位为小时。取值范围为0~23,代表00:00至23:00共24个时间点,如1表示01:00。 当一天内需要创建多次自动快照时,可以传入多个时间点:
|
repeatWeekdays | String | 否 | [“1”, “7”] |
自动快照的重复日期,单位为天,周期为星期。取值范围为1~7,如1表示周一。 当一星期内需要创建多次自动快照时,可以传入多个时间点:
|
retentionDays | Integer | 否 | 30 |
自动快照的保留时间,单位为天。取值范围:
默认值为-1。 |
EnableCrossRegionCopy | Boolean | 否 | false |
是否允许自动跨地域复制。
|
TargetCopyRegions | String | 否 | [“cn-hangzhou”] |
跨地域复制快照的目标地域。目前支持设置一个目标地域。 |
CopiedSnapshotsRetentionDays | Integer | 否 | 30 |
跨地域复制快照的保留时间,单位为天。取值范围:
默认值为-1。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求ID。 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=ModifyAutoSnapshotPolicyEx
&autoSnapshotPolicyId=sp-bp12m37ccmxvbmi5****
®ionId=cn-hangzhou
&
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
F3CD6886-D8D0-4FEE-B93E-1B73239673DE
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
403 | ParameterInvalid | The specified RegionId parameter is invalid. | 指定的地域ID无效,请您检查该地域是否正确。 |
403 | ParameterInvalid | The specified RepeatWeekDays parameter is invalid. | 指定的日期无效,请您检查该日期是否正确。 |
403 | ParameterInvalid | The specified TimePoints parameter is invalid. | 指定的时间点不合法,请您查看该时间点是否填写正确。 |
403 | ParameterInvalid | The specified AutoSnapshotPolicyId is invalid. | 指定的自动快照规则ID不合法。 |
403 | ParameterInvalid | The specified RetentionDays parameter is invalid. | 指定的保持天数不合法。 |
404 | ParameterInvalid | The specified automatic snapshot policy does not exist. | 指定的自动快照策略不存在,请您检查自动快照策略是否正确。 |
404 | ParameterInvalid | The specified automatic snapshot policy does not exist in the region. | 指定的自动快照策略不存在,请您检查自动快照策略是否正确。 |
访问错误中心查看更多错误码。
腾讯云1折,限时活动,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利。同意关联立享优惠
转转请注明出处:https://www.yunxiaoer.com/153278.html