amazonka-route53-1.4.0: Amazon Route 53 SDK.

Copyright(c) 2013-2016 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.Route53.UpdateTrafficPolicyInstance

Contents

Description

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

The DNS type of the resource record sets that you're updating must match the DNS type in the JSON document that is associated with the traffic policy version that you're using to update the traffic policy instance.

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 substantial 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.

To update a traffic policy instance, send a POST request to the '/Route 53 API version/trafficpolicyinstance/traffic policy ID' resource. The request body must include a document with an UpdateTrafficPolicyInstanceRequest element.

Synopsis

Creating a Request

updateTrafficPolicyInstance Source

Creates a value of UpdateTrafficPolicyInstance with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Request Lenses

utpiId :: Lens' UpdateTrafficPolicyInstance Text Source

The ID of the traffic policy instance that you want to update.

utpiTTL :: Lens' UpdateTrafficPolicyInstance Natural Source

The TTL that you want Amazon Route 53 to assign to all of the updated resource record sets.

utpiTrafficPolicyId :: Lens' UpdateTrafficPolicyInstance Text Source

The ID of the traffic policy that you want Amazon Route 53 to use to update resource record sets for the specified traffic policy instance.

utpiTrafficPolicyVersion :: Lens' UpdateTrafficPolicyInstance Natural Source

The version of the traffic policy that you want Amazon Route 53 to use to update resource record sets for the specified traffic policy instance.

Destructuring the Response

updateTrafficPolicyInstanceResponse Source

Creates a value of UpdateTrafficPolicyInstanceResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Response Lenses

utpirsTrafficPolicyInstance :: Lens' UpdateTrafficPolicyInstanceResponse TrafficPolicyInstance Source

A complex type that contains settings for the updated traffic policy instance.