Tags für Ihre EC2-Instances mithilfe von Instance-Metadaten anzeigen

Sie können über die Instance-Metadaten auf die Tags einer Instance zugreifen. Wenn Sie über die Instance-Metadaten auf Tags zugreifen, werden die API-Aufrufe DescribeInstances und DescribeTags nicht mehr zum Abrufen von Tag-Informationen benötigt. Dadurch werden Ihre API-Transaktionen pro Sekunde reduziert und Ihre Tag-Abrufe können mit der Anzahl der Instances, die Sie steuern, skaliert werden. Darüber hinaus können lokale Prozesse, die auf einer Instance ausgeführt werden, die Tag-Informationen der Instance direkt in den Instance-Metadaten anzeigen.

Tags sind standardmäßig nicht in den Instance-Metadaten verfügbar; Sie müssen den Zugriff explizit zulassen. Sie können den Zugriff beim Start der Instance oder nach dem Start auf einer ausgeführten oder angehaltenen Instance zulassen. Sie können den Zugriff auf Tags auch zulassen, indem Sie dies in einer Startvorlage angeben. Instances, die mit der Vorlage gestartet werden, lassen den Zugriff auf Tags in den Instance-Metadaten zu.

Wenn Sie eine Instance-Markierung hinzufügen oder entfernen, werden die Instance-Metadaten aktualisiert, während die Instance läuft, ohne dass Sie die Instance anhalten und wieder starten müssen.

Zugriff auf Tags in Instance-Metadaten ermöglichen

Standardmäßig gibt es keinen Zugriff auf Instance-Tags in den Instance-Metadaten. Sie müssen den Zugriff für jede Instance explizit ermöglichen.

Anmerkung

Wenn Sie den Zugriff auf Tags in Instanz-Metadaten zulassen, unterliegen Instanz-Tag-Schlüssel bestimmten Einschränkungen. Non-compliance führt zu fehlgeschlagenen Starts für neue Instances oder zu einem Fehler für bestehende Instances. Die Einschränkungen sind:

• Kann nur Buchstaben (a-z, A-Z), Zahlen (0-9) und die folgenden Zeichen enthalten: + - = . , _ : @.

• Dürfen keine Leerzeichen oder / enthalten.

• Kann nicht nur aus . (einer Periode), .. (zwei Perioden) oder _index bestehen.

Weitere Informationen finden Sie unter Tag (Markierung)-Einschränkungen.

Console

So ermöglichen Sie den Zugriff auf Tags in Instance-Metadaten beim Instance-Start

1. Befolgen Sie das Verfahren zum Starten einer Instance.

2. Erweitern Sie Erweiterte Details und wählen Sie für Tags in Metadaten zulassen die Option Aktivieren aus.

3. Überprüfen Sie im Bereich Summary (Übersicht) die Konfiguration Ihrer Instance und wählen Sie dann Launch instance (Instance starten) aus. Weitere Informationen finden Sie unter EC2-Instance mit dem Launch Instance Wizard in der Konsole starten.

So ermöglichen Sie den Zugriff auf Tags in Instance-Metadaten nach dem Instance-Start

1. Öffnen Sie die Amazon-EC2-Konsole unter https://console.aws.amazon.com/ec2/.

2. Wählen Sie im Navigationsbereich Instances aus.

3. Wählen Sie zuerst eine Instance aus und wählen Sie dann in den Instance-Einstellungen unter Aktionen die Option Tags in Instance-Metadaten zulassen.

4. Zum Zulassen des Zugriffs auf Tags in Instance-Metadaten aktivieren Sie das Kontrollkästchen Zulassen.

5. Wählen Sie Speichern.

AWS CLI

So ermöglichen Sie den Zugriff auf Tags in Instance-Metadaten beim Instance-Start

Verwenden Sie den Befehl run-instances und fügen Sie die Option --metadata-options hinzu.

--metadata-options "InstanceMetadataTags=enabled"

So ermöglichen Sie den Zugriff auf Tags in Instance-Metadaten nach dem Instance-Start

Verwenden Sie den Befehl modify-instance-metadata-options.

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

So überprüfen Sie, ob der Zugriff auf Tags in Instance-Metadaten ermöglicht ist

Verwenden Sie den Befehl describe-instances und überprüfen Sie den Wert von InstanceMetadataTags.

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

