Aws Stackset Drift Detect
Trigger CloudFormation StackSet drift detection and record its outcome — the
write-side sibling of @jentz/aws-stackset-audit. A single mutating detect
method calls DetectStackSetDrift for the configured stackset, polls
DescribeStackSetOperation to a terminal state (bounded by pollSeconds /
maxPolls), and writes one operation resource capturing the operation id,
action, terminal status, timestamps, and status reason.
It performs no instance audit and writes no summary/instance resources — that
is the read-only @jentz/aws-stackset-audit. Compose the two in a swamp
workflow: run this detect step first, then the audit step with
dependsOn: succeeded, so the audit reads the refreshed per-instance drift
status straight from AWS.
Mutating: it needs cloudformation:DetectStackSetDrift plus the stackset
admin role, so a *-readonly profile deliberately cannot run it. The
global-args shape (stackSetName, callAs, region, profile) is identical
to the audit sibling so a workflow wires the same inputs into both steps. Only
StackSet drift is in scope; stack-level DetectStackDrift is not.
Global Arguments
| Argument | Type | Description |
|---|---|---|
| stackSetName | string | The name of the CloudFormation StackSet to run drift detection on |
| 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 |
|---|---|---|
| pollSeconds | number | Seconds between operation status polls. |
| maxPolls | number | Maximum status polls before timing out. |
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