Verwenden Sie Instanz-Metadaten, um Ihre EC2 Instanz zu verwalten - Amazon Elastic Compute Cloud
Instance-MetadatenkategorienKategorien von dynamischen Daten

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden Sie Instanz-Metadaten, um Ihre EC2 Instanz zu verwalten

Instance-Metadaten sind Daten über eine Instance, mit denen Sie die ausgeführte Instance konfigurieren und verwalten können. Zu den Instanz-Metadaten gehören Folgendes:

Eigenschaften von Instanz-Metadaten

Die Eigenschaften von Instanz-Metadaten sind in Kategorien unterteilt, z. B. Hostname, Ereignisse und Sicherheitsgruppen.

Dynamische Daten

Dynamische Daten sind Metadaten, die beim Start der Instanz generiert werden, z. B. ein Identitätsdokument für eine Instanz. Weitere Informationen finden Sie unter Kategorien von dynamischen Daten.

Benutzerdaten

Sie können Instanz-Metadaten auch verwenden, um auf Benutzerdaten zuzugreifen, die Sie beim Start Ihrer Instance angegeben haben. Sie können beispielsweise Parameter für die Konfiguration Ihrer Instance angeben oder ein einfaches Skript einbinden. Sie können auch generische Dateien erstellen AMIs und Benutzerdaten verwenden, um die beim Start bereitgestellten Konfigurationsdateien zu ändern. Wenn Sie beispielsweise Webserver für verschiedene kleine Unternehmen betreiben, können sie alle dasselbe generische Produkt verwenden AMI und ihren Inhalt aus einem Amazon S3 S3-Bucket abrufen, den Sie beim Start in den Benutzerdaten angeben. Um jederzeit einen neuen Kunden hinzuzufügen, erstellen Sie einen Bucket für den Kunden, fügen dessen Inhalt hinzu und starten Sie Ihren Bucket AMI mit dem eindeutigen Bucket-Namen, der Ihrem Code in den Benutzerdaten zugewiesen wurde. Wenn Sie mehrere Instances mit demselben RunInstances Call starten, sind die Benutzerdaten für alle Instances in dieser Reservierung verfügbar. Jede Instance, die Teil derselben Reservierung ist, hat eine eindeutige ami-launch-index Nummer, sodass Sie Code schreiben können, der steuert, was die Instances tun. Beispielsweise kann sich der erste Host selbst als ursprünglichen Knoten in einem Cluster auswählen. Ein detailliertes AMI Startbeispiel finden Sie unterIdentifizieren Sie jede Instanz, die in einer einzigen Anfrage gestartet wurde.

Wichtig

Sie können nur innerhalb der Instance selbst auf Instance-Metadaten und Benutzerdaten zugreifen. Die Daten sind nicht durch Authentifizierungs- oder kryptografische Verfahren geschützt. Jeder, der direkten Zugriff auf die Instance hat, und möglicherweise auch jede Software, die auf der Instance läuft, kann deren Metadaten einsehen. Daher sollten Sie sensible Daten wie Passwörter oder langlebige Verschlüsselungscodes nicht als Benutzerdaten speichern.

Inhalt

Instance-Metadatenkategorien

Die Eigenschaften von Instanz-Metadaten sind in Kategorien unterteilt. Um die Eigenschaften der Instanzmetadaten abzurufen, geben Sie die Kategorie in der Anfrage an, und die Metadaten werden in der Antwort zurückgegeben.

Wenn neue Kategorien veröffentlicht werden, wird ein neuer Instance-Metadaten-Build mit einer neuen Versionsnummer erstellt. In der folgenden Tabelle wird in der Spalte Version, als die Kategorie veröffentlicht wurde die Build-Version angegeben, als die Instance-Metadatenkategorie freigegeben wurde. Um zu vermeiden, dass Sie Ihren Code jedes Mal aktualisieren müssen, wenn Amazon einen neuen Instance-Metadaten-Build EC2 veröffentlicht, verwenden Sie latest anstelle der Versionsnummer in Ihren Metadatenanfragen. Weitere Informationen finden Sie unter Abrufen der verfügbaren Versionen der Instance-Metadaten.

