Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # `AWSSupport-CopyEC2Instance` **Deskripsi** `AWSSupport-CopyEC2Instance`Runbook menyediakan solusi otomatis untuk prosedur yang diuraikan dalam artikel Pusat Pengetahuan [Bagaimana cara memindahkan EC2 instance saya ke subnet lain, Availability Zone, atau](https://aws.amazon.com/premiumsupport/knowledge-center/move-ec2-instance/) VPC? Cabang otomatisasi tergantung pada nilai yang Anda tentukan untuk `SubnetId` parameter `Region` dan. Jika Anda menentukan nilai untuk `SubnetId` parameter tetapi bukan nilai untuk `Region` parameter, otomatisasi membuat Amazon Machine Image (AMI) dari instance target dan meluncurkan instance baru dari AMI di subnet yang Anda tentukan. Jika Anda menentukan nilai untuk `SubnetId` parameter dan `Region` parameter, otomatisasi membuat AMI dari contoh target, menyalin AMI ke yang Wilayah AWS Anda tentukan, dan meluncurkan instance baru dari AMI di subnet yang Anda tentukan. Jika Anda menentukan nilai untuk `Region` parameter tetapi bukan nilai untuk `SubnetId` parameter, otomatisasi membuat AMI dari contoh target, menyalin AMI ke Wilayah yang Anda tentukan, dan meluncurkan instance baru dari AMI di subnet default virtual private cloud (VPC) Anda di Wilayah tujuan. Jika tidak ada nilai yang ditentukan untuk `SubnetId` parameter `Region` atau, otomatisasi membuat AMI dari instance target, dan meluncurkan instance baru dari AMI di subnet default VPC Anda. Untuk menyalin AMI ke Wilayah yang berbeda, Anda harus memberikan nilai untuk `AutomationAssumeRole` parameter. Jika waktu otomatisasi habis selama `waitForAvailableDestinationAmi` langkah, AMI mungkin masih menyalin. Jika ini masalahnya, Anda dapat menunggu salinan selesai dan meluncurkan instance secara manual. Sebelum menjalankan otomatisasi ini, perhatikan hal berikut: + AMIs didasarkan pada snapshot Amazon Elastic Block Store (Amazon EBS) EBS). Untuk sistem file besar tanpa snapshot sebelumnya, AMI penciptaan bisa memakan waktu beberapa jam. Untuk mengurangi AMI waktu pembuatan, buat snapshot Amazon EBS sebelum Anda membuat AMI. + Membuat AMI tidak membuat snapshot misalnya menyimpan volume pada instance. Untuk informasi tentang mencadangkan volume penyimpanan instans ke Amazon EBS, lihat [Bagaimana cara mencadangkan volume penyimpanan instans di instans Amazon saya ke Amazon EC2 EBS?](https://aws.amazon.com/premiumsupport/knowledge-center/back-up-instance-store-ebs/) + EC2 Instans Amazon baru memiliki alamat IPv6 IP pribadi IPv4 atau publik yang berbeda. Anda harus memperbarui semua referensi ke alamat IP lama (misalnya, dalam entri DNS) dengan alamat IP baru yang ditetapkan ke instance baru. Jika Anda menggunakan alamat IP Elastis pada instance sumber Anda, pastikan untuk melampirkannya ke instance baru. + Masalah konflik pengenal keamanan domain (SID) dapat terjadi ketika salinan diluncurkan dan mencoba menghubungi domain. Sebelum Anda menangkap AMI, gunakan Sysprep atau hapus instance yang bergabung dengan domain dari domain untuk mencegah masalah konflik. Untuk informasi selengkapnya, [lihat Bagaimana cara menggunakan Sysprep untuk membuat dan menginstal Windows yang dapat digunakan kembali khusus? AMIs](https://aws.amazon.com/premiumsupport/knowledge-center/sysprep-create-install-ec2-windows-amis/) [Jalankan Otomasi ini (konsol)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-CopyEC2Instance) **penting** Kami tidak menyarankan menggunakan runbook ini untuk menyalin instance Microsoft Active Directory Domain Controller. **Jenis dokumen** Otomatisasi **Pemilik** Amazon **Platform** Linux, macOS, Windows **Parameter** + AutomationAssumeRole Tipe: String Deskripsi: (Opsional) Nama Sumber Daya Amazon (ARN) peran AWS Identity and Access Management (IAM) yang memungkinkan Otomasi Systems Manager untuk melakukan tindakan atas nama Anda. Jika tidak ada peran yang ditentukan, Systems Manager Automation menggunakan izin pengguna yang memulai runbook ini. + InstanceId Tipe: String Deskripsi: (Wajib) ID dari instance yang ingin Anda salin. + KeyPair Tipe: String Deskripsi: (Opsional) Key pair yang ingin Anda kaitkan dengan instance baru yang disalin. Jika Anda menyalin instance ke Region yang berbeda, pastikan key pair ada di Region yang ditentukan. + Wilayah Tipe: String Deskripsi: (Opsional) Wilayah yang ingin Anda salin instance. Jika Anda menentukan nilai untuk parameter ini, tetapi tidak menentukan nilai untuk `SecurityGroupIds` parameter `SubnetId` dan, otomatisasi mencoba meluncurkan instance di VPC default dengan grup keamanan default. Jika EC2 -Classic diaktifkan di Wilayah tujuan, peluncuran akan gagal. + SubnetId Tipe: String Deskripsi: (Opsional) ID subnet yang ingin Anda salin instance. Jika EC2 -Classic diaktifkan di Wilayah tujuan, Anda harus memberikan nilai untuk parameter ini. + InstanceType Tipe: String Deskripsi: (Opsional) Jenis instance instance yang disalin harus diluncurkan sebagai. Jika Anda tidak menentukan nilai untuk parameter ini, jenis contoh sumber digunakan. Jika jenis instance sumber tidak didukung di Wilayah tempat instance disalin, otomatisasi gagal. + SecurityGroupIds Tipe: String Deskripsi: (Opsional) Daftar grup keamanan yang dipisahkan koma yang ingin IDs Anda kaitkan dengan instance yang disalin. Jika Anda tidak menentukan nilai untuk parameter ini, dan instance tidak disalin ke Wilayah lain, grup keamanan yang terkait dengan instance sumber akan digunakan. Jika Anda menyalin instance ke Wilayah lain, grup keamanan default untuk VPC default di Wilayah tujuan akan digunakan. + KeepImageSourceRegion Jenis: Boolean Nilai yang valid: benar/salah Default: betul Deskripsi: (Opsional) Jika Anda menentukan `true` untuk parameter ini, otomatisasi tidak menghapus AMI dari contoh sumber. Jika Anda menentukan `false` parameter ini, otomatisasi membatalkan pendaftaran AMI dan menghapus snapshot terkait. + KeepImageDestinationRegion Jenis: Boolean Nilai yang valid: benar/salah Default: betul Deskripsi: (Opsional) Jika Anda menentukan `true` untuk parameter ini, otomatisasi tidak menghapus AMI yang disalin ke Wilayah yang Anda tentukan. Jika Anda menentukan `false` parameter ini, otomatisasi membatalkan pendaftaran AMI dan menghapus snapshot terkait. + NoRebootInstanceBeforeTakingImage Jenis: Boolean Nilai yang valid: benar/salah Bawaan: salah Deskripsi: (Opsional) Jika Anda menentukan `true` parameter ini, instance sumber tidak akan dimulai ulang sebelum membuat AMI. Ketika opsi ini digunakan, integritas sistem file pada gambar yang dibuat tidak dapat dijamin. **Izin IAM yang diperlukan** `AutomationAssumeRole`Parameter memerlukan tindakan berikut untuk menggunakan runbook dengan sukses. + `ec2:CreateImage` + `ec2:DeleteSnapshot` + `ec2:DeregisterImage` + `ec2:DescribeInstances` + `ec2:DescribeImages` + `ec2:RunInstances` Jika Anda menyalin instance ke Wilayah lain, Anda juga memerlukan izin berikut. + `ec2:CopyImage` **Langkah Dokumen** + describeOriginalInstanceDetail - Mengumpulkan detail dari instance yang akan disalin. + assertRootVolumeIsEbs - Memeriksa apakah jenis perangkat volume root`ebs`, dan jika tidak, mengakhiri otomatisasi. + evalInputParameters - Mengevaluasi nilai yang disediakan untuk parameter input. + createLocalAmi - Menciptakan AMI dari contoh sumber. + tagLocalAmi - Tag AMI dibuat pada langkah sebelumnya. + branchAssertRegionIsSame - Cabang berdasarkan apakah instance sedang disalin dalam Wilayah yang sama atau ke Wilayah yang berbeda. + branchAssertSameRegionWithKeyPair - Cabang berdasarkan apakah nilai disediakan untuk `KeyPair` parameter untuk instance yang sedang disalin dalam Wilayah yang sama. + sameRegionLaunchInstanceWithKeyPair - Meluncurkan EC2 instance Amazon dari AMI contoh sumber di subnet yang sama atau subnet yang Anda tentukan menggunakan key pair yang Anda tentukan. + sameRegionLaunchInstanceWithoutKeyPair - Meluncurkan EC2 instance Amazon dari AMI contoh sumber di subnet yang sama atau subnet yang Anda tentukan tanpa key pair. + copyAmiToWilayah - Menyalin AMI ke daerah tujuan. + waitForAvailableDestinationAmi - Menunggu untuk disalin AMI negara untuk menjadi`available`. + destinationRegionLaunchInstance - Meluncurkan EC2 Instans Amazon menggunakan yang disalin AMI. + branchAssertDestinationAmiToDelete - Cabang berdasarkan nilai yang Anda berikan untuk `KeepImageDestinationRegion` parameter. + deregisterDestinationAmiAndDeleteSnapshots - Deregister yang disalin AMI dan menghapus snapshot terkait. + branchAssertSourceAmiTodelete - Cabang berdasarkan nilai yang Anda berikan untuk `KeepImageSourceRegion` parameter. + deregisterSourceAmiAndDeleteSnapshots - Deregister AMI dibuat dari instance sumber dan menghapus snapshot terkait. + tidur - Tidur otomatisasi selama 2 detik. Ini adalah langkah terminal. **Keluaran** sameRegionLaunchInstanceWithKeyPair.InstanceIds sameRegionLaunchInstanceWithoutKeyPair.InstanceIds destinationRegionLaunchInstansDestinationInstanceId.