Request Parameters Response Elements Errors Examples See Also

DescribeStackInstance

Returns the stack instance that's associated with the specified StackSet, AWS account, and AWS Region.

For a list of stack instances that are associated with a specific StackSet, use ListStackInstances.

Request Parameters

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

CallAs

[Service-managed permissions] Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account.

By default, SELF is specified. Use SELF for stack sets with self-managed permissions.

If you are signed in to the management account, specify SELF.
If you are signed in to a delegated administrator account, specify DELEGATED_ADMIN.

Your AWS account must be registered as a delegated administrator in the management account. For more information, see Register a delegated administrator in the AWS CloudFormation User Guide.

Type: String

Valid Values: SELF | DELEGATED_ADMIN

Required: No

StackInstanceAccount

The ID of an AWS account that's associated with this stack instance.

Type: String

Pattern: ^[0-9]{12}$

Required: Yes

StackInstanceRegion

The name of a Region that's associated with this stack instance.

Type: String

Pattern: ^[a-zA-Z0-9-]{1,128}$

Required: Yes

StackSetName

The name or the unique stack ID of the stack set that you want to get stack instance information for.

Type: String

Required: Yes

Response Elements

The following element is returned by the service.

StackInstance

The stack instance that matches the specified request parameters.

Type: StackInstance object

Errors

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

StackInstanceNotFound

The specified stack instance doesn't exist.

HTTP Status Code: 404

StackSetNotFound

The specified stack set doesn't exist.

HTTP Status Code: 404

Examples

DescribeStackInstance

This example illustrates one usage of DescribeStackInstance.

Sample Request


https://cloudformation.us-east-1.amazonaws.com/
 ?Action=DescribeStackInstance
 &StackInstanceRegion=ap-northeast-2
 &Version=2010-05-15
 &StackSetName=stack-set-example
 &StackInstanceAccount=012345678910
 &X-Amz-Algorithm=AWS4-HMAC-SHA256
 &X-Amz-Credential=[Access key ID and scope]
 &X-Amz-Date=20170810T233349Z
 &X-Amz-SignedHeaders=content-type;host
 &X-Amz-Signature=[Signature]

Sample Response


<DescribeStackInstanceResponse xmlns="http://internal.amazon.com/coral/com.amazonaws.maestro.service.v20160713/">
  <DescribeStackInstanceResult>
    <StackInstance>
      <DriftStatus>IN_SYNC</DriftStatus>
      <StackSetId>stack-set-example:45331555-4b18-45a1-aa43-ecf5example</StackSetId>
      <StackId>arn:aws:cloudformation:ap-northeast-2:012345678910:stack/StackSet-stack-set-example-0ca3eed7-0b67-4be7-8a71-828641fa5193/ea68eca0-f9c1-11e9-aac0-0aaexample</StackId>
      <ParameterOverrides/>
      <Region>ap-northeast-2</Region>
      <Account>012345678910</Account>
      <LastDriftCheckTimestamp>2019-12-03T20:01:04.511Z</LastDriftCheckTimestamp>
      <Status>CURRENT</Status>
    </StackInstance>
  </DescribeStackInstanceResult>
  <ResponseMetadata>
    <RequestId>afc959f5-a87c-4e16-95a9-ca25example</RequestId>
  </ResponseMetadata>
</DescribeStackInstanceResponse>