CopySnapshot
Description
the call CopySnapshot copies a normal snapshot from 1 region to another.
Request Method
POST
Request Path
/apsara/route/Ecs/CopySnapshot
Request Parameters Common Parameters
Name | Location | Type | Required | Sample value | Description |
---|---|---|---|---|---|
SnapshotId | BODY | string | Yes | s-bp67acfmxazb4p**** | source snapshot ID. |
Tag.N.Key | BODY | string | No | TestKey | the tag key of the new snapshot. Once the value is passed in, an empty string is not allowed. it can be up to 128 characters in length. it cannot start with aliyun or acs: and cannot contain http:// or https://. |
DestinationRegionId | BODY | string | Yes | cn-beijing-env17-d01 | the target region ID of the new snapshot. |
regionId | BODY | string | Yes | No sample value for this parameter. | region id |
Tag.N.Value | BODY | string | No | TestValue | the label value of the new snapshot. Once the value is passed in, an empty string is allowed. it can be up to 128 characters in length. it cannot start with aliyun or acs: and cannot contain http:// or https://. |
DestinationSnapshotName | BODY | string | Yes | test-DestinationSnapshotName | the name of the new snapshot. 2 to 128 English or Chinese characters in length, which must start with an uppercase or a Chinese letter and cannot start with http:// or https. It can contain numbers, colons (:), underscores (_), or hyphens (-). default value: empty. |
DestinationSnapshotDescription | BODY | string | Yes | This is a description example. | description information of the new snapshot. 2 to 256 English or Chinese characters in length and cannot start with http:// or https. default value: empty. |
RetentionDays | BODY | integer | No | 60 | The retention duration of a new snapshot, in days, is automatically released after the retention duration is exceeded. Value range: 1~65536. default value: empty, indicating that the snapshot will not be automatically released. |
RegionId | BODY | string | Yes | cn-qingdao-env17-d01 | the region where the source snapshot is located. You can call the DescribeRegions to view the latest Alibaba Cloud region list. |
version | BODY | string | No | 2016-01-01 | version of api |
Return data
Name | Type | Sample value | Description |
---|---|---|---|
RequestID | string | 1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DC | Request id |
Example
Successful Response example
{
"RequestID":"1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DC"
}
Failed Response example
{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}
}