Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . cloudformation ]

list-stack-instances

Description

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 AWS account name or region.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  list-stack-instances
--stack-set-name <value>
[--next-token <value>]
[--max-results <value>]
[--stack-instance-account <value>]
[--stack-instance-region <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--stack-set-name (string)

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

--next-token (string)

If the previous request didn't return all of 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 .

--max-results (integer)

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.

--stack-instance-account (string)

The name of the AWS account that you want to list stack instances for.

--stack-instance-region (string)

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

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.

Output

Summaries -> (list)

A list of StackInstanceSummary structures that contain information about the specified stack instances.

(structure)

The structure that contains summary information about a stack instance.

StackSetId -> (string)

The name or unique ID of the stack set that the stack instance is associated with.

Region -> (string)

The name of the AWS region that the stack instance is associated with.

Account -> (string)

The name of the AWS account that the stack instance is associated with.

StackId -> (string)

The ID of the stack instance.

Status -> (string)

The status of the stack instance, in terms of its synchronization with its associated stack set.

  • INOPERABLE : A DeleteStackInstances operation has failed and left the stack in an unstable state. Stacks in this state are excluded from further UpdateStackSet operations. You might need to perform a DeleteStackInstances operation, with RetainStacks set to true , to delete the stack instance, and then delete the stack manually.
  • OUTDATED : The stack isn't currently up to date with the stack set because:
    • The associated stack failed during a CreateStackSet or UpdateStackSet operation.
    • The stack was part of a CreateStackSet or UpdateStackSet operation that failed or was stopped before the stack was created or updated.
  • CURRENT : The stack is currently up to date with the stack set.

StatusReason -> (string)

The explanation for the specific status code assigned to this stack instance.

NextToken -> (string)

If the request doesn't return all of the remaining results, NextToken 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 the request returns all results, NextToken is set to null .