Lihat tag untuk instans EC2 Anda menggunakan metadata instans

Anda dapat mengakses tanda instans dari metadata instans. Dengan mengakses tanda dari metadata instans, Anda tidak perlu lagi menggunakan panggilan API DescribeInstances atau DescribeTags untuk mengambil informasi tanda, yang mengurangi transaksi API per detik, dan memungkinkan pengambilan tanda diskalakan dengan jumlah instans yang Anda kontrol. Selain itu, proses lokal yang berjalan pada sebuah instans dapat melihat informasi tanda instans secara langsung dari metadata instans.

Secara default, tanda tidak tersedia dari metadata instans; Anda harus secara eksplisit mengizinkan akses. Anda dapat mengizinkan akses saat peluncuran instans, atau setelah peluncuran pada instans yang sedang berjalan atau dihentikan. Anda juga dapat mengizinkan akses ke tanda dengan menentukannya dalam templat peluncuran. Instans yang diluncurkan menggunakan templat mengizinkan akses ke tanda dalam metadata instans.

Jika Anda menambahkan atau menghapus tanda instans, metadata instans diperbarui saat instans sedang berjalan, tanpa perlu berhenti dan kemudian memulai instans.

Aktifkan akses ke tag dalam metadata contoh

Secara default, tidak ada akses ke tanda instans dalam metadata instans. Untuk setiap contoh, Anda harus secara eksplisit mengaktifkan akses.

catatan

Jika Anda mengizinkan akses ke tag dalam metadata instance, kunci tag instance tunduk pada batasan tertentu. Non-compliance akan mengakibatkan peluncuran gagal untuk instance baru atau kesalahan untuk instance yang ada. Batasannya adalah:

• Hanya dapat menyertakan huruf (a-z,A-Z), angka (0-9), dan karakter berikut:+ - = . , _ : @.

• Tidak dapat berisi spasi atau/.

• Tidak dapat hanya terdiri dari . (satu periode), .. (dua periode), atau_index.

Untuk informasi selengkapnya, lihat Pembatasan tanda.

Console

Untuk mengaktifkan akses ke tag dalam metadata instance selama peluncuran instance

1. Ikuti prosedur untuk meluncurkan instans.

2. Perluas Detail lanjutan, dan untuk Izinkan tag dalam metadata, pilih Aktifkan.

3. Di panel Summary, tinjau konfigurasi instans Anda, lalu pilih Launch instans. Untuk informasi selengkapnya, lihat Luncurkan instans EC2 menggunakan wizard instans peluncuran di konsol.

Untuk mengaktifkan akses ke tag dalam metadata instance setelah peluncuran instance

1. Buka konsol Amazon EC2 di. https://console.aws.amazon.com/ec2/

2. Di panel navigasi, pilih Instans.

3. Pilih instans Anda, lalu pilih Tindakan, Pengaturan instans, Izinkan tag dalam metadata instance.

4. Untuk mengizinkan akses ke tag dalam metadata instance, pilih kotak centang Izinkan.

5. Pilih Simpan.

AWS CLI

Untuk mengaktifkan akses ke tag dalam metadata instance selama peluncuran instance

Gunakan perintah run-instance dan tambahkan opsi berikut. --metadata-options

--metadata-options "InstanceMetadataTags=enabled"

Untuk mengaktifkan akses ke tag dalam metadata instance setelah peluncuran instance

Gunakan perintah modify-instance-metadata-options berikut.

aws ec2 modify-instance-metadata-options \
    --instance-id i-1234567890abcdef0 \
    --instance-metadata-tags enabled

Untuk memverifikasi bahwa akses ke tag dalam metadata instance diaktifkan

Gunakan perintah describe-instance dan periksa nilai. InstanceMetadataTags

aws ec2 describe-instances \
    --instance-ids i-1234567890abcdef0 \
    --query "Reservations[*].Instances[].MetadataOptions[].InstanceMetadataTags"
    

Berikut ini adalah output contoh. Nilainya adalah enabled atau disabled.

[
    "enabled"
]

PowerShell

Untuk mengaktifkan akses ke tag dalam metadata instance selama peluncuran instance

Gunakan New-EC2Instancecmdlet dan tambahkan parameter berikut-MetadataOptions_InstanceMetadataTags.

-MetadataOptions_InstanceMetadataTags enabled

Untuk mengaktifkan akses ke tag dalam metadata instance setelah peluncuran instance

Gunakan Edit-EC2InstanceMetadataOptioncmdlet.

Edit-EC2InstanceMetadataOption `
    -InstanceId i-1234567890abcdef0 `
    -InstanceMetadataTags enabled

Untuk memverifikasi bahwa akses ke tag dalam metadata instance diaktifkan

Gunakan Get-EC2Instancecmdlet dan periksa nilai. InstanceMetadataTags

(Get-EC2Instance `
    -InstanceId i-1234567890abcdef0).Instances.MetadataOptions.InstanceMetadataTags.Value

Berikut ini adalah output contoh. Nilainya adalah enabled atau disabled.

enabled

Mengambil tanda dari metadata instans

Setelah mengizinkan akses ke tag instance dalam metadata instance, Anda dapat mengakses tags/instance kategori dari metadata instance. Untuk informasi selengkapnya, lihat Akses metadata instans untuk instans EC2.

IMDSv2

Linux

Jalankan perintah berikut dari instance Linux Anda untuk mencantumkan semua kunci tag untuk instance tersebut.

TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
    && curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/meta-data/tags/instance

Contoh ini mendapatkan nilai kunci yang diperoleh pada contoh sebelumnya. Permintaan IMDSv2 menggunakan token tersimpan yang dibuat menggunakan perintah pada contoh sebelumnya. Token tidak boleh kedaluwarsa.

curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/meta-data/tags/instance/tag-key

Windows

Jalankan cmdlet berikut dari instance Windows Anda untuk mencantumkan semua kunci tag untuk instance tersebut.

$token = Invoke-RestMethod `
    -Headers @{"X-aws-ec2-metadata-token-ttl-seconds" = "21600"} `
    -Method PUT -Uri http://169.254.169.254/latest/api/token

Invoke-RestMethod `
    -Headers @{"X-aws-ec2-metadata-token" = $token} `
    -Method GET -Uri http://169.254.169.254/latest/meta-data/tags/instance

Contoh ini mendapatkan nilai kunci yang diperoleh pada contoh sebelumnya. Permintaan IMDSv2 menggunakan token tersimpan yang dibuat menggunakan perintah pada contoh sebelumnya. Token tidak boleh kedaluwarsa.

Invoke-RestMethod `
    -Headers @{"X-aws-ec2-metadata-token" = $token} `
    -Method GET -Uri http://169.254.169.254/latest/meta-data/tags/instance/tag-key

IMDSv1

Linux

Jalankan perintah berikut dari instance Linux Anda untuk mencantumkan semua kunci tag untuk instance tersebut.

curl http://169.254.169.254/latest/meta-data/tags/instance

Contoh ini mendapatkan nilai kunci yang diperoleh pada contoh sebelumnya.

curl http://169.254.169.254/latest/meta-data/tags/instance/tag-key

Windows

Jalankan cmdlet berikut dari instance Windows Anda untuk mencantumkan semua kunci tag untuk instance tersebut.

Invoke-RestMethod -Uri http://169.254.169.254/latest/meta-data/tags/instance

Contoh ini mendapatkan nilai kunci yang diperoleh pada contoh sebelumnya.

Invoke-RestMethod -Uri http://169.254.169.254/latest/meta-data/tags/instance/tag-key

Nonaktifkan akses ke tag dalam metadata contoh

Anda dapat menonaktifkan akses ke tag instance dalam metadata instance. Anda tidak perlu menonaktifkan akses ke tag instance pada metadata instance saat peluncuran karena dimatikan secara default.

Console

Untuk menonaktifkan akses ke tag dalam metadata contoh

1. Buka konsol Amazon EC2 di. https://console.aws.amazon.com/ec2/

2. Di panel navigasi, pilih Instans.

3. Pilih sebuah instans, lalu pilih Tindakan, Pengaturan instans, Izinkan tanda dalam metadata instans.

4. Untuk menonaktifkan akses ke tag dalam metadata instance, kosongkan kotak centang Izinkan.

5. Pilih Simpan.

AWS CLI

Untuk menonaktifkan akses ke tag dalam metadata contoh

Gunakan perintah modify-instance-metadata-options berikut.

aws ec2 modify-instance-metadata-options \
    --instance-id i-1234567890abcdef0 \
    --instance-metadata-tags disabled

PowerShell

Untuk menonaktifkan akses ke tag dalam metadata contoh

Gunakan Edit-EC2InstanceMetadataOptioncmdlet.

Edit-EC2InstanceMetadataOption `
    -InstanceId i-1234567890abcdef0 `
    -InstanceMetadataTag disabled