CopyImage - Elastic Compute Service - Alibaba Cloud Documentation Center

Menyalin gambar kustom dari satu wilayah ke wilayah lain. Anda dapat menggunakan operasi ini untuk men-deploy instans ECS lintas wilayah atau mereplikasi instans ECS lintas wilayah.

Deskripsi operasi

Anda dapat menggunakan gambar yang disalin di wilayah tujuan untuk membuat instans ECS (RunInstances) atau mengganti disk sistem instans (ReplaceSystemDisk).

Saat memanggil operasi ini, perhatikan hal-hal berikut:

Gambar kustom harus berada dalam status Available.
Jika gambar tersebut adalah gambar kustom di bawah akun Anda, Anda dapat menyalinnya lintas wilayah. Jika gambar tersebut dibagikan kepada Anda oleh akun lain, Anda hanya dapat menyalinnya dalam wilayah yang sama.
Selama proses penyalinan gambar, Anda tidak dapat langsung menghapus (DeleteImage) gambar yang sedang disalin. Namun, Anda dapat membatalkan tugas penyalinan (CancelCopyImage) untuk menghapus gambar yang sedang disalin.
Maksimal lima tugas penyalinan gambar dapat berjalan secara bersamaan dalam satu wilayah. Tugas tambahan akan dimasukkan ke dalam antrean dan dieksekusi secara berurutan setelah salah satu tugas yang sedang berjalan selesai.
Anda dapat menggunakan parameter ResourceGroupId untuk menentukan kelompok sumber daya tempat gambar yang disalin berada. Jika Anda tidak mengatur parameter ResourceGroupId, gambar yang disalin akan termasuk dalam kelompok sumber daya default.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ecs:CopyImage

update

*Image.

