CopyImage

Description

After you copy a custom image to the destination region, you can use the image copy to create Elastic Compute Service (ECS) instances by calling the RunInstances operation or replace the system disks of instances by calling the ReplaceSystemDisk operation in the destination region.

When you call this operation, take note of the following items:

• Only custom images that are in the Available state can be copied.
• You can only copy images within your own Alibaba Cloud account. Images cannot be copied from one account to another.
• When an image is being copied, you cannot delete the image copy by calling the DeleteImage operation, but you can cancel the running copy task by calling the CancelCopyImage operation.
• A single region can have only one image copy task running at a time. Other image copy tasks queue up for the current task to complete before they run in sequence.
• You can set the ResourceGroupId parameter to specify the resource group to which the image copy belongs. If you do not set the ResourceGroupId parameter, the image copy belongs to the default resource group.

Request parameters

Response parameters

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=CopyImage
&ImageId=m-bp1h46wfpjsjastc****
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

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

<CopyImageResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
    <ImageId>m-bp1h46wfpjsjastd****</ImageId>
</CopyImageResponse>

JSON format

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

{
  "RequestId" : "C8B26B44-0189-443E-9816-D951F59623A9",
  "ImageId" : "m-bp1h46wfpjsjastd****"
}

Error codes

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