Visualizar um conjunto de alterações

Depois de criar um conjunto de alterações, você pode visualizar as alterações propostas antes da execução. Você pode usar o console do CloudFormation, a AWS CLI ou a API do CloudFormation para visualizar conjuntos de alterações. O console do CloudFormation fornece um resumo das alterações e uma lista detalhada delas no formato JSON. A AWS CLI e a API do AWS CloudFormation retornam uma lista detalhada das alterações em formato JSON.

View a change set for nested stack (console)

Para visualizar um conjunto de alterações para pilhas aninhadas (console)

No console do AWS CloudFormation, em Stacks (Pilhas), escolha o nome da pilha que contém o conjunto de alterações que deseja visualizar.
No painel de navegação, escolha Conjuntos de alterações para visualizar uma lista dos conjuntos de alterações da pilha.
Escolha o nome do conjunto de alterações que deseja visualizar.

O console do CloudFormation direcionará você para a página de detalhes do conjunto de alterações, onde poderá ver o horário em que o conjunto de alterações foi criado, o status, a entrada usada para gerá-lo e um resumo das alterações.

Na seção Changes (Alterações), cada linha representa um recurso para o qual o CloudFormation vai adicionar, modificar, remover ou mostrar o status de dinâmico.
- Adicionar – O CloudFormation cria um recurso quando você adicionar um recurso ao modelo da pilha.
- Modificar – O CloudFormationmodifica um recurso quando você altera as propriedades de um recurso no modelo da pilha.
- Remover – O CloudFormation exclui um recurso quando você exclui um recurso ao modelo da pilha.
- Dinâmico – O CloudFormation não pode determinar a ação exata de alteração de recurso com base no modelo da pilha aninhada.
nota
Uma modificação pode fazer com que o recurso seja interrompido ou substituído (recriado). Para obter mais informações sobre os comportamentos de atualização de recursos, consulte Atualizar comportamentos de recursos da pilha.

Para se concentrar em alterações específicas, use a visualização com filtro. Por exemplo, filtre por um determinado tipo de recurso, como AWS::CloudFormation::Stack. Para filtrar por um recurso específico, especifique o ID lógico ou físico, como DeadLetterQueue ou NestedStack.
Na seção Changes (Alterações), escolha View nested change set (Exibir conjunto de alterações aninhadas) do conjunto de alterações aninhadas que deseja visualizar.

O console do CloudFormation direciona você para a página de detalhes do conjunto de alterações aninhadas. Você pode escolher Go to root change set (Acessar o conjunto raiz de alterações) para visualizar o conjunto raiz de alterações ou escolher View parent change set (Exibir conjunto pai de alterações) para visualizar o conjunto pai de alterações. Para mais informações, consulte Conjuntos de alterações para pilhas aninhadas.
Na seção Alterações, escolha Visualizar detalhes na coluna Alterações no nível da propriedade para visualizar em detalhes as alterações feitas nos valores das propriedades de um recurso.
O console do CloudFormation direciona você para a página das alterações no nível de propriedade de um recurso, onde é possível ver a configuração do modelo do recurso antes da execução de um conjunto de alterações e como ficará a configuração do modelo depois que o conjunto de alterações for executado.

A tabela da seção de alterações no nível da propriedade mostra o Caminho, o Tipo de alteração, o Valor antes e o Valor depois das propriedades afetadas. Na tabela, escolha a caixa de seleção de cada alteração que você desejar realçar nas visualizações Antes e Depois do seu modelo para ver quais alterações serão feitas no nível da propriedade.
- Adicionar: as propriedades adicionadas são realçadas em verde.
- Modificar: as propriedades modificadas são realçadas em azul.
- Remover: as propriedades removidas são realçadas em vermelho.

View a change set (console)

Para visualizar um conjunto de alterações (console)

No console do AWS CloudFormation, em Stacks (Pilhas), escolha o nome da pilha que contém o conjunto de alterações que deseja visualizar.
No painel de navegação, escolha Change Sets (Conjuntos de alterações) para visualizar uma lista dos conjuntos de alterações da pilha.
Escolha o nome do conjunto de alterações que deseja visualizar.

O console do CloudFormation direcionará você para a página de detalhes do conjunto de alterações, onde poderá ver o horário em que o conjunto de alterações foi criado, o status, a entrada usada para gerá-lo e um resumo das alterações.

Na seção Alterações, cada linha representa um recurso que o CloudFormation vai adicionar, modificar ou remover.
- Adicionar – O CloudFormation cria um recurso quando você adicionar um recurso ao modelo da pilha.
- Modificar – O CloudFormationmodifica um recurso quando você altera as propriedades de um recurso no modelo da pilha.
- Remover – O CloudFormation exclui um recurso quando você exclui um recurso ao modelo da pilha.
nota
Uma modificação pode fazer com que o recurso seja interrompido ou substituído (recriado). Para obter mais informações sobre os comportamentos de atualização de recursos, consulte Atualizar comportamentos de recursos da pilha.

