View a markdown version of this page

Menggunakan metadata instans untuk mengelola instans EC2 - Amazon Elastic Compute Cloud
Kategori metadata instansKategori data dinamis

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

Menggunakan metadata instans untuk mengelola instans EC2

Metadata instans adalah data tentang instans Anda yang dapat Anda gunakan untuk mengonfigurasi atau mengelola instans berjalan. Metadata instans mencakup yang berikut:

Properti metadata instans

Properti metadata instans dibagi menjadi beberapa kategori, misalnya nama host, acara, dan grup keamanan.

Data dinamis

Data dinamis adalah metadata yang dihasilkan saat instance diluncurkan, seperti dokumen identitas instance. Untuk informasi selengkapnya, lihat Kategori data dinamis.

Data pengguna

Anda juga dapat menggunakan metadata instans untuk mengakses data pengguna yang Anda tentukan saat meluncurkan instans. Misalnya, Anda dapat menentukan parameter untuk mengonfigurasi instans Anda, atau menyertakan skrip sederhana. Anda juga dapat membuat AMI generik dan menggunakan data pengguna untuk memodifikasi file konfigurasi yang disediakan pada waktu peluncuran. Misalnya, jika Anda menjalankan server web untuk berbagai bisnis kecil, mereka semua dapat menggunakan AMI generik yang sama dan mengambil kontennya dari bucket Amazon S3 yang Anda tentukan dalam data pengguna saat peluncuran. Untuk menambahkan pelanggan baru kapan saja, buat bucket untuk pelanggan, tambahkan konten mereka, dan luncurkan AMI Anda dengan nama keranjang bucket unik yang diberikan untuk kode Anda di data pengguna. Jika Anda meluncurkan beberapa instans menggunakan RunInstances panggilan yang sama, data pengguna tersedia untuk semua instans dalam reservasi tersebut. Setiap instance yang merupakan bagian dari reservasi yang sama memiliki ami-launch-index nomor unik, sehingga Anda dapat menulis kode yang mengontrol apa yang dilakukan instance. Misalnya, host pertama mungkin memilih dirinya sendiri sebagai simpul asli dalam sebuah klaster. Untuk contoh peluncuran AMI mendetail, lihat .Identifikasi setiap instance yang diluncurkan dalam satu permintaan

penting

Meskipun Anda hanya dapat mengakses metadata instans dan data pengguna dari dalam instans itu sendiri, data tersebut tidak dilindungi oleh metode autentikasi atau kriptografi. Siapa pun yang memiliki akses langsung ke instans, dan perangkat lunak apa pun yang kemungkinan berjalan di instans, akan dapat melihat metadatanya. Oleh karena itu, Anda tidak boleh menyimpan data sensitif, seperti sandi atau kunci enkripsi yang tahan lama, sebagai data pengguna.

Daftar Isi

Kategori metadata instans

Properti metadata instance dibagi menjadi beberapa kategori. Untuk mengambil properti metadata instance, Anda menentukan kategori dalam permintaan, dan metadata dikembalikan dalam respons.

Saat kategori baru dirilis, build metadata instans baru dibuat dengan nomor versi baru. Dalam tabel berikut, kolom Versi saat kategori dirilis menentukan versi build saat kategori metadata instans dirilis. Untuk menghindari keharusan memperbarui kode Anda setiap kali Amazon EC2 merilis build metadata instans baru, gunakan latest, bukan nomor versi, di permintaan metadata Anda. Untuk informasi selengkapnya, lihat Dapatkan versi metadata instans yang tersedia.

Saat Amazon EC2 merilis kategori metadata instans baru, metadata instans untuk kategori baru mungkin tidak tersedia untuk instans yang sudah ada. Dengan Nitro-based instance, Anda dapat mengambil metadata instance hanya untuk kategori yang tersedia saat peluncuran. Untuk instans dengan hypervisor Xen, Anda dapat menghentikan dan kemudian memulai instans untuk memperbarui kategori yang tersedia untuk instans tersebut.

Tabel berikut mencantumkan kategori metadata instans. Beberapa nama kategori menyertakan placeholder untuk data yang unik untuk instans Anda. Misalnya, mac mewakili alamat MAC untuk antarmuka jaringan. Anda harus mengganti placeholder dengan nilai sebenarnya saat Anda mengambil metadata instans.

Kategori Deskripsi Versi ketika kategori dirilis
ami-id ID AMI yang digunakan untuk meluncurkan instans. 1.0
ami-launch-index Jika Anda meluncurkan beberapa instans menggunakan RunInstances panggilan yang sama, nilai ini menunjukkan urutan peluncuran untuk setiap instans. Nilai instans pertama yang diluncurkan adalah 0. Jika Anda meluncurkan instans menggunakan Auto Scaling atau armada EC2, nilai ini selalu 0. 1.0
ami-manifest-path Jalur ke file manifes AMI di Amazon S3. Jika Anda menggunakan Amazon EBS-backed AMI untuk meluncurkan instance, hasil yang dikembalikan adalahunknown. 1.0
ancestor-ami-ids ID AMI dari setiap instans yang dibundel ulang untuk membuat AMI ini. Nilai ini hanya akan ada jika file manifes AMI berisi kunci ancestor-amis. 10/10/2007
autoscaling/target-lifecycle-state

Nilai yang menunjukkan status siklus hidup Auto Scaling target yang dialihkan oleh instans Auto Scaling. Anda pada saat instans bertransisi ke salah satu status siklus hidup target setelah 10 Maret 2022. Nilai yang mungkin: Detached InService | Standby | Terminated | Warmed:Hibernated | Warmed:Running | Warmed:Stopped |Warmed:Terminated. Lihat Mengambil status siklus hidup target melalui metadata instans di Panduan Pengguna Amazon EC2 Auto Scaling.

