Descripción y publicación de pilas

Puede utilizar dos comandos de la AWS CLI para obtener información sobre sus pilas de AWS CloudFormation: aws cloudformation list-stacks y aws cloudformation describe-stacks.

nota

Consulte Recursos de AWS CloudFormation para leer un análisis sobre la forma en que las políticas de IAM pueden limitar las acciones de un usuario con estos dos comandos de la AWS CLI.

aws cloudformation list-stacks

El comando aws cloudformation list-stacks le permite obtener una lista de cualquiera de las pilas que haya creado (incluso las que se han eliminado hace 90 días). Puede utilizar una opción para filtrar los resultados por el estado de la pila como, por ejemplo, CREATE_COMPLETE y DELETE_COMPLETE. El comando aws cloudformation list-stacks devuelve información resumida sobre cualquiera de las pilas en ejecución o eliminadas, incluido el nombre, identificador de pila, plantilla y estado.

nota

El comando aws cloudformation list-stacks devuelve información sobre pilas eliminadas hace 90 días una vez que se hayan eliminado.

En el siguiente ejemplo, se muestra un resumen de todas las pilas que tienen el estado CREATE_COMPLETE.

$ 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

El comando aws cloudformation describe-stacks proporciona información sobre las pilas que se están ejecutando. Puede utilizar una opción para filtrar los resultados en un nombre de pila. Este comando devuelve información sobre la pila, incluido el nombre, el identificador de pila y el estado.

En el siguiente ejemplo, se muestra un resumen de la información de la pila myteststack.

$ 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
        }
    ]
}

Si no utiliza la opción --stack-name para limitar la salida a una pila, se devuelve información sobre todas las pilas que se están ejecutando.

Códigos de estado de pilas

Puede especificar uno o varios códigos de estado de pila para ver únicamente pilas con los códigos de estado especificados. En la siguiente tabla se describe cada código de estado de pila:

Estado de la pila y estado detallado opcional	Descripción
CREATE_COMPLETE	Creación correcta de una o varias pilas.
CREATE_IN_PROGRESS	Creación continua de una o varias pilas.
CREATE_FAILED	Creación incorrecta de una o varias pilas. Consulte los eventos de pila para ver los mensajes de error asociados. Algunos de los posibles motivos de que la creación no se haya realizado correctamente incluyen la falta de permisos para trabajar con todos los recursos de pila, el rechazo de los valores de los parámetros por parte de un servicio de AWS o que se ha agotado el tiempo de espera durante la creación del recurso.
DELETE_COMPLETE	Eliminación correcta de una o varias pilas. Las pilas eliminadas se conservan y se pueden ver durante 90 días.
DELETE_FAILED	Eliminación incorrecta de una o varias pilas. Dado que la eliminación no se ha realizado correctamente, es posible que algunos recursos aún se sigan ejecutando; sin embargo, no puede trabajar ni actualizar la pila. Vuelva a eliminar la pila o consulte los eventos de la pila para ver los mensajes de error asociados.
DELETE_IN_PROGRESS	Eliminación continua de una o varias pilas.
REVIEW_IN_PROGRESS	Creación continua de una o varias pilas con un StackId esperado, pero sin plantillas ni recursos. importante Una pila con este código de estado cuenta para el número máximo posible de pilas.
ROLLBACK_COMPLETE	Eliminación correcta de una o varias pilas después de un error en la creación de la pila o después de que se haya cancelado explícitamente la creación de la pila. La pila vuelve al estado anterior de trabajo. Se eliminan todos los recursos que se hayan creado durante la acción de creación de pila. Este estado solo existe después de la creación fallida de una pila. Esto significa que todas las operaciones de la pila creada parcialmente se ha limpiado de forma apropiada. Cuando en este estado, solo puede realizarse una operación de eliminación.
ROLLBACK_FAILED	Eliminación incorrecta de una o varias pilas después de un error en la creación de pila o después de que se haya cancelado explícitamente la creación de pila. Elimine la pila o consulte los eventos de pila para ver los mensajes de error asociados.
ROLLBACK_IN_PROGRESS	Eliminación continua de una o varias pilas después de un error en la creación de pila o después de que se haya cancelado explícitamente la creación de pila.
UPDATE_COMPLETE	Actualización correcta de una o varias pilas.
UPDATE_COMPLETE_CLEANUP_IN_PROGRESS	Eliminación continua de recursos antiguos para una o varias pilas después de una actualización correcta de las pilas. Para las actualizaciones de pilas que requieren que se sustituyan los recursos, CloudFormation crea los nuevos recursos en primer lugar y, a continuación, elimina los antiguos para ayudar a reducir interrupciones con la pila. En este estado, la pila se ha actualizado y se puede utilizar, pero CloudFormation sigue eliminando los recursos antiguos.
UPDATE_FAILED	Actualización incorrecta de una o varias pilas. Consulte los eventos de pila para ver los mensajes de error asociados.
UPDATE_IN_PROGRESS	Actualización continua de una o varias pilas.
UPDATE_ROLLBACK_COMPLETE	Recuperación correcta del estado activo anterior de una o varias pilas después de un error en la actualización de las pilas.
UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS	Eliminación continua de recursos nuevos para una o varias pilas después de una actualización incorrecta de las pilas. En este estado, se ha restaurado el estado anterior de la pila y se puede utilizar, pero CloudFormation sigue eliminando los nuevos recursos que ha creado durante la actualización de la pila.
UPDATE_ROLLBACK_FAILED	Restauración incorrecta del estado activo anterior de una o varias pilas después de un error en la actualización de las pilas. En este estado, puede eliminar la pila o continuar con la restauración. Probablemente necesite corregir errores antes de que la pila vuelva a estar operativa. También puede contactar con AWS Support para restaurar la pila a un estado útil.
UPDATE_ROLLBACK_IN_PROGRESS	Recuperación continua del estado activo anterior de una o varias pilas después de un error en la actualización de las pilas.
IMPORT_IN_PROGRESS	La operación de importación está actualmente en curso.
IMPORT_COMPLETE	La operación de importación se ha completado correctamente para todos los recursos de la pila compatibles con resource import.
IMPORT_ROLLBACK_IN_PROGRESS	La importación volverá a la configuración de la plantilla anterior.
IMPORT_ROLLBACK_FAILED	La operación de restauración de importación ha generado un error para un recurso de la pila como mínimo. Los resultados estarán disponibles para los recursos que CloudFormation haya importado correctamente.
IMPORT_ROLLBACK_COMPLETE	La importación ha vuelto correctamente a la configuración de plantilla anterior.