Menu
Amazon Route 53
API Reference

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.

Request Syntax

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

URI Request Parameters

The request requires the following URI parameters.

HealthCheckId

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

Length Constraints: Maximum length of 64.

Request Body

The request does not have a request body.

Response Syntax

Copy
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.

InvalidInput

The input is not valid.

HTTP Status Code: 400

NoSuchHealthCheck

No health check exists with the ID that you specified in the DeleteHealthCheck request.

HTTP Status Code: 404

Examples

Example Request

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

Example Response

Copy
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: