Descrever e listar pilhas

Você pode usar dois comandos da AWS CLI para receber informações sobre as pilhas do AWS CloudFormation: aws cloudformation list-stacks e aws cloudformation describe-stacks.

nota

Consulte Recursos do AWS CloudFormation para acessar uma discussão de como as políticas do IAM podem limitar o que um usuário pode fazer com esses dois comandos da AWS CLI.

aws cloudformation list-stacks

O comando aws cloudformation list-stacks permite que você obtenha uma lista de qualquer uma das pilhas que você criou (mesmo daquelas que foram excluídas até 90 dias). Você pode usar uma opção para filtrar resultados por status da pilha, como CREATE_COMPLETE e DELETE_COMPLETE. O comando aws cloudformation list-stacks retorna informações resumidas sobre qualquer uma das pilhas em execução ou excluídas, incluindo o nome, o identificador de pilha, modelo e status.

nota

O comando aws cloudformation list-stacks retorna informações sobre as pilhas excluídas por 90 dias após a exclusão.

O exemplo a seguir mostra um resumo de todas as pilhas que têm um status de CREATE_COMPLETE.

PROMPT> aws cloudformation list-stacks --stack-status-filter CREATE_COMPLETE
[
    {
        "StackId": "arn:aws:cloudformation:us-east-2:123456789012:stack/myteststack/
644df8e0-0dff-11e3-8e2f-5088487c4896",
        "TemplateDescription": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an
S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.",
        "StackStatusReason": null,
        "CreationTime": "2013-08-26T03:27:10.190Z",
        "StackName": "myteststack",
        "StackStatus": "CREATE_COMPLETE"
    }
]

aws cloudformation describe-stacks

O comando aws cloudformation describe-stacks fornece informações sobre as pilhas em execução. Você pode usar uma opção para filtrar resultados em um nome da pilha. Este comando retorna informações sobre a pilha, incluindo o nome, o identificador de pilha e o status.

O exemplo a seguir mostra as informações resumidos da pilha myteststack.

PROMPT> aws cloudformation describe-stacks --stack-name myteststack
{
    "Stacks":  [
        {
            "StackId": "arn:aws:cloudformation:us-east-2:123456789012:stack/myteststack/a69442d0-0b8f-11e3-8b8a-500150b352e0",
            "Description": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an S3 bucket.
You will be billed for the AWS resources used if you create a stack from this template.",
            "Tags": [],
            "Outputs": [
                {
                    "Description": "Name of S3 bucket to hold website content",
                    "OutputKey": "BucketName",
                    "OutputValue": "myteststack-s3bucket-jssofi1zie2w"
                }
            ],
            "StackStatusReason": null,
            "CreationTime": "2013-08-23T01:02:15.422Z",
            "Capabilities": [],
            "StackName": "myteststack",
            "StackStatus": "CREATE_COMPLETE",
            "DisableRollback": false
        }
    ]
}

Se você não usar a opção --stack-name para limitar a saída para uma pilha, informações sobre todas as suas pilhas em execução serão retornadas.

Códigos de status da pilha

Você pode especificar um ou mais códigos de status da pilha para listar apenas as pilhas com os códigos de status especificados. A tabela a seguir descreve cada código de status da pilha:

