

• O AWS Systems Manager CloudWatch Dashboard não estará mais disponível a partir de 30 de abril de 2026. Os clientes podem continuar usando o console do Amazon CloudWatch para visualizar, criar e gerenciar os painéis do Amazon CloudWatch exatamente como fazem hoje. Para obter mais informações, consulte a [documentação do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

# Usar Application Manager para gerenciar modelos do CloudFormation
<a name="application-manager-working-templates-overview"></a>

O Application Manager, uma ferramenta do AWS Systems Manager, inclui uma biblioteca de modelos e outras ferramentas para ajudar você a gerenciar modelos do AWS CloudFormation. Esta seção inclui as seguintes informações:

**Topics**
+ [Trabalhar com a biblioteca de modelos](#application-manager-working-stacks-template-library-working)
+ [Criar modelos](#application-manager-working-stacks-creating-template)
+ [Edite um modelo](#application-manager-working-stacks-editing-template)

## Trabalhar com a biblioteca de modelos
<a name="application-manager-working-stacks-template-library-working"></a>

A biblioteca de modelos do Application Manager fornece ferramentas para ajudar você a exibir, criar, editar, excluir e clonar modelos. Você também pode provisionar pilhas diretamente da biblioteca de modelos. Os modelos são armazenados como documentos do Systems Manager (SSM), do tipo `CloudFormation`. Ao armazenar modelos como documentos SSM, você poderá usar controles de versão para trabalhar com diferentes versões de um modelo. Você também pode definir permissões e compartilhar modelos. Depois de provisionar uma pilha com êxito, a pilha e o modelo estarão disponíveis no Application Manager e no CloudFormation. 

**Antes de começar**  
Recomendamos que você leia os tópicos a seguir para saber mais sobre os documentos SSM antes de começar a trabalhar com modelos do CloudFormation no Application Manager.
+ [Documentos do AWS Systems Manager](documents.md)
+ [Compartilhar documentos do Systems Manager](documents-ssm-sharing.md)
+ [Práticas recomendadas para documentos compartilhados do SSM](documents-ssm-sharing.md#best-practices-shared)

**Para visualizar a biblioteca de modelos no Application Manager**

1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. No painel de navegação, escolha **Application Manager**.

1. Selecione **Biblioteca de modelos do CloudFormation**.

## Criar modelos
<a name="application-manager-working-stacks-creating-template"></a>

O procedimento a seguir descreve como criar um modelo do CloudFormation no Application Manager. Ao criar um modelo, você insere os detalhes da pilha do modelo em JSON ou YAML. Se você não estiver familiarizado com JSON ou YAML, poderá usar o AWS Infrastructure Composer, uma ferramenta para criar e modificar modelos de maneira visual. Para obter mais informações, consulte [Criar modelos visualmente com o Infrastructure Composer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/infrastructure-composer-for-cloudformation.html) no *Guia do usuário do AWS CloudFormation*. Para obter informações sobre a estrutura e a sintaxe de um modelo, consulte [Seções de modelos do CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html), no *Guia do usuário do AWS CloudFormation*.

Você também pode construir um modelo a partir de vários trechos do modelo. Os trechos do modelo fornecem exemplos que demonstram como criar modelos para um recurso específico. Por exemplo, é possível visualizar trechos de instâncias do Amazon Elastic Compute Cloud (Amazon EC2), domínios do Amazon Simple Storage Service (Amazon S3), mapeamentos do CloudFormation e muito mais. Os trechos são agrupados por recurso. Você pode encontrar trechos do CloudFormation para fins gerais, na seção [Trechos de modelos gerais](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/quickref-general.html) do *Manual do usuário do AWS CloudFormation*. 

### Criar um modelo do CloudFormation usando o Application Manager (console)
<a name="application-manager-working-stacks-creating-template-console"></a>

Use o procedimento a seguir para criar um novo modelo do CloudFormation no Application Manager, usando o Console de gerenciamento da AWS.

**Para criar um modelo do CloudFormation no Application Manager**

1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. No painel de navegação, escolha **Application Manager**.

1. Selecione **Biblioteca de modelos do CloudFormation** e depois **Criar modelo** ou escolha um modelo existente e depois **Ações** e **Clonar**.

1. Para **Name** (Nome), insira um nome para o modelo que ajude você a identificar os recursos que ele cria ou a finalidade da pilha.

1. (Opcional) Em **Version name** (Nome da versão), insira um nome ou um número para identificar a versão do modelo.

1. Na seção **Code editor** (Editor de código), escolha **YAML** ou **JSON** e, em seguida, insira ou copie e cole o código do modelo.

1. (Opcional) Na seção **Tags**, aplique um ou mais pares de nome/valor de chave de tag ao modelo.

1. (Opcional) Na seção **Permissions** (Permissões), insira uma ID da Conta da AWS e escolha **Add account** (Adicionar conta). Essa ação fornece permissão de leitura para o modelo. O proprietário da conta pode provisionar e clonar o modelo, mas não pode editá-lo ou excluí-lo. 

1. Escolha **Criar**. O modelo é salvo no serviço de documentos do Systems Manager (SSM).

### Criar um modelo do CloudFormation usando o Application Manager (linha de comando)
<a name="application-manager-working-stacks-creating-template-cli"></a>

Depois de criar o conteúdo do modelo do CloudFormation no JSON ou no YAML, você poderá usar o AWS Command Line Interface (AWS CLI) ou Ferramentas da AWS para PowerShell para salvar o modelo como um documento do SSM. Substitua cada *espaço reservado para recurso de exemplo* por suas próprias informações.

**Antes de começar**  
Instale e configure a AWS CLI ou o Ferramentas da AWS para PowerShell, caso ainda não o tenha feito. Para obter informações, consulte [Instalar ou atualizar a versão mais recente da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) e [Instalar o Ferramentas da AWS para PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html).

------
#### [ Linux & macOS ]

```
aws ssm create-document \
    --content file://path/to/template_in_json_or_yaml \
    --name "a_name_for_the_template" \
    --document-type "CloudFormation" \
    --document-format "JSON_or_YAML" \
    --tags "Key=tag-key,Value=tag-value"
```

------
#### [ Windows ]

```
aws ssm create-document ^
    --content file://C:\path\to\template_in_json_or_yaml ^
    --name "a_name_for_the_template" ^
    --document-type "CloudFormation" ^
    --document-format "JSON_or_YAML" ^
    --tags "Key=tag-key,Value=tag-value"
```

------
#### [ PowerShell ]

```
$json = Get-Content -Path "C:\path\to\template_in_json_or_yaml | Out-String
New-SSMDocument `
    -Content $json `
    -Name "a_name_for_the_template" `
    -DocumentType "CloudFormation" `
    -DocumentFormat "JSON_or_YAML" `
    -Tags "Key=tag-key,Value=tag-value"
```

------

Se houver êxito, o comando retornará uma resposta semelhante à seguinte.

```
{
    "DocumentDescription": {
        "Hash": "c1d9640f15fbdba6deb41af6471d6ace0acc22f213bdd1449f03980358c2d4fb",
        "HashType": "Sha256",
        "Name": "MyTestCFTemplate",
        "Owner": "428427166869",
        "CreatedDate": "2021-06-04T09:44:18.931000-07:00",
        "Status": "Creating",
        "DocumentVersion": "1",
        "Description": "My test template",
        "PlatformTypes": [],
        "DocumentType": "CloudFormation",
        "SchemaVersion": "1.0",
        "LatestVersion": "1",
        "DefaultVersion": "1",
        "DocumentFormat": "YAML",
        "Tags": [
            {
                "Key": "Templates",
                "Value": "Test"
            }
        ]
    }
```

## Edite um modelo
<a name="application-manager-working-stacks-editing-template"></a>

Use o procedimento a seguir para editar um modelo do CloudFormation no Application Manager. As alterações do modelo estão disponíveis no CloudFormation depois de provisionar uma pilha que usa o modelo atualizado.

**Para editar um modelo do CloudFormation no Application Manager**

1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. No painel de navegação, escolha **Application Manager**.

1. Selecione **Biblioteca de modelos do CloudFormation**

1. Escolha um modelo e selecione **Actions** (Ações), **Edit** (Editar). Não é possível alterar o nome de um modelo, mas é possível alterar todos os outros detalhes.

1. Escolha **Salvar**. O modelo é salvo no serviço de documentos do Systems Manager.