Skip to content

/AWS1/CL_FRM=>LISTSTACKINSTANCES()

About ListStackInstances

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.

Method Signature

IMPORTING

Required arguments:

IV_STACKSETNAME TYPE /AWS1/FRMSTACKSETNAME /AWS1/FRMSTACKSETNAME

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

Optional arguments:

IV_NEXTTOKEN TYPE /AWS1/FRMNEXTTOKEN /AWS1/FRMNEXTTOKEN

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

IV_MAXRESULTS TYPE /AWS1/FRMMAXRESULTS /AWS1/FRMMAXRESULTS

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 NextToken value that you can assign to the NextToken request parameter to get the next set of results.

IT_FILTERS TYPE /AWS1/CL_FRMSTACKINSTFILTER=>TT_STACKINSTANCEFILTERS TT_STACKINSTANCEFILTERS

The filter to apply to stack instances

IV_STACKINSTANCEACCOUNT TYPE /AWS1/FRMACCOUNT /AWS1/FRMACCOUNT

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

IV_STACKINSTANCEREGION TYPE /AWS1/FRMREGION /AWS1/FRMREGION

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

IV_CALLAS TYPE /AWS1/FRMCALLAS /AWS1/FRMCALLAS

[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 Amazon Web Services account must be registered as a delegated administrator in the management account. For more information, see Register a delegated administrator in the CloudFormation User Guide.

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_FRMLISTSTACKINSTSOUT /AWS1/CL_FRMLISTSTACKINSTSOUT