Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14132465739.8 KB

Returns summary information about stack instances that are associated with the specified stack set. You can filter for stack instances that are associated with a specific Amazon Web Services account name or Region, or that have a specific status.

get/#Action=ListStackInstances

Query parameters

StackSetNamestring required

The name or unique ID of the stack set that you want to list stack instances for.

NextTokenstring

If the previous request didn't return all the remaining results, the response's <code>NextToken</code> parameter value is set to a token. To retrieve the next set of results, call <code>ListStackInstances</code> again and assign that token to the request object's <code>NextToken</code> parameter. If there are no remaining results, the previous response object's <code>NextToken</code> parameter is set to <code>null</code>.

MaxResultsinteger

The maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a <code>NextToken</code> value that you can assign to the <code>NextToken</code> request parameter to get the next set of results.

Name'DETAILED_STATUS' | 'LAST_OPERATION_ID'

The type of filter to apply.

Valuesstring

The status to filter by.

The filter to apply to stack instances

StackInstanceAccountstring

The name of the Amazon Web Services account that you want to list stack instances for.

StackInstanceRegionstring

The name of the Region where you want to list stack instances.

CallAs'SELF' | 'DELEGATED_ADMIN'
<p>[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.</p> <p>By default, <code>SELF</code> is specified. Use <code>SELF</code> for stack sets with self-managed permissions.</p> <ul> <li> <p>If you are signed in to the management account, specify <code>SELF</code>.</p> </li> <li> <p>If you are signed in to a delegated administrator account, specify <code>DELEGATED_ADMIN</code>.</p> <p>Your Amazon Web Services account must be registered as a delegated administrator in the management account. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html">Register a delegated administrator</a> in the <i>CloudFormation User Guide</i>.</p> </li> </ul>
Action'ListStackInstances' required
Version'2010-05-15' required

Response

Success