2021-07-15
block-device-mapping/ami Perangkat virtual yang berisi sistem root/boot file. 15/12/2007
block-device-mapping/ebsN Perangkat virtual yang terkait dengan volume Amazon EBS apa pun. Volume Amazon EBS hanya tersedia dalam metadata jika volume itu ada pada waktu peluncuran atau saat instans terakhir kali dimulai. N menunjukkan indeks volume Amazon EBS (seperti ebs1 atau ebs2). 15/12/2007
block-device-mapping/ephemeralN Perangkat virtual untuk setiap volume penyimpanan instans non-NVMe. N menunjukkan indeks setiap volume. Jumlah volume penyimpanan instans dalam pemetaan perangkat blok mungkin tidak cocok dengan jumlah volume penyimpanan instans yang sebenarnya untuk instans tersebut. Tipe instans menentukan jumlah volume penyimpanan instans yang tersedia untuk sebuah instans. Jika jumlah volume penyimpanan instans dalam pemetaan perangkat blok melebihi jumlah yang tersedia untuk sebuah instans, volume penyimpanan instans tambahan akan diabaikan. 15/12/2007
block-device-mapping/root Perangkat virtual atau partisi yang terkait dengan perangkat atau partisi root pada perangkat virtual, di mana sistem file root (/ atau C:) dikaitkan dengan instans tertentu. 15/12/2007
block-device-mapping/swap Perangkat virtual yang terkait dengan swap. Tidak selalu ada. 15/12/2007
events/maintenance/history Jika ada peristiwa pemeliharaan yang diselesaikan atau dibatalkan untuk instans tersebut, berisi string JSON dengan informasi tentang peristiwa tersebut. 17/08/2018
events/maintenance/scheduled Jika ada peristiwa pemeliharaan aktif untuk instans tersebut, berisi string JSON dengan informasi tentang peristiwa tersebut. Untuk informasi selengkapnya, lihat Melihat acara terjadwal yang memengaruhi instans Amazon EC2 Anda. 17/08/2018
events/recommendations/rebalance Perkiraan waktu, dalam UTC, ketika notifikasi rekomendasi penyeimbangan ulang instans EC2 dikeluarkan untuk instans tersebut. Berikut adalah contoh metadata untuk kategori ini: {"noticeTime": "2020-11-05T08:22:00Z"}. Kategori ini hanya tersedia setelah notifikasi dikeluarkan. Untuk informasi selengkapnya, lihat Rekomendasi penyeimbangan ulang instans EC2. 2020-10-27
hostname Jika instance EC2 menggunakan IP-based penamaan (IPBN), ini adalah nama host DNS IPv4 pribadi dari instance tersebut. Jika instance EC2 menggunakan Resource-based penamaan (RBN), ini adalah RBN. Jika ada banyak antarmuka jaringan, ini mengacu pada perangkat eth0 (perangkat yang nomor perangkatnya adalah 0). Untuk informasi selengkapnya tentang IPBN dan RBN, lihat Nama host dan domain instans EC2. 1.0
iam/info Jika ada peran IAM yang terkait dengan instance, berisi informasi tentang terakhir kali profil instans diperbarui, termasuk LastUpdated tanggal instans, InstanceProfileArn, danInstanceProfileId. Jika tidak, tidak ada. 12/01/2012
iam/security-credentials/role-name Jika ada peran IAM yang terkait dengan instance, role-name adalah nama peran, dan role-name berisi kredenSIAL keamanan sementara yang terkait dengan peran tersebut (untuk informasi selengkapnya, lihatMengambil kredensial keamanan dari metadata instans). Jika tidak, tidak ada. 12/01/2012
identity-credentials/ec2/info Informasi tentang kredensial di identity-credentials/ec2/security-credentials/ec2-instance. 23/05/2018
identity-credentials/ec2/security-credentials/ec2-instance KredenSIAL untuk peran identitas instans yang memungkinkan perangkat lunak instans mengidentifikasi dirinya sendiri AWS untuk mendukung fitur seperti EC2 Instance Connect dan Def AWS Systems Manager ault Host Management Configuration. KredenSIAL ini tidak memiliki kebijakan yang dilampirkan, sehingga mereka tidak memiliki izin AWS API tambahan selain mengidentifikasi instance ke AWS fitur. Untuk informasi selengkapnya, lihat Peran identitas instans untuk instans Amazon EC2. 23/05/2018
instance-action Memberi tahu instans bahwa instans harus di-boot ulang sebagai persiapan untuk pemaketan. Nilai yang valid: none | shutdown | bundle-pending. 01/09/2008
instance-id ID instans ini. 1.0
instance-life-cycle Opsi pembelian instans ini. Untuk informasi selengkapnya, lihat Opsi penagihan dan pembelian Amazon EC2. 01/10/2019
instance-type Tipe instans. Untuk informasi selengkapnya, lihat Tipe instans Amazon EC2. 29/08/2007
ipv6 Alamat IPv6 instans. Jika ada banyak antarmuka jaringan, alamat ini mengacu pada antarmuka jaringan perangkat eth0 (perangkat dengan nomor perangkat 0) dan alamat IPv6 yang pertama ditetapkan. Jika tidak ada alamat IPv6 di antarmuka jaringan [0], item ini tidak disetel dan menghasilkan respons HTTP 404. 2021-01-03
kernel-id ID kernel yang diluncurkan dengan instans ini, jika ada. 01/02/2008
local-hostname Jika ada banyak antarmuka jaringan, ini mengacu pada perangkat eth0 (perangkat yang nomor perangkatnya adalah 0). Jika instance EC2 menggunakan IP-based penamaan (IPBN), ini adalah nama host DNS IPv4 pribadi dari instance tersebut. Jika instance EC2 menggunakan Resource-based penamaan (RBN), ini adalah RBN. Untuk informasi selengkapnya tentang penamaan IPBN, RBN, dan EC2, lihat Nama host dan domain instans EC2. 19/01/2007
local-ipv4 Alamat IPv4 privat dari instans. Jika ada banyak antarmuka jaringan, ini mengacu pada perangkat eth0 (perangkat yang nomor perangkatnya adalah 0). Jika ini adalah IPv6-only contoh, item ini tidak disetel dan menghasilkan respons HTTP 404. 1.0
mac Alamat kontrol akses media (MAC) instans. Jika ada banyak antarmuka jaringan, ini mengacu pada perangkat eth0 (perangkat yang nomor perangkatnya adalah 0). 01/01/2011
metrics/vhostmd Tidak lagi tersedia. 01/05/2011
network/interfaces/macs/mac/device-number Nomor perangkat unik yang terkait dengan antarmuka itu. Nomor perangkat sesuai dengan nama perangkat; misalnya, device-number pada 2 adalah untuk perangkat eth2. Kategori ini sesuai dengan bidang DeviceIndex dan device-index yang digunakan oleh API Amazon EC2 dan perintah EC2 untuk AWS CLI. 01-01-2011
network/interfaces/macs/mac/interface-id ID antarmuka jaringan. 01-01-2011
network/interfaces/macs/mac/ipv4-associations/public-ip Alamat IPv4 yang terkait dengan setiap alamat IP publik dan ditetapkan ke antarmuka itu. 01-01-2011
network/interfaces/macs/mac/ipv6s Alamat IPv6 yang ditetapkan ke antarmuka. 30/06/2016
network/interfaces/macs/mac/ipv6-prefix Awalan IPv6 ditetapkan ke antarmuka jaringan.
network/interfaces/macs/mac/local-hostname

Nama host DNS IPv4 pribadi dari antarmuka jaringan. Nilai ini tidak diatur untuk antarmuka tanpa alamat IP sama sekali, seperti EFA-only antarmuka. Jika ini adalah IPv6-only antarmuka, ini adalah nama berbasis sumber daya. Untuk informasi selengkapnya tentang IPBN dan RBN, lihat Nama host dan domain instans EC2.

 19/01/2007
network/interfaces/macs/mac/local-ipv4s Alamat IPv4 privat yang terkait dengan antarmuka. Jika ini adalah antarmuka IPv6-only jaringan, item ini tidak disetel dan menghasilkan respons HTTP 404. 01-01-2011
network/interfaces/macs/mac/mac Alamat MAC instans. 01/01/2011
network/interfaces/macs/mac/network-card Indeks kartu jaringan. Beberapa tipe instans mendukung banyak kartu jaringan. 01/11/2020
network/interfaces/macs/mac/owner-id ID pemilik antarmuka jaringan. Di lingkungan multi-antarmuka, antarmuka dapat dipasang oleh pihak ketiga, seperti Elastic Load Balancing. Lalu lintas pada antarmuka selalu ditagihkan ke pemilik antarmuka. 01/01/2011
network/interfaces/macs/mac/public-hostname DNS publik antarmuka (IPv4). Kategori ini hanya ditampilkan jika atribut enableDnsHostnames diatur ke true. Untuk informasi selengkapnya, lihat Atribut DNS untuk VPC Anda dalam Panduan Pengguna Amazon VPC. Jika instans hanya memiliki alamat IPv6 publik dan tidak ada alamat IPv4 publik, item ini tidak diatur dan akan menghasilkan respons HTTP 404. 01-01-2011
network/interfaces/macs/mac/public-ipv4s Alamat IP publik atau alamat IP Elastis yang terkait dengan antarmuka. Mungkin ada beberapa alamat IPv4 pada sebuah instans. 01-01-2011
network/interfaces/macs/mac/security-groups Grup keamanan yang memiliki antarmuka jaringan. 01-01-2011
network/interfaces/macs/mac/security-group-ids ID grup keamanan yang memiliki antarmuka jaringan. 01-01-2011
network/interfaces/macs/mac/subnet-id ID subnet tempat antarmuka berada. 01-01-2011
network/interfaces/macs/mac/subnet-ipv4-cidr-block Blok CIDR IPv4 dari subnet tempat antarmuka berada. 01-01-2011
network/interfaces/macs/mac/subnet-ipv6-cidr-blocks Blok CIDR IPv6 dari subnet tempat antarmuka berada. 30/06/2016
network/interfaces/macs/mac/vpc-id ID VPC tempat antarmuka berada. 01-01-2011
network/interfaces/macs/mac/vpc-ipv4-cidr-block Blok CIDR IPv4 primer dari VPC. 01-01-2011
network/interfaces/macs/mac/vpc-ipv4-cidr-blocks Blok CIDR IPv4 untuk VPC. 30/06/2016
network/interfaces/macs/mac/vpc-ipv6-cidr-blocks Blok CIDR IPv6 dari VPC tempat antarmuka berada. 30/06/2016
placement/availability-zone Zona Ketersediaan tempat instans diluncurkan. 01/02/2008
placement/availability-zone-id ID Zona Ketersediaan statis tempat instans diluncurkan. ID Zona Ketersediaan konsisten di semua akun. Namun, ini mungkin berbeda dari Zona Ketersediaan, yang dapat berbeda tergantung pada akun. 01/10/2019
placement/group-name Nama grup penempatan tempat instans diluncurkan. 24/08/2020
placement/host-id ID host tempat instans diluncurkan. Hanya berlaku untuk Host Khusus. 24/08/2020
placement/partition-number Jumlah partisi tempat instans diluncurkan. 24/08/2020
placement/region Wil AWS ayah tempat instance diluncurkan. 24/08/2020
product-codes AWS Marketplace kode produk yang terkait dengan instance, jika ada. 01/03/2007
public-hostname DNS publik instans (IPv4). Kategori ini hanya ditampilkan jika atribut enableDnsHostnames diatur ke true. Untuk informasi selengkapnya, lihat Atribut DNS untuk VPC Anda dalam Panduan Pengguna Amazon VPC. Jika instans hanya memiliki alamat IPv6 publik dan tidak ada alamat IPv4 publik, item ini tidak diatur dan akan menghasilkan respons HTTP 404. 19/01/2007
public-ipv4 Alamat IPv4 publik. Jika alamat IP Elastis dikaitkan dengan instans, nilai yang ditampilkan adalah alamat IP Elastis. 19/01/2007
public-keys/0/openssh-key Kunci publik. Hanya tersedia jika disediakan pada waktu peluncuran instans. 1.0
ramdisk-id ID dari RAM disk ditentukan pada waktu peluncuran, jika ada. 10/10/2007
reservation-id ID reservasi. 1.0
security-groups

Nama-nama grup keamanan yang diterapkan ke instans.

Setelah peluncuran, Anda dapat mengubah grup keamanan instans. Perubahan tersebut tercermin di sini dan di network/interfaces /macs//security-groups. mac

1.0
services/domain

Domain untuk AWS sumber daya untuk Wilayah.

 25/02/2014
services/partition

Partisi tempat sumber daya berada. Untuk Wil AWS ayah standar, partisi adalahaws. Jika Anda memiliki sumber daya di partisi lain, maka partisi-nya adalah aws-partitionname. Contohnya, partisi untuk sumber daya di Wilayah Tiongkok (Beijing) adalah aws-cn.

 20/10/2015
spot/instance-action

Tindakan (hibernasi, berhenti, atau berakhir) dan perkiraan waktu, dalam UTC, saat tindakan akan terjadi. Item ini ada hanya jika Instans Spot telah ditandai untuk hibernasi, berhenti, atau berakhir. Untuk informasi selengkapnya, lihat tindakan-contoh.

 15/11/2016
spot/termination-time

Perkiraan waktu, dalam UTC, sistem operasi untuk Instans Spot Anda akan menerima sinyal shutdown. Item ini hadir dan berisi nilai waktu (misalnya, 2015-01-05T18:02:00Z) hanya jika Instans Spot telah ditandai untuk penghentian oleh Amazon EC2. Item waktu pengakhiran tidak diatur ke suatu waktu jika Anda sendiri mengakhiri Instans Spot. Untuk informasi selengkapnya, lihat penghentian-waktu.

 05/11/2014
system Jenis virtualisasi yang mendasari (hypervisor) dari instance. 2022-09-24
tags/instance Tanda instans yang terkait dengan instans. Hanya tersedia jika Anda secara eksplisit mengizinkan akses ke tanda dalam metadata instans. Untuk informasi selengkapnya, lihat Aktifkan akses ke tag dalam metadata contoh. 2021-03-23

Kategori data dinamis

Tabel berikut mencantumkan kategori data dinamis.

Kategori Deskripsi Versi ketika kategori dirilis
fws/instance-monitoring Nilai yang menunjukkan apakah pelanggan telah mengaktifkan pemantauan satu menit yang terperinci. CloudWatch Nilai yang valid: enabled | disabled 04/04/2009
instance-identity/document JSON berisi atribut instans, seperti instance-id, alamat IP privat, dll. Lihat Dokumen identitas instans untuk instans Amazon EC2. 04/04/2009
instance-identity/pkcs7 Digunakan untuk memverifikasi keaslian dokumen dan konten terhadap tanda tangan. Lihat Dokumen identitas instans untuk instans Amazon EC2. 04/04/2009
instance-identity/signature Data yang dapat digunakan pihak lain untuk memverifikasi asal dan keasliannya. Lihat Dokumen identitas instans untuk instans Amazon EC2. 04/04/2009