ModifyAutoSnapshotPolicyEx -

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters


Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyAutoSnapshotPolicyEx	The operation that you want to perform. Set the value to ModifyAutoSnapshotPolicyEx.
regionId	String	Yes	cn-hangzhou	The region ID of the automatic snapshot policy to be modified. You can call the DescribeRegions operation to query the most recent region list.
autoSnapshotPolicyId	String	Yes	sp-bp12m37ccmxvbmi5****	The ID of the automatic snapshot policy. You can call the DescribeAutoSnapshotPolicyEx operation to query available automatic snapshot policies.
autoSnapshotPolicyName	String	No	SPTestName	The name of the automatic snapshot policy. If this parameter is not specified, the original name of the automatic snapshot policy is retained.
timePoints	String	No	["0", "1"]	The points in time of the day at which to create automatic snapshots. The time must be in UTC+8. Unit: hours. Valid values are 0 to 23, which correspond to the 24 points in time on the hour from 00:00:00 to 23:00:00. For example, a value of 1 indicates 01:00:00. To schedule multiple automatic snapshots to be created in a day, you can specify multiple hours. You can specify up to 24 points in time. You must set this parameter to a JSON array such as `["0", "1", ... "23"]`. Separate the points in time with commas (,).
repeatWeekdays	String	No	["1", "7"]	The days of the week on which to create automatic snapshots. Valid values are 1 to 7, which correspond to the days of the week. For example, a value of 1 indicates Monday. To schedule multiple automatic snapshots to be created in a week, you can specify multiple days. You can specify up to seven days over a one-week period. You must set this parameter to a JSON array such as `["1", "2" ... "7"]`. Separate the values in the array with commas (,).
retentionDays	Integer	No	30	The retention period of the automatic snapshot. Unit: days. Valid values: -1: The automatic snapshot is permanently retained. 1 to 65536: The auto snapshot is retained for the specified number of days. Default value: -1.
EnableCrossRegionCopy	Boolean	No	false	Specifies whether to enable cross-region replication for the automatic snapshot. true: enables cross-region replication for the automatic snapshot. false: disables cross-region replication for the automatic snapshot.
TargetCopyRegions	String	No	["cn-hangzhou"]	The destination region to which to copy the snapshot. You can specify only a single destination region.
CopiedSnapshotsRetentionDays	Integer	No	30	The retention period of the snapshot copy in the destination region. Unit: days. Valid values: -1: The snapshot is permanently retained. 1 to 65535: The automatic snapshot is retained for the specified number of days. Default value: -1.

Response parameters


Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	The ID of the request.

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=ModifyAutoSnapshotPolicyEx
&autoSnapshotPolicyId=sp-bp12m37ccmxvbmi5****
&regionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyAutoSnapshotPolicyResponse>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ModifyAutoSnapshotPolicyResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}

Error codes


HTTP status code	Error code	Error message	Description
403	ParameterInvalid	The specified RegionId parameter is invalid.	The error message returned because the specified regionId parameter is invalid.
403	ParameterInvalid	The specified RepeatWeekDays parameter is invalid.	The error message returned because the specified repeatWeekdays parameter is invalid.
403	ParameterInvalid	The specified TimePoints parameter is invalid.	The error message returned because the specified timePoints parameter is invalid.
403	ParameterInvalid	The specified AutoSnapshotPolicyId is invalid.	The error message returned because the specified autoSnapshotPolicyId parameter is invalid.
403	ParameterInvalid	The specified RetentionDays parameter is invalid.	The error message returned because the specified retentionDays parameter is invalid.
404	ParameterInvalid	The specified automatic snapshot policy does not exist.	The error message returned because the specified autoSnapshotPolicyId parameter does not exist.
404	ParameterInvalid	The specified automatic snapshot policy does not exist in the region.	The error message returned because the specified autoSnapshotPolicyId parameter does not exist.

For a list of error codes, visit the API Error Center.