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:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginCreateTrafficPolicyInstance and EndCreateTrafficPolicyInstance.

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

Syntax

C#
public abstract Task<CreateTrafficPolicyInstanceResponse> CreateTrafficPolicyInstanceAsync(
         CreateTrafficPolicyInstanceRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.Route53.Model.CreateTrafficPolicyInstanceRequest

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

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

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 Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also