| Copyright | (c) 2013-2015 Brendan Hay |
|---|---|
| License | Mozilla Public License, v. 2.0. |
| Maintainer | Brendan Hay <brendan.g.hay@gmail.com> |
| Stability | auto-generated |
| Portability | non-portable (GHC extensions) |
| Safe Haskell | None |
| Language | Haskell2010 |
Network.AWS.Route53.UpdateTrafficPolicyInstance
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:
- 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.
- 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.
- 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
'/2013-04-01/trafficpolicyinstance/traffic policy ID' resource. The
request body must include an XML document with an
UpdateTrafficPolicyInstanceRequest element.
See: AWS API Reference for UpdateTrafficPolicyInstance.
- updateTrafficPolicyInstance :: Text -> Natural -> Text -> Natural -> UpdateTrafficPolicyInstance
- data UpdateTrafficPolicyInstance
- utpiId :: Lens' UpdateTrafficPolicyInstance Text
- utpiTTL :: Lens' UpdateTrafficPolicyInstance Natural
- utpiTrafficPolicyId :: Lens' UpdateTrafficPolicyInstance Text
- utpiTrafficPolicyVersion :: Lens' UpdateTrafficPolicyInstance Natural
- updateTrafficPolicyInstanceResponse :: Int -> TrafficPolicyInstance -> UpdateTrafficPolicyInstanceResponse
- data UpdateTrafficPolicyInstanceResponse
- utpirsResponseStatus :: Lens' UpdateTrafficPolicyInstanceResponse Int
- utpirsTrafficPolicyInstance :: Lens' UpdateTrafficPolicyInstanceResponse TrafficPolicyInstance
Creating a Request
updateTrafficPolicyInstance Source
Arguments
| :: Text | |
| -> Natural | |
| -> Text | |
| -> Natural | |
| -> UpdateTrafficPolicyInstance |
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:
data UpdateTrafficPolicyInstance Source
A complex type that contains information about the resource record sets that you want to update based on a specified traffic policy instance.
See: updateTrafficPolicyInstance smart constructor.
Instances
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
Arguments
| :: Int | |
| -> TrafficPolicyInstance | |
| -> UpdateTrafficPolicyInstanceResponse |
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:
data UpdateTrafficPolicyInstanceResponse Source
A complex type that contains information about the resource record sets that Amazon Route 53 created based on a specified traffic policy.
See: updateTrafficPolicyInstanceResponse smart constructor.
Instances
Response Lenses
utpirsResponseStatus :: Lens' UpdateTrafficPolicyInstanceResponse Int Source
The response status code.
utpirsTrafficPolicyInstance :: Lens' UpdateTrafficPolicyInstanceResponse TrafficPolicyInstance Source
A complex type that contains settings for the updated traffic policy instance.