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 a new version of an existing traffic policy. When you create a new version of a traffic policy, you specify the ID of the traffic policy that you want to update and a JSON-formatted document that describes the new version. You use traffic policies to create multiple DNS resource record sets for one domain name (such as example.com) or one subdomain name (such as www.example.com). You can create a maximum of 1000 versions of a traffic policy. If you reach the limit and need to create another version, you'll need to start a new traffic policy.

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 BeginCreateTrafficPolicyVersion and EndCreateTrafficPolicyVersion.

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

Syntax

C#
public abstract Task<CreateTrafficPolicyVersionResponse> CreateTrafficPolicyVersionAsync(
         CreateTrafficPolicyVersionRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.Route53.Model.CreateTrafficPolicyVersionRequest

Container for the necessary parameters to execute the CreateTrafficPolicyVersion 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 CreateTrafficPolicyVersion service method, as returned by Route53.

Exceptions

ExceptionCondition
ConcurrentModificationException Another user submitted a request to create, update, or delete the object at the same time that you did. Retry the request.
InvalidInputException The input is not valid.
InvalidTrafficPolicyDocumentException The format of the traffic policy document that you specified in the Document element is not valid.
NoSuchTrafficPolicyException No traffic policy exists with the specified ID.
TooManyTrafficPolicyVersionsForCurrentPolicyException This traffic policy version can't be created because you've reached the limit of 1000 on the number of versions that you can create for the current traffic policy. To create more traffic policy versions, you can use GetTrafficPolicy to get the traffic policy document for a specified traffic policy version, and then use CreateTrafficPolicy to create a new traffic policy using the traffic policy document.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also