Wenn Amazon eine neue Instance-Metadatenkategorie EC2 veröffentlicht, sind die Instance-Metadaten für die neue Kategorie möglicherweise nicht für bestehende Instances verfügbar. Bei Nitro-basierten Instances können Sie Instance-Metadaten nur für die Kategorien abrufen, die beim Start verfügbar waren. Bei Instances mit dem Xen-Hypervisor können Sie die Instance stoppen und dann starten, um die für die Instance verfügbaren Kategorien zu aktualisieren.

In der folgenden Tabelle werden die Kategorien von Instance-Metadaten aufgeführt. Einige der Kategorienamen enthalten Platzhalter für Daten, die für Ihre Instance eindeutig sind.. Zum Beispiel mac steht für die MAC Adresse der Netzwerkschnittstelle. Sie müssen die Platzhalter durch tatsächliche Werte ersetzen, wenn Sie die Instance-Metadaten abrufen.

Kategorie Beschreibung Version, als die Kategorie veröffentlicht wurde
ami-id Die AMI ID, die zum Starten der Instance verwendet wurde. 1,0
ami-launch-index Wenn Sie mehrere Instances mit demselben RunInstances Aufruf starten, gibt dieser Wert die Startreihenfolge für jede Instance an. Der Wert für die zuerst gestartete Instance ist 0. Wenn Sie Instances mit Auto Scaling oder EC2 Fleet starten, ist dieser Wert immer 0. 1,0
ami-manifest-path Der Pfad zur AMI Manifestdatei in Amazon S3. Wenn Sie zum Starten der Instance eine EBS AMI Amazon-gestützte Instanz verwendet haben, lautet unknown das zurückgegebene Ergebnis. 1,0
ancestor-ami-ids Die AMI IDs aller Instances, die zu diesem Zweck neu gebündelt wurden. AMI Dieser Wert ist nur vorhanden, wenn die AMI Manifestdatei einen ancestor-amis Schlüssel enthielt. 2007-10-10
autoscaling/target-lifecycle-state

Wert, der den Zielzustand des Auto-Scaling-Lebenszyklus anzeigt, in den eine Auto-Scaling-Instance übergeht. Wird verwendet, wenn die Instance nach dem 10. März 2022 in einen der Ziel-Lebenszyklusstatus wechselt. Mögliche Werte: Detached | InService | Standby | Terminated | Warmed:Hibernated | Warmed:Running | Warmed:Stopped | Warmed:Terminated. Weitere Informationen finden Sie unter Abrufen des Ziellebenszyklusstatus mithilfe von Instance-Metadaten im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.

15.07.2021
block-device-mapping/ami Das virtuelle Gerät, auf dem sich das Root- bzw. Boot-Dateisystem befindet 2007-12-15
block-device-mapping/ebsN Die virtuellen Geräte, die beliebigen EBS Amazon-Volumes zugeordnet sind. EBSAmazon-Volumes sind nur dann in Metadaten verfügbar, wenn sie beim Start oder beim letzten Start der Instance vorhanden waren. Das N steht für den Index des EBS Amazon-Volumens (z. B. ebs1 oderebs2). 2007-12-15
block-device-mapping/ephemeralN Die virtuellen Geräte für alle Speicher-Volumes, die keine NVMe Instances sind. N gibt den Index jedes Volumes an. Die Anzahl der Instance-Speicher-Volumes in der Blockgerät-Zuweisung entspricht möglicherweise nicht der tatsächlichen Anzahl der Instance-Speicher-Volumes für die Instance. Der Instance-Typ bestimmt die Anzahl der Instance-Speicher-Volumes, die für eine Instance verfügbar sind. Wenn die Anzahl der Instance-Speicher-Volumes in einer Blockgerät-Zuweisung die für eine Instance verfügbare Anzahl übersteigt, werden die überzähligen Instance-Speicher-Volumes ignoriert. 2007-12-15
block-device-mapping/root Die virtuellen Laufwerke oder Partitionen, die den Root-Laufwerken oder Partitionen auf dem virtuellen Laufwerk zugeordnet sind, wobei das Root-Dateisystem (/ oder C:) der angegebenen Instance zugeordnet ist. 2007-12-15
block-device-mapping/swap Die virtuellen Geräte, die mit swap verknüpft sind. Nicht immer vorhanden. 2007-12-15
elastic-gpus/associations/elastic-gpu-id Wenn ein Elastic an die Instance GPU angehängt ist, enthält es eine JSON Zeichenfolge mit Informationen über das ElasticGPU, einschließlich seiner ID und Verbindungsinformationen. 30.11.2016
elastic-inference/associations/eia-id Wenn ein Elastic Inference Accelerator an die Instance angehängt ist, enthält er eine JSON Zeichenfolge mit Informationen über den Elastic Inference Accelerator, einschließlich seiner ID und seines Typs. 2018-11-29
events/maintenance/history Enthält eine JSON Zeichenfolge mit Informationen zu den Ereignissen, wenn Wartungsereignisse für die Instance abgeschlossen oder abgebrochen wurden. 2018-08-17
events/maintenance/scheduled Enthält eine JSON Zeichenfolge mit Informationen zu den Ereignissen, wenn es aktive Wartungsereignisse für die Instanz gibt. Weitere Informationen finden Sie unter Geplante Ereignisse anzeigen, die sich auf Ihre EC2 Amazon-Instances auswirken. 2018-08-17
events/recommendations/rebalance Der ungefähre Zeitpunkt (in)UTC, zu dem die Benachrichtigung über die Empfehlung zur Neugewichtung der EC2 Instance für die Instance ausgegeben wird. Das Folgende ist ein Beispiel für die Metadaten für diese Kategorie: {"noticeTime": "2020-11-05T08:22:00Z"}. Diese Kategorie ist erst verfügbar, nachdem die Benachrichtigung gesendet wurde. Weitere Informationen finden Sie unter EC2Empfehlungen zur Neugewichtung von Instanzen. 2020-10-27
hostname Wenn die EC2 Instanz IP-basiertes Naming (IPBN) verwendet, ist dies der private IPv4 DNS Hostname der Instanz. Wenn die EC2 Instanz die ressourcenbasierte Benennung (RBN) verwendet, ist dies der. RBN Wenn mehrere Netzwerkschnittstellen vorhanden sind, bezieht sich dieser Wert auf das Gerät eth0 (das Gerät mit der Gerätenummer 0). Weitere Hinweise zu IPBN und RBN finden Sie unter. Hostnamentypen für EC2 Amazon-Instances 1,0
iam/info Wenn der Instance eine IAM Rolle zugeordnet ist, enthält Informationen darüber, wann das Instanzprofil zuletzt aktualisiert wurde, einschließlich des LastUpdated Datums der Instanz InstanceProfileArn, undInstanceProfileId. Andernfalls nicht vorhanden. 2012-01-12
iam/security-credentials/role-name Wenn der Instanz eine IAM Rolle zugeordnet ist, role-name ist der Name der Rolle und role-name enthält die temporären Sicherheitsanmeldedaten, die der Rolle zugeordnet sind (weitere Informationen finden Sie unterAbrufen von Sicherheitsanmeldeinformationen aus Instance-Metadaten). Andernfalls nicht vorhanden. 2012-01-12
identity-credentials/ec2/info Informationen zu den Anmeldeinformationen in identity-credentials/ec2/security-credentials/ec2-instance. 2018-05-23
identity-credentials/ec2/security-credentials/ec2-instance Anmeldeinformationen für die Instanzidentitätsrolle, die es der On-Instance-Software ermöglichen, sich selbst AWS zu identifizieren, um Funktionen wie EC2 Instance Connect und AWS Systems Manager Standard-Host-Management-Konfiguration zu unterstützen. An diese Anmeldeinformationen sind keine Richtlinien angehängt, sodass sie über die Identifizierung der Instanz für die AWS Funktion hinaus keine zusätzlichen AWS API Berechtigungen haben. Weitere Informationen finden Sie unter Instanzidentitätsrollen für EC2 Amazon-Instances. 2018-05-23
instance-action Weist die Instance an, zur Vorbereitung einer Bündelung einen Neustart durchzuführen. Zulässige Werte: none | shutdown | bundle-pending. 2008-09-01
instance-id Die ID dieser Instance 1,0
instance-life-cycle Die Kaufoption dieser Instance. Weitere Informationen finden Sie unter EC2Abrechnungs- und Kaufoptionen von Amazon. 01.10.2019
instance-type Der Typ der Instance. Weitere Informationen finden Sie unter EC2Amazon-Instance-Typen. 2007-08-29
ipv6 Die IPv6 Adresse der Instanz. In Fällen, in denen mehrere Netzwerkschnittstellen vorhanden sind, bezieht sich dies auf die Netzwerkschnittstelle des eth0-Geräts (das Gerät, für das die Gerätenummer 0 ist) und die erste zugewiesene IPv6 Adresse. Wenn auf der Netzwerkschnittstelle [0] keine IPv6 Adresse vorhanden ist, ist dieses Element nicht gesetzt und führt zu einer HTTP 404-Antwort. 2021-01-03
kernel-id Die ID des mit dieser Instance gestarteten Kernels (falls zutreffend) 2008-02-01
local-hostname Wenn mehrere Netzwerkschnittstellen vorhanden sind, bezieht sich dieser Wert auf das Gerät eth0 (das Gerät mit der Gerätenummer 0). Wenn die EC2 Instanz IP-basiertes Naming (IPBN) verwendet, ist dies der private IPv4 DNS Hostname der Instanz. Wenn die EC2 Instanz die ressourcenbasierte Benennung (RBN) verwendet, ist dies der. RBN Weitere Informationen zu IPBNRBN, und zur Benennung von EC2 Instanzen finden Sie unter. Hostnamentypen für EC2 Amazon-Instances 2007-01-19
local-ipv4 Die private IPv4 Adresse der Instanz. Wenn mehrere Netzwerkschnittstellen vorhanden sind, bezieht sich dieser Wert auf das Gerät eth0 (das Gerät mit der Gerätenummer 0). Wenn es sich um eine IPv6 reine Instanz handelt, ist dieses Element nicht festgelegt und führt zu einer HTTP 404-Antwort. 1,0
mac Die Adresse der Instanz für die Medienzugriffskontrolle (MAC). Wenn mehrere Netzwerkschnittstellen vorhanden sind, bezieht sich dieser Wert auf das Gerät eth0 (das Gerät mit der Gerätenummer 0). 01.01.2011
metrics/vhostmd Nicht mehr verfügbar. 2011-05-01
network/interfaces/macs/mac/device-number Die eindeutige Gerätenummer, die mit dieser Schnittstelle verknüpft ist. Die Gerätenummer entspricht dem Gerätenamen; device-number 2 steht z. B. für das Gerät eth2. Diese Kategorie entspricht den device-index Feldern DeviceIndex und, die von Amazon verwendet werden, EC2 API und den EC2 Befehlen für die AWS CLI. 01.01.2011
network/interfaces/macs/mac/interface-id Die ID der Netzwerkschnittstelle. 01.01.2011
network/interfaces/macs/mac/ipv4-associations/public-ip Die privaten IPv4 Adressen, die jeder öffentlichen IP-Adresse zugeordnet und dieser Schnittstelle zugewiesen sind. 01.01.2011
network/interfaces/macs/mac/ipv6s Die der Schnittstelle zugewiesenen IPv6 Adressen. 2016-06-30
network/interfaces/macs/mac/ipv6-prefix Das der Netzwerkschnittstelle zugewiesene IPv6 Präfix.
network/interfaces/macs/mac/local-hostname

