ListImports - AWS CloudFormation

ListImports

Lists all stacks that are importing an exported output value. To modify or remove an exported output value, first use this action to see which stacks are using it. To see the exported output values in your account, see ListExports.

For more information about importing an exported output value, see the Fn::ImportValue function.

Request Parameters

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

ExportName

The name of the exported output value. AWS CloudFormation returns the stack names that are importing this value.

Type: String

Required: Yes

NextToken

A string (provided by the ListImports response output) that identifies the next page of stacks that are importing the specified exported output value.

Type: String

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

Required: No

Response Elements

The following elements are returned by the service.

Imports.member.N

A list of stack names that are importing the specified exported output value.

Type: Array of strings

NextToken

A string that identifies the next page of exports. If there is no additional page, this value is null.

Type: String

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

Errors

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

Examples

ListExports

This example illustrates one usage of ListImports.

Sample Request

https://cloudformation.us-east-1.amazonaws.com/ ?Action=ListImports &ExportName=SampleStack-MyExportedValue &Version=2010-05-15 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=[Access key ID and scope] &X-Amz-Date=20160316T233349Z &X-Amz-SignedHeaders=content-type;host &X-Amz-Signature=[Signature]

Sample Response

<ListImportsResponse xmlns="http://cloudformation.amazonaws.com/doc/2010-05-15/"> <ListImportsResult> <Imports> <member>Import-SampleStack</member> </Imports> </ListImportsResult> <ResponseMetadata> <RequestId>a13656a8-a7b9-11e6-964c-41b56747ddb0</RequestId> </ResponseMetadata> </ListImportsResponse>

See Also

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