AWS CloudFormation
API Reference (API Version 2010-05-15)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

DescribeStackResource

Description

Returns a description of the specified resource in the specified stack.

For deleted stacks, DescribeStackResource returns resource information for up to 90 days after the stack has been deleted.

Request Parameters

For information about the common parameters that all actions use, see Common Parameters.

LogicalResourceId

The logical name of the resource as specified in the template.

Default: There is no default value.

Type: String

Required: Yes

StackName

The name or the unique identifier associated with the stack.

Default: There is no default value.

Type: String

Required: Yes

Response Elements

The following element is returned in a DescribeStackResourceResult structure.

StackResourceDetail

A StackResourceDetail structure containing the description of the specified resource in the specified stack.

Type: StackResourceDetail

Examples

Sample Request

https://cloudformation.us-east-1.amazonaws.com/
 ?Action=DescribeStackResource
 &StackName=MyStack
 &LogicalResourceId=MyDBInstance
 &Version=2010-05-15
 &SignatureVersion=2
 &Timestamp=2011-07-08T22%3A26%3A28.000Z
 &AWSAccessKeyId=[AWS Access KeyID]
 &Signature=[Signature]

Sample Response

<DescribeStackResourceResponse>
 <DescribeStackResourceResult>
  <StackResourceDetail>
      <StackId>arn:aws:cloudformation:us-east-1:123456789:stack/MyStack/aaf549a0-a413-11df-adb3-5081b3858e83</StackId>
      <StackName>MyStack</StackName>
      <LogicalResourceId>MyDBInstance</LogicalResourceId>
      <PhysicalResourceId>MyStack_DB1</PhysicalResourceId>
      <ResourceType>AWS::RDS::DBInstance</ResourceType>
      <LastUpdatedTimestamp>2011-07-07T22:27:28Z</LastUpdatedTimestamp>
      <ResourceStatus>CREATE_COMPLETE</ResourceStatus>
  </StackResourceDetail>
 </DescribeStackResourceResult>
</DescribeStackResourceResponse>