acs:ecs:{#regionId}:{#accountId}:image/*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
DestinationImageName	string	No	Nama gambar yang disalin. Panjang nama harus 2 hingga 128 karakter. Nama harus diawali dengan huruf dan tidak boleh diawali dengan `aliyun` atau `acs:`. Nama tidak boleh mengandung `http://` atau `https://`. Nama dapat berisi angka, titik (.), titik dua (:), garis bawah (_), dan tanda hubung (-).	YourImageName
DestinationDescription	string	No	Deskripsi gambar yang disalin. Panjang deskripsi harus 2 hingga 256 karakter dan tidak boleh diawali dengan `http://` atau `https://`.	Ini adalah contoh deskripsi
ImageId	string	Yes	ID gambar kustom sumber.	m-bp1h46wfpjsjastc****
RegionId	string	Yes	ID wilayah gambar kustom sumber. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
DestinationRegionId	string	No	ID wilayah tujuan.	cn-shanghai
Encrypted	boolean	No	Apakah akan mengenkripsi gambar yang disalin. true: Mengenkripsi gambar yang disalin. false: Tidak mengenkripsi gambar yang disalin. Tidak ditentukan: Bergantung pada logika backend. Untuk informasi lebih lanjut, lihat deskripsi tambahan di bawah. Nilai default: tidak ditentukan.	false
KMSKeyId	string	No	ID kunci yang digunakan untuk mengenkripsi gambar.	e522b26d-abf6-4e0d-b5da-04b7******3c
EncryptAlgorithm	string	No	Catatan Parameter ini tidak tersedia untuk publik.	hide
ResourceGroupId	string	No	ID kelompok sumber daya gambar yang direplikasi. Jika Anda tidak mengatur parameter ini, gambar yang direplikasi akan termasuk dalam kelompok sumber daya default. Catatan Jika Anda menggunakan Pengguna RAM untuk memanggil operasi ini dan parameter `ResourceGroupId` dibiarkan kosong, perhatikan hal berikut: jika Pengguna RAM tidak memiliki izin pada kelompok sumber daya default, pemanggilan akan mengembalikan pesan error `Forbidden: User not authorized to operate on the specified resource`. Atur parameter `ResourceGroupId` ke ID kelompok sumber daya yang memiliki izin Pengguna RAM, atau berikan izin kepada Pengguna RAM pada kelompok sumber daya default menggunakan akun Alibaba Cloud yang sesuai, lalu panggil operasi ini kembali.	rg-bp67acfmxazb4p****
Tag	array<object>	No	Tag.
	object	No	Tag.
Key	string	No	Kunci tag gambar yang disalin. Nilai valid N: 1 hingga 20. Kunci tag tidak boleh berupa string kosong. Panjang kunci tag dapat mencapai 128 karakter dan tidak boleh diawali dengan `aliyun` atau `acs:`. Kunci tag tidak boleh mengandung `http://` atau `https://`.	TestKey
Value	string	No	Nilai tag gambar yang disalin. Nilai valid N: 1 hingga 20. Nilai tag dapat berupa string kosong. Panjang nilai tag dapat mencapai 128 karakter dan tidak boleh diawali dengan `acs:`. Nilai tag tidak boleh mengandung `http://` atau `https://`.	TestValue
DryRun	boolean	No	Apakah akan menjalankan dry run saja. Nilai valid: true: Hanya menjalankan dry run. Sistem memeriksa permintaan untuk potensi masalah, termasuk Pasangan Kunci Akses, otorisasi Pengguna RAM, dan apakah parameter yang diperlukan telah ditentukan. Jika permintaan gagal dalam dry run, pesan error yang sesuai akan dikembalikan. Jika permintaan lulus dry run, kode kesalahan `DryRunOperation` akan dikembalikan. false: Menjalankan dry run dan mengirimkan permintaan Normal. Jika permintaan lulus dry run, kode status HTTP 2XX akan dikembalikan dan operasi akan dijalankan. Nilai default: false.	false
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi pastikan token tersebut unik di antara permintaan yang berbeda. Nilai ClientToken hanya dapat berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.	123e4567-e89b-12d3-a456-426655440000

Skenario	Status gambar sumber	Parameter Encrypted	Parameter KMSKeyId	Apakah Enkripsi default tingkat akun EBS dikonfigurasi di wilayah tujuan	Hasil gambar tujuan	Deskripsi
1	Gambar tidak terenkripsi	False atau tidak ditentukan	Tidak ditentukan	Tidak dikonfigurasi	Gambar tidak terenkripsi	Gambar tidak dienkripsi dan tetap tidak berubah.
2	Gambar tidak terenkripsi	True	Tidak ditentukan	Apa pun	Gambar terenkripsi penuh	Pengguna secara eksplisit meminta enkripsi. Jika enkripsi default tingkat akun EBS dikonfigurasi, kunci default yang dikonfigurasi akan dienkripsi dengan kunci rahasia. Jika tidak, kunci layanan akan dienkripsi dengan kunci rahasia.
3	Gambar tidak terenkripsi	True	Ditentukan	Apa pun	Gambar terenkripsi penuh	Pengguna secara eksplisit meminta enkripsi. KMSKeyId yang ditentukan akan dienkripsi dengan kunci rahasia.
4	Gambar tidak terenkripsi	Tidak ditentukan	Tidak ditentukan	Dikonfigurasi	Gambar terenkripsi penuh	Kunci yang dikonfigurasi untuk enkripsi default tingkat akun EBS akan dienkripsi dengan kunci rahasia.
5	Gambar terenkripsi	Tidak ditentukan	Tidak ditentukan	Tidak dikonfigurasi	Gambar terenkripsi	Format asli dipertahankan. Snapshot tidak terenkripsi tetap tidak terenkripsi, dan snapshot terenkripsi dienkripsi dengan kunci layanan.
6	Gambar terenkripsi	Tidak ditentukan atau True	Tidak ditentukan	Dikonfigurasi	Gambar terenkripsi penuh	Kunci yang dikonfigurasi untuk enkripsi default tingkat akun EBS akan dienkripsi dengan kunci rahasia.
7	Gambar terenkripsi	True	Tidak ditentukan	Tidak dikonfigurasi	Gambar terenkripsi penuh	Kunci layanan akan dienkripsi dengan kunci rahasia.
8	Gambar terenkripsi	True	Tidak ditentukan	Dikonfigurasi	Gambar terenkripsi penuh	Kunci yang dikonfigurasi untuk enkripsi default tingkat akun EBS akan dienkripsi dengan kunci rahasia.
9	Gambar terenkripsi	True	Ditentukan	Apa pun	Gambar terenkripsi penuh	Pengguna secara eksplisit meminta enkripsi. KMSKeyId yang ditentukan akan dienkripsi dengan kunci rahasia.

Elemen respons

Element	Type	Description	Example
	object
ImageId	string	ID gambar yang disalin.	m-bp1h46wfpjsjastd****
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Contoh

Respons sukses

JSONformat

{
  "ImageId": "m-bp1h46wfpjsjastd****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidDescription.Malformed	The specified destination description is wrongly formed.	Format deskripsi Sumber daya yang ditentukan tidak valid. Deskripsi harus memiliki panjang 2 hingga 256 karakter dan tidak boleh dimulai dengan http:// atau https://.
400	SourceRegion.NotFound	The source region not found.
400	DestinationRegion.NotFound	The destination region not found.	Wilayah tujuan yang ditentukan tidak ada.
400	IncorrectImageStatus	The image not available.	Penyalinan gambar gagal.
400	InvalidSnapshotId.NotFound	The specified SnapshotId does not exist.	Snapshot yang ditentukan tidak ada. Pastikan snapshot benar.
400	InvalidImageName.Duplicated	The specified image name is already in use in the target region. Please try a different one.	Nama image sudah ada.
400	InvalidParameter.EncryptedIllegal	The Encrypted parameter must be set to true when KMSKeyId is specified. Please adjust the parameters and try again.
400	InvalidEncrypted.NotMatchEncryptAlgorithm	The Encrypted parameter must be set to true when EncryptAlgorithm is specified. Please adjust the parameters and try again.
400	InvalidEncryptAlgorithm	The specified EncryptAlgorithm is not valid. Ensure the value is a supported encryption algorithm such as AES-256.
400	InvalidEncrypted.NotMatchKmsKeyId	The Encrypted parameter must be set to true when KMSKeyId is specified. Please adjust the parameters and try again.
400	OperationDenied.CommunityImage	Community image does not support copy.	Gambar komunitas tidak mendukung penyalinan.
400	InvalidImageName.Malformed	The specified destination image name is wrongly formed.	Nama image tidak valid. Untuk informasi lebih lanjut tentang konvensi penamaan, lihat deskripsi metrik parameter DestinationImageName.
400	InvalidParameter.KmsNotEnabled	The specified operation need enable KMS.	Operasi saat ini memerlukan Key Management Service (KMS) untuk diaktifkan.
400	OperationDenied.ImageCopyConflict	The same image cannot be copied concurrently. Please wait until the last copy is completed before performing the next operation.	Operasi penyalinan konkuren pada image yang sama tidak diizinkan. Tunggu hingga operasi penyalinan sebelumnya selesai sebelum memulai yang baru.
400	Account.Arrearage	Your account has an outstanding payment.	Saldo akun Anda tidak mencukupi. Isi ulang akun Anda sebelum melanjutkan.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Terdapat kunci duplikat dalam tag. Pastikan semua kunci unik.
401	InvalidAliUid.IsNull	The aliUid must not be null.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Terjadi error internal. Coba lagi.
403	Forbbiden	User not authorized to operate on the specified resource.	Pengguna tidak diizinkan untuk melakukan operasi pada Sumber daya tertentu.
403	InvalidOperation.CopyingDataFromThisRegionUnsupported	Data transfer from the current region to other regions is not supported.	Mereplikasi data dari wilayah saat ini ke wilayah lain tidak didukung.
403	InvalidOperation.CopyingDataToThisRegionUnsupported	Only Some Regions %s can copy data to this region.	Hanya wilayah tertentu yang dapat mereplikasi data ke wilayah saat ini.
403	QuotaExceed.Image	The number of images exceeds the limit (%s).	Kuota gambar kustom telah habis.
403	QuotaExceed.Snapshot	The snapshot quota exceeds.
403	OperationDenied.ImageCopying	The image is currently being copied. Please try again later.	Image sedang disalin. Coba lagi nanti.
403	RegionNotSupportCopy	The region not support copy.
403	InvalidSnapshot.TooOld	This operation is denied because the specified snapshot is created before 2013-07-15.	Snapshot sumber dari disk yang ditentukan dibuat pada atau sebelum 15 Juli 2013, dan tidak dapat diinisialisasi ulang.
403	OperationDenied	The specified snapshot is not allowed to create image.	Snapshot yang ditentukan tidak mengizinkan pembuatan volume data.
403	IncorrectDestinationRegion	The destination region is not equal the target region.
403	OperationDeined.EncryptedSnapshot	The image contains encrypted snapshots, which do not support copying.	Image berisi snapshot terenkripsi.
403	OperationDenied.SameRegionOnly	The image shared from others can not be copied to another region directly.	Image yang dibagikan oleh pengguna 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 yang ditentukan tidak dapat dilakukan. Image sumber dari image berasal dari Alibaba Cloud Marketplace dan belum dipublikasikan di wilayah tujuan.
403	OperationDenied.NotAuthorized	The operation is denied because corresponding marketplace image is not authorized to current user.
403	OperationDenied.EncryptSnapshotAcrossRegion	The image do not contain encrypted snapshots, which do not support copying to encrypted ones.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	The ECS service is not authorized to access your KMS key. Please grant the ECS service permission to use the key and try again.
403	InvalidRegion.NotSupport	The specified region does not support byok.	Wilayah yang ditentukan tidak didukung.
403	UserNotInTheWhiteList	The user is not in byok white list.	Pengguna tidak berada dalam daftar putih Shared Block Storage. Ajukan tiket untuk mendaftar ke daftar putih.
403	InvalidRegionId.NotSupportEncryptAlgorithm	The current region does not support creating encrypted disks with EncryptAlgorithm.
403	OperationDenied.KmsServiceUnauthorized	The ECS service is not authorized to access your KMS key. Please grant the ECS service permission to use the key and try again.
403	OperationDenied.NonCompliantDestinationRegion	The copy operation to the destination region is not in compliance with regulations.	Wilayah tujuan tidak memenuhi persyaratan kepatuhan keamanan.
403	InvalidEncrypted.NotMatchDiskDefaultEncryption	The specified parameter Encrypted not match for your account default encryption settings.	Parameter enkripsi tidak cocok dengan konfigurasi enkripsi disk secara default dari akun saat ini.
403	InvalidParameter.DataEncryptedKeyCreateFailed	The ECS service is not authorized to access your KMS key. Please grant the ECS service permission to use the key and try again.
403	SizeExceed.Image	The image exceeds the maximum size. You can use the CopySnapshot API to copy your snapshots of the image and then create a new image from them.	Ukuran image yang ditentukan melebihi batas. Kirim tiket untuk meminta peningkatan batas.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The specified KMS key must be in an enabled state. Please enable the key in the KMS console and try again.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The specified KMS key is not authorized for the ECS service. Please grant the ECS service permission to use the key in the KMS console and try again.
403	InvalidOperation.VhdImageUnsupported	The specified vhd image is not supported for this operation. Please switch to a raw image and retry.	Image format VHD tidak mendukung operasi ini. Beralih ke image format RAW dan coba lagi.
403	InvalidOperation.CloudBoxImageCopyUnsupported	Copying CloudBox images is not supported.	Image CloudBox tidak mendukung penyalinan.
403	OperationDenied.KMSKeyUnauthorized	The operation is denied due to missing KMS key authorization. Please check the KMS key permissions and ensure the key is properly authorized for this operation.
404	InvalidImageId.NotFound	The specified ImageId does not exist.	Image yang ditentukan tidak ada di akun ini. Verifikasi bahwa ID image benar.
404	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	Kelompok sumber daya tidak ditemukan dalam catatan.
409	InvalidOperation.Conflict	Request was denied due to conflict with a previous request, please try again later.	Operasi ini tidak diizinkan karena adanya konflik tugas.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.