CopyImage

Description

call the CopyImage to copy custom images in one region to other regions. Copying images can deploy ECS instances across regions and replicate ECS instances across regions.

Request Method

POST

Request Path

/apsara/route/Ecs/CopyImage

Request Parameters Common Parameters

Name	Location	Type	Required	Sample value	Description
KMSKeyId	BODY	string	No	e522b26d-abf6-4e0d-b5da-04b7******3c	the key ID used to encrypt the image.
DestinationRegionId	BODY	string	No	cn-shanghai-env17-d02	ID copied to the target region.
regionId	BODY	string	Yes	No sample value for this parameter.	region id
Encrypted	BODY	boolean	No	false	Whether to encrypt the copied image. default value: false.
ImageId	BODY	string	Yes	m-bp1h46wfpjsjastc****	derived from the ID that defines the image.
DestinationDescription	BODY	string	No	This is a description example.	description information of the copied image. 2 to 256 English or Chinese characters in length and cannot start with http:// or https. default value: empty.
RegionId	BODY	string	Yes	cn-qingdao-env17-d01	the region ID from the definition mirror. You can call the DescribeRegions to view the latest Alibaba Cloud region list.
version	BODY	string	No	2016-01-01	version of api
DestinationImageName	BODY	string	No	YourImageName	the name of the copied image. The length is 2~128 English or Chinese characters. It must start with a letter or Chinese, and cannot start with http:// or https. It can contain numbers, colons (:), underscores (_), or dashes (-). default value: empty.

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
 }

}