あるリージョンから別のリージョンにカスタムイメージをコピーします。 対象リージョンでコピーしたイメージを使用して、インスタンスの作成(RunInstances)やシステムディスクの交換(ReplaceSystemDisk)などを実行できます。

説明

このインターフェイスを呼び出すときは、次の点を考慮してください。

  • カスタムイメージが「使用可能」の状態にあるときにのみコピーできます。
  • Alibaba Cloud アカウント内でのみイメージをコピーできます。 クロスアカウントでイメージのコピーは許可されていません。
  • コピーが完了していない場合は、DeleteImage を呼び出してイメージを削除することはできませんが、CancelCopyImage を呼び出してコピーをキャンセルすることはできます。

デバッグ

API Explorer を使用してデバッグを実行できます。 API Explorer を使用することで、さまざまな操作を実行して API の使用を簡単にできます。 たとえば、API の取得、API の呼び出し、SDK のサンプルコードの動的な生成ができます。

リクエストパラメータ

名前 必須 説明
ImageId String はい m-imageid1

ソースカスタムイメージの ID。

RegionId String はい cn-hangzhou

ソースカスタムイメージが属するリージョンの ID。 DescribeRegions を呼び出すと、Alibaba Cloud の最新リージョンが表示されます。

Action String いいえ CopyImage

実行する操作。 値を CopyImage に設定します。

DestinationDescription String いいえ FinanceDept

コピー先のカスタムイメージの説明。 説明の長さは 2~256 文字で、http:// または https:// で始めることはできません。 デフォルト値 : NULL。

DestinationImageName String いいえ FinanceJoshua

対象カスタムイメージの名前。 名前の長さは 2 ~ 128 文字です。 名前は英字で始まる必要があります。注:http:// または https:// で始めることはできません。 英字、数字、ピリオド (.)、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。 デフォルト値 : NULL。

DestinationRegionId String いいえ cn-shanghai

対象カスタムイメージが属するリージョンの ID。

Encrypted Boolean いいえ false

イメージを暗号化するかどうかを示します。

Tag.n.Key String いいえ FinanceJoshua

カスタムイメージのタグキー。

Tag.n.Value String いいえ FinanceDept

カスタムイメージのタグ値。

レスポンスパラメータ

名前 説明
ImageId String m-imageid2

対象カスタムイメージの ID。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

リクエストの ID です。

リクエストのコーディング例

https://ecs.aliyuncs.com/?Action=CopyImage
&ImageId=m-imageid1
&RegionId=cn-hangzhou 
&DestinationImageName=FinanceJoshua
&DestinationDescription=FinanceDept
&DestinationRegionId=cn-shanghai
&Encrypted=false
&<Common request parameters>

成功したレスポンスの例

XML 形式

<CopyImageResponse>
  <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
  <ImageId>Img-231234567</ImageId>
</CopyImageResponse>

JSON 形式

{
	"ImageId":"Img-231234567",
	"RequestId":"C8B26B44-0189-443E-9816-D951F59623A9"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
401 InvalidAliUid.IsNull aliUid は空にすることはできません 必要な AliUid パラメータが指定されていない場合に返されるエラーメッセージ。
403 禁止されています 指定されたリソースで操作する権限のないユーザー。 指定されたリソースにアクセスする権限がない場合に返されるエラーメッセージ。
400 InvalidDescription.Malformed 指定された宛先の説明の形式が誤っています。 指定された説明が無効な場合に返されるエラーメッセージ。 説明の長さは 2~256 文字で、http:// または https:// で始めることはできません。
400 InvalidDescription.Malformed 指定された説明の形式が誤っています。 指定された説明が無効な場合に返されるエラーメッセージ。 説明の長さは 2~256 文字で、http:// または https:// で始めることはできません。
404 InvalidImageId.NotFound 指定された ImageId は存在しません。 指定されたイメージがこのアカウントに存在しない場合に返されるエラーメッセージ。 イメージ ID が正しいかチェックします。
400 IncorrectImageStatus イメージは利用できません。 指定されたトレイルがが存在しない場合に返されるエラーメッセージです。
403 QuotaExceed.Image イメージクォータを超えています。 カスタムイメージクォータが使い果たされたときに返されるエラーメッセージ。
403 QuotaExceed.Snapshot スナップショットの上限を超えています。 スナップショットクォータが使い果たされたときに返されるエラーメッセージ。 新しいスナップショットを保存するために、ビジネスに影響を与えずに既存のスナップショットを削除できます。
403 OperationDenied 指定されたスナップショットはイメージを作成できません。 指定されたスナップショットを使用してイメージを作成できない場合に返されるエラーメッセージ。
403 SizeExceed.Image イメージが最大サイズを超えています。 ホワイトリストにアカウントを追加するためにチケットを起票します。 指定されたイメージサイズが上限に達するとエラーメッセージが返されます。 問題が解決しない場合は、チケットを起票して Alibaba Cloud テクニカルサポートまでご連絡ください。
403 OperationDeined.EncryptedSnapshot イメージにはコピーできない暗号化されたスナップショットが含まれています。 指定されたイメージに暗号化されたスナップショットが含まれているためコピーできない場合に返されるエラーメッセージ。
403 OperationDenied.SameRegionOnly 他人と共有しているイメージを他のリージョンに直接コピーすることはできません。 指定されたイメージが他のアカウントと共有されているためコピーできない場合に返されるエラーメッセージ。

エラーコードの表示。