Skip to content

Describe Stack Drift Detection Status

cloudformation_describe_stack_drift_detection_status R Documentation

Returns information about a stack drift detection operation

Description

Returns information about a stack drift detection operation. A stack drift detection operation detects whether a stack's actual configuration differs, or has drifted, from its expected configuration, as defined in the stack template and any values specified as template parameters. A stack is considered to have drifted if one or more of its resources have drifted. For more information about stack and resource drift, see Detecting Unregulated Configuration Changes to Stacks and Resources.

Use detect_stack_drift to initiate a stack drift detection operation. detect_stack_drift returns a StackDriftDetectionId you can use to monitor the progress of the operation using describe_stack_drift_detection_status. Once the drift detection operation has completed, use describe_stack_resource_drifts to return drift information about the stack and its resources.

Usage

cloudformation_describe_stack_drift_detection_status(
  StackDriftDetectionId)

Arguments

StackDriftDetectionId

[required] The ID of the drift detection results of this operation.

CloudFormation generates new results, with a new drift detection ID, each time this operation is run. However, the number of drift results CloudFormation retains for any given stack, and for how long, may vary.

Value

A list with the following syntax:

list(
  StackId = "string",
  StackDriftDetectionId = "string",
  StackDriftStatus = "DRIFTED"|"IN_SYNC"|"UNKNOWN"|"NOT_CHECKED",
  DetectionStatus = "DETECTION_IN_PROGRESS"|"DETECTION_FAILED"|"DETECTION_COMPLETE",
  DetectionStatusReason = "string",
  DriftedStackResourceCount = 123,
  Timestamp = as.POSIXct(
    "2015-01-01"
  )
)

Request syntax

svc$describe_stack_drift_detection_status(
  StackDriftDetectionId = "string"
)