Der private IPv4 DNS Hostname der Instanz. Wenn mehrere Netzwerkschnittstellen vorhanden sind, bezieht sich dieser Wert auf das Gerät eth0 (das Gerät mit der Gerätenummer 0). Wenn es sich um eine IPv6 reine Instanz handelt, ist dies der ressourcenbasierte Name. Weitere Hinweise zu IPBN und RBN finden Sie unter. Hostnamentypen für EC2 Amazon-Instances

 2007-01-19
network/interfaces/macs/mac/local-ipv4s Die privaten IPv4 Adressen, die der Schnittstelle zugeordnet sind. Wenn es sich um eine IPv6 reine Netzwerkschnittstelle handelt, ist dieses Element nicht gesetzt und führt zu einer HTTP 404-Antwort. 01.01.2011
network/interfaces/macs/mac/mac Die MAC Adresse der Instanz. 01.01.2011
network/interfaces/macs/mac/network-card Der Index der Netzwerkkarte. Einige Instance-Typen unterstützen mehrere Netzwerkkarten. 01.11.2020
network/interfaces/macs/mac/owner-id Die ID des Eigentümers der Netzwerkschnittstelle. In Umgebungen mit mehreren Schnittstellen kann eine Schnittstelle von einem Drittanbieter wie Elastic Load Balancing zugewiesen werden. Der Datenverkehr auf einer Schnittstelle wird immer dem Eigentümer der Schnittstelle in Rechnung gestellt. 01.01.2011
network/interfaces/macs/mac/public-hostname Die Schnittstelle ist public DNS (IPv4). Diese Kategorie wird nur ausgegeben, wenn das Attribut enableDnsHostnames auf true gesetzt ist. Weitere Informationen finden Sie unter DNSAttribute für Sie VPC im VPCAmazon-Benutzerhandbuch. Wenn die Instance nur eine öffentliche IPv6 Adresse und keine öffentliche IPv4 Adresse hat, ist dieser Artikel nicht festgelegt und führt zu einer HTTP 404-Antwort. 01.01.2011
network/interfaces/macs/mac/public-ipv4s Die öffentliche IP-Adresse oder die Elastic IP-Adressen, die dem Adapter zugeordnete sind. Eine Instanz kann mehrere IPv4 Adressen enthalten. 01.01.2011
network/interfaces/macs/mac/security-groups Sicherheitsgruppen, zu denen die Netzwerkschnittstelle gehört. 01.01.2011
network/interfaces/macs/mac/security-group-ids Die IDs Sicherheitsgruppen, zu denen die Netzwerkschnittstelle gehört. 01.01.2011
network/interfaces/macs/mac/subnet-id Die ID für das Subnetz, in der sich die Schnittstelle befindet. 01.01.2011
network/interfaces/macs/mac/subnet-ipv4-cidr-block Der IPv4 CIDR Block des Subnetzes, in dem sich die Schnittstelle befindet. 01.01.2011
network/interfaces/macs/mac/subnet-ipv6-cidr-blocks Der IPv6 CIDR Block des Subnetzes, in dem sich die Schnittstelle befindet. 2016-06-30
network/interfaces/macs/mac/vpc-id Die ID des, VPC in dem sich die Schnittstelle befindet. 01.01.2011
network/interfaces/macs/mac/vpc-ipv4-cidr-block Der IPv4 CIDR Primärblock von. VPC 01.01.2011
network/interfaces/macs/mac/vpc-ipv4-cidr-blocks Die IPv4 CIDR Blöcke für dieVPC. 2016-06-30
network/interfaces/macs/mac/vpc-ipv6-cidr-blocks Der IPv6 CIDR Block von, VPC in dem sich die Schnittstelle befindet. 2016-06-30
placement/availability-zone Die Availability Zone, in der die Instance gestartet wurde 2008-02-01
placement/availability-zone-id Die statische Availability Zone-ID, in der die Instance gestartet wird. Die Availability Zone-ID ist für alle Konten konsistent. Sie kann sich jedoch von der Availability Zone unterscheiden, die je nach Konto variieren kann. 01.10.2019
placement/group-name Der Name der Platzierungsgruppe, in der die Instance gestartet wird. 24.08.2020
placement/host-id Die ID des Hosts, auf dem die Instance gestartet wird. Gilt nur für Dedicated Hosts. 24.08.2020
placement/partition-number Die Nummer der Partition, in der die Instance gestartet wird. 24.08.2020
placement/region Die AWS Region, in der die Instance gestartet wird. 24.08.2020
product-codes AWS Marketplace Produktcodes, die der Instance zugeordnet sind, falls vorhanden. 2007-03-01
public-hostname Die Instanz ist öffentlich DNS (IPv4). Diese Kategorie wird nur ausgegeben, wenn das Attribut enableDnsHostnames auf true gesetzt ist. Weitere Informationen finden Sie unter DNSAttribute für Sie VPC im VPCAmazon-Benutzerhandbuch. Wenn die Instance nur eine öffentliche IPv6 Adresse und keine öffentliche IPv4 Adresse hat, ist dieser Artikel nicht festgelegt und führt zu einer HTTP 404-Antwort. 2007-01-19
public-ipv4 Die öffentliche IPv4 Adresse. Wenn eine Elastic IP-Adresse mit der Instance verknüpft ist, ist der zurückgegebene Wert die Elastic IP-Adresse. 2007-01-19
public-keys/0/openssh-key Der öffentliche Schlüssel. Nur verfügbar, wenn bei der Instance-Startzeit angegeben. 1,0
ramdisk-id Die ID der RAM Festplatte, die beim Start angegeben wurde, falls zutreffend. 2007-10-10
reservation-id Die ID der Reservierung 1,0
security-groups

