Returns summary information about stack instances that are associated with the specified StackSet¶

Description¶

Returns summary information about stack instances that are associated with the specified StackSet. 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.

Usage¶

cloudformation_list_stack_instances(StackSetName, NextToken, MaxResults,
  Filters, StackInstanceAccount, StackInstanceRegion, CallAs)

Arguments¶

• StackSetName

  [required] The name or unique ID of the StackSet that you want to list stack instances for.

• NextToken

  The token for the next set of items to return. (You received this token from a previous call.)

• MaxResults

  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.

• Filters

  The filter to apply to stack instances

• StackInstanceAccount

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

• StackInstanceRegion

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

• 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 StackSets 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.

Value¶

A list with the following syntax:

list(
  Summaries = list(
    list(
      StackSetId = "string",
      Region = "string",
      Account = "string",
      StackId = "string",
      Status = "CURRENT"|"OUTDATED"|"INOPERABLE",
      StatusReason = "string",
      StackInstanceStatus = list(
        DetailedStatus = "PENDING"|"RUNNING"|"SUCCEEDED"|"FAILED"|"CANCELLED"|"INOPERABLE"|"SKIPPED_SUSPENDED_ACCOUNT"|"FAILED_IMPORT"
      ),
      OrganizationalUnitId = "string",
      DriftStatus = "DRIFTED"|"IN_SYNC"|"UNKNOWN"|"NOT_CHECKED",
      LastDriftCheckTimestamp = as.POSIXct(
        "2015-01-01"
      ),
      LastOperationId = "string"
    )
  ),
  NextToken = "string"
)

Request syntax¶

svc$list_stack_instances(
  StackSetName = "string",
  NextToken = "string",
  MaxResults = 123,
  Filters = list(
    list(
      Name = "DETAILED_STATUS"|"LAST_OPERATION_ID"|"DRIFT_STATUS",
      Values = "string"
    )
  ),
  StackInstanceAccount = "string",
  StackInstanceRegion = "string",
  CallAs = "SELF"|"DELEGATED_ADMIN"
)