Status da pilha	Descrição
CREATE_COMPLETE	Criação bem-sucedida de uma ou mais pilhas.
CREATE_IN_PROGRESS	Criação contínua de uma ou mais pilhas.
CREATE_FAILED	Criação malsucedida de uma ou mais pilhas. Visualize os eventos da pilha para ver as mensagens de erro associadas. As possíveis razões para uma falha na criação incluem permissões insuficientes para trabalhar com todos os recursos na pilha, valores de parâmetro rejeitados por um produto da AWS ou um tempo limite durante a criação de recursos.
DELETE_COMPLETE	Exclusão bem-sucedida de uma ou mais pilhas. As pilhas excluídas serão retidas e poderão ser visualizadas por 90 dias.
DELETE_FAILED	Exclusão malsucedida de uma ou mais pilhas. Como a exclusão falhou, alguns recursos ainda poderão estar em execução. No entanto, não é possível trabalhar com a pilha, tampouco atualizá-la. Exclua a pilha novamente ou visualize os eventos de pilha para ver as mensagens de erro associadas.
DELETE_IN_PROGRESS	Remoção contínua de uma ou mais pilhas.
REVIEW_IN_PROGRESS	Criação contínua de uma ou mais pilhas com um StackId esperado, mas sem modelos ou recursos. Importante Uma pilha com este código de status conta contra o número máximo possível de pilhas.
ROLLBACK_COMPLETE	Remoção bem-sucedida de uma ou mais pilhas após uma falha na criação de uma pilha ou após um cancelamento explícito da criação de uma pilha. A pilha retorna ao estado operacional anterior. Quaisquer recursos criados durante a ação de criação da pilha serão excluídos. Esse status ocorre somente após uma falha de criação de uma pilha. Ele significa que todas as operações da pilha parcialmente criada foram adequadamente limpas. Ao entrar nesse estado, a única operação possível é a exclusão.
ROLLBACK_FAILED	Remoção malsucedida de uma ou mais pilhas após uma falha na criação de uma pilha ou após um cancelamento explícito da criação de uma pilha. Exclua a pilha ou visualize os eventos de pilha para ver as mensagens de erro associadas.
ROLLBACK_IN_PROGRESS	Remoção contínua de uma ou mais pilhas após uma falha na criação de uma pilha ou após um cancelamento explícito da criação de uma pilha.
UPDATE_COMPLETE	Atualização bem-sucedida de uma ou mais pilhas.
UPDATE_COMPLETE_CLEANUP_IN_PROGRESS	Remoção contínua de recursos antigos para uma ou mais pilhas após uma atualização bem-sucedida da pilha. Para atualizações de pilha que exigem a substituição de recursos, o CloudFormation cria os novos recursos primeiro e, em seguida, exclui os recursos antigos para ajudar a reduzir as interrupções com a pilha. Nesse estado, a pilha foi atualizado e é utilizável, mas o CloudFormation ainda está excluindo os recursos antigos.
UPDATE_FAILED	Atualização bem-sucedida de uma ou mais pilhas. Visualize os eventos da pilha para ver as mensagens de erro associadas.
UPDATE_IN_PROGRESS	Atualização contínua de uma ou mais pilhas.
UPDATE_ROLLBACK_COMPLETE	Retorno bem-sucedido de uma ou mais pilhas para um estado de trabalho anterior após uma falha na atualização da pilha.
UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS	Remoção contínua de recursos novos para uma ou mais pilhas após uma atualização falha da pilha. Nesse estado, a pilha foi revertida para seu estado de trabalho anterior e é utilizável, mas o CloudFormation ainda está excluindo os recursos novos criados durante a atualização da pilha.
UPDATE_ROLLBACK_FAILED	Retorno malsucedido de uma ou mais pilhas para um estado de trabalho anterior após uma falha na atualização da pilha. Quando estiver neste estado, você pode excluir a pilha ou continuar a reversão. Talvez você precise corrigir erros para que a pilha possa retornar a um estado operacional. Se preferir, entre em contato com o AWS Support para restaurar a pilha para um estado utilizável.
UPDATE_ROLLBACK_IN_PROGRESS	Retorno contínuo de uma ou mais pilhas para o estado de trabalho anterior após falha na atualização da pilha.
IMPORT_IN_PROGRESS	A operação de importação está em andamento.
IMPORT_COMPLETE	A operação de importação foi concluída com êxito para todos os recursos da pilha que oferecem suporte a resource import.
IMPORT_ROLLBACK_IN_PROGRESS	A importação será revertida para a configuração do modelo anterior.
IMPORT_ROLLBACK_FAILED	Houve uma falha na operação de reversão de importação para pelo menos um recurso na pilha. Os resultados serão disponibilizados para os recursos importados com êxito pelo CloudFormation.
IMPORT_ROLLBACK_COMPLETE	A importação foi revertida com êxito para a configuração de modelo anterior.