AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates resource record sets in a specified hosted zone based on the settings in a specified traffic policy version. In addition, CreateTrafficPolicyInstance associates the resource record sets with a specified domain name (such as example.com) or subdomain name (such as www.example.com). Amazon Route 53 responds to DNS queries for the domain or subdomain name by using the resource record sets that CreateTrafficPolicyInstance created.

After you submit an CreateTrafficPolicyInstance request, there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. Use GetTrafficPolicyInstance with the id of new traffic policy instance to confirm that the CreateTrafficPolicyInstance request completed successfully. For more information, see the State response element.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreateTrafficPolicyInstanceAsync.

Namespace: Amazon.Route53
Assembly: AWSSDK.Route53.dll
Version: 3.x.y.z

Syntax

C#
public virtual CreateTrafficPolicyInstanceResponse CreateTrafficPolicyInstance(
         CreateTrafficPolicyInstanceRequest request
)

Parameters

request
Type: Amazon.Route53.Model.CreateTrafficPolicyInstanceRequest

Container for the necessary parameters to execute the CreateTrafficPolicyInstance service method.

Return Value


The response from the CreateTrafficPolicyInstance service method, as returned by Route53.

Exceptions

ExceptionCondition
InvalidInputException The input is not valid.
NoSuchHostedZoneException No hosted zone exists with the ID that you specified.
NoSuchTrafficPolicyException No traffic policy exists with the specified ID.
TooManyTrafficPolicyInstancesException This traffic policy instance can't be created because the current account has reached the limit on the number of traffic policy instances. For information about default limits, see Limits in the Amazon Route 53 Developer Guide. For information about how to get the current limit for an account, see GetAccountLimit. To request a higher limit, create a case with the Amazon Web Services Support Center.
TrafficPolicyInstanceAlreadyExistsException There is already a traffic policy instance with the specified ID.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

See Also