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.

Updates the resource record sets in a specified hosted zone that were created based on the settings in a specified traffic policy version.

When you update a traffic policy instance, Amazon Route 53 continues to respond to DNS queries for the root resource record set name (such as example.com) while it replaces one group of resource record sets with another. Amazon Route 53 performs the following operations:

  1. Amazon Route 53 creates a new group of resource record sets based on the specified traffic policy. This is true regardless of how significant the differences are between the existing resource record sets and the new resource record sets.

  2. When all of the new resource record sets have been created, Amazon Route 53 starts to respond to DNS queries for the root resource record set name (such as example.com) by using the new resource record sets.

  3. Amazon Route 53 deletes the old group of resource record sets that are associated with the root resource record set name.

Note:

For PCL this operation is only available in asynchronous form. Please refer to UpdateTrafficPolicyInstanceAsync.

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

Syntax

C#
public abstract UpdateTrafficPolicyInstanceResponse UpdateTrafficPolicyInstance(
         UpdateTrafficPolicyInstanceRequest request
)
Parameters
request
Type: Amazon.Route53.Model.UpdateTrafficPolicyInstanceRequest

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

Return Value
The response from the UpdateTrafficPolicyInstance service method, as returned by Route53.

Exceptions

ExceptionCondition
ConflictingTypesException You tried to update a traffic policy instance by using a traffic policy version that has a different DNS type than the current type for the instance. You specified the type in the JSON document in the CreateTrafficPolicy or CreateTrafficPolicyVersionrequest.
InvalidInputException The input is not valid.
NoSuchTrafficPolicyException No traffic policy exists with the specified ID.
NoSuchTrafficPolicyInstanceException No traffic policy instance exists with the specified ID.
PriorRequestNotCompleteException If Amazon Route 53 can't process a request before the next request arrives, it will reject subsequent requests for the same hosted zone and return an HTTP 400 error (Bad request). If Amazon Route 53 returns this error repeatedly for the same request, we recommend that you wait, in intervals of increasing duration, before you try the request again.

Version Information

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

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also