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.
Sections de modèle
CloudFormation les modèles sont divisés en différentes sections, et chaque section est conçue pour contenir un type d'information spécifique. Certaines sections doivent être déclarées dans un ordre précis, tandis que pour d'autres, l'ordre n'a pas d'importance. Toutefois, lorsque vous créez un modèle, il peut être utile de vous baser sur l'ordre logique indiqué dans la liste suivante, car les valeurs d'une section peuvent faire référence à celles d'une section précédente.
Important
Lorsque vous créez des modèles, n'utilisez pas de sections principales dupliquées, telles que la Resources section. Bien qu'il soit CloudFormation possible d'accepter le modèle, celui-ci aura un comportement indéfini lors du traitement du modèle et risque de fournir des ressources de manière incorrecte ou de renvoyer des erreurs inexplicables.
- Version de format (facultative)
-
Version du CloudFormation modèle à laquelle le modèle est conforme.
- Description (facultative)
-
Chaîne de texte qui décrit le modèle. Cette section doit toujours suivre la section de version du format du modèle.
- Métadonnées (facultatives)
-
Objets qui fournissent des informations supplémentaires sur le modèle.
- Paramètres (facultatifs)
-
Les valeurs à transmettre au modèle lors de l'exécution (lorsque vous créez ou mettez à jour une pile). Vous pouvez faire référence aux paramètres dans les sections
ResourcesetOutputsdu modèle. - Règles (facultatif)
-
Valide un paramètre ou une combinaison de paramètres transmis à un modèle lors d'une création ou d’une mise à jour de pile.
- Mappages (facultatifs)
-
Mappage de clés et de valeurs associées que vous pouvez utiliser pour spécifier des valeurs de paramètres conditionnelles, comme pour une table de recherche. Vous pouvez associer une clé à une valeur correspondante en utilisant la fonction FindInMap intrinsèque Fn : : dans les
OutputssectionsResourceset. - Conditions (facultatives)
-
Conditions déterminant si certaines ressources sont créées ou si une valeur est attribuée à certaines propriétés de ressources pendant la création ou la mise à jour de la pile. Par exemple, vous pouvez créer une ressource de manière conditionnelle, laquelle varie selon que la pile est destinée à un environnement de production ou de test.
- Transformation (facultative)
-
Pour les applications sans serveur (également appelées applications basées sur Lambda), spécifie la version du modèle d'application AWS sans serveur (AWS SAM
) à utiliser. Lorsque vous spécifiez une transformation, vous pouvez utiliser la syntaxe AWS SAM afin de déclarer des ressources dans votre modèle. Le modèle définit la syntaxe que vous pouvez utiliser et comment elle est traitée. Vous pouvez également utiliser les transformations de AWS::Includetransformation pour travailler avec des extraits de modèle stockés séparément du modèle principal CloudFormation . Vous pouvez stocker vos fichiers d'extrait dans un compartiment Amazon S3, puis réutiliser les fonctions entre plusieurs modèles.
- Ressources (obligatoires)
-
Spécifie les ressources de la pile et leurs propriétés, telles qu'une instance Amazon EC2 ou un compartiment Amazon S3. Vous pouvez faire référence à des ressources dans les sections
ResourcesetOutputsdu modèle. - Sorties (facultatives)
-
Décrit les valeurs qui sont renvoyées chaque fois que vous affichez les propriétés de la pile. Par exemple, vous pouvez déclarer une sortie pour le nom d'un compartiment S3, puis appeler la describe-stacks AWS CLI commande pour afficher le nom.
