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.
# Référence des types de propriétés partagés
Cette section contient des informations de référence détaillées pour les types de propriétés compatibles CloudFormation avec plusieurs types de ressources.
**Topics**
+ [CloudFormation dénomination personnalisée des ressources](aws-properties-name.md)
+ [CloudFormation balisage des ressources](aws-properties-resource-tags.md)
# CloudFormation dénomination personnalisée des ressources
Vous pouvez attribuer des noms personnalisés aux types de ressources pris en charge dans votre CloudFormation modèle afin de les rendre plus significatifs et facilement identifiables. Par défaut, CloudFormation génère un identifiant physique unique pour nommer une ressource. Par exemple, CloudFormation vous pouvez nommer un compartiment Amazon S3 avec l'ID physique suivant`MyStack-MyBucket-abcdefghijk1`. Avec des noms personnalisés, vous pouvez définir un nom qui est plus facile à lire et à identifier, comme `production-app-logs` ou `business-metrics`.
Toutes les ressources ne prennent pas en charge les noms personnalisés. Chaque AWS service détermine indépendamment les types de ressources compatibles avec les noms personnalisés.
Les noms de ressource doivent être uniques dans l’ensemble de vos piles actives. Si vous réutilisez des modèles pour créer plusieurs piles, vous devez modifier ou supprimer les noms personnalisés à partir du modèle. Si vous ne spécifiez pas de nom, CloudFormation génère un identifiant physique unique pour nommer la ressource. Les noms doivent commencer par une lettre, doivent contenir uniquement des lettres ASCII, des chiffres et des tirets, et ne doivent pas se terminer par un tiret ni contenir deux tirets consécutifs.
De plus, ne gérez pas les ressources de la pile en dehors de CloudFormation. Par exemple, si vous renommez une ressource qui fait partie d'une pile sans l'utiliser CloudFormation, vous risquez de recevoir une erreur chaque fois que vous tentez de mettre à jour ou de supprimer cette pile.
**Important**
Vous ne pouvez pas effectuer une mise à jour qui entraîne le remplacement d'une ressource dont le nom est personnalisé. Si vous devez remplacer la ressource, spécifiez un nouveau nom.
## Exemple
Si vous souhaitez utiliser un nom personnalisé, définissez une propriété de nom pour cette ressource dans votre modèle CloudFormation . Chaque ressource qui prend en charge des noms personnalisés inclut sa propre propriété que vous spécifiez. Par exemple, pour nommer une table DynamoDB, utilisez la propriété `TableName` comme dans l'exemple suivant :
### JSON
```
"myDynamoDBTable" : {
"Type" : "AWS::DynamoDB::Table",
"Properties" : {
"KeySchema" : {
"HashKeyElement": {
"AttributeName" : "AttributeName1",
"AttributeType" : "S"
},
"RangeKeyElement" : {
"AttributeName" : "AttributeName2",
"AttributeType" : "N"
}
},
"ProvisionedThroughput" : {
"ReadCapacityUnits" : "5",
"WriteCapacityUnits" : "10"
},
"TableName" : "SampleTable"
}
}
```
### YAML
```
myDynamoDBTable:
Type: AWS::DynamoDB::Table
Properties:
KeySchema:
HashKeyElement:
AttributeName: "AttributeName1"
AttributeType: "S"
RangeKeyElement:
AttributeName: "AttributeName2"
AttributeType: "N"
ProvisionedThroughput:
ReadCapacityUnits: "5"
WriteCapacityUnits: "10"
TableName: "SampleTable"
```
# CloudFormation balisage des ressources
Vous pouvez appliquer des balises aux ressources en utilisant la `Tags` propriété de votre CloudFormation modèle, ce qui peut vous aider à identifier et à classer ces ressources.
Pour plus d’informations sur les ressources qui prennent en charge la propriété `Tags`, consultez les ressources individuelles dans la [référence des types de ressources et de propriétés AWS](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-template-resource-type-ref.html). Si une ressource ne prend pas encore en charge la propriété `Tags`, son service peut néanmoins prendre en charge le balisage au moyen de ses propres opérations API. Pour plus d’informations, référez-vous à la documentation spécifique à ce service.
Outre les balises que vous définissez, crée CloudFormation automatiquement les balises de niveau pile suivantes avec le préfixe : `aws:`
+ `aws:cloudformation:logical-id`
+ `aws:cloudformation:stack-id`
+ `aws:cloudformation:stack-name`
Le `aws:` préfixe est réservé à l' AWS usage. Ce préfixe n'est pas sensible à la casse. Si vous utilisez ce préfixe dans la propriété `Key` ou `Value`, vous ne pouvez pas mettre à jour ou supprimer la balise. Les balises avec ce préfixe ne sont pas prises en compte dans le nombre de balises par ressource.
La propagation des balises de pile vers les ressources, y compris celles portant le préfixe `aws:`, varie selon le type de ressource. Par exemple, les balises ne sont pas propagées dans les volumes Amazon EBS créés à partir de mappages de périphérique de stockage en mode bloc.
**Note**
Certaines ressources nécessitent des paramètres explicites pour propager les balises. Par exemple, la ressource `AWS::AutoScaling::AutoScalingGroup` doit avoir sa propriété `PropagateAtLaunch` définie sur `true` pour propager les balises vers ses instances EC2. Cependant, les balises au niveau de la pile sont automatiquement appliquées aux instances EC2, indépendamment du paramètre `PropagateAtLaunch`.
## Syntaxe
### JSON
```
{
"Key" : String,
"Value" : String
}
```
### YAML
```
Key: String
Value: String
```
## Propriétés
`Key`
Nom de clé de la balise. Vous pouvez spécifier une valeur comprise entre 1 et 128 caractères Unicode. Le préfixe `aws:` ne doit pas être utilisé. Les caractères suivants sont acceptés : l'ensemble des lettres Unicode, les chiffres, les espaces, `_`, `.`, `:`, `/`, `=`, `+`, `@`, `-` et `"`.
*Obligatoire* : oui
*Type* : chaîne
`Value`
Valeur de la balise. Vous pouvez spécifier une valeur comprise entre 1 et 256 caractères. Les caractères suivants sont acceptés : l'ensemble des lettres Unicode, les chiffres, les espaces, `_`, `.`, `/`, `=`, `+` et `-`.
*Obligatoire* : oui
*Type* : chaîne
## Exemple
Cet exemple illustre une propriété `Tags`. Vous devez spécifier cette propriété dans la section `Properties` d'une ressource qui la prend en charge. Lorsque la ressource est créée, la balise `Environment` est définie dynamiquement au moyen d’un paramètre, et la balise `Owner` est définie statiquement sur `MyName`.
### JSON
```
1. "Tags" : [
2. {
3. "Key" : "Environment",
4. "Value" : { "Ref": "Environment" }
5. },
6. {
7. "Key" : "Owner",
8. "Value" : "MyName"
9. }
10. ]
```
### YAML
```
1. Tags:
2. - Key: Environment
3. Value: !Ref Environment
4. - Key: Owner
5. Value: MyName
```
## Consultez aussi
+ [Configuration des options de pile](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html#configure-stack-options) dans le *Guide de l’utilisateur AWS CloudFormation *
+ [Affichage des données et des ressources de la CloudFormation pile AWS Management Console dans le](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-view-stack-data-resources.html) *guide de AWS CloudFormation l'utilisateur*