ListStackResources - Amazon CloudFormation
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

ListStackResources

Returns descriptions of all resources of the specified stack.

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

Request Parameters

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

NextToken

A string that identifies the next page of stack resources that you want to retrieve.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Required: No

StackName

The name or the unique stack ID that is associated with the stack, which aren't always interchangeable:

  • Running stacks: You can specify either the stack's name or its unique stack ID.

  • Deleted stacks: You must specify the unique stack ID.

Default: There is no default value.

Type: String

Required: Yes

Response Elements

The following elements are returned by the service.

NextToken

If the output exceeds 1 MB, a string that identifies the next page of stack resources. If no additional page exists, this value is null.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

StackResourceSummaries.member.N

A list of StackResourceSummary structures.

Type: Array of StackResourceSummary objects

Errors

For information about the errors that are common to all actions, see Common Errors.

Examples

ListStackResources

This example illustrates one usage of ListStackResources.

Sample Request

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

Sample Response

<ListStackResourcesResponse xmlns="http://cloudformation.amazonaws.com/doc/2010-05-15/"> <ListStackResourcesResult> <StackResourceSummaries> <member> <ResourceStatus>CREATE_COMPLETE</ResourceStatus> <LogicalResourceId>DBSecurityGroup</LogicalResourceId> <LastUpdatedTimestamp>2011-06-21T20:15:58Z</LastUpdatedTimestamp> <PhysicalResourceId>gmarcteststack-dbsecuritygroup-1s5m0ez5lkk6w</Physic alResourceId> <ResourceType>AWS::RDS::DBSecurityGroup</ResourceType> </member> <member> <ResourceStatus>CREATE_COMPLETE</ResourceStatus> <LogicalResourceId>SampleDB</LogicalResourceId> <LastUpdatedTimestamp>2011-06-21T20:25:57Z</LastUpdatedTimestamp> <PhysicalResourceId>MyStack-sampledb-ycwhk1v830lx</PhysicalResour ceId> <ResourceType>AWS::RDS::DBInstance</ResourceType> </member> <member> <ResourceStatus>CREATE_COMPLETE</ResourceStatus> <LogicalResourceId>SampleApplication</LogicalResourceId> <LastUpdatedTimestamp>2011-06-21T20:26:12Z</LastUpdatedTimestamp> <PhysicalResourceId>MyStack-SampleApplication-1MKNASYR3RBQL</Phys icalResourceId> <ResourceType>AWS::ElasticBeanstalk::Application</ResourceType> </member> <member> <ResourceStatus>CREATE_COMPLETE</ResourceStatus> <LogicalResourceId>SampleEnvironment</LogicalResourceId> <LastUpdatedTimestamp>2011-06-21T20:28:48Z</LastUpdatedTimestamp> <PhysicalResourceId>myst-Samp-1AGU6ERZX6M3Q</PhysicalResourceId> <ResourceType>AWS::ElasticBeanstalk::Environment</ResourceType> </member> <member> <ResourceStatus>CREATE_COMPLETE</ResourceStatus> <LogicalResourceId>AlarmTopic</LogicalResourceId> <LastUpdatedTimestamp>2011-06-21T20:29:06Z</LastUpdatedTimestamp> <PhysicalResourceId>arn:aws:sns:us-east-1:803981987763:MyStack-Al armTopic-SW4IQELG7RPJ</PhysicalResourceId> <ResourceType>AWS::SNS::Topic</ResourceType> </member> <member> <ResourceStatus>CREATE_COMPLETE</ResourceStatus> <LogicalResourceId>CPUAlarmHigh</LogicalResourceId> <LastUpdatedTimestamp>2011-06-21T20:29:23Z</LastUpdatedTimestamp> <PhysicalResourceId>MyStack-CPUAlarmHigh-POBWQPDJA81F</PhysicalRe sourceId> <ResourceType>AWS::CloudWatch::Alarm</ResourceType> </member> </StackResourceSummaries> </ListStackResourcesResult> <ResponseMetadata> <RequestId>2d06e36c-ac1d-11e0-a958-example</RequestId> </ResponseMetadata> </ListStackResourcesResponse>

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: