Il s’agit du nouveau *Guide de référence des modèles CloudFormation *. Veuillez mettre à jour vos favoris et vos liens. Pour obtenir de l'aide pour démarrer CloudFormation, consultez le [guide de AWS CloudFormation l'utilisateur](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Vous pouvez utiliser le script d'`cfn-get-metadata`assistance pour récupérer un bloc de métadonnées CloudFormation et l'imprimer sur la sortie standard. Vous pouvez également imprimer une sous-arborescence du bloc de métadonnées si vous spécifiez une clé. Toutefois, seules les clés de niveau supérieur sont prises en charge.

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

## Syntaxe
<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
```

**Note**  
`cfn-get-metadata` ne nécessite pas d’informations d’identification, vous n’avez donc pas besoin d’utiliser les options `--access-key`, `--secret-key`, `--role` ou `--credential-file`. Toutefois, si aucune information d'identification n'est spécifiée, CloudFormation vérifie l'appartenance de la pile et limite la portée de l'appel à la pile à laquelle l'instance appartient. Pour de plus amples informations, veuillez consulter [Autorisations pour les scripts d'assistant](cfn-helper-scripts-reference.md#cfn-helper-scripts-reference-permissions).

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


| Nom | Description | Obligatoire | 
| --- | --- | --- | 
|   `-k, --key`   |  Pour une paire clé-valeur, cette propriété renvoie le nom de la clé pour la valeur que vous avez spécifiée. *Type* : chaîne *Exemple* : pour `{ "Key1": "SampleKey1", "Key2": "SampleKey2" }`, `cfn-get-metadata -k Key2` renvoie `SampleKey2`.  |  Non  | 
|   `-s, --stack`   |  Nom de la pile. *Type* : chaîne *Par défaut* : aucun *Exemple* : `-s { "Ref" : "AWS::StackName" },`  |  Oui  | 
|   `-r, --resource`   |  ID de ressource logique de la ressource qui contient les métadonnées. *Type* : chaîne *Exemple* : `-r WebServerHost`  |  Oui  | 
|  `--role` (signalement de ressources uniquement)  |  Nom d'un rôle IAM associé à l'instance. *Type* : chaîne Condition : le paramètre du fichier d'informations d'identification prévaut sur ce paramètre.  |  Non  | 
|   `--region`   |  Région à partir de laquelle dériver l' CloudFormation URL. *Type* : chaîne *Par défaut* : aucun *Exemple* : `--region ", { "Ref" : "AWS::Region" },`  |  Non  | 
|   `--access-key`   |  AWS Clé d'accès pour un compte autorisé DescribeStackResource à appeler CloudFormation. *Type* : chaîne Condition : le paramètre du fichier d'informations d'identification prévaut sur ce paramètre.  |  Conditionnel  | 
|   `--secret-key`   |  AWS Clé secrète correspondant à la clé AWS d'accès spécifiée. *Type* : chaîne Condition : le paramètre du fichier d'informations d'identification prévaut sur ce paramètre.  |  Conditionnel  | 
|   `-f, --credential-file`   |  Fichier qui contient une clé d'accès secrète et une clé d'accès. *Type* : chaîne Condition : le paramètre du fichier d'informations d'identification supplante les paramètres --access-key et --secret-key.  |  Conditionnel  |