Skip to content

CloudFormation  >  Operations  >  describe_stack_resource_drifts

describe_stack_resource_drifts

Operation

describe_stack_resource_drifts async 

describe_stack_resource_drifts(input: DescribeStackResourceDriftsInput, plugins: list[Plugin] | None = None) -> DescribeStackResourceDriftsOutput

Returns drift information for the resources that have been checked for drift in the specified stack. This includes actual and expected configuration values for resources where CloudFormation detects configuration drift.

For a given stack, there will be one StackResourceDrift for each stack resource that has been checked for drift. Resources that haven't yet been checked for drift aren't included. Resources that don't currently support drift detection aren't checked, and so not included. For a list of resources that support drift detection, see Resource type support for imports and drift detection.

Use DetectStackResourceDrift to detect drift on individual resources, or DetectStackDrift to detect drift on all supported resources for a given stack.

Parameters:

Name Type Description Default
input DescribeStackResourceDriftsInput

An instance of DescribeStackResourceDriftsInput.

 required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

 None

Returns:

Type Description
DescribeStackResourceDriftsOutput

An instance of DescribeStackResourceDriftsOutput.

Input

DescribeStackResourceDriftsInput dataclass

Bases: _SerdeShape

Dataclass for DescribeStackResourceDriftsInput structure.

Attributes

max_results class-attribute instance-attribute 
max_results: int | None = ...

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.

next_token class-attribute instance-attribute 
next_token: str | None = ...

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

stack_name class-attribute instance-attribute 
stack_name: str | None = ...

The name of the stack for which you want drift information.

stack_resource_drift_status_filters class-attribute instance-attribute 
stack_resource_drift_status_filters: list[str] | None = ...

The resource drift status values to use as filters for the resource drift results returned.

  • DELETED: The resource differs from its expected template configuration in that the resource has been deleted.

  • MODIFIED: One or more resource properties differ from their expected template values.

  • IN_SYNC: The resource's actual configuration matches its expected template configuration.

  • NOT_CHECKED: CloudFormation doesn't currently return this value.

  • UNKNOWN: CloudFormation could not run drift detection for the resource.

Output

DescribeStackResourceDriftsOutput dataclass

Bases: _SerdeShape

Dataclass for DescribeStackResourceDriftsOutput structure.

Attributes

next_token class-attribute instance-attribute 
next_token: str | None = ...

If the request doesn't return all the remaining results, NextToken is set to a token. To retrieve the next set of results, call DescribeStackResourceDrifts again and assign that token to the request object's NextToken parameter. If the request returns all results, NextToken is set to null.

response_metadata class-attribute instance-attribute 
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.

stack_resource_drifts class-attribute instance-attribute 
stack_resource_drifts: list[StackResourceDrift] | None = ...

Drift information for the resources that have been checked for drift in the specified stack. This includes actual and expected configuration values for resources where CloudFormation detects drift.

For a given stack, there will be one StackResourceDrift for each stack resource that has been checked for drift. Resources that haven't yet been checked for drift aren't included. Resources that do not currently support drift detection aren't checked, and so not included. For a list of resources that support drift detection, see Resource type support for imports and drift detection.