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. Instance-Metadaten enthalten Folgendes:

Eigenschaften von Instanz-Metadaten

Instance-Metadaten-Eigenschaften sind in Kategorien unterteilt (z.B. Hostname, Ereignisse und Sicherheitsgruppen).

Dynamische Daten

Dynamische Daten sind Metadaten, die beim Start der Instance generiert werden, z. B. ein Instance-Identitätsdokument. Weitere Informationen finden Sie unter Kategorien von dynamischen Daten.

Benutzerdaten

Sie können Instance-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 erstellen AMIs und mit Hilfe von Benutzerdaten die beim Start ausgelieferten Konfigurationsdateien ä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 Sie dessen Inhalt hinzu und starten Ihren AMI mit dem eindeutigen Bucket-Namen, der Ihrem Code in den Benutzerdaten zur Verfügung steht. 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 die Aktivitäten der Instances steuert. 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 Instance, 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

Instance-Metadateneigenschaften werden in vier Kategorien unterteilt. Um Instance-Metadaten-Eigenschaften 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öffentlichtlatest, verwenden Sie in Ihren Metadaten-Anfragen nicht die Versionsnummer. 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 vorhandene 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 stellt die MAC Adresse für die Netzwerkschnittstelle dar. 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 für den Start 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 zu der 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 für diese Erstellung gebündelt wurden. AMI Dieser Wert ist nur vorhanden, wenn die AMI Manifestdatei einen ancestor-amis -Schlüssel enthalten hat. 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. Siehe Abrufen des Ziellebenszyklusstatus durch Instance-Metadaten im Benutzerhandbuch für Amazon EC2 Auto Scaling.

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 mit einem EBS Amazon-Volume verknüpft sind EBSAmazon-Volumes sind nur in Metadaten enthalten, wenn sie beim Starten der Instance — oder als die Instance zuletzt gestartet wurde — 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 NVMe Nicht-Instance-Speicher-Volumes. 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 Enthält eine JSON Zeichenfolge mit Informationen zum Elastic einschließlich ID und VerbindungsinformationenGPU, wenn der Instance ein Elastic GPU angefügt ist. 30.11.2016
elastic-inference/associations/eia-id Enthält eine JSON Zeichenfolge mit Informationen zum Elastic Inference Accelerator einschließlich ID und Typ, wenn der Instance ein Elastic Interference Accelerator angefügt ist. 2018-11-29
events/maintenance/history Enthält eine JSON Zeichenfolge mit Informationen zu den Ereignissen, wenn es abgeschlossene oder abgebrochene Wartungsereignisse für die Instance gibt. 2018-08-17
events/maintenance/scheduled Enthält eine JSON Zeichenfolge mit Informationen zu den Ereignissen, wenn es aktive Wartungsereignisse für die Instance gibt. Weitere Informationen finden Sie unter Geplante Ereignisse anzeigen, die sich auf Ihre EC2 Amazon-Instances auswirken. 2018-08-17
events/recommendations/rebalance Die ungefähre ZeitUTC, in der die Empfehlungsbenachrichtigung des EC2 Instance-Neuausgleichs für die Instance ausgesendet 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 EC2Empfehlung zum Neuausgleich. 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 eine IAM Rolle mit der Instance verknüpft ist, enthält dieser Wert Informationen darüber, wann das Instance-Profil zuletzt aktualisiert wurde: einschließlich des LastUpdated Instance-Datums InstanceProfileArn, undInstanceProfileId. Andernfalls nicht vorhanden. 2012-01-12
iam/security-credentials/role-name Wenn mit der Instance eine IAM -Rolle verknüpft ist, role-name ist der Name der Rolle und role-name enthält die temporären Sicherheitsanmeldeinformationen, 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 Instance-Identitätsrolle, mit denen On-Instance-Software sich gegenüber identifizieren kann, AWS um Features wie EC2 Instance Connect und AWS Systems Manager Default Host Management Configuration zu unterstützen. An diese Anmeldeinformationen sind keine Richtlinien angehängt, sodass sie über keine zusätzlichen AWS API Berechtigungen verfügen, die über die Identifizierung der Instance für das AWS -Feature hinausgehen. 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. Wenn mehrere Netzwerkschnittstellen vorhanden sind, bezieht sich dieser Wert auf die Netzwerkschnittstelle des eth0 -Geräts (das Gerät mit der Gerätenummer 0) und die erste zugewiesene IPv6 Adresse. Wenn auf der Netzwerkschnittstelle keine IPv6 Adresse vorhanden ist [0], wird dieses Element nicht festgelegt und führt zu einer HTTP 404-Antwort. 03.01.2021
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 Instance. 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 -Instance handelt, wird dieses Element nicht festgelegt und führt zu einer HTTP 404-Antwort. 1,0
mac Die Media Access Control-Adresse (MAC) der Instance. 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 mit jeder öffentlichen IP-Adresse verknüpft und dieser Netzwerkschnittstelle 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 IPv6 Präfix, das der Netzwerkschnittstelle zugewiesen ist.
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 Instance 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 mit der Netzwerkschnittstelle verknüpft sind Wenn es sich um eine IPv6 reine Netzwerkschnittstelle handelt, wird dieses Element nicht festgelegt 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 IPv6 Public-Adresse und keine IPv4 Public-Adresse hat, wird dieses Element 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. Es können mehrere IPv4 Adressen zu einer Instance gehören. 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 für das Subnetz, in der sich die Schnittstelle befindet. 01.01.2011
network/interfaces/macs/mac/subnet-ipv6-cidr-blocks Der IPv6 CIDR Block für das Subnetz, in der sich die Schnittstelle befindet. 2016-06-30
network/interfaces/macs/mac/vpc-id Die ID für die, VPC in der 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 Mit der Instance verknüpfte Produkt-Codes (falls zutreffend) 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 IPv6 Public-Adresse und keine IPv4 Public-Adresse hat, wird dieses Element 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 des RAM Datenträgers, der 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 Domäne 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, anhalten oder beenden) sowie den ungefähren ZeitpunktUTC, in dem 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

Die ungefähre Zeit inUTC, zu der das Betriebssystem für Ihre Spot-Instance das Signal zum Beenden empfängt. Dieses Element ist nur vorhanden und enthält einen Zeitwert (z. B. 2015-01-05T 18:02:00 Z), wenn die Spot-Instance von Amazon zum Beenden 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 Der Wert gibt an, ob der Kunde die detaillierte Überwachung (einminütig) in CloudWatch aktiviert hat. Zulässige Werte: enabled | disabled 2009-04-04
instance-identity/document JSONmit Instance-Attributen, z. B. Instance-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