Die Namen der Sicherheitsgruppen für die Instance.

Nach dem Start können Sie die Sicherheitsgruppen von Instances ändern. Solche Änderungen spiegeln sich hier und innetwork/interfaces/macs/wider mac/Sicherheitsgruppen.

 1,0
services/domain

Die Domain für AWS Ressourcen für die Region.

 2014-02-25
services/partition

Die Partition, in der sich die Ressource befindet. Für AWS Standardregionen lautet die Partitionaws. Wenn Sie Ressourcen in anderen Partitionen haben, lautet die Partition aws-partitionname. Die Aufteilung der Ressourcen in der Region China (Peking) lautet beispielsweise aws-cn.

 2015-10-20
spot/instance-action

Die Aktion (in den Ruhezustand versetzen, beenden oder beenden) und die ungefähre ZeitUTC, in der die Aktion ausgeführt wird. Dieses Element ist nur vorhanden, wenn die Spot-Instance für das Versetzen in den Ruhezustand, das Anhalten oder das Beenden markiert wurde. Weitere Informationen finden Sie unter instance-action.

 15.11.2016
spot/termination-time

Der ungefähre Zeitpunkt, zu dem das Betriebssystem Ihrer Spot-Instance das Shutdown-Signal empfängt. UTC Dieser Artikel ist nur dann vorhanden und enthält einen Zeitwert (z. B. 2015-01-05T 18:02:00 Z), wenn die Spot-Instance von Amazon zur Kündigung markiert wurde. EC2 Das Element für den Beendigungszeitpunkt enthält keinen Wert, wenn Sie die Spot-Instance selbst beenden. Weitere Informationen finden Sie unter termination-time.

 2014-11-05
