Skip to main content

atmos aws cloudformation stackset instances

List a CloudFormation StackSet's stack instances (ListStackInstances) — each instance's account, region, status, and stack ID.

Experimental
atmos aws cloudformation stackset instances --help
 

Usage

atmos aws cloudformation stackset instances <component> --stack <stack> [options]
atmos aws cloudformation stackset instances vpc -s plat-ue2-dev

List instances for all or affected components in dependency order:

atmos aws cloudformation stackset instances --all -s plat-ue2-dev
atmos aws cloudformation stackset instances --affected --base origin/main

Flags

--stack, -s (required)
Atmos stack.
--all (optional)
List instances for all aws/cloudformation components in dependency order.
--affected (optional)
List instances for affected aws/cloudformation components and their dependencies.
--include-dependents (optional)
With --affected, include dependent aws/cloudformation components.
--tags (optional)
Filter by tags (comma-separated, matches any): --tags=production,tier-1. Composes with --all/--affected to narrow the selected set further; cannot be combined with a single component argument.
--labels (optional)
Filter by labels (comma-separated key=value or key:value pairs, matches all): --labels=cost-center=platform,compliance=sox. Composes with --all/--affected/--tags; cannot be combined with a single component argument.

Output

If the StackSet has no instances, stackset instances prints a single line saying so. Otherwise, each line shows the instance's account, region, status, and stack ID.

stackset instances acts directly on the StackSet whose name matches the component's stack_name — it takes no --target flag and does not need a kind: aws/stackset provision target declared.

note

stackset instances does not fire before/after hook events — only apply, diff, and delete do.