Get information about stacks

To explore the state and history of a particular stack, you can run a number of commands.

  1. To see which stacks are visible to the current user, run the following command:

    $ heat stack-list
    +--------------------------------------+---------------+-----------------+----------------------+
    | id                                   | stack_name    | stack_status    | creation_time        |
    +--------------------------------------+---------------+-----------------+----------------------+
    | 4c712026-dcd5-4664-90b8-0915494c1332 | mystack       | CREATE_COMPLETE | 2013-04-03T23:22:08Z |
    | 7edc7480-bda5-4e1c-9d5d-f567d3b6a050 | my-otherstack | CREATE_FAILED   | 2013-04-03T23:28:20Z |
    +--------------------------------------+---------------+-----------------+----------------------+
  2. To show the details of a stack, run the following command:

    $ heat stack-show mystack
  3. A stack consists of a collection of resources. To list the resources and their status, run the following command:

    $ heat resource-list mystack
    +---------------------+--------------------+-----------------+----------------------+
    | logical_resource_id | resource_type      | resource_status | updated_time         |
    +---------------------+--------------------+-----------------+----------------------+
    | WikiDatabase        | AWS::EC2::Instance | CREATE_COMPLETE | 2013-04-03T23:25:56Z |
    +---------------------+--------------------+-----------------+----------------------+
  4. To show the details for the specified resource in a stack, run the following command:

    $ heat resource-show mystack WikiDatabase

    Some resources have associated metadata which can change throughout the life-cycle of a resource:

    $ heat resource-metadata mystack WikiDatabase
  5. A series of events is generated during the life-cycle of a stack. This command displays those events:

    $ heat event-list mystack
    +---------------------+----+------------------------+-----------------+----------------------+
    | logical_resource_id | id | resource_status_reason | resource_status | event_time           |
    +---------------------+----+------------------------+-----------------+----------------------+
    | WikiDatabase        | 1  | state changed          | IN_PROGRESS     | 2013-04-03T23:22:09Z |
    | WikiDatabase        | 2  | state changed          | CREATE_COMPLETE | 2013-04-03T23:25:56Z |
    +---------------------+----+------------------------+-----------------+----------------------+
  6. To show the details for a particular event, run the following command:

    $ heat event-show WikiDatabase 1
Log a bug against this page

loading table of contents...