Dies ist das neue *CloudFormation Template Reference Guide*. Bitte aktualisieren Sie Ihre Lesezeichen und Links. Hilfe zu den ersten CloudFormation Schritten finden Sie im [AWS CloudFormation Benutzerhandbuch](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

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.

# cfn-get-metadata
<a name="cfn-get-metadata"></a>

Sie können das `cfn-get-metadata` Hilfsskript verwenden, um einen Metadatenblock aus der Standardausgabe abzurufen CloudFormation und ihn in die Standardausgabe zu drucken. Sie können zudem eine untergeordnete Struktur des Metadaten-Blocks drucken, wenn Sie einen Schlüssel angeben. Es werden jedoch nur Top-Level-Schlüssel unterstützt.

**Topics**
+ [Syntax](#cfn-get-metadata-Syntax)
+ [Optionen](#cfn-get-metadata-options)

## Syntax
<a name="cfn-get-metadata-Syntax"></a>

```
cfn-get-metadata --access-key {{access.key}} \
                 --secret-key {{secret.key}} \
                 --credential-file|f {{credential.file}} \
                 --key|k {{key}} \
                 --stack|-s {{stack.name.or.id}} \
                 --resource|-r {{logical.resource.id}} \
                 --role {{IAM.role.name}} \
                 --url|-u {{service.url}} \
                 --region {{region}}
```

**Anmerkung**  
Für `cfn-get-metadata` sind keine Berechtigungsnachweise erforderlich, so dass Sie die Optionen `--access-key`, `--secret-key`, `--role` oder `--credential-file` nicht verwenden müssen. Wenn jedoch keine Anmeldeinformationen angegeben werden, prüft CloudFormation auf Stack-Mitgliedschaft und schränkt den Geltungsbereich des Aufrufs desjenigen Stacks ein, zu dem die Instance gehört. Weitere Informationen finden Sie unter [Berechtigungen für Helferobjektskripte](cfn-helper-scripts-reference.md#cfn-helper-scripts-reference-permissions).

## Optionen
<a name="cfn-get-metadata-options"></a>


| Name | Description | Erforderlich | 
| --- | --- | --- | 
|  `-k, --key`  | Gibt bei einem Schlüssel-Werte-Paar den Namen des Schlüssels für den angegebenen Wert an.<br />*Typ:* Zeichenfolge<br />*Beispiel*: Bei `{ "Key1": "SampleKey1", "Key2": "SampleKey2" }` gibt `cfn-get-metadata -k Key2` `SampleKey2` aus. | Nein | 
|  `-s, --stack`  | Name des Stacks.<br />*Typ:* Zeichenfolge<br />*Standard*: Keiner<br />*Beispiel*: `-s { "Ref" : "AWS::StackName" },` | Ja | 
|  `-r, --resource`  | Die logische Ressourcen-ID der Ressource, die die Metadaten enthält.<br />*Typ:* Zeichenfolge<br />*Beispiel*: `-r WebServerHost` | Ja | 
| `--role` (nur Ressourcen-Signalisierung) | Der Name einer IAM-Rolle, die mit dieser Instance verknüpft ist.<br />*Typ:* Zeichenfolge<br />Bedingun: Der Dateiparameter Anmeldeinformationen hat Vorrang vor diesem Parameter. | Nein | 
|  `--region`  | Die Region, aus der die CloudFormation URL abgeleitet werden soll.<br />*Typ:* Zeichenfolge<br />*Standard*: Keiner<br />*Beispiel*: `--region ", { "Ref" : "AWS::Region" },` | Nein | 
|  `--access-key`  | AWS Zugriffsschlüssel für ein Konto mit DescribeStackResource Anrufberechtigung. CloudFormation<br />*Typ:* Zeichenfolge<br />Bedingun: Der Dateiparameter Anmeldeinformationen hat Vorrang vor diesem Parameter. | Bedingt | 
|  `--secret-key`  | AWS Geheimer Schlüssel, der dem angegebenen AWS Zugriffsschlüssel entspricht.<br />*Typ:* Zeichenfolge<br />Bedingun: Der Dateiparameter Anmeldeinformationen hat Vorrang vor diesem Parameter. | Bedingt | 
|  `-f, --credential-file`  | Eine Datei mit einem geheimen Zugriffsschlüssel und einem Zugriffsschlüssel.<br />*Typ:* Zeichenfolge<br />Bedingung: Der Dateiparameter Anmeldeinformationen hat Vorrang vor den Parametern Rolle, Zugriffschlüssel und geheimer Zugriffschlüssel. | Bedingt |