Es folgt eine Beispielausgabe. Der Wert ist entweder enabled oder disabled.

[
    "enabled"
]

PowerShell

So ermöglichen Sie den Zugriff auf Tags in Instance-Metadaten beim Instance-Start

Verwenden Sie das New-EC2InstanceCmdlet und fügen Sie den folgenden -MetadataOptions_InstanceMetadataTags Parameter hinzu.

-MetadataOptions_InstanceMetadataTags enabled

So ermöglichen Sie den Zugriff auf Tags in Instance-Metadaten nach dem Instance-Start

Verwenden Sie das cmdlet Edit-EC2InstanceMetadataOption.

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

So überprüfen Sie, ob der Zugriff auf Tags in Instance-Metadaten ermöglicht ist

Verwenden Sie das Get-EC2InstanceCmdlet und überprüfen Sie den Wert von. InstanceMetadataTags

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

Es folgt eine Beispielausgabe. Der Wert ist entweder enabled oder disabled.

enabled

Abrufen von Tags aus Instance-Metadaten

Nachdem Sie den Zugriff auf Instance-Tags in den Instance-Metadaten erlaubt haben, können Sie über die Instance-Metadaten auf die tags/instance-Kategorie zugreifen. Weitere Informationen finden Sie unter Auf Instance-Metadaten für eine EC2-Instance zugreifen.

IMDSv2

Linux

Führen Sie den folgenden Befehl von Ihrer Linux-Instance aus, um alle Tag-Schlüssel für die Instance aufzulisten.

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

In diesem Beispiel wird der Wert eines Schlüssels abgerufen, der im vorherigen Beispiel ermittelt wurde. Die IMDSv2-Anforderung verwendet das gespeicherte Token, das im vorhergehenden Beispielbefehl erstellt wurde. Das Token darf nicht abgelaufen sein.

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

Windows

Führen Sie das folgende cmdlet von Ihrer Windows-Instance aus, um alle Tag-Schlüssel für die Instance aufzulisten.

$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

In diesem Beispiel wird der Wert eines Schlüssels abgerufen, der im vorherigen Beispiel ermittelt wurde. Die IMDSv2-Anforderung verwendet das gespeicherte Token, das im vorhergehenden Beispielbefehl erstellt wurde. Das Token darf nicht abgelaufen sein.

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

Führen Sie den folgenden Befehl von Ihrer Linux-Instance aus, um alle Tag-Schlüssel für die Instance aufzulisten.

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

In diesem Beispiel wird der Wert eines Schlüssels abgerufen, der im vorherigen Beispiel ermittelt wurde.

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

Windows

Führen Sie das folgende cmdlet von Ihrer Windows-Instance aus, um alle Tag-Schlüssel für die Instance aufzulisten.

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

In diesem Beispiel wird der Wert eines Schlüssels abgerufen, der im vorherigen Beispiel ermittelt wurde.

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

Zugriff auf Tags in Instance-Metadaten deaktivieren

Sie können den Zugriff auf Instance-Tags in den Instance-Metadaten deaktivieren. Sie müssen den Zugriff auf Instance-Tags in Instance-Metadaten beim Start nicht deaktivieren, da dieser standardmäßig deaktiviert ist.

Console

So deaktivieren Sie den Zugriff auf Tags in Instance-Metadaten

1. Öffnen Sie die Amazon-EC2-Konsole unter https://console.aws.amazon.com/ec2/.

2. Wählen Sie im Navigationsbereich Instances aus.

3. Wählen Sie zuerst eine Instance aus und wählen Sie dann in den Instance settings (Instance-Einstellungen) unter Actions (Aktionen) die Option Allow tags in instance metadata (Zulassen von Tags in Instance-Metadaten).

4. Zum Deaktivieren des Zugriffs auf Tags in Instance-Metadaten deaktivieren Sie das Kontrollkästchen Zulassen.

5. Wählen Sie Speichern.

AWS CLI

So deaktivieren Sie den Zugriff auf Tags in Instance-Metadaten

Verwenden Sie den Befehl modify-instance-metadata-options.

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

PowerShell

So deaktivieren Sie den Zugriff auf Tags in Instance-Metadaten

Verwenden Sie das cmdlet Edit-EC2InstanceMetadataOption.

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