CopyImage - - Alibaba Cloud Documentation Center

Menyalin custom image dari satu wilayah ke wilayah lain. Anda dapat menggunakan custom image ini untuk men-deploy atau mereplikasi instance Elastic Compute Service (ECS) lintas wilayah.

Catatan penggunaan

Setelah menyalin custom image ke wilayah tujuan, Anda dapat menggunakan salinan tersebut (image baru) untuk membuat instance ECS dengan memanggil operasi RunInstances atau mengganti disk sistem instance dengan memanggil operasi ReplaceSystemDisk di wilayah tersebut.

Perhatikan hal-hal berikut:

Hanya custom image yang berstatus Available yang dapat disalin.
Custom image yang ingin Anda salin harus dimiliki oleh Akun Alibaba Cloud Anda atau telah dibagikan kepada Anda oleh pihak lain, dan tidak dapat disalin lintas akun.
Selama proses penyalinan berlangsung, image tersebut tidak dapat dihapus melalui operasi DeleteImage. Namun, Anda dapat membatalkan tugas penyalinan yang sedang berjalan dengan memanggil operasi CancelCopyImage.
Satu wilayah hanya dapat menjalankan satu tugas penyalinan image pada satu waktu. Tugas penyalinan tambahan akan masuk antrian dan dijalankan secara berurutan setelah tugas saat ini selesai.
Anda dapat mengonfigurasi parameter ResourceGroupId untuk menentukan kelompok sumber daya tempat image baru ditempatkan. Jika tidak dikonfigurasi, image baru akan ditempatkan dalam kelompok sumber daya default.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	CopyImage	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CopyImage.
DestinationImageName	String	No	YourImageName	Nama image baru. Nama harus terdiri dari 2 hingga 128 karakter. Nama harus diawali dengan huruf dan tidak boleh diawali dengan `acs:` atau `aliyun`. Nama tidak boleh mengandung `http://` atau `https://`. Nama dapat mengandung huruf, angka, titik (.), titik dua (:), garis bawah (_), dan tanda hubung (-).
DestinationDescription	String	No	This is a description example.	Deskripsi image baru. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh diawali dengan `http://` atau `https://`.
ImageId	String	Yes	m-bp1h46wfpjsjastc****	ID custom image sumber.
RegionId	String	Yes	cn-hangzhou	ID wilayah custom image sumber. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.
DestinationRegionId	String	No	cn-shanghai	ID wilayah tujuan tempat custom image sumber akan disalin.
Encrypted	Boolean	No	false	Menentukan apakah image baru akan dienkripsi. true false Nilai default: false.
KMSKeyId	String	No	e522b26d-abf6-4e0d-b5da-04b7******3c	ID kunci yang digunakan untuk mengenkripsi image baru.
EncryptAlgorithm	String	No	hide	Catatan Parameter ini tidak tersedia untuk umum.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	ID kelompok sumber daya tempat image baru ditempatkan. Jika Anda tidak menentukan parameter ini, image baru akan termasuk dalam kelompok sumber daya default. Catatan Jika Anda memanggil operasi CopyImage sebagai Pengguna Resource Access Management (RAM) yang tidak memiliki izin untuk mengelola kelompok sumber daya default dan tidak menentukan parameter `ResourceGroupId`, pesan kesalahan `Forbbiden: User not authorized to operate on the specified resource` akan dikembalikan. Anda harus menentukan ID kelompok sumber daya yang dikelola oleh Pengguna RAM tersebut atau memberikan izin kepada Pengguna RAM untuk mengelola kelompok sumber daya default sebelum memanggil kembali operasi CopyImage.
Tag.N.Key	String	No	TestKey	Kunci tag N yang akan ditambahkan ke image baru. Nilai valid untuk N: 1 hingga 20. Kunci tag tidak boleh berupa string kosong. Panjang kunci tag maksimal 128 karakter dan tidak boleh mengandung `http://` atau `https://`. Kunci tag tidak boleh diawali dengan `acs:` atau `aliyun`.
Tag.N.Value	String	No	TestValue	Nilai tag N yang akan ditambahkan ke image baru. Nilai valid untuk N: 1 hingga 20. Nilai tag boleh berupa string kosong. Panjang nilai tag maksimal 128 karakter dan tidak boleh mengandung `http://` atau `https://`. Nilai tag tidak boleh diawali dengan `acs:`.

Parameter respons

Parameter	Type	Example	Description
ImageId	String	m-bp1h46wfpjsjastd****	ID image baru.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.

Contoh

Contoh permintaan

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

Contoh respons sukses

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****"
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	InvalidDescription.Malformed	The specified destination description is wrongly formed.	Nilai DestinationDescription tidak valid. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh diawali dengan http:// atau https://.
400	SourceRegion.NotFound	The source region not found.	Wilayah sumber yang ditentukan tidak ditemukan.
400	DestinationRegion.NotFound	The destination region not found.	Wilayah tujuan tidak ditemukan.
400	IncorrectImageStatus	The image not available.	Image yang ditentukan tidak tersedia.
400	InvalidSnapshotId.NotFound	The specified SnapshotId does not exist.	Snapshot yang ditentukan tidak ditemukan. Periksa apakah ID image sudah benar.
400	InvalidImageName.Duplicated	The destination image is exist.	Nama image sudah ada.
400	InvalidParameter.EncryptedIllegal	The specified parameter Encrypted must be true when kmsKeyId is not empty.	Fitur enkripsi harus diaktifkan setelah ID kunci Key Management Service (KMS) ditentukan.
400	OperationDenied.CommunityImage	Community image does not support copy.	Community image tidak dapat disalin.
400	InvalidImageName.Malformed	The specified destination image name is wrongly formed.	Nilai DestinationImageName tidak valid. Untuk informasi selengkapnya, lihat deskripsi parameter DestinationImageName.
400	InvalidParameter.KmsNotEnabled	The specified operation need enable KMS.	Anda harus mengaktifkan KMS.
403	Forbbiden	User not authorized to operate on the specified resource.	Anda tidak memiliki izin untuk melakukan operasi pada resource tersebut.
403	QuotaExceed.Image	The Image Quota exceeds.	Kuota custom image telah habis.
403	QuotaExceed.Snapshot	The snapshot quota exceeds.	Jumlah maksimum snapshot telah terlampaui. Untuk membuat snapshot, hapus snapshot yang tidak lagi diperlukan.
403	OperationDenied.ImageCopying	The Image are coping.	Image sedang dalam proses penyalinan. Coba lagi nanti.
403	RegionNotSupportCopy	The region not support copy.	Wilayah sumber atau wilayah tujuan yang ditentukan tidak mendukung penyalinan image.
403	InvalidSnapshot.TooOld	This operation is denied because the specified snapshot is created before 2013-07-15.	Operasi ditolak karena snapshot yang ditentukan dibuat sebelum 15 Juli 2013.
403	OperationDenied	The specified snapshot is not allowed to create image.	Snapshot yang ditentukan tidak dapat digunakan untuk membuat image.
403	IncorrectDestinationRegion	The destination region is not equal the target region.	Wilayah sumber harus berbeda dari wilayah tujuan saat Anda menyalin image lintas wilayah.
403	SizeExceed.Image	The image exceeds the maximum size. Please open a ticket to add the account to the white list.	Ukuran maksimum image telah terlampaui.
403	OperationDeined.EncryptedSnapshot	The image contains encrypted snapshots, which do not support copying.	Image yang ditentukan mengandung snapshot terenkripsi dan tidak dapat disalin.
403	OperationDenied.SameRegionOnly	The image shared from others can not be copied to another region directly.	Image yang dibagikan oleh akun Alibaba Cloud lain tidak dapat disalin ke wilayah lain.
403	OperationDenied.NotPublished	The operation is denied because corresponding marketplace image is not published in destination region.	Operasi ditolak karena gambar Marketplace Alibaba Cloud yang menjadi dasar image yang ditentukan belum dirilis di wilayah tujuan.
403	OperationDeined.EncryptedSnapshot	The image contains encrypted snapshots, which do not support copying to non-encrypted ones.	Image mengandung snapshot terenkripsi dan tidak dapat disalin ke snapshot yang tidak terenkripsi.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	Kunci master pelanggan (CMK) tidak diaktifkan saat ID kunci KMS ditentukan untuk disk. Anda dapat memanggil operasi DescribeKey milik KMS untuk mengambil informasi tentang CMK yang ditentukan.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service have no right to access your KMS.	ECS tidak memiliki izin untuk mengakses resource KMS Anda.
403	InvalidRegion.NotSupport	The specified region does not support byok.	Fitur Bring Your Own Key (BYOK) tidak didukung di wilayah yang ditentukan.
403	UserNotInTheWhiteList	The user is not in byok white list.	Anda tidak memiliki izin untuk menggunakan fitur BYOK. Coba lagi setelah Anda mendapatkan izin.
403	OperationDenied.KmsServiceUnauthorized	The account is not authorized to kms service, please authorize it.	Anda tidak memiliki izin untuk mengakses KMS. Ajukan permohonan izin yang diperlukan untuk mengakses KMS.
404	InvalidImageId.NotFound	The specified ImageId does not exist.	Image yang ditentukan tidak ditemukan dalam akun. Periksa apakah ID image sudah benar.
404	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist.	ID kunci KMS yang ditentukan tidak ditemukan.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	Kelompok sumber daya tidak ditemukan.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Terjadi kesalahan internal. Coba lagi nanti.

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.