AWS CloudFormation
User Guide (API Version 2010-05-15)
AWS Documentation » AWS CloudFormation » User Guide » Command Line Tools Reference » cfn-describe-stack-resources
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.Did this page help you?  Yes | No |  Tell us about it...

cfn-describe-stack-resources

Description

Describe one or more member resources for one, or all of your running stacks.

If you do not provide either a stack or resource id, information for all running stacks and resources will be returned, up to a limit of 100 records.

Note

To list more than 100 resources use cfn-list-stack-resources instead.

Syntax

cfn-describe-stack-resources StackName common-options

Options

NameDescriptionRequired

-l, --logical-resource-id VALUE

The logical resource ID for a particular resource to describe. If you do not specify either a logical or physical resource ID, then all resources will be returned.

Type: String

Default: None

No

-p, --physical-resource-id VALUE

The physical resource ID for a particular resource to describe. If you do not specify either a logical or physical resource ID, then all resources will be returned.

Type: String

Default: None

No

-s, --stack-name

The name of the stack whose resources you want to describe. If you do not specify a stack, then resources for all of your running stacks and up to 90 days of your deleted stacks will be returned, up to a total of 100 resources.

Type: String

Default: None

No

Output

The command returns a table that contains the following information:

  • LOGICAL_ID

    Logical identifier for the resource

  • PHYSICAL_ID

    Physical identifier for the resource

  • TYPE

    Type of the resource

  • CREATED_TIME

    Time when the resource's status changed to CREATE_COMPLETE

  • STATUS

    The current status of the resource.

  • STATUS_REASON

    More information about the resource status.

AWS CloudFormation displays errors on stderr.

Examples

Example Request

This example describes the resources in the example-1 stack.

PROMPT> cfn-describe-stack-resources example-1

STACK_RESOURCE     LOGICAL_ID      PHYSICAL_ID                       TYPE                           CREATED_TIME        STATUS
STACK_RESOURCE     example-lb1     stack-1-example-lb1-2052137016    AWS::LoadBalancer              2009-04-15:39:56Z   CREATE_COMPLETE
STACK_RESOURCE     example-lc1     stack-1-example-lc1-2052137016    AWS::LaunchConfiguration       2009-04-16:45:00Z   CREATE_COMPLETE
Document Conventions« PreviousNext »
Terms of UseDid this page help you?  Yes | No |  Tell us about it...