DetectStackResourceDrift - 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).

DetectStackResourceDrift

Returns information about whether a resource's actual configuration differs, or has drifted, from its expected configuration, as defined in the stack template and any values specified as template parameters. This information includes actual and expected property values for resources in which Amazon CloudFormation detects drift. Only resource properties explicitly defined in the stack template are checked for drift. For more information about stack and resource drift, see Detecting Unregulated Configuration Changes to Stacks and Resources.

Use DetectStackResourceDrift to detect drift on individual resources, or DetectStackDrift to detect drift on all resources in a given stack that support drift detection.

Resources that don't currently support drift detection can't be checked. For a list of resources that support drift detection, see Resources that Support Drift Detection.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

LogicalResourceId

The logical name of the resource for which to return drift information.

Type: String

Required: Yes

StackName

The name of the stack to which the resource belongs.

Type: String

Length Constraints: Minimum length of 1.

Pattern: ([a-zA-Z][-a-zA-Z0-9]*)|(arn:\b(aws|aws-us-gov|aws-cn)\b:[-a-zA-Z0-9:/._+]*)

Required: Yes

Response Elements

The following element is returned by the service.

StackResourceDrift

Information about whether the resource's actual configuration has drifted from its expected template configuration, including actual and expected property values and any differences detected.

Type: StackResourceDrift object

Errors

For information about the errors that are common to all actions, see Common Errors.

Examples

DetectStackResourceDrift

This example illustrates one usage of DetectStackResourceDrift.

Sample Request

https://cloudformation.us-east-1.amazonaws.com/ ?Action=DetectStackResourceDrift &Version=2010-05-15 &LogicalResourceId=Queue &StackName=my-stack-with-resource-drift &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=[Access key ID and scope] &X-Amz-Date=20171211T230005Z &X-Amz-SignedHeaders=content-type;host &X-Amz-Signature=[Signature]

Sample Response

<DetectStackResourceDriftResponse xmlns="http://cloudformation.amazonaws.com/doc/2010-05-15/"> <DetectStackResourceDriftResult> <StackResourceDrift> <PropertyDifferences> <member> <ActualValue>120</ActualValue> <ExpectedValue>20</ExpectedValue> <DifferenceType>NOT_EQUAL</DifferenceType> <PropertyPath>/DelaySeconds</PropertyPath> </member> <member> <ActualValue>12</ActualValue> <ExpectedValue>10</ExpectedValue> <DifferenceType>NOT_EQUAL</DifferenceType> <PropertyPath>/RedrivePolicy/maxReceiveCount</PropertyPath> </member> </PropertyDifferences> <PhysicalResourceId>https://sqs.us-east-1.amazonaws.com/012345678910/my-stack-with-resource-drift-Queue-494PBHCO76H4</PhysicalResourceId> <ExpectedProperties>{ "ReceiveMessageWaitTimeSeconds":0, "DelaySeconds":20, "RedrivePolicy":{ "deadLetterTargetArn":"arn:aws:sqs:us-east-1:012345678910:my-stack-with-resource-drift-DLQ-1BCY7HHD5QIM3", "maxReceiveCount":10 }, "MessageRetentionPeriod":345600, "MaximumMessageSize":262144, "VisibilityTimeout":60, "QueueName":"my-stack-with-resource-drift-Queue-494PBHCO76H4" } </ExpectedProperties> <StackResourceDriftStatus>MODIFIED</StackResourceDriftStatus> <StackId>arn:aws:cloudformation:us-east-1:012345678910:stack/my-stack-with-resource-drift/489e5570-df85-11e7-a7d9-503acac5c0fd</StackId> <LogicalResourceId>Queue</LogicalResourceId> <ActualProperties>{ "ReceiveMessageWaitTimeSeconds":0, "DelaySeconds":120, "RedrivePolicy":{ "deadLetterTargetArn":"arn:aws:sqs:us-east-1:012345678910:my-stack-with-resource-drift-DLQ-1BCY7HHD5QIM3", "maxReceiveCount":12 }, "MessageRetentionPeriod":345600, "MaximumMessageSize":262144, "VisibilityTimeout":60, "QueueName":"my-stack-with-resource-drift-Queue-494PBHCO76H4" } </ActualProperties> <Timestamp>2017-12-28T23:51:49.616Z</Timestamp> <ResourceType>AWS::SQS::Queue</ResourceType> </StackResourceDrift> </DetectStackResourceDriftResult> <ResponseMetadata> <RequestId>1229a48a-ec2a-11e7-a8e5-97a4c2fc6398</RequestId> </ResponseMetadata> </DetectStackResourceDriftResponse>

See Also

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