Para se concentrar em alterações específicas, use a visualização com filtro. Por exemplo, filtre por um determinado tipo de recurso, como AWS::EC2::Instance. Para filtrar por um recurso específico, especifique o ID lógico ou físico, como myWebServer ou i-123abcd4.
Na seção Alterações, escolha Visualizar detalhes na coluna Alterações no nível da propriedade para visualizar as alterações feitas nos valores das propriedades do recurso.
O console do CloudFormation direciona você para a página das alterações no nível de propriedade de um recurso, onde é possível ver a configuração do modelo do recurso antes da execução de um conjunto de alterações e como ficará a configuração do modelo depois que o conjunto de alterações for executado.

A tabela da seção de alterações no nível da propriedade mostra o Caminho, o Tipo de alteração, o Valor antes e o Valor depois das propriedades afetadas. Na tabela, escolha a caixa de seleção de cada alteração que você desejar realçar nas visualizações Antes e Depois do seu modelo para ver quais alterações serão feitas no nível da propriedade.
- Adicionar: as propriedades adicionadas são realçadas em verde.
- Modificar: as propriedades modificadas são realçadas em azul.
- Remover: as propriedades removidas são realçadas em vermelho.

Para visualizar um conjunto de alterações (AWS CLI)

Para obter o ID do conjunto de alterações, execute o comando aws cloudformation list-change-sets.

Especifique o ID da pilha que contém o conjunto de alterações que você deseja visualizar, como mostrado no exemplo a seguir:


$ aws cloudformation list-change-sets \
    --stack-name arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000

O CloudFormation retorna uma lista de conjuntos de alterações, semelhante a esta:


{
    "Summaries": [
        {
            "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000",
            "Status": "CREATE_COMPLETE",
            "ChangeSetName": "SampleChangeSet",
            "CreationTime": "2020-11-18T20:44:05.889Z",
            "StackName": "SampleStack",
            "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet/1a2345b6-0000-00a0-a123-00abc0abc000"
        },
        {
            "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000",
            "Status": "CREATE_COMPLETE",
            "ChangeSetName": "SampleChangeSet-conditional",
            "CreationTime": "2020-11-18T21:15:56.398Z",
            "StackName": "SampleStack",
            "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-conditional/1a2345b6-0000-00a0-a123-00abc0abc000"
        },
        {
            "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000",
            "Status": "CREATE_COMPLETE",
            "ChangeSetName": "SampleChangeSet-replacement",
            "CreationTime": "2020-11-18T21:03:37.706Z",
            "StackName": "SampleStack",
            "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-replacement/1a2345b6-0000-00a0-a123-00abc0abc000"
        }
    ]
}

Execute o comando aws cloudformation describe-change-set, especificando o ID do conjunto de alterações que você deseja visualizar. Por exemplo:


$ aws cloudformation describe-change-set --change-set-name arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet/1a2345b6-0000-00a0-a123-00abc0abc000

O CloudFormation retorna informações sobre o conjunto de alterações especificado:


{
    "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000",
    "Status": "CREATE_COMPLETE",
    "ChangeSetName": "SampleChangeSet-direct",
    "Parameters": [
        {
            "ParameterValue": "testing",
            "ParameterKey": "Purpose"
        },
        {
            "ParameterValue": "ellioty-useast1",
            "ParameterKey": "KeyPairName"
        },
        {
            "ParameterValue": "t2.micro",
            "ParameterKey": "InstanceType"
        }
    ],
    "Changes": [
        {
            "ResourceChange": {
                "ResourceType": "AWS::EC2::Instance",
                "PhysicalResourceId": "i-1abc23d4",
                "Details": [
                    {
                        "ChangeSource": "DirectModification",
                        "Evaluation": "Static",
                        "Target": {
                            "Attribute": "Tags",
                            "RequiresRecreation": "Never"
                        }
                    }
                ],
                "Action": "Modify",
                "Scope": [
                    "Tags"
                ],
                "LogicalResourceId": "MyEC2Instance",
                "Replacement": "False"
            },
            "Type": "Resource"
        }
    ],
    "CreationTime": "2020-11-18T23:35:25.813Z",
    "Capabilities": [],
    "StackName": "SampleStack",
    "NotificationARNs": [],
    "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-direct/9edde307-960d-4e6e-ad66-b09ea2f20255"
}

Use --include-property-values com describe-change-set para listar as alterações no nível da propriedade.

A chave Changes relaciona as alterações nos recursos. Se você executar esse conjunto de alterações, o CloudFormation poderá atualizar as tags da instância do EC2 i-1abc23d4. Para obter uma descrição de cada campo, consulte o tipo de dados Change, na Referência de APIs do AWS CloudFormation.

Para obter mais exemplos de conjuntos de alterações, consulte Exemplos de conjuntos de alterações.

Para visualizar as alterações no nível da propriedade em um conjunto de alterações (AWS CLI)

O comando a seguir lista as alterações no nível da propriedade relacionadas a um conjunto de alterações de um recurso AWS::EC2::NetworkInterface que removerá a propriedade Ipv4Prefixes, modificará a Description do recurso e adicionará uma Tag:


$ aws cloudformation describe-change-set --include-property-values --change-set-name arn:aws:cloudformation:us-east-1:123456789012:changeSet/ExampleChangeSet/9f7b541b-126b-44f7-998e-932174557841


"ChangeSetName": "ExampleChangeSet",
    "ChangeSetId": "arn:aws:cloudformation:us-east-1:803642222207:changeSet/ExampleChangeSet/9f7b541b-126b-44f7-998e-932174557841",
    "StackId": "arn:aws:cloudformation:us-east-1:803642222207:stack/ExampleStack/ab664180-f686-11ee-9e29-12cd92393671",
    "StackName": "ExampleStack",
    "Description": null,
    "Parameters": null,
    "CreationTime": "2024-04-09T18:04:59.935000+00:00",
    "ExecutionStatus": "AVAILABLE",
    "Status": "CREATE_COMPLETE",
    "StatusReason": null,
    "NotificationARNs": [],
    "RollbackConfiguration": {
        "RollbackTriggers": []
    },
    "Capabilities": [],
    "Tags": null,
    "ParentChangeSetId": null,
    "IncludeNestedStacks": true,
    "RootChangeSetId": null,
    "OnStackFailure": null,
 {
    "Changes": [
        {
            "Type": "Resource",
            "ResourceChange": {
                "Action": "Modify",
                "LogicalResourceId": "EC2NetworkInterface00eni067fd35b649a05b7100Tpyls",
                "PhysicalResourceId": "eni-067fd35b649a05b71",
                "ResourceType": "AWS::EC2::NetworkInterface",
                "Replacement": "False",
                "Scope": [
                    "Properties",
                    "Tags"
                ],
                "Details": [
                    {
                        "Target": {
                            "Attribute": "Properties",
                            "Name": "Ipv4Prefixes",
                            "RequiresRecreation": "Never",
                            "Path": "/Properties/Ipv4Prefixes",
                            "BeforeValue": "[]",
                            "AttributeChangeType": "Remove"
                        },
                        "Evaluation": "Static",
                        "ChangeSource": "DirectModification"
                    },
                    {
                        "Target": {
                            "Attribute": "Properties",
                            "Name": "Description",
                            "RequiresRecreation": "Never",
                            "Path": "/Properties/Description",
                            "BeforeValue": "",
                            "AfterValue": "Description",
                            "AttributeChangeType": "Modify"
                        },
                        "Evaluation": "Static",
                        "ChangeSource": "DirectModification"
                    },
                    {
                        "Target": {
                            "Attribute": "Tags",
                            "RequiresRecreation": "Never",
                            "Path": "/Properties/Tags/0",
                            "AfterValue": "{\"Key\":\"Test\",\"Value\":\"Test\"}",
                            "AttributeChangeType": "Add"
                        },
                        "Evaluation": "Static",
                        "ChangeSource": "DirectModification"
                    }
                ],
                "BeforeContext": "{\"Properties\":{\"Description\":\"\",\"PrivateIpAddress\":\"172.31.76.2\",\"PrivateIpAddresses\":[{\"PrivateIpAddress\":\"172.31.76.2\",\"Primary\":\"true\"}],\"SecondaryPrivateIpAddressCount\":\"0\",\"Ipv6PrefixCount\":\"0\",\"Ipv4Prefixes\":[],\"Ipv4PrefixCount\":\"0\",\"GroupSet\":[\"sg-05a45689b1059e82d\"],\"Ipv6Prefixes\":[],\"SubnetId\":\"subnet-455e8969\",\"SourceDestCheck\":\"true\",\"InterfaceType\":\"interface\",\"Tags\":[]},\"UpdateReplacePolicy\":\"Retain\",\"DeletionPolicy\":\"Retain\"}",
                "AfterContext": "{\"Properties\":{\"Description\":\"Description\",\"PrivateIpAddress\":\"172.31.76.2\",\"PrivateIpAddresses\":[{\"PrivateIpAddress\":\"172.31.76.2\",\"Primary\":\"true\"}],\"SecondaryPrivateIpAddressCount\":\"0\",\"Ipv6PrefixCount\":\"0\",\"Ipv4PrefixCount\":\"0\",\"GroupSet\":[\"sg-05a45689b1059e82d\"],\"Ipv6Prefixes\":[],\"SubnetId\":\"subnet-455e8969\",\"SourceDestCheck\":\"true\",\"InterfaceType\":\"interface\",\"Tags\":[{\"Value\":\"Test\",\"Key\":\"Test\"}]},\"UpdateReplacePolicy\":\"Retain\",\"DeletionPolicy\":\"Retain\"}"
            }
        }
    ],
    "ChangeSetName": "ExampleChangeSet",
    "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/ExampleChangeSet/9f7b541b-126b-44f7-998e-932174557841",
    "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/ExampleStack/ab664180-f686-11ee-9e29-12cd92393671",

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Criar um conjunto de alterações

Executar um conjunto de alterações