AWS CloudFormation
User Guide (API Version 2010-05-15)
« 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-resource

Description

Returns the description for the specified resource in the specified stack.

Note

The cfn-describe-stack-resource command returns information about deleted stacks for 90 days after they have been deleted.

Syntax

cfn-describe-stack-resource StackName common-options

Options

NameDescriptionRequired

StackName

The name of the stack containing the resource whose description you want to view.

You can also set this value using -s or --stack-name.

Type: String

Default: None

Yes

LogicalResourceId

The logical resource ID for the resource whose description you want to view.

You can also set this value using -l or --logical-resource-id.

Type: String

Default: None

Yes

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.

  • LAST_UPDATED_TIMESTAMP

    Time when the resource's status was last updated.

  • STATUS

    The current status of the resource.

  • STATUS_REASON

    More information about the resource status. To display this value, you must specify --show-long.

  • METADATA

    The JSON format content of the Metadata attribute declared for the resource. To display this value, you must specify --show-long or --show-xml. For more information, see Metadata.

AWS CloudFormation displays errors on stderr.

Examples

Example Request

This example returns the example-lb1 resource in the example-1 stack.

PROMPT> cfn-describe-stack-resource example-1 example-lb1

STACK_RESOURCE     LOGICAL_ID      PHYSICAL_ID                       TYPE                           LAST_UPDATED_TIMESTAMP      STATUS
STACK_RESOURCE     example-lb1     stack-1-example-lb1-2052137016    AWS::LoadBalancer              2011-07-11T15:39:56Z   	CREATE_COMPLETE