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.
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 Amazon SDKs, see the following: