Formats de modèle

Vous pouvez créer CloudFormation des modèles dans JSON ou YAML formats. Les mêmes CloudFormation caractéristiques et fonctions sont disponibles pour les deux formats.

JSON

L'exemple suivant montre la structure d'un modèle JSON formaté avec toutes les sections disponibles.

{
  "AWSTemplateFormatVersion" : "version date",

  "Description" : "JSON string",

  "Metadata" : {
    template metadata
  },

  "Parameters" : {
    set of parameters
  },
  
  "Rules" : {
    set of rules
  },

  "Mappings" : {
    set of mappings
  },

  "Conditions" : {
    set of conditions
  },

  "Transform" : {
    set of transforms
  },

  "Resources" : {
    set of resources
  },
  
  "Outputs" : {
    set of outputs
  }
}

YAML

L'exemple suivant montre la structure d'un modèle YAML formaté avec toutes les sections disponibles.

---
AWSTemplateFormatVersion: "version date"

Description:
  String

Metadata:
  template metadata

Parameters:
  set of parameters

Rules:
  set of rules

Mappings:
  set of mappings

Conditions:
  set of conditions

Transform:
  set of transforms

Resources:
  set of resources

Outputs:
  set of outputs

S'agissant du format à privilégier, optez pour celui qui vous est le plus familier. Tenez également compte YAML du fait que certaines fonctionnalités, telles que les commentaires, ne sont pas disponibles dansJSON.

L'exemple suivant montre un YAML modèle avec des commentaires intégrés.

AWSTemplateFormatVersion: "2010-09-09"
Description: A sample template
Resources:
  MyEC2Instance: #An inline comment
    Type: "AWS::EC2::Instance"
    Properties: 
      ImageId: "ami-0ff8a91507f77f867" #Another comment -- This is a Linux AMI
      InstanceType: t2.micro
      KeyName: testkey
      BlockDeviceMappings:
        -
          DeviceName: /dev/sdm
          Ebs:
            VolumeType: io1
            Iops: 200
            DeleteOnTermination: false
            VolumeSize: 20

Spécifications

CloudFormation prend en charge les éléments suivants JSON et YAML les spécifications :

JSON

CloudFormation suit la JSON norme ECMA -404. Pour plus d'informations sur le JSON format, consultez http://www.json.org.

YAML

CloudFormation prend en charge la spécification de la YAML version 1.1 à quelques exceptions près. CloudFormation ne prend pas en charge les fonctionnalités suivantes :

• les balises binary, omap, pairs, set et timestamp ;

• Alias

• les fusions de hachage.

Pour plus d'informations surYAML, consultez https://yaml.org/.

En savoir plus

Pour chaque ressource que vous spécifiez dans votre modèle, vous définissez ses propriétés et ses valeurs à l'aide des règles de syntaxe spécifiques de l'un JSON ou de l'autreYAML. Pour plus d'informations sur la syntaxe des modèles pour chaque format, consultez Sections de modèle.