複製一個地域下的自訂鏡像到其他地域。您可以在其他地域可以使用複製後的鏡像 建立 ECS 執行個體（RunInstances）或者更換執行個體的系統盤（ReplaceSystemDisk）。

描述

調用該介面時，您需要注意：

  • 自訂鏡像的狀態必須為 Available。

  • 被複製的自訂鏡像必須為您帳號下的鏡像，不能跨帳號複製。

  • 複製鏡像的過程中無法刪除鏡像（DeleteImage），但是您可以取消複製任務（CancelCopyImage）。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：CopyImage
RegionId String 是 源自訂鏡像的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
ImageId String 是 源自訂鏡像的 ID。
DestinationRegionId String 是 複製到目標地域的 ID。
DestinationImageName String 否 複製後的鏡像的名稱。
  • 長度為 [2, 128] 個字元英文或中文字元，必須以大小字母或中文開頭，可包含數字、半形冒號（:）、底線（_）或連字號（-）。
  • 不能以 http:// 和 https:// 開頭。
不填則為空，預設值：空。
DestinationDescription String 否 目標鏡像的描述資訊。
  • 長度為 [0, 256] 個字元。
  • 不能以 http:// 和 https:// 開頭。
不填則為空，預設值：空。

返回參數

名稱 類型 描述
ImageId String 複製後的鏡像的 ID

樣本

請求樣本 
https://ecs.aliyuncs.com/?Action=CopyImage
&DestinationRegionId=cn-hangzhou
&ImageId=m-281234567
&RegionId=cn-qingdao
&<公共請求參數>
返回樣本

XML 格式

<CopyImageResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
    <ImageId>Img-231234567</ImageId>
</CopyImageResponse>
JSON 格式 
{
    "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
    "ImageId": "Img-231234567"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
DestinationRegion.NotFound The destination region not found 400 指定的參數 DestinationRegionId 不存在。
IncorrectImageStatus The image not available. 400 指定的鏡像（ImageId）的狀態必須為可用（Available）。
InvalidDescription.Malformed The specified description is wrongly formed. 400 指定的參數 DestinationDescription格式有誤。
InvalidImageId.NotFound The specified ImageId does not exist. 400 指定的源鏡像（ImageId）不存在。
InvalidImageName.Duplicated The destination image is exist. 400 指定的 DestinationImageName 已經存在，請更改取值。
InvalidImageName.Malformed The specified destination Image name is wrongly formed. 400 指定的目 DestinationImageName 標鏡像名稱不合法。
InvalidImageName.Malformed The specified Image name is wrongly formed. 400 指定的 DestinationImageName 格式有誤。
SourceRegion.NotFound The source region not found 400 指定的源鏡像（RegionId）不存在。
Forbidden User not authorized to operate on the specified resource. 403 您暫時沒有許可權複製鏡像。
IncorrectDestinationRegion The destination region is not equal the target region. 403 指定的源地域（RegionId）和目標地域（DestinationRegionId）的取值不能相同
InvalidSnapshot.TooOld This operation is denied because the specified snapshot is created before 2013-07-15. 403 指定源鏡像（ImageId）所含的快照建立於 2013 年 7 月 15 日（含）之前，不能用於複製鏡像。
OperationDeined.EncryptedSnapshot The image contains encrypted snapshots, which do not support copying. 403 指定源鏡像（ImageId）含有加密快照，不支援複製。
OperationDenied.ImageCopying The specified image is being copied. 403 正在複製指定的源鏡像（ImageId）中，請稍後再試。
QuotaExceed.Image The Image Quota exceeds. 403 您的自訂鏡像數量已經超過最大額度，無法複製鏡像。
QuotaExceed.Snapshot The maximum number of snapshots is exceeded. 403 已經超過快照的最大額度，無法複製鏡像。
RegionNotSupportCopy The region not support copy. 403 指定的目標地域（DestinationRegionId）不支援鏡像複製。