DeleteHealthCheck - Amazon Route 53

DeleteHealthCheck

Deletes a health check.

Important

Amazon Route 53 does not prevent you from deleting a health check even if the health check is associated with one or more resource record sets. If you delete a health check and you don't update the associated resource record sets, the future status of the health check can't be predicted and may change. This will affect the routing of DNS queries for your DNS failover configuration. For more information, see Replacing and Deleting Health Checks in the Amazon Route 53 Developer Guide.

If you're using AWS Cloud Map and you configured Cloud Map to create a Route 53 health check when you register an instance, you can't use the Route 53 DeleteHealthCheck command to delete the health check. The health check is deleted automatically when you deregister the instance; there can be a delay of several hours before the health check is deleted from Route 53.

Request Syntax

DELETE /2013-04-01/healthcheck/HealthCheckId HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

HealthCheckId

The ID of the health check that you want to delete.

Length Constraints: Maximum length of 64.

Required: Yes

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

Errors

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

HealthCheckInUse

This error has been deprecated.

This error code is not in use.

HTTP Status Code: 400

InvalidInput

The input is not valid.

HTTP Status Code: 400

NoSuchHealthCheck

No health check exists with the specified ID.

HTTP Status Code: 404

Examples

Example Request

This example illustrates one usage of DeleteHealthCheck.

DELETE /2013-04-01/healthcheck/abcdef11-2222-3333-4444-555555fedcba

Example Response

This example illustrates one usage of DeleteHealthCheck.

HTTP/1.1 200 OK <?xml version="1.0" encoding="UTF-8"?> <DeleteHealthCheckResponse xmlns="https://route53.amazonaws.com/doc/2013-04-01/"> </DeleteHealthCheckResponse>

See Also

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