tags/instance Die Instance-Tags, die der Instance zugeordnet sind. Nur verfügbar, wenn Sie explizit Zugriff auf Tags in Instance-Metadaten zulassen. Weitere Informationen finden Sie unter Zulassen des Zugriffs auf Tags in Instance-Metadaten. 23.03.2021

Kategorien von dynamischen Daten

In der folgenden Tabelle werden die Kategorien von dynamischen Daten aufgeführt.

Kategorie Beschreibung Version, als die Kategorie veröffentlicht wurde
fws/instance-monitoring Wert, der angibt, ob der Kunde eine detaillierte einminütige Überwachung aktiviert hat. CloudWatch Zulässige Werte: enabled | disabled 2009-04-04
instance-identity/document JSONenthält Instanzattribute wie Instanz-ID, private IP-Adresse usw. Siehe Instanzidentitätsdokumente für EC2 Amazon-Instances. 2009-04-04
instance-identity/pkcs7 Wird verwendet, um die Authentizität und den Inhalt des Dokuments mithilfe der Signatur zu überprüfen. Siehe Instanzidentitätsdokumente für EC2 Amazon-Instances. 2009-04-04
instance-identity/signature Die Daten können von Dritten verwendet werden, um den Ursprung und die Authentizität zu überprüfen. Siehe Instanzidentitätsdokumente für EC2 Amazon-Instances. 2009-04-04