Skip to main content

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

NameLocationTypeRequiredSample valueDescription
SnapshotIdBODYstringYess-bp67acfmxazb4p****source snapshot ID.
Tag.N.KeyBODYstringNoTestKeythe 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://.
DestinationRegionIdBODYstringYescn-beijing-env17-d01the target region ID of the new snapshot.
regionIdBODYstringYesNo sample value for this parameter.region id
Tag.N.ValueBODYstringNoTestValuethe 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://.
DestinationSnapshotNameBODYstringYestest-DestinationSnapshotNamethe 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.
DestinationSnapshotDescriptionBODYstringYesThis 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.
RetentionDaysBODYintegerNo60The 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.
RegionIdBODYstringYescn-qingdao-env17-d01the region where the source snapshot is located. You can call the DescribeRegions to view the latest Alibaba Cloud region list.
versionBODYstringNo2016-01-01version of api

Return data

NameTypeSample valueDescription
RequestIDstring1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DCRequest id

Example

Successful Response example

{
"RequestID":"1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DC"
}

Failed Response example

{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}

}