StackSetDriftDetectionDetails - Amazon CloudFormation
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

StackSetDriftDetectionDetails

Detailed information about the drift status of the stack set.

For stack sets, contains information about the last completed drift operation performed on the stack set. Information about drift operations in-progress isn't included.

For stack set operations, includes information about drift operations currently being performed on the stack set.

For more information, see Detecting unmanaged changes in stack sets in the Amazon CloudFormation User Guide.

Contents

DriftDetectionStatus

The status of the stack set drift detection operation.

  • COMPLETED: The drift detection operation completed without failing on any stack instances.

  • FAILED: The drift detection operation exceeded the specified failure tolerance.

  • PARTIAL_SUCCESS: The drift detection operation completed without exceeding the failure tolerance for the operation.

  • IN_PROGRESS: The drift detection operation is currently being performed.

  • STOPPED: The user has canceled the drift detection operation.

Type: String

Valid Values: COMPLETED | FAILED | PARTIAL_SUCCESS | IN_PROGRESS | STOPPED

Required: No

DriftedStackInstancesCount

The number of stack instances that have drifted from the expected template and parameter configuration of the stack set. A stack instance is considered to have drifted if one or more of the resources in the associated stack don't match their expected configuration.

Type: Integer

Valid Range: Minimum value of 0.

Required: No

DriftStatus

Status of the stack set's actual configuration compared to its expected template and parameter configuration. A stack set is considered to have drifted if one or more of its stack instances have drifted from their expected template and parameter configuration.

  • DRIFTED: One or more of the stack instances belonging to the stack set stack differs from the expected template and parameter configuration. A stack instance is considered to have drifted if one or more of the resources in the associated stack have drifted.

  • NOT_CHECKED: Amazon CloudFormation hasn't checked the stack set for drift.

  • IN_SYNC: All of the stack instances belonging to the stack set stack match from the expected template and parameter configuration.

Type: String

Valid Values: DRIFTED | IN_SYNC | NOT_CHECKED

Required: No

FailedStackInstancesCount

The number of stack instances for which the drift detection operation failed.

Type: Integer

Valid Range: Minimum value of 0.

Required: No

InProgressStackInstancesCount

The number of stack instances that are currently being checked for drift.

Type: Integer

Valid Range: Minimum value of 0.

Required: No

InSyncStackInstancesCount

The number of stack instances which match the expected template and parameter configuration of the stack set.

Type: Integer

Valid Range: Minimum value of 0.

Required: No

LastDriftCheckTimestamp

Most recent time when CloudFormation performed a drift detection operation on the stack set. This value will be NULL for any stack set on which drift detection hasn't yet been performed.

Type: Timestamp

Required: No

TotalStackInstancesCount

The total number of stack instances belonging to this stack set.

The total number of stack instances is equal to the total of:

  • Stack instances that match the stack set configuration.

  • Stack instances that have drifted from the stack set configuration.

  • Stack instances where the drift detection operation has failed.

  • Stack instances currently being checked for drift.

Type: Integer

Valid Range: Minimum value of 0.

Required: No

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: