Menu
Amazon Route 53
API Reference

CreateTrafficPolicy

Creates a traffic policy, which you use to create multiple DNS resource record sets for one domain name (such as example.com) or one subdomain name (such as www.example.com).

Request Syntax

Copy
POST /2013-04-01/trafficpolicy HTTP/1.1 <?xml version="1.0" encoding="UTF-8"?> <CreateTrafficPolicyRequest xmlns="https://route53.amazonaws.com/doc/2013-04-01/"> <Comment>string</Comment> <Document>string</Document> <Name>string</Name> </CreateTrafficPolicyRequest>

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in XML format.

CreateTrafficPolicyRequest

Root level tag for the CreateTrafficPolicyRequest parameters.

Required: Yes

Comment

(Optional) Any comments that you want to include about the traffic policy.

Type: String

Length Constraints: Maximum length of 1024.

Required: No

Document

The definition of this traffic policy in JSON format. For more information, see Traffic Policy Document Format.

Type: String

Length Constraints: Maximum length of 102400.

Required: Yes

Name

The name of the traffic policy.

Type: String

Length Constraints: Maximum length of 512.

Required: Yes

Response Syntax

Copy
HTTP/1.1 201 Location: Location <?xml version="1.0" encoding="UTF-8"?> <CreateTrafficPolicyResponse> <TrafficPolicy> <Comment>string</Comment> <Document>string</Document> <Id>string</Id> <Name>string</Name> <Type>string</Type> <Version>integer</Version> </TrafficPolicy> </CreateTrafficPolicyResponse>

Response Elements

If the action is successful, the service sends back an HTTP 201 response.

The response returns the following HTTP headers.

Location

A unique URL that represents a new traffic policy.

Length Constraints: Maximum length of 1024.

The following data is returned in XML format by the service.

CreateTrafficPolicyResponse

Root level tag for the CreateTrafficPolicyResponse parameters.

Required: Yes

TrafficPolicy

A complex type that contains settings for the new traffic policy.

Type: TrafficPolicy object

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

InvalidTrafficPolicyDocument

The format of the traffic policy document that you specified in the Document element is invalid.

HTTP Status Code: 400

TooManyTrafficPolicies

You've created the maximum number of traffic policies that can be created for the current AWS account. You can request an increase to the limit on the Contact Us page.

HTTP Status Code: 400

TrafficPolicyAlreadyExists

A traffic policy that has the same value for Name already exists.

HTTP Status Code: 409

Examples

Example Request

Copy
POST /2013-04-01/trafficpolicy HTTP/1.1 <?xml version="1.0" encoding="UTF-8"?> <CreateTrafficPolicyRequest xmlns="https://route53.amazonaws.com/doc/2013-04-01/"> <Name>MyTrafficPolicy</Name> <Document>traffic policy definition in JSON format</Document> <Comment>First traffic policy</Comment> </CreateTrafficPolicyRequest>

Example Response

Copy
HTTP/1.1 200 OK <?xml version="1.0" encoding="UTF-8"?> <CreateTrafficPolicyResponse xmlns="https://route53.amazonaws.com/doc/2013-04-01/"> <TrafficPolicy> <Id>12345</Id> <Version>1</Version> <Name>MyTrafficPolicy</Name> <Type>A</Type> <Document>traffic policy definition in JSON format</Document> <Comment>First traffic policy</Comment> </TrafficPolicy> </CreateTrafficPolicyResponse>

See Also

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