

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# `AWSPremiumSupport-ResizeNitroInstance`
<a name="automation-aws-resizenitroinstance"></a>

 **Deskripsi** 

`AWSPremiumSupport-ResizeNitroInstance`Runbook ini menyediakan solusi otomatis untuk mengubah ukuran instans Amazon Elastic Compute Cloud (Amazon EC2) yang dibangun di atas Sistem Nitro.

Untuk mengurangi potensi risiko kehilangan data dan downtime, runbook memverifikasi hal-hal berikut:
+ Perilaku berhenti contoh.
+ Jika instans merupakan bagian dari grup Amazon EC2 Auto Scaling, `standby` dan dalam mode.
+ Status instans dan sewa.
+ Jenis instans yang ingin Anda ubah untuk mendukung jumlah antarmuka jaringan yang saat ini dilampirkan ke instance Anda.
+ Arsitektur prosesor dan jenis virtualisasi untuk tipe instans saat ini dan target adalah sama.
+ Jika instance sedang berjalan, itu melewati semua pemeriksaan status.
+ Jenis instans yang ingin Anda ubah tersedia di Availability Zone yang sama.

Jika Amazon EC2 tidak lulus pemeriksaan status setelah mengubah jenis instans, runbook secara otomatis memutar kembali ke jenis instance sebelumnya.

Secara default, runbook ini tidak akan mengubah jenis instance jika sedang berjalan dan volume penyimpanan instance dilampirkan. Runbook juga tidak akan mengubah jenis instance jika instance adalah bagian dari AWS CloudFormation tumpukan. Jika Anda ingin mengubah salah satu perilaku ini, `yes` tentukan `AllowCloudFormationInstances` parameter `AllowInstanceStoreInstances` dan.

Runbook menyediakan dua cara berbeda untuk menentukan jenis instance yang ingin Anda ubah:
+ Untuk otomatisasi sederhana yang menargetkan satu instance, tentukan jenis instance yang ingin Anda ubah menggunakan parameter. `TargetInstanceTypeFromParameter`
+ Untuk menjalankan otomatisasi pada skala untuk mengubah jenis instance dari beberapa instance, tentukan jenis instance menggunakan parameter. `TargetInstanceTypeFromTagValue` Untuk informasi tentang menjalankan otomatisasi dalam skala besar, lihat [Menjalankan otomatisasi dalam](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-working-targets-and-rate-controls.html) skala besar.

Jika Anda tidak menentukan nilai untuk salah satu parameter, otomatisasi gagal.

**penting**  
Akses ke `AWSPremiumSupport-*` runbook memerlukan Business \$1 Support, Enterprise Support, atau Unified Operations Subscription. Untuk informasi selengkapnya, lihat [Bandingkan AWS Dukungan Paket](https://aws.amazon.com/premiumsupport/plans/).

 **Pertimbangan-pertimbangan** 
+ Kami merekomendasikan untuk membuat cadangan instance Anda sebelum menggunakan runbook ini.
+ Untuk informasi tentang kompatibilitas untuk mengubah jenis instance, lihat [Kompatibilitas untuk mengubah jenis instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/resize-limitations.html).
+ Jika otomatisasi gagal dan kembali ke jenis instans asli, lihat [Memecahkan masalah mengubah jenis instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/troubleshoot-change-instance-type.html).
+ Mengubah jenis instance membutuhkan runbook untuk menghentikan instance Anda. Ketika sebuah instance dihentikan, data apa pun yang disimpan dalam memori atau pada volume penyimpanan instance hilang. Juga, setiap IPv4 alamat publik yang ditetapkan secara otomatis akan dirilis. Untuk informasi selengkapnya tentang apa yang terjadi ketika Anda menghentikan sebuah instans, lihat [Berhenti dan mulai instance Anda](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Stop_Start.html).
+ Dengan menggunakan `SkipInstancesWithTagKey` parameter, Anda dapat melewati instance yang memiliki kunci tag Amazon EC2 tertentu yang diterapkan.

 [Jalankan Otomasi ini (konsol)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSPremiumSupport-ResizeNitroInstance) 

**Jenis dokumen**

Otomatisasi

**Pemilik**

Amazon

**Platform**

Linux, 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.
+ Akui

  Tipe: String

  Deskripsi: (Wajib) Enter **yes** untuk mengetahui bahwa instans Anda akan dihentikan jika sedang berjalan.
+ AllowInstanceStoreInstances

  Tipe: String

  Nilai yang valid: tidak \$1 ya

  Default: no

  Deskripsi: (Opsional) Jika Anda menentukan`yes`, Anda mengizinkan runbook berjalan pada instance yang memiliki volume penyimpanan instans yang dilampirkan.
+ AllowCloudFormationInstances

  Tipe: String

  Nilai yang valid: tidak \$1 ya

  Default: no

  Deskripsi: (Opsional) Jika Anda menentukan`yes`, runbook berjalan pada instance yang merupakan bagian dari tumpukan. CloudFormation 
+ DryRun

  Tipe: String

  Nilai yang valid: tidak \$1 ya

  Default: no

  Deskripsi: (Opsional) Jika Anda menentukan`yes`, buku runbook memvalidasi persyaratan pengubahan ukuran tanpa membuat perubahan pada jenis instance.
+ InstanceId

  Tipe: String

  Deskripsi: (Wajib) ID instans Amazon EC2 yang jenisnya ingin Anda ubah.
+ SkipInstancesWithTagKey

  Tipe: String

  Deskripsi: (Opsional) Otomatisasi melewatkan instance target jika kunci tag yang Anda tentukan diterapkan ke instance.
+ SleepTime

  Tipe: String

  Default: 3

  Deskripsi: (Opsional) Jumlah detik runbook ini harus tidur setelah selesai.
+ TagInstance

  Tipe: String

  Deskripsi: (Opsional) Tandai instance dengan kunci dan nilai pilihan Anda menggunakan format berikut:*Key=ChangingType,Value=True*. Opsi ini memungkinkan Anda untuk melacak instance yang telah ditargetkan oleh runbook ini. Kunci dan nilai tag sensitif huruf besar dan kecil.
+ TargetInstanceTypeFromParameter

  Tipe: String

  Deskripsi: (Opsional) Jenis instans yang ingin Anda ubah instans Anda. Biarkan parameter ini kosong jika Anda ingin menggunakan nilai kunci tag yang disediakan dalam `TargetInstanceTypeFromTagValue` parameter.
+ TargetInstanceTypeFromTagValue

  Tipe: String

  Deskripsi: (Opsional) Kunci tag diterapkan ke instance target Anda yang nilainya berisi jenis instance yang ingin Anda ubah. Jika Anda menentukan nilai untuk `TargetInstanceTypeFromParameter` parameter, itu akan mengganti nilai apa pun yang Anda tentukan untuk parameter ini.

**Izin IAM yang diperlukan**

`AutomationAssumeRole`Parameter memerlukan tindakan berikut untuk menggunakan runbook dengan sukses.
+  `autoscaling:DescribeAutoScalingInstances` 
+  `cloudformation:DescribeStackResources` 
+  `ssm:GetAutomationExecution` 
+  `ssm:DescribeAutomationExecutions` 
+  `ec2:DescribeInstanceAttribute` 
+  `ec2:DescribeInstances` 
+  `ec2:DescribeInstanceStatus` 
+  `ec2:DescribeInstanceTypeOfferings` 
+  `ec2:DescribeInstanceTypes` 
+  `ec2:DescribeTags` 
+  `ec2:ModifyInstanceAttribute` 
+  `ec2:StartInstances` 
+  `ec2:StopInstances` 

 **Langkah Dokumen** 

1. `aws:assertAwsResourceProperty`: Memastikan instans Amazon EC2 tidak ditandai dengan kunci tag sumber daya yang ditentukan dalam parameter. `SkipInstancesWithTagKey` Jika kunci tag ditemukan diterapkan ke instance, langkah gagal dan otomatisasi berakhir.

1. `aws:assertAwsResourceProperty`: Mengonfirmasi status instans Amazon EC2 target adalah`running`,, `pending``stopped`, atau. `stopping` Jika tidak, otomatisasi berakhir.

1. `aws:executeAwsApi`: Mengumpulkan properti dari instans Amazon EC2.

1. `aws:executeAwsApi`: Mengumpulkan detail tentang jenis instans Amazon EC2 saat ini.

1. `aws:branch`: Memeriksa apakah jenis instance saat ini dan jenis instance yang ditentukan dalam `TargetInstanceTypeFromParameter` parameter adalah sama. Jika ya, otomatisasi berakhir.

1. `aws:assertAwsResourceProperty`: Memastikan instance berjalan pada Sistem Nitro.

1. `aws:branch`: Memastikan jenis volume root instans Amazon EC2 adalah volume Amazon Elastic Block Store (Amazon EBS).

1. `aws:assertAwsResourceProperty`: Mengonfirmasi perilaku shutdown instance `stop` dan tidak`terminate`.

1. `aws:branch`: Memastikan instans Amazon EC2 bukan instance Spot.

1. `aws:branch`: Memastikan penyewaan instans Amazon EC2 adalah default dan bukan host khusus, atau instans khusus.

1. `aws:executeScript`: Mengonfirmasi hanya ada satu otomatisasi runbook ini yang menargetkan ID instance saat ini. Jika otomatisasi lain sedang berlangsung dengan menargetkan instance yang sama, otomatisasi mengembalikan kesalahan dan berakhir.

1. `aws:branch`: Memcabangkan otomatisasi berdasarkan status instans Amazon EC2.

   1. Jika `stopped` atau`stopping`, otomatisasi berjalan `aws:waitForAwsResourceProperty` hingga instans Amazon EC2 dihentikan sepenuhnya.

   1. Jika `running` atau`pending`, otomatisasi berjalan `aws:waitForAwsResourceProperty` hingga instans Amazon EC2 melewati pemeriksaan status.

1. `aws:assertAwsResourceProperty`: Mengonfirmasi bahwa instans Amazon EC2 bukan bagian dari grup Auto Scaling dengan memanggil `DescribeAutoScalingInstances` operasi API. Jika instans merupakan bagian dari grup Auto Scaling, pastikan instans Amazon EC2 dalam mode. `standby`

1. `aws:branch`: Memcabangkan otomatisasi tergantung pada apakah Anda ingin otomatisasi memeriksa apakah instans Amazon EC2 adalah bagian dari tumpukan: CloudFormation 

   1. `aws:executeScript`Memastikan instans Amazon EC2 bukan bagian dari CloudFormation tumpukan dengan memanggil operasi `DescribeStackResources` API.

1. `aws:executeAwsApi`: Mengembalikan daftar jenis instance dengan tipe arsitektur prosesor yang sama, tipe virtulization, dan yang mendukung jumlah antarmuka jaringan yang saat ini dilampirkan ke instance target.

1. `aws:executeAwsApi`: Mendapat nilai tipe instance target dari kunci tag yang ditentukan dalam `TargetInstanceTypeFromTagValue` parameter.

1. `aws:executeScript`: Mengonfirmasi bahwa jenis instance saat ini dan target kompatibel. Memastikan bahwa jenis instance target tersedia di subnet yang sama. Memverifikasi kepala sekolah yang memulai runbook memiliki izin untuk mengubah jenis instance, dan menghentikan dan memulai instance jika sedang berjalan.

1. `aws:branch`: Memcabangkan otomatisasi berdasarkan apakah nilai `DryRun` parameter disetel ke`yes`. Jika`yes`, otomatisasi berakhir.

1. `aws:branch`: Memeriksa apakah jenis instans asli dan target sama. Jika mereka sama, otomatisasi berakhir.

1. `aws:executeAwsApi`: Mendapat status instance saat ini.

1. `aws:changeInstanceState`: Menghentikan instans Amazon EC2.

1. `aws:changeInstanceState`: Memaksa instance untuk berhenti jika macet di `stopping` negara bagian.

1. `aws:executeAwsApi`: Mengubah jenis instance ke tipe instance target.

1. `aws:sleep`: Menunggu 3 detik setelah mengubah jenis instance untuk konsistensi akhirnya.

1. `aws:branch`: Memcabangkan otomatisasi berdasarkan status instance sebelumnya. Jika ya`running`, instance dimulai.

   1. `aws:changeInstanceState`: Memulai instans Amazon EC2 jika dijalankan sebelum mengubah jenis instans.

   1. `aws:waitForAwsResourceProperty`: Menunggu instans Amazon EC2 untuk lulus pemeriksaan status. Jika instance tidak lulus pemeriksaan status, instance diubah kembali ke tipe instans aslinya.

      1. `aws:changeInstanceState`: Menghentikan instans Amazon EC2 sebelum mengubahnya ke jenis instans aslinya.

      1. `aws:changeInstanceState`: Memaksa instans Amazon EC2 untuk berhenti sebelum mengubahnya ke jenis instans aslinya jika macet dalam status berhenti.

      1. `aws:executeAwsApi`: Mengubah instans Amazon EC2 ke tipe aslinya.

      1. `aws:sleep`: Menunggu 3 detik setelah mengubah jenis instance untuk konsistensi akhirnya.

      1. `aws:changeInstanceState`: Memulai instans Amazon EC2 jika dijalankan sebelum mengubah jenis instans.

      1. `aws:waitForAwsResourceProperty`: Menunggu instans Amazon EC2 untuk lulus pemeriksaan status.

1. `aws:sleep`: Menunggu sebelum mengakhiri runbook.