Aws Stackset Audit
Read-only operational audit of a CloudFormation StackSet and all of its stack
instances across accounts and regions. A single audit method fans out in one
locked execution — DescribeStackSet, paginated ListStackInstances, recent
ListStackSetOperations — and writes one summary resource plus one
instance resource per stack instance.
The summary carries the stackset config, a drift-detection rollup,
per-dimension counts (detailed/overall status, region, drift status, failure
category), recent operations, a ranked rootCauses grouping, detected
cross-instance anti-patterns, and a derived safeToReapply verdict. Each
instance carries account, region, detailed and overall status, status
reason, drift status, stack id, OU id, and a normalized failureCategory.
Read-only: only Describe* / List* are ever called, so the audit runs under
a *-readonly profile. It reports each instance's existing drift status as the
StackSet API returns it; triggering fresh drift detection is a separate,
mutating sibling extension. Compose them in a swamp workflow (drift-detect step
first, then this audit step with dependsOn: succeeded).
Global Arguments
| Argument | Type | Description |
|---|---|---|
| stackSetName | string | The name of the CloudFormation StackSet to audit (e.g. 'ExampleOrgBaseline'). |
| callAs | enum | Who you are calling as. SELF when signed in to the org management |
| region | string | Region of the CloudFormation endpoint to talk to. StackSet metadata is |
| profile | string | Named AWS profile to use (resolved via fromIni). Empty (default) uses |
| Argument | Type | Description |
|---|---|---|
| recentOperations | number | How many recent stackset operations to capture. |
Resources
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned