Formatos de modelo do AWS CloudFormation - AWS CloudFormation

Formatos de modelo do AWS CloudFormation

Você pode criar modelos do AWS CloudFormation no formato JSON ou YAML. Oferecemos suporte a todos os recursos e funções do AWS CloudFormation em ambos os formatos, inclusive no AWS CloudFormation Designer.

Ao decidir qual formato usar, escolha aquele com o qual você está mais familiarizado. Considere também que o YAML fornece alguns recursos de forma inerente, como comentários, que não estão disponíveis no formato JSON.

Importante

É recomendável não adicionar comentários do # YAML aos modelos no Designer. Se o modelo YAML tiver comentários #, o Designer não os preservará ao converter o modelo em JSON. Além disso, se você modificar o modelo no Designer (por exemplo, ao mover um recurso na tela), seus comentários serão perdidos.

Você pode adicionar comentários aos modelos do AWS CloudFormation criados fora do Designer. O exemplo a seguir mostra um modelo YAML com comentários em linha.

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

Para obter mais informações sobre a sintaxe de modelo de cada formato, consulte Anatomia do modelo.

O AWS CloudFormation é compatível com as seguintes especificações JSON e YAML:

JSON

O AWS CloudFormation segue o padrão JSON ECMA-404. Para obter mais informações sobre o formato JSON, consulte http://www.json.org.

YAML

O AWS CloudFormation é compatível com a especificação YAML Versão 1.1, com algumas exceções. O AWS CloudFormation não é compatível com os seguintes recursos:

  • As tags binary, omap, pairs, set e timestamp

  • Aliases

  • Mesclagens de hash

Para obter mais informações sobre o YAML, consulte https://yaml.org/.