AWSSupport-ConfigureEC2Metadata - AWS Systems Manager Referensi buku runbook otomatisasi

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

AWSSupport-ConfigureEC2Metadata

Deskripsi

Runbook ini membantu Anda mengonfigurasi opsi layanan metadata instans (IMDS) untuk instans Amazon Elastic Compute Cloud (Amazon). EC2 Dengan menggunakan runbook ini, Anda dapat mengonfigurasi yang berikut:

  • Menegakkan penggunaan IMDSv2 metadata misalnya.

  • Konfigurasikan HttpPutResponseHopLimit nilainya.

  • Izinkan atau tolak akses metadata instance.

Untuk informasi selengkapnya tentang metadata instance, lihat Mengonfigurasi Layanan Metadata Instans di Panduan Pengguna Amazon. EC2

Jalankan Otomasi ini (konsol)

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.

  • Menegakkan IMDSv2

    Tipe: String

    Nilai yang valid: wajib | opsional

    Default: opsional

    Deskripsi: (Opsional) Menegakkan IMDSv2. Jika Anda memilihrequired, EC2 instans Amazon hanya akan digunakan IMDSv2. Jika Anda memilihoptional, Anda dapat memilih antara IMDSv1 dan IMDSv2 untuk akses metadata.

    penting

    Jika Anda menerapkan IMDSv2, aplikasi yang menggunakan IMDSv1 mungkin tidak berfungsi dengan benar. Sebelum menerapkan IMDSv2, pastikan aplikasi Anda yang menggunakan IMDS ditingkatkan ke versi yang mendukung. IMDSv2 Untuk informasi tentang Layanan Metadata Instans Versi 2 (IMDSv2), lihat Mengonfigurasi Layanan Metadata Instans di Panduan Pengguna Amazon. EC2

  • HttpPutResponseHopLimit

    Jenis: Integer

    Nilai yang valid: 0-64

    Default: 0

    Deskripsi: (Opsional) Nilai batas hop respons HTTP PUT yang diinginkan (1-64) misalnya permintaan metadata. Nilai ini mengontrol jumlah hop yang dapat dilalui oleh respons PUT. Untuk mencegah respons berjalan di luar instance, 1 tentukan nilai parameter.

  • InstanceId

    Tipe: String

    Deskripsi: (Wajib) ID EC2 instans Amazon yang setelan metadatanya ingin Anda konfigurasikan.

  • MetadataAccess

    Tipe: String

    Nilai yang valid: diaktifkan | dinonaktifkan

    Default: diaktifkan

    Deskripsi: (Opsional) Izinkan atau tolak akses metadata instans di instans Amazon EC2 . Jika Anda menentukandisabled, semua parameter lain akan diabaikan dan akses metadata akan ditolak untuk contoh tersebut.

Izin IAM yang diperlukan

AutomationAssumeRoleParameter memerlukan tindakan berikut untuk menggunakan runbook dengan sukses.

  • ec2:DescribeInstances

  • ec2:ModifyInstanceMetadataOptions

  • ssm:GetAutomationExecution

  • ssm:StartAutomationExecution

Langkah Dokumen

  1. branchOnMetadataAkses - Otomatisasi cabang berdasarkan nilai MetadataAccess parameter.

  2. disableMetadataAccess - Memanggil tindakan ModifyInstanceMetadataOptions API untuk menonaktifkan akses titik akhir metadata.

  3. branchOnHttpPutResponseHopLimit - Otomatisasi cabang berdasarkan nilai HttpPutResponseHopLimit parameter.

  4. maintainHopLimitAndConfigureImdsVersion - Jika HttpPutResponseHopLimit 0, mempertahankan batas hop saat ini dan mengubah opsi metadata lainnya.

  5. waitBeforeAssertingIMDSv2Negara - Menunggu 30 detik sebelum menegaskan IMDSv2 status.

  6. setHopLimitAndConfigureImdsVersion - Jika HttpPutResponseHopLimit lebih besar dari 0, mengkonfigurasi opsi metadata menggunakan parameter input yang diberikan.

  7. waitBeforeAssertingHopLimit - Menunggu 30 detik sebelum menegaskan opsi metadata.

  8. assertHopLimit - Menegaskan HttpPutResponseHopLimit properti diatur ke nilai yang Anda tentukan.

  9. branchVerificationOnIMDSv2Opsi - Verifikasi cabang berdasarkan nilai EnforceIMDSv2 parameter.

  10. assert IMDSv2 IsOptional - Menegaskan HttpTokens nilai yang disetel ke. optional

  11. assert IMDSv2 IsEnforced - Menegaskan HttpTokens nilai yang disetel ke. required

  12. waitBeforeAssertingMetadataState - Menunggu 30 detik sebelum menyatakan status metadata dinonaktifkan.

  13. assertMetadataIsDinonaktifkan - Menegaskan metadata adalah. disabled

  14. describeMetadataOptions - Mendapat opsi metadata setelah perubahan yang Anda tentukan telah diterapkan.

Keluaran

describeMetadataOptions.Negara

describeMetadataOptions.MetadataAccess

describeMetadataOptions.IMDSv2

describeMetadataOptions.HttpPutResponseHopLimit