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

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

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 ID that you specified in the DeleteHealthCheck request.

HTTP Status Code: 404

PriorRequestNotComplete

If Amazon Route 53 can't process a request before the next request arrives, it will reject subsequent requests for the same hosted zone and return an HTTP 400 error (Bad request). If Amazon Route 53 returns this error repeatedly for the same request, we recommend that you wait, in intervals of increasing duration, before you try the request again.

HTTP Status Code: 400

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: