DeleteTrafficPolicy - Amazon Route 53

DeleteTrafficPolicy

Deletes a traffic policy.

When you delete a traffic policy, Route 53 sets a flag on the policy to indicate that it has been deleted. However, Route 53 never fully deletes the traffic policy. Note the following:

  • Deleted traffic policies aren't listed if you run ListTrafficPolicies.

  • There's no way to get a list of deleted policies.

  • If you retain the ID of the policy, you can get information about the policy, including the traffic policy document, by running GetTrafficPolicy.

Request Syntax

DELETE /2013-04-01/trafficpolicy/Id/Version HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

Id

The ID of the traffic policy that you want to delete.

Length Constraints: Minimum length of 1. Maximum length of 36.

Required: Yes

Version

The version number of the traffic policy that you want to delete.

Valid Range: Minimum value of 1. Maximum value of 1000.

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.

ConcurrentModification

Another user submitted a request to create, update, or delete the object at the same time that you did. Retry the request.

HTTP Status Code: 400

InvalidInput

The input is not valid.

HTTP Status Code: 400

NoSuchTrafficPolicy

No traffic policy exists with the specified ID.

HTTP Status Code: 404

TrafficPolicyInUse

One or more traffic policy instances were created by using the specified traffic policy.

HTTP Status Code: 400

Examples

Example Request

This example illustrates one usage of DeleteTrafficPolicy.

DELETE /2013-04-01/trafficpolicy/12345678-abcd-9876-fedc-1a2b3c4de5f6/2

Example Response

This example illustrates one usage of DeleteTrafficPolicy.

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

See Also

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