Editor de JSON e YAML integrado - AWS CloudFormation

Editor de JSON e YAML integrado

Use o editor de JSON e YAML integrado do Designer para visualizar e editar os detalhes do modelo. Por exemplo, você pode usar o editor integrado para definir as propriedades de um recurso ou alterar um parâmetro de modelo. O editor integrado tem duas visualizações: Components (Componentes) e Template (Modelo).

Para fazer alterações mínimas em uma seção específica de um modelo, use a visualização de Componentes. Na visualização de Componentes, os componentes que você pode editar estão divididos em guias. Essas guias são alteradas dependendo do recurso selecionado.

Por exemplo, caso você selecione um recurso, Designer fornece guias para editar as propriedades e os atributos do recurso, como uma política de atualização ou de criação. Caso você não tenha selecionado nada, o Designer fornece guias para editar os parâmetros de modelo, os mapeamentos, as condições, os metadados e as saídas. Todas as alterações que você faz na visualização de Componentes devem ser marcações válidas em JSON ou YAML. Se você introduzir marcações JSON ou YAML inválidas, o Designer reverterá a marcação inválida para uma marcação válida quando você deixar a visualização Components (Componentes).

Para fazer alterações amplas no modelo, use a visualização de Modelo. Na visualização de Template (Modelo), o editor de JSON e YAML integrado mostra o JSON ou o YAML bruto de todo o modelo. Quando você quiser fazer alterações em um recurso, selecione-o no painel de tela. O Designer destaca automaticamente esse recurso no editor de JSON e YAML integrado.

AWS CloudFormation Designer editor de JSON e YAML integrado


            Captura de tela do editor de JSON e YAML integrado com JSON bruto.

Conversão de modelos em YAML ou JSON

Você pode converter um modelo válido entre o JSON e o YAML selecionando o botão de opção apropriado em Choose template language (Escolher linguagem do modelo). O Designer só pode converter modelos JSON ou YAML válidos. Caso a conversão seja bem-sucedida, o painel Mensagens exibirá uma mensagem como: Conversão bem-sucedida do modelo em YAML.

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 preservará esses comentários ao editar o YAML ou converter em JSON. Se você editar ou modificar o modelo no Designer (por exemplo, se arrastar um recurso na tela), os comentários serão perdidos.

Assim que você escolher uma linguagem de modelo, todos os novos recursos que você arrastar para a tela serão criados na linguagem que selecionou. Para mudar de volta para a outra linguagem, verifique se o modelo é válido e, em seguida, selecione YAML ou JSON em Escolher linguagem do modelo.

nota

Quando você converte um modelo em YAML, o Designer usa a notação de forma curta para funções. Por exemplo, - !GetAtt. Além disso, todos os links visuais que você desenhar usará a notação de forma curta em modo YAML. Para obter mais informações sobre funções intrínsecas, consulte Ref.

Autocompletar

O editor de JSON e YAML integrado inclui um recurso de autocompletar que ajuda a especificar propriedades do recurso, de maneira que você não precise lembrar nomes de propriedade. Para ver uma lista de propriedades válidas em um modelo JSON, pressione Ctrl+Space dentro das Properties chaves ({}), conforme mostrado no seguinte exemplo:


            Opções de autopreencher em um exemplo de JSON.

Para um modelo YAML, você pode excluir primeiramente as chaves de abertura e fechamento e pressionar Enter a fim de ir para uma nova linha. Para ver uma lista de propriedades válidas, pressione Ctrl+Space na nova linha depois de Properties, conforme mostrado no seguinte exemplo:


            Opções de autopreencher em um exemplo de YAML.

Atalhos de teclado

O editor de JSON e YAML integrado do Designer fornece os seguintes atalhos de teclado:

Ctrl+Espaço

Na chave Properties de um recurso, lista todas as propriedades disponíveis para o recurso.

Ctrl+F

Procura um valor especificado.

Para destacar tudo o que corresponde ao valor especificado, pressione Alt+Enter.