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.
Instance-Metadaten verwenden, um Ihre EC2-Instance 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 der Instance-Metadaten
-
Instance-Metadaten sind in Kategorien unterteilt (z. B. Host-Name, Ereignisse und Sicherheitsgruppen).
- Dynamische Daten
-
Dynamische Daten sind Metadaten, die beim Start der Instance generiert werden, wie 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 generische AMIs erstellen 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 AMI verwenden und ihren Inhalt aus dem Amazon-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 Ihr AMI mit dem eindeutigen Bucket-Namen, der Ihrem Code in den Benutzerdaten zur Verfügung steht. Wenn Sie mehrere Instances mit demselben
RunInstances-Aufruf starten, sind die Benutzerdaten für alle Instances in dieser Reservierung verfügbar. Jede Instance, die Teil derselben Reservierung ist, hat eine eindeutigeami-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 unter Identifizieren Sie jede Instance, die in einer einzelnen 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-Metadaten-Eigenschaften werden in Kategorien unterteilt. Um Instance-Metadaten 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 EC2 einen neuen Instance-Metadaten-Build veröffentlicht, verwenden Sie latest in Ihren Metadaten-Anfragen, nicht die Versionsnummer. Weitere Informationen finden Sie unter Abrufen der verfügbaren Versionen der Instance-Metadaten.
Wenn Amazon EC2 eine neue Instance-Metadatenkategorie veröffentlicht, sind die Instance-Metadaten für die neue Kategorie möglicherweise nicht für vorhandene Instances verfügbar. Bei Nitro-based 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.. macStellt beispielsweise 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 | Description | Version, als die Kategorie veröffentlicht wurde |
|---|---|---|
ami-id
|
Die für den Start der Instance verwendete AMI-ID | 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-Flotte starten, ist dieser Wert immer 0. |
1,0 |
ami-manifest-path
|
Der Pfad zu der AMI-Manifestdatei in Amazon S3. Wenn Sie ein EBS-backed Amazon-AMI verwendet haben, um die Instance zu starten, lautet das zurückgegebene Ergebnisunknown. |
1,0 |
ancestor-ami-ids
|
Die AMI-IDs aller Instances, die für die Erstellung dieses AMIs gebündelt wurden. 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: |
15.07.2021 |
block-device-mapping/ami |
Das virtuelle Gerät, das das Dateisystem enthält. root/boot | 2007-12-15 |
block-device-mapping/ebsN |
Die virtuellen Geräte, die mit einem Amazon EBS-Volume verknüpft sind. Amazon EBS-Volumes sind nur in Metadaten enthalten, wenn sie beim Starten der Instance – oder als die Instance zuletzt gestartet wurde – vorhanden waren. N zeigt dabei den Index für das Amazon EBS-Volume an (z. B. ebs1 oder ebs2). |
2007-12-15 |
block-device-mapping/ephemeralN |
Die virtuellen Geräte für alle Nicht-NVMe-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 |
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, die sich auf Ihre Amazon-EC2-Instances auswirken, anzeigen. | 2018-08-17 |
events/recommendations/rebalance |
Die ungefähre Zeit in UTC, zu 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 Empfehlung zum Neuausgleich einer EC2-Instance. |
2020-10-27 |
hostname |
Wenn die EC2-Instance IP-based Benaming (IPBN) verwendet, ist dies der private IPv4-DNS-Hostname der Instance. Wenn die EC2-Instance eine Resource-based Benennung (RBN) verwendet, ist dies die RBN. Wenn mehrere Netzwerkschnittstellen vorhanden sind, bezieht sich dieser Wert auf das Gerät eth0 (das Gerät mit der Gerätenummer 0). Weitere Informationen zu IPBN und RBN finden Sie unter Hostnamen und Domains der EC2-Instance. | 1,0 |
iam/info
|
Wenn der Instance eine IAM-Rolle zugeordnet ist, enthält sie Informationen darüber, wann das Instance-Profil zuletzt aktualisiert wurde, einschließlich des LastUpdated Datums der Instance, und. InstanceProfileArn InstanceProfileId Andernfalls nicht vorhanden. | 2012-01-12 |
iam/security-credentials/
|
Wenn der Instance eine IAM-Rolle zugeordnet role-name ist, ist dies 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, anhand derer sich die Instance-Software identifizieren kann, AWS um Funktionen wie EC2 Instance Connect und die AWS Systems Manager Standard-Hostverwaltungskonfiguration zu unterstützen. Diesen Anmeldeinformationen sind keine Richtlinien zugeordnet, sodass sie über die Identifizierung der Instance anhand der Funktion keine zusätzlichen AWS API-Berechtigungen verfügen. AWS Weitere Informationen finden Sie unter Instance-Identitäts-Rollen für Amazon-EC2-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 Abrechnungs- und Kaufoptionen von Amazon EC2. | 01.10.2019 |
instance-type
|
Der Typ der Instance. Weitere Informationen finden Sie unter Amazon EC2-Instance-Typen. | 2007-08-29 |
ipv6
|
Die IPv6-Adresse der Instance. In Fällen, in denen mehrere Netzwerkschnittstellen vorhanden sind, bezieht sich dies auf die Netzwerkschnittstelle des eth0-Geräts (das Gerät, dessen Gerätenummer 0 ist) und die erste zugewiesene IPv6-Adresse. Wenn auf der Netzwerkschnittstelle keine IPv6-Adresse vorhanden ist [0], ist 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-Instance IP-based Benaming (IPBN) verwendet, ist dies der private IPv4-DNS-Hostname der Instance. Wenn die EC2-Instance eine Resource-based Benennung (RBN) verwendet, ist dies die RBN. Weitere Informationen zur Benennung von IPBN-, RBN- und EC2-Instances finden Sie unter Hostnamen und Domains der EC2-Instance. | 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-only Instanz handelt, ist 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/
|
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 Feldern DeviceIndex und device-index, die von der Amazon EC2 API und den EC2-Befehlen für die AWS CLI verwendet werden. |
01.01.2011 |
network/interfaces/macs/
|
Die ID der Netzwerkschnittstelle. | 01.01.2011 |
network/interfaces/macs/
|
Die privaten IPv4-Adressen, die mit jeder öffentlichen IP-Adresse verknüpft und dieser Netzwerkschnittstelle zugewiesen sind. | 01.01.2011 |
network/interfaces/macs/ |
Die IPv6-Adressen, die mit der Schnittstelle verknüpft sind. | 2016-06-30 |
network/interfaces/macs/ |
Das der Netzwerkschnittstelle zugewiesene IPv6-Präfix. | |
network/interfaces/macs/
|
Der private IPv4-DNS-Hostname der Netzwerkschnittstelle. Dieser Wert ist nicht für Schnittstellen festgelegt, die überhaupt keine IP-Adressen haben, wie EFA-only z. B. Schnittstellen. Wenn es sich um eine IPv6-only Schnittstelle handelt, ist dies der ressourcenbasierte Name. Weitere Informationen zu IPBN und RBN finden Sie unter Hostnamen und Domains der EC2-Instance. |
2007-01-19 |
network/interfaces/macs/
|
Die privaten IPv4-Adressen, die mit der Netzwerkschnittstelle verknüpft sind Wenn es sich um eine IPv6-only Netzwerkschnittstelle handelt, ist dieses Element nicht gesetzt und führt zu einer HTTP 404-Antwort. | 01.01.2011 |
network/interfaces/macs/
|
Die MAC-Adresse der Instance | 01.01.2011 |
network/interfaces/macs/
|
Der Index der Netzwerkkarte. Einige Instance-Typen unterstützen mehrere Netzwerkkarten. | 01.11.2020 |
network/interfaces/macs/
|
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/
|
Der öffentliche DNS-Name (IPv4) der Schnittstelle. Diese Kategorie wird nur ausgegeben, wenn das Attribut enableDnsHostnames auf true gesetzt ist. Weitere Infomationen finden Sie unter DNS-Attribute für Ihre VPC im Amazon VPC-Benutzerhandbuch. Wenn die Instance nur eine Public-IPv6-Adresse und keine Public-IPv4-Adresse hat, wird dieses Element nicht festgelegt und führt zu einer HTTP-404-Antwort. |
01.01.2011 |
network/interfaces/macs/
|
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/
|
Sicherheitsgruppen, zu denen die Netzwerkschnittstelle gehört. | 01.01.2011 |
network/interfaces/macs/
|
Die IDs der Sicherheitsgruppen, zu denen die Netzwerkschnittstelle gehört. | 01.01.2011 |
network/interfaces/macs/
|
Die ID für das Subnetz, in der sich die Schnittstelle befindet. | 01.01.2011 |
network/interfaces/macs/
|
Der IPv4-CIDR-Block für das Subnetz, in der sich die Schnittstelle befindet. | 01.01.2011 |
network/interfaces/macs/
|
Der IPv6-CIDR-Block für das Subnetz, in der sich die Schnittstelle befindet. | 2016-06-30 |
network/interfaces/macs/
|
Die ID für die VPC, in der sich die Schnittstelle befindet. | 01.01.2011 |
network/interfaces/macs/ |
Der primäre IPv4 CIDR-Block der VPC. | 01.01.2011 |
network/interfaces/macs/ |
Die IPv4 CIDR-Blöcke für die VPC | 2016-06-30 |
network/interfaces/macs/ |
Der IPv6-CIDR-Block für die VPC, in der 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 Instanz zugeordnet sind, falls vorhanden. | 2007-03-01 |
public-hostname
|
Das öffentliche DNS der Instance (IPv4). Diese Kategorie wird nur ausgegeben, wenn das Attribut enableDnsHostnames auf true gesetzt ist. Weitere Infomationen finden Sie unter DNS-Attribute für Ihre VPC im Amazon VPC-Benutzerhandbuch. Wenn die Instance nur eine Public-IPv6-Adresse und keine Public-IPv4-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 werden hier und in network/interfaces /macs/ |
1,0 |
services/domain
|
Die Domain für Ressourcen für die Region. AWS |
2014-02-25 |
services/partition
|
Die Partition, in der sich die Ressource befindet. Für AWS Standardregionen lautet die Partition |
2015-10-20 |
spot/instance-action
|
Die Aktion (in den Ruhezustand versetzen, anhalten oder beenden) sowie den ungefähren Zeitpunkt in UTC, an 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-Aktion. |
15.11.2016 |
spot/termination-time
|
Die ungefähre Zeit in UTC, 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-05T18:02:00Z), wenn die Spot-Instance von Amazon EC2 zur Kündigung markiert wurde. Das Element für den Beendigungszeitpunkt enthält keinen Wert, wenn Sie die Spot-Instance selbst beenden. Weitere Informationen finden Sie unter Beendigungszeitpunkt. |
2014-11-05 |
system |
Der zugrunde liegende Virtualisierungstyp (Hypervisor) der Instance. | 24.09.2022 |
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 Zugriff auf Tags in Instance-Metadaten ermöglichen. | 23.03.2021 |
Kategorien von dynamischen Daten
In der folgenden Tabelle werden die Kategorien von dynamischen Daten aufgeführt.
| Kategorie | Description | Version, als die Kategorie veröffentlicht wurde |
|---|---|---|
fws/instance-monitoring
|
Wert, der angibt, ob der Kunde die detaillierte einminütige Überwachung aktiviert hat. CloudWatch Zulässige Werte: enabled |
disabled |
2009-04-04 |
instance-identity/document
|
JSON-Wert mit Instance-Attributen, z. B. Instance-ID, private IP-Adresse, usw. Siehe Instance-Identitätsdokumente für Amazon-EC2-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 Instance-Identitätsdokumente für Amazon-EC2-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 Instance-Identitätsdokumente für Amazon-EC2-Instances. | 2009-04-04 |
