{ "version":"2.0", "metadata":{ "apiVersion":"2013-04-01", "endpointPrefix":"route53", "globalEndpoint":"route53.amazonaws.com", "protocol":"rest-xml", "serviceAbbreviation":"Route 53", "serviceFullName":"Amazon Route 53", "signatureVersion":"v4" }, "operations":{ "AssociateVPCWithHostedZone":{ "name":"AssociateVPCWithHostedZone", "http":{ "method":"POST", "requestUri":"/2013-04-01/hostedzone/{Id}/associatevpc" }, "input":{ "shape":"AssociateVPCWithHostedZoneRequest", "locationName":"AssociateVPCWithHostedZoneRequest", "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} }, "output":{"shape":"AssociateVPCWithHostedZoneResponse"}, "errors":[ {"shape":"NoSuchHostedZone"}, {"shape":"InvalidVPCId"}, {"shape":"InvalidInput"}, {"shape":"PublicZoneVPCAssociation"}, {"shape":"ConflictingDomainExists"}, {"shape":"LimitsExceeded"} ], "documentation":"
This action associates a VPC with an hosted zone.
To associate a VPC with an hosted zone, send a POST
request to the 2013-04-01/hostedzone/hosted zone ID/associatevpc
resource. The request body must include an XML document with a AssociateVPCWithHostedZoneRequest
element. The response returns the AssociateVPCWithHostedZoneResponse
element that contains ChangeInfo
for you to track the progress of the AssociateVPCWithHostedZoneRequest
you made. See GetChange
operation for how to track the progress of your change.
Use this action to create or change your authoritative DNS information. To use this action, send a POST
request to the 2013-04-01/hostedzone/hosted Zone ID/rrset
resource. The request body must include an XML document with a ChangeResourceRecordSetsRequest
element.
Changes are a list of change items and are considered transactional. For more information on transactional changes, also known as change batches, see POST ChangeResourceRecordSets in the Amazon Route 53 API Reference.
InvalidChangeBatch
error.In response to a ChangeResourceRecordSets
request, your DNS data is changed on all Amazon Route 53 DNS servers. Initially, the status of a change is PENDING
. This means the change has not yet propagated to all the authoritative Amazon Route 53 DNS servers. When the change is propagated to all hosts, the change returns a status of INSYNC
.
Note the following limitations on a ChangeResourceRecordSets
request:
Value
elements in a request cannot exceed 32,000 characters.This action creates a new health check.
To create a new health check, send a POST
request to the 2013-04-01/healthcheck
resource. The request body must include an XML document with a CreateHealthCheckRequest
element. The response returns the CreateHealthCheckResponse
element that contains metadata about the health check.
This action creates a new hosted zone.
To create a new hosted zone, send a POST
request to the 2013-04-01/hostedzone
resource. The request body must include an XML document with a CreateHostedZoneRequest
element. The response returns the CreateHostedZoneResponse
element that contains metadata about the hosted zone.
Amazon Route 53 automatically creates a default SOA record and four NS records for the zone. The NS records in the hosted zone are the name servers you give your registrar to delegate your domain to. For more information about SOA and NS records, see NS and SOA Records that Amazon Route 53 Creates for a Hosted Zone in the Amazon Route 53 Developer Guide.
When you create a zone, its initial status is PENDING
. This means that it is not yet available on all DNS servers. The status of the zone changes to INSYNC
when the NS and SOA records are available on all Amazon Route 53 DNS servers.
When trying to create a hosted zone using a reusable delegation set, you could specify an optional DelegationSetId, and Route53 would assign those 4 NS records for the zone, instead of alloting a new one.
" }, "CreateReusableDelegationSet":{ "name":"CreateReusableDelegationSet", "http":{ "method":"POST", "requestUri":"/2013-04-01/delegationset", "responseCode":201 }, "input":{ "shape":"CreateReusableDelegationSetRequest", "locationName":"CreateReusableDelegationSetRequest", "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} }, "output":{"shape":"CreateReusableDelegationSetResponse"}, "errors":[ {"shape":"DelegationSetAlreadyCreated"}, {"shape":"LimitsExceeded"}, {"shape":"HostedZoneNotFound"}, {"shape":"InvalidArgument"}, {"shape":"InvalidInput"}, {"shape":"DelegationSetNotAvailable"}, {"shape":"DelegationSetAlreadyReusable"} ], "documentation":"This action creates a reusable delegationSet.
To create a new reusable delegationSet, send a POST
request to the 2013-04-01/delegationset
resource. The request body must include an XML document with a CreateReusableDelegationSetRequest
element. The response returns the CreateReusableDelegationSetResponse
element that contains metadata about the delegationSet.
If the optional parameter HostedZoneId is specified, it marks the delegationSet associated with that particular hosted zone as reusable.
" }, "CreateTrafficPolicy":{ "name":"CreateTrafficPolicy", "http":{ "method":"POST", "requestUri":"/2013-04-01/trafficpolicy", "responseCode":201 }, "input":{ "shape":"CreateTrafficPolicyRequest", "locationName":"CreateTrafficPolicyRequest", "xmlNamespace":{"uri":"https://route53.amazonaws.com/doc/2013-04-01/"} }, "output":{"shape":"CreateTrafficPolicyResponse"}, "errors":[ {"shape":"InvalidInput"}, {"shape":"TooManyTrafficPolicies"}, {"shape":"TrafficPolicyAlreadyExists"}, {"shape":"InvalidTrafficPolicyDocument"} ], "documentation":"Creates a traffic policy, which you use to create multiple DNS resource record sets for one domain name (such as example.com) or one subdomain name (such as www.example.com).
To create a traffic policy, send a POST
request to the 2013-04-01/trafficpolicy
resource. The request body must include an XML document with a CreateTrafficPolicyRequest
element. The response includes the CreateTrafficPolicyResponse
element, which contains information about the new traffic policy.
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.
To create a traffic policy instance, send a POST
request to the 2013-04-01/trafficpolicyinstance
resource. The request body must include an XML document with a CreateTrafficPolicyRequest
element. The response returns the CreateTrafficPolicyInstanceResponse
element, which contains information about the traffic policy instance.
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).
To create a new version, send a POST
request to the 2013-04-01/trafficpolicy/
resource. The request body includes an XML document with a CreateTrafficPolicyVersionRequest
element. The response returns the CreateTrafficPolicyVersionResponse
element, which contains information about the new version of the traffic policy.
This action deletes a health check. To delete a health check, send a DELETE
request to the 2013-04-01/healthcheck/health check ID
resource.
HealthCheckInUse
error. For information about disassociating the records from your health check, see ChangeResourceRecordSets.This action deletes a hosted zone. To delete a hosted zone, send a DELETE
request to the 2013-04-01/hostedzone/hosted zone ID
resource.
For more information about deleting a hosted zone, see Deleting a Hosted Zone in the Amazon Route 53 Developer Guide.
HostedZoneNotEmpty
error. For information about deleting records from your hosted zone, see ChangeResourceRecordSets.This action deletes a reusable delegation set. To delete a reusable delegation set, send a DELETE
request to the 2013-04-01/delegationset/delegation set ID
resource.
DelegationSetInUse
error.Deletes a traffic policy. To delete a traffic policy, send a DELETE
request to the 2013-04-01/trafficpolicy
resource.
Deletes a traffic policy instance and all of the resource record sets that Amazon Route 53 created when you created the instance.
To delete a traffic policy instance, send a DELETE
request to the 2013-04-01/trafficpolicy/traffic policy instance ID
resource.
This action disassociates a VPC from an hosted zone.
To disassociate a VPC to a hosted zone, send a POST
request to the 2013-04-01/hostedzone/hosted zone ID/disassociatevpc
resource. The request body must include an XML document with a DisassociateVPCFromHostedZoneRequest
element. The response returns the DisassociateVPCFromHostedZoneResponse
element that contains ChangeInfo
for you to track the progress of the DisassociateVPCFromHostedZoneRequest
you made. See GetChange
operation for how to track the progress of your change.
This action returns the current status of a change batch request. The status is one of the following values:
- PENDING
indicates that the changes in this request have not replicated to all Amazon Route 53 DNS servers. This is the initial status of all change batch requests.
- INSYNC
indicates that the changes have replicated to all Amazon Route 53 DNS servers.
This action returns the status and changes of a change batch request.
" }, "GetCheckerIpRanges":{ "name":"GetCheckerIpRanges", "http":{ "method":"GET", "requestUri":"/2013-04-01/checkeripranges" }, "input":{"shape":"GetCheckerIpRangesRequest"}, "output":{"shape":"GetCheckerIpRangesResponse"}, "documentation":"To retrieve a list of the IP ranges used by Amazon Route 53 health checkers to check the health of your resources, send a GET
request to the 2013-04-01/checkeripranges
resource. You can use these IP addresses to configure router and firewall rules to allow health checkers to check the health of your resources.
To retrieve a single geo location, send a GET
request to the 2013-04-01/geolocation
resource with one of these options: continentcode | countrycode | countrycode and subdivisioncode.
To retrieve the health check, send a GET
request to the 2013-04-01/healthcheck/health check ID
resource.
To retrieve a count of all your health checks, send a GET
request to the 2013-04-01/healthcheckcount
resource.
If you want to learn why a health check is currently failing or why it failed most recently (if at all), you can get the failure reason for the most recent failure. Send a GET
request to the 2013-04-01/healthcheck/health check ID/lastfailurereason
resource.
To retrieve the health check status, send a GET
request to the 2013-04-01/healthcheck/health check ID/status
resource. You can use this call to get a health check's current status.
To retrieve the delegation set for a hosted zone, send a GET
request to the 2013-04-01/hostedzone/hosted zone ID
resource. The delegation set is the four Amazon Route 53 name servers that were assigned to the hosted zone when you created it.
To retrieve a count of all your hosted zones, send a GET
request to the 2013-04-01/hostedzonecount
resource.
To retrieve the reusable delegation set, send a GET
request to the 2013-04-01/delegationset/delegation set ID
resource.
Gets information about a specific traffic policy version. To get the information, send a GET
request to the 2013-04-01/trafficpolicy
resource.
Gets information about a specified traffic policy instance.
To get information about the traffic policy instance, send a GET
request to the 2013-04-01/trafficpolicyinstance
resource.
CreateTrafficPolicyInstance
or an UpdateTrafficPolicyInstance
request, there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For more information, see the State response element. Gets the number of traffic policy instances that are associated with the current AWS account.
To get the number of traffic policy instances, send a GET
request to the 2013-04-01/trafficpolicyinstancecount
resource.
This action gets the list of ChangeBatches in a given time period for a given hosted zone.
" }, "ListChangeBatchesByRRSet":{ "name":"ListChangeBatchesByRRSet", "http":{ "method":"GET", "requestUri":"/2013-04-01/hostedzone/{Id}/rrsChanges" }, "input":{"shape":"ListChangeBatchesByRRSetRequest"}, "output":{"shape":"ListChangeBatchesByRRSetResponse"}, "errors":[ {"shape":"NoSuchHostedZone"}, {"shape":"InvalidInput"} ], "documentation":"This action gets the list of ChangeBatches in a given time period for a given hosted zone and RRSet.
" }, "ListGeoLocations":{ "name":"ListGeoLocations", "http":{ "method":"GET", "requestUri":"/2013-04-01/geolocations" }, "input":{"shape":"ListGeoLocationsRequest"}, "output":{"shape":"ListGeoLocationsResponse"}, "errors":[ {"shape":"InvalidInput"} ], "documentation":"To retrieve a list of supported geo locations, send a GET
request to the 2013-04-01/geolocations
resource. The response to this request includes a GeoLocationDetailsList
element with zero, one, or multiple GeoLocationDetails
child elements. The list is sorted by country code, and then subdivision code, followed by continents at the end of the list.
By default, the list of geo locations is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems
parameter. If the list is truncated, IsTruncated
will be set to true and a combination of NextContinentCode, NextCountryCode, NextSubdivisionCode
will be populated. You can pass these as parameters to StartContinentCode, StartCountryCode, StartSubdivisionCode
to control the geo location that the list begins with.
To retrieve a list of your health checks, send a GET
request to the 2013-04-01/healthcheck
resource. The response to this request includes a HealthChecks
element with zero, one, or multiple HealthCheck
child elements. By default, the list of health checks is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems
parameter. You can use the Marker
parameter to control the health check that the list begins with.
To retrieve a list of your hosted zones, send a GET
request to the 2013-04-01/hostedzone
resource. The response to this request includes a HostedZones
element with zero, one, or multiple HostedZone
child elements. By default, the list of hosted zones is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems
parameter. You can use the Marker
parameter to control the hosted zone that the list begins with.
To retrieve a list of your hosted zones in lexicographic order, send a GET
request to the 2013-04-01/hostedzonesbyname
resource. The response to this request includes a HostedZones
element with zero or more HostedZone
child elements lexicographically ordered by DNS name. By default, the list of hosted zones is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems
parameter. You can use the DNSName
and HostedZoneId
parameters to control the hosted zone that the list begins with.
Imagine all the resource record sets in a zone listed out in front of you. Imagine them sorted lexicographically first by DNS name (with the labels reversed, like \"com.amazon.www\" for example), and secondarily, lexicographically by record type. This operation retrieves at most MaxItems resource record sets from this list, in order, starting at a position specified by the Name and Type arguments:
Use ListResourceRecordSets to retrieve a single known record set by specifying the record set's name and type, and setting MaxItems = 1
To retrieve all the records in a HostedZone, first pause any processes making calls to ChangeResourceRecordSets. Initially call ListResourceRecordSets without a Name and Type to get the first page of record sets. For subsequent calls, set Name and Type to the NextName and NextType values returned by the previous response.
In the presence of concurrent ChangeResourceRecordSets calls, there is no consistency of results across calls to ListResourceRecordSets. The only way to get a consistent multi-page snapshot of all RRSETs in a zone is to stop making changes while pagination is in progress.
However, the results from ListResourceRecordSets are consistent within a page. If MakeChange calls are taking place concurrently, the result of each one will either be completely visible in your results or not at all. You will not see partial changes, or changes that do not ultimately succeed. (This follows from the fact that MakeChange is atomic)
The results from ListResourceRecordSets are strongly consistent with ChangeResourceRecordSets. To be precise, if a single process makes a call to ChangeResourceRecordSets and receives a successful response, the effects of that change will be visible in a subsequent call to ListResourceRecordSets by that process.
" }, "ListReusableDelegationSets":{ "name":"ListReusableDelegationSets", "http":{ "method":"GET", "requestUri":"/2013-04-01/delegationset" }, "input":{"shape":"ListReusableDelegationSetsRequest"}, "output":{"shape":"ListReusableDelegationSetsResponse"}, "errors":[ {"shape":"InvalidInput"} ], "documentation":"To retrieve a list of your reusable delegation sets, send a GET
request to the 2013-04-01/delegationset
resource. The response to this request includes a DelegationSets
element with zero, one, or multiple DelegationSet
child elements. By default, the list of delegation sets is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems
parameter. You can use the Marker
parameter to control the delegation set that the list begins with.
Gets information about the latest version for every traffic policy that is associated with the current AWS account. To get the information, send a GET
request to the 2013-04-01/trafficpolicy
resource.
Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policies, you can use the maxitems
parameter to list them in groups of up to 100.
The response includes three values that help you navigate from one group of maxitems
traffic policies to the next:
If the value of IsTruncated
in the response is true
, there are more traffic policies associated with the current AWS account.
If IsTruncated
is false
, this response includes the last traffic policy that is associated with the current account.
If IsTruncated
is true
, TrafficPolicyIdMarker
is the ID of the first traffic policy in the next group of MaxItems
traffic policies. If you want to list more traffic policies, make another call to ListTrafficPolicies
, and specify the value of the TrafficPolicyIdMarker
element from the response in the TrafficPolicyIdMarker
request parameter.
If IsTruncated
is false
, the TrafficPolicyIdMarker
element is omitted from the response.
The value that you specified for the MaxItems
parameter in the request that produced the current response.
Gets information about the traffic policy instances that you created by using the current AWS account.
UpdateTrafficPolicyInstance
request, there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For more information, see the State response element.To get information about the traffic policy instances that are associated with the current AWS account, send a GET
request to the 2013-04-01/trafficpolicyinstance
resource.
Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policy instances, you can use the MaxItems
parameter to list them in groups of up to 100.
The response includes five values that help you navigate from one group of MaxItems
traffic policy instances to the next:
If the value of IsTruncated
in the response is true
, there are more traffic policy instances associated with the current AWS account.
If IsTruncated
is false
, this response includes the last traffic policy instance that is associated with the current account.
The value that you specified for the MaxItems
parameter in the request that produced the current response.
If IsTruncated
is true
, these three values in the response represent the first traffic policy instance in the next group of MaxItems
traffic policy instances. To list more traffic policy instances, make another call to ListTrafficPolicyInstances
, and specify these values in the corresponding request parameters.
If IsTruncated
is false
, all three elements are omitted from the response.
Gets information about the traffic policy instances that you created in a specified hosted zone.
UpdateTrafficPolicyInstance
request, there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For more information, see the State response element.To get information about the traffic policy instances that you created in a specified hosted zone, send a GET
request to the 2013-04-01/trafficpolicyinstance
resource and include the ID of the hosted zone.
Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policy instances, you can use the MaxItems
parameter to list them in groups of up to 100.
The response includes four values that help you navigate from one group of MaxItems
traffic policy instances to the next:
If the value of IsTruncated in the response is
true
, there are more traffic policy instances associated with the current AWS account.
If IsTruncated
is false
, this response includes the last traffic policy instance that is associated with the current account.
The value that you specified for the MaxItems
parameter in the request that produced the current response.
If IsTruncated
is true
, these two values in the response represent the first traffic policy instance in the next group of MaxItems
traffic policy instances. To list more traffic policy instances, make another call to ListTrafficPolicyInstancesByHostedZone
, and specify these values in the corresponding request parameters.
If IsTruncated
is false
, all three elements are omitted from the response.
Gets information about the traffic policy instances that you created by using a specify traffic policy version.
CreateTrafficPolicyInstance
or an UpdateTrafficPolicyInstance
request, there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For more information, see the State response element.To get information about the traffic policy instances that you created by using a specify traffic policy version, send a GET
request to the 2013-04-01/trafficpolicyinstance
resource and include the ID and version of the traffic policy.
Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policy instances, you can use the MaxItems
parameter to list them in groups of up to 100.
The response includes five values that help you navigate from one group of MaxItems
traffic policy instances to the next:
If the value of IsTruncated
in the response is true
, there are more traffic policy instances associated with the specified traffic policy.
If IsTruncated
is false
, this response includes the last traffic policy instance that is associated with the specified traffic policy.
The value that you specified for the MaxItems
parameter in the request that produced the current response.
If IsTruncated
is true
, these values in the response represent the first traffic policy instance in the next group of MaxItems
traffic policy instances. To list more traffic policy instances, make another call to ListTrafficPolicyInstancesByPolicy
, and specify these values in the corresponding request parameters.
If IsTruncated
is false
, all three elements are omitted from the response.
Gets information about all of the versions for a specified traffic policy. ListTrafficPolicyVersions
lists only versions that have not been deleted.
Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policies, you can use the maxitems
parameter to list them in groups of up to 100.
The response includes three values that help you navigate from one group of maxitems
maxitems traffic policies to the next:
If the value of IsTruncated
in the response is true
, there are more traffic policy versions associated with the specified traffic policy.
If IsTruncated
is false
, this response includes the last traffic policy version that is associated with the specified traffic policy.
The ID of the next traffic policy version that is associated with the current AWS account. If you want to list more traffic policies, make another call to ListTrafficPolicyVersions
, and specify the value of the TrafficPolicyVersionMarker
element in the TrafficPolicyVersionMarker
request parameter.
If IsTruncated
is false
, Amazon Route 53 omits the TrafficPolicyVersionMarker
element from the response.
The value that you specified for the MaxItems
parameter in the request that produced the current response.
This action updates an existing health check.
To update a health check, send a POST
request to the 2013-04-01/healthcheck/health check ID
resource. The request body must include an XML document with an UpdateHealthCheckRequest
element. The response returns an UpdateHealthCheckResponse
element, which contains metadata about the health check.
To update the hosted zone comment, send a POST
request to the 2013-04-01/hostedzone/hosted zone ID
resource. The request body must include an XML document with a UpdateHostedZoneCommentRequest
element. The response to this request includes the modified HostedZone
element.
Updates the comment for a specified traffic policy version.
To update the comment, send a POST
request to the /2013-04-01/trafficpolicy/
resource.
The request body must include an XML document with an UpdateTrafficPolicyCommentRequest
element.
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:
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.
Alias resource record sets only: The value you use depends on where you want to route queries:
Z2FDTNDATAQYW2
.HostedZoneId
and DNSName
. If you get one value from the console and the other value from the API or the CLI, creating the resource record set will fail.For more information and an example, see Example: Creating Alias Resource Record Sets in the Amazon Route 53 API Reference.
" }, "DNSName":{ "shape":"DNSName", "documentation":"Alias resource record sets only: The external DNS name associated with the AWS Resource. The value that you specify depends on where you want to route queries:
acme.example.com
, your CloudFront distribution must include acme.example.com
as one of the alternate domain names. For more information, see Using Alternate Domain Names (CNAMEs) in the Amazon CloudFront Developer Guide.HostedZoneId
and DNSName
. If you get one value from the console and the other value from the API or the CLI, creating the resource record set will fail.s3-website-us-east-1.amazonaws.com
. For more information about valid values, see the table Amazon Simple Storage Service (S3) Website Endpoints in the Amazon Web Services General Reference. For more information about using Amazon S3 buckets for websites, see Hosting a Static Website on Amazon S3 in the Amazon Simple Storage Service Developer Guide.For more information and an example, see Example: Creating Alias Resource Record Sets in the Amazon Route 53 API Reference.
" }, "EvaluateTargetHealth":{ "shape":"AliasHealthEnabled", "documentation":"Alias resource record sets only: If you set the value of EvaluateTargetHealth
to true
for the resource record set or sets in an alias, weighted alias, latency alias, or failover alias resource record set, and if you specify a value for HealthCheckId
for every resource record set that is referenced by these alias resource record sets, the alias resource record sets inherit the health of the referenced resource record sets.
In this configuration, when Amazon Route 53 receives a DNS query for an alias resource record set:
Note the following:
AliasTarget
is a resource record set or a group of resource record sets (for example, a group of weighted resource record sets), but it is not another alias resource record set, we recommend that you associate a health check with all of the resource record sets in the alias target. For more information, see What Happens When You Omit Health Checks? in the Amazon Route 53 Developer Guide.AliasTarget
, Elastic Load Balancing routes queries only to the healthy Amazon EC2 instances that are registered with the load balancer. If no Amazon EC2 instances are healthy or if the load balancer itself is unhealthy, and if EvaluateTargetHealth
is true
for the corresponding alias resource record set, Amazon Route 53 routes queries to other resources.We recommend that you set EvaluateTargetHealth
to true
only when you have enough idle capacity to handle the failure of one or more endpoints.
For more information and examples, see Amazon Route 53 Health Checks and DNS Failover in the Amazon Route 53 Developer Guide.
" } }, "documentation":"Alias resource record sets only: Information about the CloudFront distribution, ELB load balancer, Amazon S3 bucket, or Amazon Route 53 resource record set to which you are routing traffic.
If you're creating resource record sets for a private hosted zone, note the following:
For more information and an example, see Example: Creating Alias Resource Record Sets in the Amazon Route 53 API Reference.
" }, "AssociateVPCComment":{"type":"string"}, "AssociateVPCWithHostedZoneRequest":{ "type":"structure", "required":[ "HostedZoneId", "VPC" ], "members":{ "HostedZoneId":{ "shape":"ResourceId", "documentation":"The ID of the hosted zone you want to associate your VPC with.
Note that you cannot associate a VPC with a hosted zone that doesn't have an existing VPC association.
", "location":"uri", "locationName":"Id" }, "VPC":{ "shape":"VPC", "documentation":"The VPC that you want your hosted zone to be associated with.
" }, "Comment":{ "shape":"AssociateVPCComment", "documentation":"Optional: Any comments you want to include about a AssociateVPCWithHostedZoneRequest
.
A complex type that contains information about the request to associate a VPC with an hosted zone.
" }, "AssociateVPCWithHostedZoneResponse":{ "type":"structure", "required":["ChangeInfo"], "members":{ "ChangeInfo":{ "shape":"ChangeInfo", "documentation":"A complex type that contains the ID, the status, and the date and time of your AssociateVPCWithHostedZoneRequest
.
A complex type containing the response information for the request.
" }, "Change":{ "type":"structure", "required":[ "Action", "ResourceRecordSet" ], "members":{ "Action":{ "shape":"ChangeAction", "documentation":"The action to perform:
CREATE
: Creates a resource record set that has the specified values.DELETE
: Deletes a existing resource record set that has the specified values for Name
, Type
, SetIdentifier
(for latency, weighted, geolocation, and failover resource record sets), and TTL
(except alias resource record sets, for which the TTL is determined by the AWS resource that you're routing DNS queries to).UPSERT
: If a resource record set does not already exist, Amazon Route 53 creates it. If a resource record set does exist, Amazon Route 53 updates it with the values in the request. Amazon Route 53 can update an existing resource record set only when all of the following values match: Name
, Type
, and SetIdentifier
(for weighted, latency, geolocation, and failover resource record sets).Information about the resource record set to create or delete.
" } }, "documentation":"A complex type that contains the information for each change in a change batch request.
" }, "ChangeAction":{ "type":"string", "enum":[ "CREATE", "DELETE", "UPSERT" ] }, "ChangeBatch":{ "type":"structure", "required":["Changes"], "members":{ "Comment":{ "shape":"ResourceDescription", "documentation":"Optional: Any comments you want to include about a change batch request.
" }, "Changes":{ "shape":"Changes", "documentation":"A complex type that contains one Change
element for each resource record set that you want to create or delete.
A complex type that contains an optional comment and the changes that you want to make with a change batch request.
" }, "ChangeBatchRecord":{ "type":"structure", "required":[ "Id", "Status" ], "members":{ "Id":{ "shape":"ResourceId", "documentation":"The ID of the request. Use this ID to track when the change has completed across all Amazon Route 53 DNS servers.
" }, "SubmittedAt":{ "shape":"TimeStamp", "documentation":"The date and time the change was submitted, in the format YYYY-MM-DDThh:mm:ssZ
, as specified in the ISO 8601 standard (for example, 2009-11-19T19:37:58Z). The Z
after the time indicates that the time is listed in Coordinated Universal Time (UTC).
The current state of the request. PENDING
indicates that this request has not yet been applied to all Amazon Route 53 DNS servers.
Valid Values: PENDING
| INSYNC
A complex type that describes change information about changes made to your hosted zone.
This element contains an ID that you use when performing a GetChange action to get detailed information about the change.
" }, "Submitter":{ "shape":"AWSAccountID", "documentation":"The AWS account ID attached to the changes.
" }, "Changes":{ "shape":"Changes", "documentation":"A list of changes made in the ChangeBatch.
" } }, "documentation":"A complex type that lists the changes and information for a ChangeBatch.
" }, "ChangeBatchRecords":{ "type":"list", "member":{ "shape":"ChangeBatchRecord", "locationName":"ChangeBatchRecord" }, "min":1 }, "ChangeInfo":{ "type":"structure", "required":[ "Id", "Status", "SubmittedAt" ], "members":{ "Id":{ "shape":"ResourceId", "documentation":"The ID of the request. Use this ID to track when the change has completed across all Amazon Route 53 DNS servers.
" }, "Status":{ "shape":"ChangeStatus", "documentation":"The current state of the request. PENDING
indicates that this request has not yet been applied to all Amazon Route 53 DNS servers.
Valid Values: PENDING
| INSYNC
The date and time the change was submitted, in the format YYYY-MM-DDThh:mm:ssZ
, as specified in the ISO 8601 standard (for example, 2009-11-19T19:37:58Z). The Z
after the time indicates that the time is listed in Coordinated Universal Time (UTC).
A complex type that describes change information about changes made to your hosted zone.
This element contains an ID that you use when performing a GetChange action to get detailed information about the change.
" } }, "documentation":"A complex type that describes change information about changes made to your hosted zone.
This element contains an ID that you use when performing a GetChange action to get detailed information about the change.
" }, "ChangeResourceRecordSetsRequest":{ "type":"structure", "required":[ "HostedZoneId", "ChangeBatch" ], "members":{ "HostedZoneId":{ "shape":"ResourceId", "documentation":"The ID of the hosted zone that contains the resource record sets that you want to change.
", "location":"uri", "locationName":"Id" }, "ChangeBatch":{ "shape":"ChangeBatch", "documentation":"A complex type that contains an optional comment and the Changes
element.
A complex type that contains a change batch.
" }, "ChangeResourceRecordSetsResponse":{ "type":"structure", "required":["ChangeInfo"], "members":{ "ChangeInfo":{ "shape":"ChangeInfo", "documentation":"A complex type that contains information about changes made to your hosted zone.
This element contains an ID that you use when performing a GetChange action to get detailed information about the change.
" } }, "documentation":"A complex type containing the response for the request.
" }, "ChangeStatus":{ "type":"string", "enum":[ "PENDING", "INSYNC" ] }, "ChangeTagsForResourceRequest":{ "type":"structure", "required":[ "ResourceType", "ResourceId" ], "members":{ "ResourceType":{ "shape":"TagResourceType", "documentation":"The type of the resource.
- The resource type for health checks is healthcheck
.
- The resource type for hosted zones is hostedzone
.
The ID of the resource for which you want to add, change, or delete tags.
", "location":"uri", "locationName":"ResourceId" }, "AddTags":{ "shape":"TagList", "documentation":"A complex type that contains a list of Tag
elements. Each Tag
element identifies a tag that you want to add or update for the specified resource.
A list of Tag
keys that you want to remove from the specified resource.
A complex type containing information about a request to add, change, or delete the tags that are associated with a resource.
" }, "ChangeTagsForResourceResponse":{ "type":"structure", "members":{ }, "documentation":"Empty response for the request.
" }, "Changes":{ "type":"list", "member":{ "shape":"Change", "locationName":"Change" }, "min":1 }, "CheckerIpRanges":{ "type":"list", "member":{"shape":"IPAddressCidr"} }, "ChildHealthCheckList":{ "type":"list", "member":{ "shape":"HealthCheckId", "locationName":"ChildHealthCheck" }, "max":256 }, "ConcurrentModification":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"Another user submitted a request to update the object at the same time that you did. Retry the request.
", "error":{"httpStatusCode":400}, "exception":true }, "ConflictingDomainExists":{ "type":"structure", "members":{ "message":{"shape":"ErrorMessage"} }, "exception":true }, "ConflictingTypes":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"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 CreateTrafficPolicyVersion
request.
A unique string that identifies the request and that allows failed CreateHealthCheck
requests to be retried without the risk of executing the operation twice. You must use a unique CallerReference
string every time you create a health check. CallerReference
can be any unique string; you might choose to use a string that identifies your project.
Valid characters are any Unicode code points that are legal in an XML 1.0 document. The UTF-8 encoding of the value must be less than 128 bytes.
" }, "HealthCheckConfig":{ "shape":"HealthCheckConfig", "documentation":"A complex type that contains health check configuration.
" } }, "documentation":">A complex type that contains information about the request to create a health check.
" }, "CreateHealthCheckResponse":{ "type":"structure", "required":[ "HealthCheck", "Location" ], "members":{ "HealthCheck":{ "shape":"HealthCheck", "documentation":"A complex type that contains identifying information about the health check.
" }, "Location":{ "shape":"ResourceURI", "documentation":"The unique URL representing the new health check.
", "location":"header", "locationName":"Location" } }, "documentation":"A complex type containing the response information for the new health check.
" }, "CreateHostedZoneRequest":{ "type":"structure", "required":[ "Name", "CallerReference" ], "members":{ "Name":{ "shape":"DNSName", "documentation":"The name of the domain. This must be a fully-specified domain, for example, www.example.com. The trailing dot is optional; Amazon Route 53 assumes that the domain name is fully qualified. This means that Amazon Route 53 treats www.example.com (without a trailing dot) and www.example.com. (with a trailing dot) as identical.
This is the name you have registered with your DNS registrar. You should ask your registrar to change the authoritative name servers for your domain to the set of NameServers
elements returned in DelegationSet
.
The VPC that you want your hosted zone to be associated with. By providing this parameter, your newly created hosted cannot be resolved anywhere other than the given VPC.
" }, "CallerReference":{ "shape":"Nonce", "documentation":"A unique string that identifies the request and that allows failed CreateHostedZone
requests to be retried without the risk of executing the operation twice. You must use a unique CallerReference
string every time you create a hosted zone. CallerReference
can be any unique string; you might choose to use a string that identifies your project, such as DNSMigration_01
.
Valid characters are any Unicode code points that are legal in an XML 1.0 document. The UTF-8 encoding of the value must be less than 128 bytes.
" }, "HostedZoneConfig":{ "shape":"HostedZoneConfig", "documentation":"A complex type that contains an optional comment about your hosted zone.
" }, "DelegationSetId":{ "shape":"ResourceId", "documentation":"The delegation set id of the reusable delgation set whose NS records you want to assign to the new hosted zone.
" } }, "documentation":"A complex type that contains information about the request to create a hosted zone.
" }, "CreateHostedZoneResponse":{ "type":"structure", "required":[ "HostedZone", "ChangeInfo", "DelegationSet", "Location" ], "members":{ "HostedZone":{ "shape":"HostedZone", "documentation":"A complex type that contains identifying information about the hosted zone.
" }, "ChangeInfo":{ "shape":"ChangeInfo", "documentation":"A complex type that contains information about the request to create a hosted zone. This includes an ID that you use when you call the GetChange action to get the current status of the change request.
" }, "DelegationSet":{ "shape":"DelegationSet", "documentation":"A complex type that contains name server information.
" }, "VPC":{"shape":"VPC"}, "Location":{ "shape":"ResourceURI", "documentation":"The unique URL representing the new hosted zone.
", "location":"header", "locationName":"Location" } }, "documentation":"A complex type containing the response information for the new hosted zone.
" }, "CreateReusableDelegationSetRequest":{ "type":"structure", "required":["CallerReference"], "members":{ "CallerReference":{ "shape":"Nonce", "documentation":"A unique string that identifies the request and that allows failed CreateReusableDelegationSet
requests to be retried without the risk of executing the operation twice. You must use a unique CallerReference
string every time you create a reusable delegation set. CallerReference
can be any unique string; you might choose to use a string that identifies your project, such as DNSMigration_01
.
Valid characters are any Unicode code points that are legal in an XML 1.0 document. The UTF-8 encoding of the value must be less than 128 bytes.
" }, "HostedZoneId":{ "shape":"ResourceId", "documentation":"The ID of the hosted zone whose delegation set you want to mark as reusable. It is an optional parameter.
" } } }, "CreateReusableDelegationSetResponse":{ "type":"structure", "required":[ "DelegationSet", "Location" ], "members":{ "DelegationSet":{ "shape":"DelegationSet", "documentation":"A complex type that contains name server information.
" }, "Location":{ "shape":"ResourceURI", "documentation":"The unique URL representing the new reusbale delegation set.
", "location":"header", "locationName":"Location" } } }, "CreateTrafficPolicyInstanceRequest":{ "type":"structure", "required":[ "HostedZoneId", "Name", "TTL", "TrafficPolicyId", "TrafficPolicyVersion" ], "members":{ "HostedZoneId":{ "shape":"ResourceId", "documentation":"The ID of the hosted zone in which you want Amazon Route 53 to create resource record sets by using the configuration in a traffic policy.
" }, "Name":{ "shape":"DNSName", "documentation":"The domain name (such as example.com) or subdomain name (such as www.example.com) for which Amazon Route 53 responds to DNS queries by using the resource record sets that Amazon Route 53 creates for this traffic policy instance.
" }, "TTL":{ "shape":"TTL", "documentation":"The TTL that you want Amazon Route 53 to assign to all of the resource record sets that it creates in the specified hosted zone.
" }, "TrafficPolicyId":{ "shape":"TrafficPolicyId", "documentation":"The ID of the traffic policy that you want to use to create resource record sets in the specified hosted zone.
" }, "TrafficPolicyVersion":{ "shape":"TrafficPolicyVersion", "documentation":"The version of the traffic policy that you want to use to create resource record sets in the specified hosted zone.
" } }, "documentation":"A complex type that contains information about the resource record sets that you want to create based on a specified traffic policy.
" }, "CreateTrafficPolicyInstanceResponse":{ "type":"structure", "required":[ "TrafficPolicyInstance", "Location" ], "members":{ "TrafficPolicyInstance":{ "shape":"TrafficPolicyInstance", "documentation":"A complex type that contains settings for the new traffic policy instance.
" }, "Location":{ "shape":"ResourceURI", "documentation":"A unique URL that represents a new traffic policy instance.
", "location":"header", "locationName":"Location" } }, "documentation":"A complex type that contains the response information for the CreateTrafficPolicyInstance
request.
The name of the traffic policy.
" }, "Document":{ "shape":"TrafficPolicyDocument", "documentation":"The definition of this traffic policy in JSON format.
" }, "Comment":{ "shape":"TrafficPolicyComment", "documentation":"Any comments that you want to include about the traffic policy.
" } }, "documentation":"A complex type that contains information about the traffic policy that you want to create.
" }, "CreateTrafficPolicyResponse":{ "type":"structure", "required":[ "TrafficPolicy", "Location" ], "members":{ "TrafficPolicy":{ "shape":"TrafficPolicy", "documentation":"A complex type that contains settings for the new traffic policy.
" }, "Location":{ "shape":"ResourceURI", "location":"header", "locationName":"Location" } }, "documentation":"A complex type that contains the response information for the CreateTrafficPolicy
request.
The ID of the traffic policy for which you want to create a new version.
", "location":"uri", "locationName":"Id" }, "Document":{ "shape":"TrafficPolicyDocument", "documentation":"The definition of a new traffic policy version, in JSON format. You must specify the full definition of the new traffic policy. You cannot specify just the differences between the new version and a previous version.
" }, "Comment":{ "shape":"TrafficPolicyComment", "documentation":"Any comments that you want to include about the new traffic policy version.
" } }, "documentation":"A complex type that contains information about the traffic policy for which you want to create a new version.
" }, "CreateTrafficPolicyVersionResponse":{ "type":"structure", "required":[ "TrafficPolicy", "Location" ], "members":{ "TrafficPolicy":{ "shape":"TrafficPolicy", "documentation":"A complex type that contains settings for the new version of the traffic policy.
" }, "Location":{ "shape":"ResourceURI", "location":"header", "locationName":"Location" } }, "documentation":"A complex type that contains the response information for the CreateTrafficPolicyVersion
request.
A complex type that contains the authoritative name servers for the hosted zone. Use the method provided by your domain registrar to add an NS record to your domain for each NameServer
that is assigned to your hosted zone.
A complex type that contains name server information.
" }, "DelegationSetAlreadyCreated":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"A delegation set with the same owner and caller reference combination has already been created.
", "exception":true }, "DelegationSetAlreadyReusable":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"The specified delegation set has already been marked as reusable.
", "exception":true }, "DelegationSetInUse":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"The specified delegation contains associated hosted zones which must be deleted before the reusable delegation set can be deleted.
", "exception":true }, "DelegationSetNameServers":{ "type":"list", "member":{ "shape":"DNSName", "locationName":"NameServer" }, "min":1 }, "DelegationSetNotAvailable":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"Amazon Route 53 allows some duplicate domain names, but there is a maximum number of duplicate names. This error indicates that you have reached that maximum. If you want to create another hosted zone with the same name and Amazon Route 53 generates this error, you can request an increase to the limit on the Contact Us page.
", "exception":true }, "DelegationSetNotReusable":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"The specified delegation set has not been marked as reusable.
", "exception":true }, "DelegationSets":{ "type":"list", "member":{ "shape":"DelegationSet", "locationName":"DelegationSet" } }, "DeleteHealthCheckRequest":{ "type":"structure", "required":["HealthCheckId"], "members":{ "HealthCheckId":{ "shape":"HealthCheckId", "documentation":"The ID of the health check to delete.
", "location":"uri", "locationName":"HealthCheckId" } }, "documentation":"A complex type containing the request information for delete health check.
" }, "DeleteHealthCheckResponse":{ "type":"structure", "members":{ }, "documentation":"Empty response for the request.
" }, "DeleteHostedZoneRequest":{ "type":"structure", "required":["Id"], "members":{ "Id":{ "shape":"ResourceId", "documentation":"The ID of the hosted zone you want to delete.
", "location":"uri", "locationName":"Id" } }, "documentation":"A complex type that contains information about the hosted zone that you want to delete.
" }, "DeleteHostedZoneResponse":{ "type":"structure", "required":["ChangeInfo"], "members":{ "ChangeInfo":{ "shape":"ChangeInfo", "documentation":"A complex type that contains the ID, the status, and the date and time of your delete request.
" } }, "documentation":"A complex type containing the response information for the request.
" }, "DeleteReusableDelegationSetRequest":{ "type":"structure", "required":["Id"], "members":{ "Id":{ "shape":"ResourceId", "documentation":"The ID of the reusable delegation set you want to delete.
", "location":"uri", "locationName":"Id" } }, "documentation":"A complex type containing the information for the delete request.
" }, "DeleteReusableDelegationSetResponse":{ "type":"structure", "members":{ }, "documentation":"Empty response for the request.
" }, "DeleteTrafficPolicyInstanceRequest":{ "type":"structure", "required":["Id"], "members":{ "Id":{ "shape":"TrafficPolicyInstanceId", "documentation":"The ID of the traffic policy instance that you want to delete.
A complex type that contains information about the traffic policy instance that you want to delete.
" }, "DeleteTrafficPolicyInstanceResponse":{ "type":"structure", "members":{ }, "documentation":"An empty element.
" }, "DeleteTrafficPolicyRequest":{ "type":"structure", "required":[ "Id", "Version" ], "members":{ "Id":{ "shape":"TrafficPolicyId", "documentation":"The ID of the traffic policy that you want to delete.
", "location":"uri", "locationName":"Id" }, "Version":{ "shape":"TrafficPolicyVersion", "documentation":"The version number of the traffic policy that you want to delete.
", "location":"uri", "locationName":"Version" } }, "documentation":"A request to delete a specified traffic policy version.
" }, "DeleteTrafficPolicyResponse":{ "type":"structure", "members":{ }, "documentation":"An empty element.
" }, "DisassociateVPCComment":{"type":"string"}, "DisassociateVPCFromHostedZoneRequest":{ "type":"structure", "required":[ "HostedZoneId", "VPC" ], "members":{ "HostedZoneId":{ "shape":"ResourceId", "documentation":"The ID of the hosted zone you want to disassociate your VPC from.
Note that you cannot disassociate the last VPC from a hosted zone.
", "location":"uri", "locationName":"Id" }, "VPC":{ "shape":"VPC", "documentation":"The VPC that you want your hosted zone to be disassociated from.
" }, "Comment":{ "shape":"DisassociateVPCComment", "documentation":"Optional: Any comments you want to include about a DisassociateVPCFromHostedZoneRequest
.
A complex type that contains information about the request to disassociate a VPC from an hosted zone.
" }, "DisassociateVPCFromHostedZoneResponse":{ "type":"structure", "required":["ChangeInfo"], "members":{ "ChangeInfo":{ "shape":"ChangeInfo", "documentation":"A complex type that contains the ID, the status, and the date and time of your DisassociateVPCFromHostedZoneRequest
.
A complex type containing the response information for the request.
" }, "ErrorMessage":{"type":"string"}, "ErrorMessages":{ "type":"list", "member":{ "shape":"ErrorMessage", "locationName":"Message" } }, "FailureThreshold":{ "type":"integer", "max":10, "min":1 }, "FullyQualifiedDomainName":{ "type":"string", "max":255 }, "GeoLocation":{ "type":"structure", "members":{ "ContinentCode":{ "shape":"GeoLocationContinentCode", "documentation":"The code for a continent geo location. Note: only continent locations have a continent code.
Valid values: AF
| AN
| AS
| EU
| OC
| NA
| SA
Constraint: Specifying ContinentCode
with either CountryCode
or SubdivisionCode
returns an InvalidInput error.
The code for a country geo location. The default location uses '*' for the country code and will match all locations that are not matched by a geo location.
The default geo location uses a *
for the country code. All other country codes follow the ISO 3166 two-character code.
The code for a country's subdivision (e.g., a province of Canada). A subdivision code is only valid with the appropriate country code.
Constraint: Specifying SubdivisionCode
without CountryCode
returns an InvalidInput error.
A complex type that contains information about a geo location.
" }, "GeoLocationContinentCode":{ "type":"string", "max":2, "min":2 }, "GeoLocationContinentName":{ "type":"string", "max":32, "min":1 }, "GeoLocationCountryCode":{ "type":"string", "max":2, "min":1 }, "GeoLocationCountryName":{ "type":"string", "max":64, "min":1 }, "GeoLocationDetails":{ "type":"structure", "members":{ "ContinentCode":{ "shape":"GeoLocationContinentCode", "documentation":"The code for a continent geo location. Note: only continent locations have a continent code.
" }, "ContinentName":{ "shape":"GeoLocationContinentName", "documentation":"The name of the continent. This element is only present if ContinentCode
is also present.
The code for a country geo location. The default location uses '*' for the country code and will match all locations that are not matched by a geo location.
The default geo location uses a *
for the country code. All other country codes follow the ISO 3166 two-character code.
The name of the country. This element is only present if CountryCode
is also present.
The code for a country's subdivision (e.g., a province of Canada). A subdivision code is only valid with the appropriate country code.
" }, "SubdivisionName":{ "shape":"GeoLocationSubdivisionName", "documentation":"The name of the subdivision. This element is only present if SubdivisionCode
is also present.
A complex type that contains information about a GeoLocation
.
The ID of the change batch request. The value that you specify here is the value that ChangeResourceRecordSets
returned in the Id element when you submitted the request.
The input for a GetChangeDetails request.
" }, "GetChangeDetailsResponse":{ "type":"structure", "required":["ChangeBatchRecord"], "members":{ "ChangeBatchRecord":{ "shape":"ChangeBatchRecord", "documentation":"A complex type that contains information about the specified change batch, including the change batch ID, the status of the change, and the contained changes.
" } }, "documentation":"A complex type that contains the ChangeBatchRecord
element.
The ID of the change batch request. The value that you specify here is the value that ChangeResourceRecordSets
returned in the Id element when you submitted the request.
The input for a GetChange request.
" }, "GetChangeResponse":{ "type":"structure", "required":["ChangeInfo"], "members":{ "ChangeInfo":{ "shape":"ChangeInfo", "documentation":"A complex type that contains information about the specified change batch, including the change batch ID, the status of the change, and the date and time of the request.
" } }, "documentation":"A complex type that contains the ChangeInfo
element.
Empty request.
" }, "GetCheckerIpRangesResponse":{ "type":"structure", "required":["CheckerIpRanges"], "members":{ "CheckerIpRanges":{ "shape":"CheckerIpRanges", "documentation":"A complex type that contains sorted list of IP ranges in CIDR format for Amazon Route 53 health checkers.
" } }, "documentation":"A complex type that contains the CheckerIpRanges
element.
The code for a continent geo location. Note: only continent locations have a continent code.
Valid values: AF
| AN
| AS
| EU
| OC
| NA
| SA
Constraint: Specifying ContinentCode
with either CountryCode
or SubdivisionCode
returns an InvalidInput error.
The code for a country geo location. The default location uses '*' for the country code and will match all locations that are not matched by a geo location.
The default geo location uses a *
for the country code. All other country codes follow the ISO 3166 two-character code.
The code for a country's subdivision (e.g., a province of Canada). A subdivision code is only valid with the appropriate country code.
Constraint: Specifying SubdivisionCode
without CountryCode
returns an InvalidInput error.
A complex type that contains information about the request to get a geo location.
" }, "GetGeoLocationResponse":{ "type":"structure", "required":["GeoLocationDetails"], "members":{ "GeoLocationDetails":{ "shape":"GeoLocationDetails", "documentation":"A complex type that contains the information about the specified geo location.
" } }, "documentation":"A complex type containing information about the specified geo location.
" }, "GetHealthCheckCountRequest":{ "type":"structure", "members":{ }, "documentation":"To retrieve a count of all your health checks, send a GET
request to the 2013-04-01/healthcheckcount
resource.
The number of health checks associated with the current AWS account.
" } }, "documentation":"A complex type that contains the count of health checks associated with the current AWS account.
" }, "GetHealthCheckLastFailureReasonRequest":{ "type":"structure", "required":["HealthCheckId"], "members":{ "HealthCheckId":{ "shape":"HealthCheckId", "documentation":"The ID of the health check for which you want to retrieve the reason for the most recent failure.
", "location":"uri", "locationName":"HealthCheckId" } }, "documentation":"A complex type that contains information about the request to get the most recent failure reason for a health check.
" }, "GetHealthCheckLastFailureReasonResponse":{ "type":"structure", "required":["HealthCheckObservations"], "members":{ "HealthCheckObservations":{ "shape":"HealthCheckObservations", "documentation":"A list that contains one HealthCheckObservation
element for each Amazon Route 53 health checker.
A complex type that contains information about the most recent failure for the specified health check.
" }, "GetHealthCheckRequest":{ "type":"structure", "required":["HealthCheckId"], "members":{ "HealthCheckId":{ "shape":"HealthCheckId", "documentation":"The ID of the health check to retrieve.
", "location":"uri", "locationName":"HealthCheckId" } }, "documentation":"A complex type that contains information about the request to get a health check.
" }, "GetHealthCheckResponse":{ "type":"structure", "required":["HealthCheck"], "members":{ "HealthCheck":{ "shape":"HealthCheck", "documentation":"A complex type that contains the information about the specified health check.
" } }, "documentation":"A complex type containing information about the specified health check.
" }, "GetHealthCheckStatusRequest":{ "type":"structure", "required":["HealthCheckId"], "members":{ "HealthCheckId":{ "shape":"HealthCheckId", "documentation":"If you want Amazon Route 53 to return this resource record set in response to a DNS query only when a health check is passing, include the HealthCheckId
element and specify the ID of the applicable health check.
Amazon Route 53 determines whether a resource record set is healthy by periodically sending a request to the endpoint that is specified in the health check. If that endpoint returns an HTTP status code of 2xx or 3xx, the endpoint is healthy. If the endpoint returns an HTTP status code of 400 or greater, or if the endpoint doesn't respond for a certain amount of time, Amazon Route 53 considers the endpoint unhealthy and also considers the resource record set unhealthy.
The HealthCheckId
element is only useful when Amazon Route 53 is choosing between two or more resource record sets to respond to a DNS query, and you want Amazon Route 53 to base the choice in part on the status of a health check. Configuring health checks only makes sense in the following configurations:
You set EvaluateTargetHealth
to true
for the resource record sets in an alias, weighted alias, latency alias, geolocation alias, or failover alias resource record set, and you specify health check IDs for all of the resource record sets that are referenced by the alias resource record sets. For more information about this configuration, see EvaluateTargetHealth.
Amazon Route 53 doesn't check the health of the endpoint specified in the resource record set, for example, the endpoint specified by the IP address in the Value
element. When you add a HealthCheckId
element to a resource record set, Amazon Route 53 checks the health of the endpoint that you specified in the health check.
For geolocation resource record sets, if an endpoint is unhealthy, Amazon Route 53 looks for a resource record set for the larger, associated geographic region. For example, suppose you have resource record sets for a state in the United States, for the United States, for North America, and for all locations. If the endpoint for the state resource record set is unhealthy, Amazon Route 53 checks the resource record sets for the United States, for North America, and for all locations (a resource record set for which the value of CountryCode is *
), in that order, until it finds a resource record set for which the endpoint is healthy.
If your health checks specify the endpoint only by domain name, we recommend that you create a separate health check for each endpoint. For example, create a health check for each HTTP server that is serving content for www.example.com. For the value of FullyQualifiedDomainName
, specify the domain name of the server (such as us-east-1-www.example.com
), not the name of the resource record sets (example.com).
FullyQualifiedDomainName
matches the name of the resource record sets and then associate the health check with those resource record sets, health check results will be unpredictable.A complex type that contains information about the request to get health check status for a health check.
" }, "GetHealthCheckStatusResponse":{ "type":"structure", "required":["HealthCheckObservations"], "members":{ "HealthCheckObservations":{ "shape":"HealthCheckObservations", "documentation":"A list that contains one HealthCheckObservation
element for each Amazon Route 53 health checker.
A complex type that contains information about the status of the specified health check.
" }, "GetHostedZoneCountRequest":{ "type":"structure", "members":{ }, "documentation":"To retrieve a count of all your hosted zones, send a GET
request to the 2013-04-01/hostedzonecount
resource.
The number of hosted zones associated with the current AWS account.
" } }, "documentation":"A complex type that contains the count of hosted zones associated with the current AWS account.
" }, "GetHostedZoneRequest":{ "type":"structure", "required":["Id"], "members":{ "Id":{ "shape":"ResourceId", "documentation":"The ID of the hosted zone for which you want to get a list of the name servers in the delegation set.
", "location":"uri", "locationName":"Id" } }, "documentation":"The input for a GetHostedZone request.
" }, "GetHostedZoneResponse":{ "type":"structure", "required":["HostedZone"], "members":{ "HostedZone":{ "shape":"HostedZone", "documentation":"A complex type that contains the information about the specified hosted zone.
" }, "DelegationSet":{ "shape":"DelegationSet", "documentation":"A complex type that contains information about the name servers for the specified hosted zone.
" }, "VPCs":{ "shape":"VPCs", "documentation":"A complex type that contains information about VPCs associated with the specified hosted zone.
" } }, "documentation":"A complex type containing information about the specified hosted zone.
" }, "GetReusableDelegationSetRequest":{ "type":"structure", "required":["Id"], "members":{ "Id":{ "shape":"ResourceId", "documentation":"The ID of the reusable delegation set for which you want to get a list of the name server.
", "location":"uri", "locationName":"Id" } }, "documentation":"The input for a GetReusableDelegationSet request.
" }, "GetReusableDelegationSetResponse":{ "type":"structure", "required":["DelegationSet"], "members":{ "DelegationSet":{ "shape":"DelegationSet", "documentation":"A complex type that contains the information about the nameservers for the specified delegation set ID.
" } }, "documentation":"A complex type containing information about the specified reusable delegation set.
" }, "GetTrafficPolicyInstanceCountRequest":{ "type":"structure", "members":{ }, "documentation":"To retrieve a count of all your traffic policy instances, send a GET
request to the 2013-04-01/trafficpolicyinstancecount
resource.
The number of traffic policy instances that are associated with the current AWS account.
" } }, "documentation":"A complex type that contains information about the number of traffic policy instances that are associated with the current AWS account.
" }, "GetTrafficPolicyInstanceRequest":{ "type":"structure", "required":["Id"], "members":{ "Id":{ "shape":"TrafficPolicyInstanceId", "documentation":"The ID of the traffic policy instance that you want to get information about.
", "location":"uri", "locationName":"Id" } }, "documentation":"Gets information about a specified traffic policy instance.
To get information about a traffic policy instance, send a GET
request to the 2013-04-01/trafficpolicyinstance/Id
resource.
A complex type that contains settings for the traffic policy instance.
" } }, "documentation":"A complex type that contains information about the resource record sets that Amazon Route 53 created based on a specified traffic policy.
" }, "GetTrafficPolicyRequest":{ "type":"structure", "required":[ "Id", "Version" ], "members":{ "Id":{ "shape":"TrafficPolicyId", "documentation":"The ID of the traffic policy that you want to get information about.
", "location":"uri", "locationName":"Id" }, "Version":{ "shape":"TrafficPolicyVersion", "documentation":"The version number of the traffic policy that you want to get information about.
", "location":"uri", "locationName":"Version" } }, "documentation":"Gets information about a specific traffic policy version. To get the information, send a GET request to the 2013-04-01/trafficpolicy resource, and specify the ID and the version of the traffic policy.
" }, "GetTrafficPolicyResponse":{ "type":"structure", "required":["TrafficPolicy"], "members":{ "TrafficPolicy":{ "shape":"TrafficPolicy", "documentation":"A complex type that contains settings for the specified traffic policy.
" } }, "documentation":"A complex type that contains the response information for the request.
" }, "HealthCheck":{ "type":"structure", "required":[ "Id", "CallerReference", "HealthCheckConfig", "HealthCheckVersion" ], "members":{ "Id":{ "shape":"HealthCheckId", "documentation":"The ID of the specified health check.
" }, "CallerReference":{ "shape":"HealthCheckNonce", "documentation":"A unique string that identifies the request to create the health check.
" }, "HealthCheckConfig":{ "shape":"HealthCheckConfig", "documentation":"A complex type that contains the health check configuration.
" }, "HealthCheckVersion":{ "shape":"HealthCheckVersion", "documentation":"The version of the health check. You can optionally pass this value in a call to UpdateHealthCheck
to prevent overwriting another change to the health check.
A complex type that contains identifying information about the health check.
" }, "HealthCheckAlreadyExists":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"The health check you are trying to create already exists. Amazon Route 53 returns this error when a health check has already been created with the specified CallerReference
.
IP Address of the instance being checked.
" }, "Port":{ "shape":"Port", "documentation":"Port on which connection will be opened to the instance to health check. For HTTP and HTTP_STR_MATCH this defaults to 80 if the port is not specified. For HTTPS and HTTPS_STR_MATCH this defaults to 443 if the port is not specified.
" }, "Type":{ "shape":"HealthCheckType", "documentation":"The type of health check to be performed. Currently supported types are TCP, HTTP, HTTPS, HTTP_STR_MATCH, and HTTPS_STR_MATCH.
" }, "ResourcePath":{ "shape":"ResourcePath", "documentation":"Path to ping on the instance to check the health. Required for HTTP, HTTPS, HTTP_STR_MATCH, and HTTPS_STR_MATCH health checks. The HTTP request is issued to the instance on the given port and path.
" }, "FullyQualifiedDomainName":{ "shape":"FullyQualifiedDomainName", "documentation":"Fully qualified domain name of the instance to be health checked.
" }, "SearchString":{ "shape":"SearchString", "documentation":"A string to search for in the body of a health check response. Required for HTTP_STR_MATCH and HTTPS_STR_MATCH health checks.
" }, "RequestInterval":{ "shape":"RequestInterval", "documentation":"The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health-check request.
Each Amazon Route 53 health checker makes requests at this interval. Valid values are 10 and 30. The default value is 30.
" }, "FailureThreshold":{ "shape":"FailureThreshold", "documentation":"The number of consecutive health checks that an endpoint must pass or fail for Amazon Route 53 to change the current status of the endpoint from unhealthy to healthy or vice versa.
Valid values are integers between 1 and 10. For more information, see \"How Amazon Route 53 Determines Whether an Endpoint Is Healthy\" in the Amazon Route 53 Developer Guide.
" }, "MeasureLatency":{ "shape":"MeasureLatency", "documentation":"A Boolean value that indicates whether you want Amazon Route 53 to measure the latency between health checkers in multiple AWS regions and your endpoint and to display CloudWatch latency graphs in the Amazon Route 53 console.
" }, "Inverted":{ "shape":"Inverted", "documentation":"A boolean value that indicates whether the status of health check should be inverted. For example, if a health check is healthy but Inverted
is True
, then Amazon Route 53 considers the health check to be unhealthy.
The minimum number of child health checks that must be healthy for Amazon Route 53 to consider the parent health check to be healthy. Valid values are integers between 0 and 256, inclusive.
" }, "ChildHealthChecks":{ "shape":"ChildHealthCheckList", "documentation":"For a specified parent health check, a list of HealthCheckId
values for the associated child health checks.
A complex type that contains the health check configuration.
" }, "HealthCheckCount":{"type":"long"}, "HealthCheckId":{ "type":"string", "max":64 }, "HealthCheckInUse":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"There are resource records associated with this health check. Before you can delete the health check, you must disassociate it from the resource record sets.
", "error":{"httpStatusCode":400}, "exception":true }, "HealthCheckNonce":{ "type":"string", "max":64, "min":1 }, "HealthCheckObservation":{ "type":"structure", "members":{ "IPAddress":{ "shape":"IPAddress", "documentation":"The IP address of the Amazon Route 53 health checker that performed the health check.
" }, "StatusReport":{ "shape":"StatusReport", "documentation":"A complex type that contains information about the health check status for the current observation.
" } }, "documentation":"A complex type that contains the IP address of a Amazon Route 53 health checker and the reason for the health check status.
" }, "HealthCheckObservations":{ "type":"list", "member":{ "shape":"HealthCheckObservation", "locationName":"HealthCheckObservation" } }, "HealthCheckType":{ "type":"string", "enum":[ "HTTP", "HTTPS", "HTTP_STR_MATCH", "HTTPS_STR_MATCH", "TCP", "CALCULATED" ] }, "HealthCheckVersion":{ "type":"long", "min":1 }, "HealthCheckVersionMismatch":{ "type":"structure", "members":{ "message":{"shape":"ErrorMessage"} }, "error":{"httpStatusCode":409}, "exception":true }, "HealthChecks":{ "type":"list", "member":{ "shape":"HealthCheck", "locationName":"HealthCheck" } }, "HealthThreshold":{ "type":"integer", "max":256, "min":0 }, "HostedZone":{ "type":"structure", "required":[ "Id", "Name", "CallerReference" ], "members":{ "Id":{ "shape":"ResourceId", "documentation":"The ID of the specified hosted zone.
" }, "Name":{ "shape":"DNSName", "documentation":"The name of the domain. This must be a fully-specified domain, for example, www.example.com. The trailing dot is optional; Amazon Route 53 assumes that the domain name is fully qualified. This means that Amazon Route 53 treats www.example.com (without a trailing dot) and www.example.com. (with a trailing dot) as identical.
This is the name you have registered with your DNS registrar. You should ask your registrar to change the authoritative name servers for your domain to the set of NameServers
elements returned in DelegationSet
.
A unique string that identifies the request to create the hosted zone.
" }, "Config":{ "shape":"HostedZoneConfig", "documentation":"A complex type that contains the Comment
element.
Total number of resource record sets in the hosted zone.
" } }, "documentation":"A complex type that contain information about the specified hosted zone.
" }, "HostedZoneAlreadyExists":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"The hosted zone you are trying to create already exists. Amazon Route 53 returns this error when a hosted zone has already been created with the specified CallerReference
.
An optional comment about your hosted zone. If you don't want to specify a comment, you can omit the HostedZoneConfig
and Comment
elements from the XML document.
A complex type that contains an optional comment about your hosted zone. If you don't want to specify a comment, you can omit the HostedZoneConfig
and Comment
elements from the XML document.
Descriptive message for the error response.
" } }, "documentation":"The hosted zone contains resource record sets in addition to the default NS and SOA resource record sets. Before you can delete the hosted zone, you must delete the additional resource record sets.
", "error":{"httpStatusCode":400}, "exception":true }, "HostedZoneNotFound":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"The specified HostedZone cannot be found.
", "exception":true }, "HostedZoneRRSetCount":{"type":"long"}, "HostedZones":{ "type":"list", "member":{ "shape":"HostedZone", "locationName":"HostedZone" } }, "IPAddress":{ "type":"string", "max":15, "pattern":"^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$" }, "IPAddressCidr":{"type":"string"}, "IncompatibleVersion":{ "type":"structure", "members":{ "message":{"shape":"ErrorMessage"} }, "documentation":"The resource you are trying to access is unsupported on this Amazon Route 53 endpoint. Please consider using a newer endpoint or a tool that does so.
", "error":{"httpStatusCode":400}, "exception":true }, "InvalidArgument":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"At least one of the specified arguments is invalid.
", "exception":true }, "InvalidChangeBatch":{ "type":"structure", "members":{ "messages":{ "shape":"ErrorMessages", "documentation":"Descriptive message for the error response.
" } }, "documentation":"This error contains a list of one or more error messages. Each error message indicates one error in the change batch. For more information, see Example InvalidChangeBatch Errors.
", "exception":true }, "InvalidDomainName":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"This error indicates that the specified domain name is not valid.
", "error":{"httpStatusCode":400}, "exception":true }, "InvalidInput":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"Some value specified in the request is invalid or the XML document is malformed.
", "error":{"httpStatusCode":400}, "exception":true }, "InvalidTrafficPolicyDocument":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"The format of the traffic policy document that you specified in the Document
element is invalid.
Descriptive message for the error response.
" } }, "documentation":"The hosted zone you are trying to create for your VPC_ID does not belong to you. Amazon Route 53 returns this error when the VPC specified by VPCId
does not belong to you.
Descriptive message for the error response.
" } }, "documentation":"The VPC you are trying to disassociate from the hosted zone is the last the VPC that is associated with the hosted zone. Amazon Route 53 currently doesn't support disassociate the last VPC from the hosted zone.
", "error":{"httpStatusCode":400}, "exception":true }, "LimitsExceeded":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"The limits specified for a resource have been exceeded.
", "exception":true }, "ListChangeBatchesByHostedZoneRequest":{ "type":"structure", "required":[ "HostedZoneId", "StartDate", "EndDate" ], "members":{ "HostedZoneId":{ "shape":"ResourceId", "documentation":"The ID of the hosted zone that you want to see changes for.
", "location":"uri", "locationName":"Id" }, "StartDate":{ "shape":"Date", "documentation":"The start of the time period you want to see changes for.
", "location":"querystring", "locationName":"startDate" }, "EndDate":{ "shape":"Date", "documentation":"The end of the time period you want to see changes for.
", "location":"querystring", "locationName":"endDate" }, "MaxItems":{ "shape":"PageMaxItems", "documentation":"The maximum number of items on a page.
", "location":"querystring", "locationName":"maxItems" }, "Marker":{ "shape":"PageMarker", "documentation":"The page marker.
", "location":"querystring", "locationName":"marker" } }, "documentation":"The input for a ListChangeBatchesByHostedZone request.
" }, "ListChangeBatchesByHostedZoneResponse":{ "type":"structure", "required":[ "MaxItems", "Marker", "ChangeBatchRecords" ], "members":{ "MaxItems":{ "shape":"PageMaxItems", "documentation":"The maximum number of items on a page.
" }, "Marker":{ "shape":"PageMarker", "documentation":"The page marker.
" }, "IsTruncated":{ "shape":"PageTruncated", "documentation":"A flag that indicates if there are more change batches to list.
" }, "ChangeBatchRecords":{ "shape":"ChangeBatchRecords", "documentation":"The change batches within the given hosted zone and time period.
" }, "NextMarker":{ "shape":"PageMarker", "documentation":"The next page marker.
" } }, "documentation":"The input for a ListChangeBatchesByHostedZone request.
" }, "ListChangeBatchesByRRSetRequest":{ "type":"structure", "required":[ "HostedZoneId", "Name", "Type", "StartDate", "EndDate" ], "members":{ "HostedZoneId":{ "shape":"ResourceId", "documentation":"The ID of the hosted zone that you want to see changes for.
", "location":"uri", "locationName":"Id" }, "Name":{ "shape":"DNSName", "documentation":"The name of the RRSet that you want to see changes for.
", "location":"querystring", "locationName":"rrSet_name" }, "Type":{ "shape":"RRType", "documentation":"The type of the RRSet that you want to see changes for.
", "location":"querystring", "locationName":"type" }, "SetIdentifier":{ "shape":"ResourceRecordSetIdentifier", "documentation":"The identifier of the RRSet that you want to see changes for.
", "location":"querystring", "locationName":"identifier" }, "StartDate":{ "shape":"Date", "documentation":"The start of the time period you want to see changes for.
", "location":"querystring", "locationName":"startDate" }, "EndDate":{ "shape":"Date", "documentation":"The end of the time period you want to see changes for.
", "location":"querystring", "locationName":"endDate" }, "MaxItems":{ "shape":"PageMaxItems", "documentation":"The maximum number of items on a page.
", "location":"querystring", "locationName":"maxItems" }, "Marker":{ "shape":"PageMarker", "documentation":"The page marker.
", "location":"querystring", "locationName":"marker" } }, "documentation":"The input for a ListChangeBatchesByRRSet request.
" }, "ListChangeBatchesByRRSetResponse":{ "type":"structure", "required":[ "MaxItems", "Marker", "ChangeBatchRecords" ], "members":{ "MaxItems":{ "shape":"PageMaxItems", "documentation":"The maximum number of items on a page.
" }, "Marker":{ "shape":"PageMarker", "documentation":"The page marker.
" }, "IsTruncated":{ "shape":"PageTruncated", "documentation":"A flag that indicates if there are more change batches to list.
" }, "ChangeBatchRecords":{ "shape":"ChangeBatchRecords", "documentation":"The change batches within the given hosted zone and time period.
" }, "NextMarker":{ "shape":"PageMarker", "documentation":"The next page marker.
" } }, "documentation":"The input for a ListChangeBatchesByRRSet request.
" }, "ListGeoLocationsRequest":{ "type":"structure", "members":{ "StartContinentCode":{ "shape":"GeoLocationContinentCode", "documentation":"The first continent code in the lexicographic ordering of geo locations that you want the ListGeoLocations
request to list. For non-continent geo locations, this should be null.
Valid values: AF
| AN
| AS
| EU
| OC
| NA
| SA
Constraint: Specifying ContinentCode
with either CountryCode
or SubdivisionCode
returns an InvalidInput error.
The first country code in the lexicographic ordering of geo locations that you want the ListGeoLocations
request to list.
The default geo location uses a *
for the country code. All other country codes follow the ISO 3166 two-character code.
The first subdivision code in the lexicographic ordering of geo locations that you want the ListGeoLocations
request to list.
Constraint: Specifying SubdivisionCode
without CountryCode
returns an InvalidInput error.
The maximum number of geo locations you want in the response body.
", "location":"querystring", "locationName":"maxitems" } }, "documentation":"The input for a ListGeoLocations request.
" }, "ListGeoLocationsResponse":{ "type":"structure", "required":[ "GeoLocationDetailsList", "IsTruncated", "MaxItems" ], "members":{ "GeoLocationDetailsList":{ "shape":"GeoLocationDetailsList", "documentation":"A complex type that contains information about the geo locations that are returned by the request.
" }, "IsTruncated":{ "shape":"PageTruncated", "documentation":"A flag that indicates whether there are more geo locations to be listed. If your results were truncated, you can make a follow-up request for the next page of results by using the values included in the ListGeoLocationsResponse$NextContinentCode, ListGeoLocationsResponse$NextCountryCode and ListGeoLocationsResponse$NextSubdivisionCode elements.
Valid Values: true
| false
If the results were truncated, the continent code of the next geo location in the list. This element is present only if ListGeoLocationsResponse$IsTruncated is true and the next geo location to list is a continent location.
" }, "NextCountryCode":{ "shape":"GeoLocationCountryCode", "documentation":"If the results were truncated, the country code of the next geo location in the list. This element is present only if ListGeoLocationsResponse$IsTruncated is true and the next geo location to list is not a continent location.
" }, "NextSubdivisionCode":{ "shape":"GeoLocationSubdivisionCode", "documentation":"If the results were truncated, the subdivision code of the next geo location in the list. This element is present only if ListGeoLocationsResponse$IsTruncated is true and the next geo location has a subdivision.
" }, "MaxItems":{ "shape":"PageMaxItems", "documentation":"The maximum number of records you requested. The maximum value of MaxItems
is 100.
A complex type that contains information about the geo locations that are returned by the request and information about the response.
" }, "ListHealthChecksRequest":{ "type":"structure", "members":{ "Marker":{ "shape":"PageMarker", "documentation":"If the request returned more than one page of results, submit another request and specify the value of NextMarker
from the last response in the marker
parameter to get the next page of results.
Specify the maximum number of health checks to return per page of results.
", "location":"querystring", "locationName":"maxitems" } }, "documentation":"To retrieve a list of your health checks, send a GET
request to the 2013-04-01/healthcheck
resource. The response to this request includes a HealthChecks
element with zero or more HealthCheck
child elements. By default, the list of health checks is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems
parameter. You can use the Marker
parameter to control the health check that the list begins with.
MaxItems
to a value greater than 100, Amazon Route 53 returns only the first 100.A complex type that contains information about the health checks associated with the current AWS account.
" }, "Marker":{ "shape":"PageMarker", "documentation":"If the request returned more than one page of results, submit another request and specify the value of NextMarker
from the last response in the marker
parameter to get the next page of results.
A flag indicating whether there are more health checks to be listed. If your results were truncated, you can make a follow-up request for the next page of results by using the Marker
element.
Valid Values: true
| false
Indicates where to continue listing health checks. If ListHealthChecksResponse$IsTruncated is true
, make another request to ListHealthChecks
and include the value of the NextMarker
element in the Marker
element to get the next page of results.
The maximum number of health checks to be included in the response body. If the number of health checks associated with this AWS account exceeds MaxItems
, the value of ListHealthChecksResponse$IsTruncated in the response is true
. Call ListHealthChecks
again and specify the value of ListHealthChecksResponse$NextMarker in the ListHostedZonesRequest$Marker element to get the next page of results.
A complex type that contains the response for the request.
" }, "ListHostedZonesByNameRequest":{ "type":"structure", "members":{ "DNSName":{ "shape":"DNSName", "documentation":"The first name in the lexicographic ordering of domain names that you want the ListHostedZonesByNameRequest
request to list.
If the request returned more than one page of results, submit another request and specify the value of NextDNSName
and NextHostedZoneId
from the last response in the DNSName
and HostedZoneId
parameters to get the next page of results.
If the request returned more than one page of results, submit another request and specify the value of NextDNSName
and NextHostedZoneId
from the last response in the DNSName
and HostedZoneId
parameters to get the next page of results.
Specify the maximum number of hosted zones to return per page of results.
", "location":"querystring", "locationName":"maxitems" } }, "documentation":"To retrieve a list of your hosted zones in lexicographic order, send a GET
request to the 2013-04-01/hostedzonesbyname
resource. The response to this request includes a HostedZones
element with zero or more HostedZone
child elements lexicographically ordered by DNS name. By default, the list of hosted zones is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems
parameter. You can use the DNSName
and HostedZoneId
parameters to control the hosted zone that the list begins with.
For more information about listing hosted zones, see Listing the Hosted Zones for an AWS Account in the Amazon Route 53 Developer Guide.
" }, "ListHostedZonesByNameResponse":{ "type":"structure", "required":[ "HostedZones", "IsTruncated", "MaxItems" ], "members":{ "HostedZones":{ "shape":"HostedZones", "documentation":"A complex type that contains information about the hosted zones associated with the current AWS account.
" }, "DNSName":{ "shape":"DNSName", "documentation":"The DNSName
value sent in the request.
The HostedZoneId
value sent in the request.
A flag indicating whether there are more hosted zones to be listed. If your results were truncated, you can make a follow-up request for the next page of results by using the NextDNSName
and NextHostedZoneId
elements.
Valid Values: true
| false
If ListHostedZonesByNameResponse$IsTruncated is true
, there are more hosted zones associated with the current AWS account. To get the next page of results, make another request to ListHostedZonesByName
. Specify the value of ListHostedZonesByNameResponse$NextDNSName in the ListHostedZonesByNameRequest$DNSName element and ListHostedZonesByNameResponse$NextHostedZoneId in the ListHostedZonesByNameRequest$HostedZoneId element.
If ListHostedZonesByNameResponse$IsTruncated is true
, there are more hosted zones associated with the current AWS account. To get the next page of results, make another request to ListHostedZonesByName
. Specify the value of ListHostedZonesByNameResponse$NextDNSName in the ListHostedZonesByNameRequest$DNSName element and ListHostedZonesByNameResponse$NextHostedZoneId in the ListHostedZonesByNameRequest$HostedZoneId element.
The maximum number of hosted zones to be included in the response body. If the number of hosted zones associated with this AWS account exceeds MaxItems
, the value of ListHostedZonesByNameResponse$IsTruncated in the response is true
. Call ListHostedZonesByName
again and specify the value of ListHostedZonesByNameResponse$NextDNSName and ListHostedZonesByNameResponse$NextHostedZoneId elements respectively to get the next page of results.
A complex type that contains the response for the request.
" }, "ListHostedZonesRequest":{ "type":"structure", "members":{ "Marker":{ "shape":"PageMarker", "documentation":"If the request returned more than one page of results, submit another request and specify the value of NextMarker
from the last response in the marker
parameter to get the next page of results.
Specify the maximum number of hosted zones to return per page of results.
", "location":"querystring", "locationName":"maxitems" }, "DelegationSetId":{ "shape":"ResourceId", "location":"querystring", "locationName":"delegationsetid" } }, "documentation":"To retrieve a list of your hosted zones, send a GET
request to the 2013-04-01/hostedzone
resource. The response to this request includes a HostedZones
element with zero or more HostedZone
child elements. By default, the list of hosted zones is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems
parameter. You can use the Marker
parameter to control the hosted zone that the list begins with. For more information about listing hosted zones, see Listing the Hosted Zones for an AWS Account in the Amazon Route 53 Developer Guide.
MaxItems
to a value greater than 100, Amazon Route 53 returns only the first 100.A complex type that contains information about the hosted zones associated with the current AWS account.
" }, "Marker":{ "shape":"PageMarker", "documentation":"If the request returned more than one page of results, submit another request and specify the value of NextMarker
from the last response in the marker
parameter to get the next page of results.
A flag indicating whether there are more hosted zones to be listed. If your results were truncated, you can make a follow-up request for the next page of results by using the Marker
element.
Valid Values: true
| false
Indicates where to continue listing hosted zones. If ListHostedZonesResponse$IsTruncated is true
, make another request to ListHostedZones
and include the value of the NextMarker
element in the Marker
element to get the next page of results.
The maximum number of hosted zones to be included in the response body. If the number of hosted zones associated with this AWS account exceeds MaxItems
, the value of ListHostedZonesResponse$IsTruncated in the response is true
. Call ListHostedZones
again and specify the value of ListHostedZonesResponse$NextMarker in the ListHostedZonesRequest$Marker element to get the next page of results.
A complex type that contains the response for the request.
" }, "ListResourceRecordSetsRequest":{ "type":"structure", "required":["HostedZoneId"], "members":{ "HostedZoneId":{ "shape":"ResourceId", "documentation":"The ID of the hosted zone that contains the resource record sets that you want to get.
", "location":"uri", "locationName":"Id" }, "StartRecordName":{ "shape":"DNSName", "documentation":"The first name in the lexicographic ordering of domain names that you want the ListResourceRecordSets
request to list.
The DNS type at which to begin the listing of resource record sets.
Valid values: A
| AAAA
| CNAME
| MX
| NS
| PTR
| SOA
| SPF
| SRV
| TXT
Values for Weighted Resource Record Sets: A
| AAAA
| CNAME
| TXT
Values for Regional Resource Record Sets: A
| AAAA
| CNAME
| TXT
Values for Alias Resource Record Sets: A
| AAAA
Constraint: Specifying type
without specifying name
returns an InvalidInput error.
Weighted resource record sets only: If results were truncated for a given DNS name and type, specify the value of ListResourceRecordSetsResponse$NextRecordIdentifier
from the previous response to get the next resource record set that has the current DNS name and type.
The maximum number of records you want in the response body.
", "location":"querystring", "locationName":"maxitems" } }, "documentation":"The input for a ListResourceRecordSets request.
" }, "ListResourceRecordSetsResponse":{ "type":"structure", "required":[ "ResourceRecordSets", "IsTruncated", "MaxItems" ], "members":{ "ResourceRecordSets":{ "shape":"ResourceRecordSets", "documentation":"A complex type that contains information about the resource record sets that are returned by the request.
" }, "IsTruncated":{ "shape":"PageTruncated", "documentation":"A flag that indicates whether there are more resource record sets to be listed. If your results were truncated, you can make a follow-up request for the next page of results by using the ListResourceRecordSetsResponse$NextRecordName element.
Valid Values: true
| false
If the results were truncated, the name of the next record in the list. This element is present only if ListResourceRecordSetsResponse$IsTruncated is true.
" }, "NextRecordType":{ "shape":"RRType", "documentation":"If the results were truncated, the type of the next record in the list. This element is present only if ListResourceRecordSetsResponse$IsTruncated is true.
" }, "NextRecordIdentifier":{ "shape":"ResourceRecordSetIdentifier", "documentation":"Weighted resource record sets only: If results were truncated for a given DNS name and type, the value of SetIdentifier
for the next resource record set that has the current DNS name and type.
The maximum number of records you requested. The maximum value of MaxItems
is 100.
A complex type that contains information about the resource record sets that are returned by the request and information about the response.
" }, "ListReusableDelegationSetsRequest":{ "type":"structure", "members":{ "Marker":{ "shape":"PageMarker", "documentation":"If the request returned more than one page of results, submit another request and specify the value of NextMarker
from the last response in the marker
parameter to get the next page of results.
Specify the maximum number of reusable delegation sets to return per page of results.
", "location":"querystring", "locationName":"maxitems" } }, "documentation":"To retrieve a list of your reusable delegation sets, send a GET
request to the 2013-04-01/delegationset
resource. The response to this request includes a DelegationSets
element with zero or more DelegationSet
child elements. By default, the list of reusable delegation sets is displayed on a single page. You can control the length of the page that is displayed by using the MaxItems
parameter. You can use the Marker
parameter to control the delegation set that the list begins with.
MaxItems
to a value greater than 100, Amazon Route 53 returns only the first 100.A complex type that contains information about the reusable delegation sets associated with the current AWS account.
" }, "Marker":{ "shape":"PageMarker", "documentation":"If the request returned more than one page of results, submit another request and specify the value of NextMarker
from the last response in the marker
parameter to get the next page of results.
A flag indicating whether there are more reusable delegation sets to be listed. If your results were truncated, you can make a follow-up request for the next page of results by using the Marker
element.
Valid Values: true
| false
Indicates where to continue listing reusable delegation sets. If ListReusableDelegationSetsResponse$IsTruncated is true
, make another request to ListReusableDelegationSets
and include the value of the NextMarker
element in the Marker
element to get the next page of results.
The maximum number of reusable delegation sets to be included in the response body. If the number of reusable delegation sets associated with this AWS account exceeds MaxItems
, the value of ListReusablDelegationSetsResponse$IsTruncated in the response is true
. Call ListReusableDelegationSets
again and specify the value of ListReusableDelegationSetsResponse$NextMarker in the ListReusableDelegationSetsRequest$Marker element to get the next page of results.
A complex type that contains the response for the request.
" }, "ListTagsForResourceRequest":{ "type":"structure", "required":[ "ResourceType", "ResourceId" ], "members":{ "ResourceType":{ "shape":"TagResourceType", "documentation":"The type of the resource.
- The resource type for health checks is healthcheck
.
- The resource type for hosted zones is hostedzone
.
The ID of the resource for which you want to retrieve tags.
", "location":"uri", "locationName":"ResourceId" } }, "documentation":"A complex type containing information about a request for a list of the tags that are associated with an individual resource.
" }, "ListTagsForResourceResponse":{ "type":"structure", "required":["ResourceTagSet"], "members":{ "ResourceTagSet":{ "shape":"ResourceTagSet", "documentation":"A ResourceTagSet
containing tags associated with the specified resource.
A complex type containing tags for the specified resource.
" }, "ListTagsForResourcesRequest":{ "type":"structure", "required":[ "ResourceType", "ResourceIds" ], "members":{ "ResourceType":{ "shape":"TagResourceType", "documentation":"The type of the resources.
- The resource type for health checks is healthcheck
.
- The resource type for hosted zones is hostedzone
.
A complex type that contains the ResourceId element for each resource for which you want to get a list of tags.
" } }, "documentation":"A complex type containing information about a request for a list of the tags that are associated with up to 10 specified resources.
" }, "ListTagsForResourcesResponse":{ "type":"structure", "required":["ResourceTagSets"], "members":{ "ResourceTagSets":{ "shape":"ResourceTagSetList", "documentation":"A list of ResourceTagSet
s containing tags associated with the specified resources.
A complex type containing tags for the specified resources.
" }, "ListTrafficPoliciesRequest":{ "type":"structure", "members":{ "TrafficPolicyIdMarker":{ "shape":"TrafficPolicyId", "documentation":"For your first request to ListTrafficPolicies
, do not include the TrafficPolicyIdMarker
parameter.
If you have more traffic policies than the value of MaxItems
, ListTrafficPolicies
returns only the first MaxItems
traffic policies. To get the next group of MaxItems
policies, submit another request to ListTrafficPolicies
. For the value of TrafficPolicyIdMarker
, specify the value of the TrafficPolicyIdMarker
element that was returned in the previous response.
Policies are listed in the order in which they were created.
", "location":"querystring", "locationName":"trafficpolicyid" }, "MaxItems":{ "shape":"PageMaxItems", "documentation":"The maximum number of traffic policies to be included in the response body for this request. If you have more than MaxItems
traffic policies, the value of the IsTruncated
element in the response is true
, and the value of the TrafficPolicyIdMarker
element is the ID of the first traffic policy in the next group of MaxItems
traffic policies.
A complex type that contains the information about the request to list the traffic policies that are associated with the current AWS account.
" }, "ListTrafficPoliciesResponse":{ "type":"structure", "required":[ "TrafficPolicySummaries", "IsTruncated", "TrafficPolicyIdMarker", "MaxItems" ], "members":{ "TrafficPolicySummaries":{ "shape":"TrafficPolicySummaries", "documentation":"A list that contains one TrafficPolicySummary
element for each traffic policy that was created by the current AWS account.
A flag that indicates whether there are more traffic policies to be listed. If the response was truncated, you can get the next group of MaxItems
traffic policies by calling ListTrafficPolicies
again and specifying the value of the TrafficPolicyIdMarker
element in the TrafficPolicyIdMarker
request parameter.
Valid Values: true
| false
If the value of IsTruncated
is true
, TrafficPolicyIdMarker
is the ID of the first traffic policy in the next group of MaxItems
traffic policies.
The value that you specified for the MaxItems
parameter in the call to ListTrafficPolicies
that produced the current response.
A complex type that contains the response information for the request.
" }, "ListTrafficPolicyInstancesByHostedZoneRequest":{ "type":"structure", "required":["HostedZoneId"], "members":{ "HostedZoneId":{ "shape":"ResourceId", "documentation":"The ID of the hosted zone for which you want to list traffic policy instances.
", "location":"querystring", "locationName":"id" }, "TrafficPolicyInstanceNameMarker":{ "shape":"DNSName", "documentation":"For the first request to ListTrafficPolicyInstancesByHostedZone
, omit this value.
If the value of IsTruncated
in the previous response was true
, TrafficPolicyInstanceNameMarker
is the name of the first traffic policy instance in the next group of MaxItems
traffic policy instances.
If the value of IsTruncated
in the previous response was false
, there are no more traffic policy instances to get for this hosted zone.
If the value of IsTruncated
in the previous response was false
, omit this value.
For the first request to ListTrafficPolicyInstancesByHostedZone
, omit this value.
If the value of IsTruncated
in the previous response was true
, TrafficPolicyInstanceTypeMarker
is the DNS type of the first traffic policy instance in the next group of MaxItems
traffic policy instances.
If the value of IsTruncated
in the previous response was false
, there are no more traffic policy instances to get for this hosted zone.
The maximum number of traffic policy instances to be included in the response body for this request. If you have more than MaxItems
traffic policy instances, the value of the IsTruncated
element in the response is true
, and the values of HostedZoneIdMarker
, TrafficPolicyInstanceNameMarker
, and TrafficPolicyInstanceTypeMarker
represent the first traffic policy instance in the next group of MaxItems
traffic policy instances.
A request for the traffic policy instances that you created in a specified hosted zone.
" }, "ListTrafficPolicyInstancesByHostedZoneResponse":{ "type":"structure", "required":[ "TrafficPolicyInstances", "IsTruncated", "MaxItems" ], "members":{ "TrafficPolicyInstances":{ "shape":"TrafficPolicyInstances", "documentation":"A list that contains one TrafficPolicyInstance
element for each traffic policy instance that matches the elements in the request.
If IsTruncated
is true
, TrafficPolicyInstanceNameMarker
is the name of the first traffic policy instance in the next group of MaxItems
traffic policy instances.
If IsTruncated
is true, TrafficPolicyInstanceTypeMarker
is the DNS type of the resource record sets that are associated with the first traffic policy instance in the next group of MaxItems
traffic policy instances.
A flag that indicates whether there are more traffic policy instances to be listed. If the response was truncated, you can get the next group of MaxItems
traffic policy instances by calling ListTrafficPolicyInstancesByHostedZone
again and specifying the values of the HostedZoneIdMarker
, TrafficPolicyInstanceNameMarker
, and TrafficPolicyInstanceTypeMarker
elements in the corresponding request parameters.
Valid Values: true
| false
The value that you specified for the MaxItems
parameter in the call to ListTrafficPolicyInstancesByHostedZone
that produced the current response.
A complex type that contains the response information for the request.
" }, "ListTrafficPolicyInstancesByPolicyRequest":{ "type":"structure", "required":[ "TrafficPolicyId", "TrafficPolicyVersion" ], "members":{ "TrafficPolicyId":{ "shape":"TrafficPolicyId", "documentation":"The ID of the traffic policy for which you want to list traffic policy instances.
", "location":"querystring", "locationName":"id" }, "TrafficPolicyVersion":{ "shape":"TrafficPolicyVersion", "documentation":"The version of the traffic policy for which you want to list traffic policy instances. The version must be associated with the traffic policy that is specified by TrafficPolicyId
.
For the first request to ListTrafficPolicyInstancesByPolicy
, omit this value.
If the value of IsTruncated
in the previous response was true
, HostedZoneIdMarker
is the ID of the hosted zone for the first traffic policy instance in the next group of MaxItems
traffic policy instances.
If the value of IsTruncated
in the previous response was false
, there are no more traffic policy instances to get for this hosted zone.
If the value of IsTruncated
in the previous response was false
, omit this value.
For the first request to ListTrafficPolicyInstancesByPolicy
, omit this value.
If the value of IsTruncated
in the previous response was true
, TrafficPolicyInstanceNameMarker
is the name of the first traffic policy instance in the next group of MaxItems
traffic policy instances.
If the value of IsTruncated
in the previous response was false
, there are no more traffic policy instances to get for this hosted zone.
If the value of IsTruncated
in the previous response was false
, omit this value.
For the first request to ListTrafficPolicyInstancesByPolicy
, omit this value.
If the value of IsTruncated
in the previous response was true
, TrafficPolicyInstanceTypeMarker
is the DNS type of the first traffic policy instance in the next group of MaxItems
traffic policy instances.
If the value of IsTruncated
in the previous response was false
, there are no more traffic policy instances to get for this hosted zone.
The maximum number of traffic policy instances to be included in the response body for this request. If you have more than MaxItems
traffic policy instances, the value of the IsTruncated
element in the response is true
, and the values of HostedZoneIdMarker
, TrafficPolicyInstanceNameMarker
, and TrafficPolicyInstanceTypeMarker
represent the first traffic policy instance in the next group of MaxItems
traffic policy instances.
A complex type that contains the information about the request to list your traffic policy instances.
" }, "ListTrafficPolicyInstancesByPolicyResponse":{ "type":"structure", "required":[ "TrafficPolicyInstances", "IsTruncated", "MaxItems" ], "members":{ "TrafficPolicyInstances":{ "shape":"TrafficPolicyInstances", "documentation":"A list that contains one TrafficPolicyInstance
element for each traffic policy instance that matches the elements in the request.
If IsTruncated
is true
, HostedZoneIdMarker
is the ID of the hosted zone of the first traffic policy instance in the next group of MaxItems
traffic policy instances.
If IsTruncated
is true
, TrafficPolicyInstanceNameMarker
is the name of the first traffic policy instance in the next group of MaxItems
traffic policy instances.
If IsTruncated
is true
, TrafficPolicyInstanceTypeMarker
is the DNS type of the resource record sets that are associated with the first traffic policy instance in the next group of MaxItems
traffic policy instances.
A flag that indicates whether there are more traffic policy instances to be listed. If the response was truncated, you can get the next group of MaxItems
traffic policy instances by calling ListTrafficPolicyInstancesByPolicy
again and specifying the values of the HostedZoneIdMarker
, TrafficPolicyInstanceNameMarker
, and TrafficPolicyInstanceTypeMarker
elements in the corresponding request parameters.
Valid Values: true
| false
The value that you specified for the MaxItems
parameter in the call to ListTrafficPolicyInstancesByPolicy
that produced the current response.
A complex type that contains the response information for the request.
" }, "ListTrafficPolicyInstancesRequest":{ "type":"structure", "members":{ "HostedZoneIdMarker":{ "shape":"ResourceId", "documentation":"For the first request to ListTrafficPolicyInstances
, omit this value.
If the value of IsTruncated
in the previous response was true
, you have more traffic policy instances. To get the next group of MaxItems
traffic policy instances, submit another ListTrafficPolicyInstances
request. For the value of HostedZoneIdMarker
, specify the value of HostedZoneIdMarker
from the previous response, which is the hosted zone ID of the first traffic policy instance in the next group of MaxItems
traffic policy instances.
If the value of IsTruncated
in the previous response was false
, there are no more traffic policy instances to get.
For the first request to ListTrafficPolicyInstances
, omit this value.
If the value of IsTruncated
in the previous response was true
, TrafficPolicyInstanceNameMarker
is the name of the first traffic policy instance in the next group of MaxItems
traffic policy instances.
If the value of IsTruncated
in the previous response was false
, there are no more traffic policy instances to get.
For the first request to ListTrafficPolicyInstances
, omit this value.
If the value of IsTruncated
in the previous response was true
, TrafficPolicyInstanceTypeMarker
is the DNS type of the first traffic policy instance in the next group of MaxItems
traffic policy instances.
If the value of IsTruncated
in the previous response was false
, there are no more traffic policy instances to get.
The maximum number of traffic policy instances to be included in the response body for this request. If you have more than MaxItems
traffic policy instances, the value of the IsTruncated
element in the response is true
, and the values of HostedZoneIdMarker
, TrafficPolicyInstanceNameMarker
, and TrafficPolicyInstanceTypeMarker
represent the first traffic policy instance in the next group of MaxItems
traffic policy instances.
A complex type that contains the information about the request to list your traffic policy instances.
" }, "ListTrafficPolicyInstancesResponse":{ "type":"structure", "required":[ "TrafficPolicyInstances", "IsTruncated", "MaxItems" ], "members":{ "TrafficPolicyInstances":{ "shape":"TrafficPolicyInstances", "documentation":"A list that contains one TrafficPolicyInstance
element for each traffic policy instance that matches the elements in the request.
If IsTruncated
is true
, HostedZoneIdMarker
is the ID of the hosted zone of the first traffic policy instance in the next group of MaxItems
traffic policy instances.
If IsTruncated
is true
, TrafficPolicyInstanceNameMarker
is the name of the first traffic policy instance in the next group of MaxItems
traffic policy instances.
If IsTruncated
is true
, TrafficPolicyInstanceTypeMarker
is the DNS type of the resource record sets that are associated with the first traffic policy instance in the next group of MaxItems
traffic policy instances.
A flag that indicates whether there are more traffic policy instances to be listed. If the response was truncated, you can get the next group of MaxItems
traffic policy instances by calling ListTrafficPolicyInstances
again and specifying the values of the HostedZoneIdMarker
, TrafficPolicyInstanceNameMarker
, and TrafficPolicyInstanceTypeMarker
elements in the corresponding request parameters.
Valid Values: true
| false
The value that you specified for the MaxItems
parameter in the call to ListTrafficPolicyInstances
that produced the current response.
A complex type that contains the response information for the request.
" }, "ListTrafficPolicyVersionsRequest":{ "type":"structure", "required":["Id"], "members":{ "Id":{ "shape":"TrafficPolicyId", "documentation":"Specify the value of Id
of the traffic policy for which you want to list all versions.
For your first request to ListTrafficPolicyVersions
, do not include the TrafficPolicyVersionMarker
parameter.
If you have more traffic policy versions than the value of MaxItems
, ListTrafficPolicyVersions
returns only the first group of MaxItems
versions. To get the next group of MaxItems
traffic policy versions, submit another request to ListTrafficPolicyVersions
. For the value of TrafficPolicyVersionMarker
, specify the value of the TrafficPolicyVersionMarker
element that was returned in the previous response.
Traffic policy versions are listed in sequential order.
", "location":"querystring", "locationName":"trafficpolicyversion" }, "MaxItems":{ "shape":"PageMaxItems", "documentation":"The maximum number of traffic policy versions that you want Amazon Route 53 to include in the response body for this request. If the specified traffic policy has more than MaxItems
versions, the value of the IsTruncated
element in the response is true
, and the value of the TrafficPolicyVersionMarker
element is the ID of the first version in the next group of MaxItems
traffic policy versions.
A complex type that contains the information about the request to list your traffic policies.
" }, "ListTrafficPolicyVersionsResponse":{ "type":"structure", "required":[ "TrafficPolicies", "IsTruncated", "TrafficPolicyVersionMarker", "MaxItems" ], "members":{ "TrafficPolicies":{ "shape":"TrafficPolicies", "documentation":"A list that contains one TrafficPolicy
element for each traffic policy version that is associated with the specified traffic policy.
A flag that indicates whether there are more traffic policies to be listed. If the response was truncated, you can get the next group of maxitems
traffic policies by calling ListTrafficPolicyVersions
again and specifying the value of the NextMarker
element in the marker parameter.
Valid Values: true
| false
If IsTruncated
is true
, the value of TrafficPolicyVersionMarker
identifies the first traffic policy in the next group of MaxItems
traffic policies. Call ListTrafficPolicyVersions
again and specify the value of TrafficPolicyVersionMarker
in the TrafficPolicyVersionMarker
request parameter.
This element is present only if IsTruncated
is true
.
The value that you specified for the maxitems
parameter in the call to ListTrafficPolicyVersions
that produced the current response.
A complex type that contains the response information for the request.
" }, "MeasureLatency":{"type":"boolean"}, "Message":{ "type":"string", "max":1024 }, "NoSuchChange":{ "type":"structure", "members":{ "message":{"shape":"ErrorMessage"} }, "error":{"httpStatusCode":404}, "exception":true }, "NoSuchDelegationSet":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"The specified delegation set does not exist.
", "exception":true }, "NoSuchGeoLocation":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"The geo location you are trying to get does not exist.
", "error":{"httpStatusCode":404}, "exception":true }, "NoSuchHealthCheck":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"The health check you are trying to get or delete does not exist.
", "error":{"httpStatusCode":404}, "exception":true }, "NoSuchHostedZone":{ "type":"structure", "members":{ "message":{"shape":"ErrorMessage"} }, "error":{"httpStatusCode":404}, "exception":true }, "NoSuchTrafficPolicy":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"No traffic policy exists with the specified ID.
", "error":{"httpStatusCode":404}, "exception":true }, "NoSuchTrafficPolicyInstance":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"No traffic policy instance exists with the specified ID.
", "error":{"httpStatusCode":404}, "exception":true }, "Nonce":{ "type":"string", "max":128, "min":1 }, "PageMarker":{ "type":"string", "max":64 }, "PageMaxItems":{"type":"string"}, "PageTruncated":{"type":"boolean"}, "Port":{ "type":"integer", "max":65535, "min":1 }, "PriorRequestNotComplete":{ "type":"structure", "members":{ "message":{"shape":"ErrorMessage"} }, "documentation":"The request was rejected because Amazon Route 53 was still processing a prior request.
", "error":{"httpStatusCode":400}, "exception":true }, "PublicZoneVPCAssociation":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"The hosted zone you are trying to associate VPC with doesn't have any VPC association. Amazon Route 53 currently doesn't support associate a VPC with a public hosted zone.
", "error":{"httpStatusCode":400}, "exception":true }, "RData":{ "type":"string", "max":4000 }, "RRType":{ "type":"string", "enum":[ "SOA", "A", "TXT", "NS", "CNAME", "MX", "PTR", "SRV", "SPF", "AAAA" ] }, "RequestInterval":{ "type":"integer", "max":30, "min":10 }, "ResourceDescription":{ "type":"string", "max":256 }, "ResourceId":{ "type":"string", "max":32 }, "ResourcePath":{ "type":"string", "max":255 }, "ResourceRecord":{ "type":"structure", "required":["Value"], "members":{ "Value":{ "shape":"RData", "documentation":"The current or new DNS record value, not to exceed 4,000 characters. In the case of a DELETE
action, if the current value does not match the actual value, an error is returned. For descriptions about how to format Value
for different record types, see Supported DNS Resource Record Types in the Amazon Route 53 Developer Guide.
You can specify more than one value for all record types except CNAME
and SOA
.
A complex type that contains the value of the Value
element for the current resource record set.
The name of the domain you want to perform the action on.
Enter a fully qualified domain name, for example, www.example.com
. You can optionally include a trailing dot. If you omit the trailing dot, Amazon Route 53 still assumes that the domain name that you specify is fully qualified. This means that Amazon Route 53 treats www.example.com
(without a trailing dot) and www.example.com.
(with a trailing dot) as identical.
For information about how to specify characters other than a-z, 0-9, and - (hyphen) and how to specify internationalized domain names, see DNS Domain Name Format in the Amazon Route 53 Developer Guide.
You can use an asterisk (*) character in the name. DNS treats the * character either as a wildcard or as the * character (ASCII 42), depending on where it appears in the name. For more information, see Using an Asterisk (*) in the Names of Hosted Zones and Resource Record Sets in the Amazon Route 53 Developer Guide
The DNS record type. For information about different record types and how data is encoded for them, see Supported DNS Resource Record Types in the Amazon Route 53 Developer Guide.
Valid values for basic resource record sets: A
| AAAA
| CNAME
| MX
| NS
| PTR
| SOA
| SPF
| SRV
| TXT
Values for weighted, latency, geolocation, and failover resource record sets: A
| AAAA
| CNAME
| MX
| PTR
| SPF
| SRV
| TXT
. When creating a group of weighted, latency, geolocation, or failover resource record sets, specify the same value for all of the resource record sets in the group.
Type
is SPF
. RFC 7208, Sender Policy Framework (SPF) for Authorizing Use of Domains in Email, Version 1, has been updated to say, \"...[I]ts existence and mechanism defined in [RFC4408] have led to some interoperability issues. Accordingly, its use is no longer appropriate for SPF version 1; implementations are not to use it.\" In RFC 7208, see section 14.1, The SPF DNS Record Type.Values for alias resource record sets:
A
A
| AAAA
NS
or SOA
.Weighted, Latency, Geo, and Failover resource record sets only: An identifier that differentiates among multiple resource record sets that have the same combination of DNS name and type. The value of SetIdentifier
must be unique for each resource record set that has the same combination of DNS name and type.
Weighted resource record sets only: Among resource record sets that have the same combination of DNS name and type, a value that determines the proportion of DNS queries that Amazon Route 53 responds to using the current resource record set. Amazon Route 53 calculates the sum of the weights for the resource record sets that have the same combination of DNS name and type. Amazon Route 53 then responds to queries based on the ratio of a resource's weight to the total. Note the following:
Weight
element for every weighted resource record set.ResourceRecord
per weighted resource record set.Name
and Type
elements as weighted resource record sets.Name
and Type
elements.For weighted (but not weighted alias) resource record sets, if you set Weight
to 0
for a resource record set, Amazon Route 53 never responds to queries with the applicable value for that resource record set. However, if you set Weight
to 0
for all resource record sets that have the same combination of DNS name and type, traffic is routed to all resources with equal probability.
The effect of setting Weight
to 0
is different when you associate health checks with weighted resource record sets. For more information, see Options for Configuring Amazon Route 53 Active-Active and Active-Passive Failover in the Amazon Route 53 Developer Guide.
Latency-based resource record sets only: The Amazon EC2 region where the resource that is specified in this resource record set resides. The resource typically is an AWS resource, such as an Amazon EC2 instance or an ELB load balancer, and is referred to by an IP address or a DNS domain name, depending on the record type.
When Amazon Route 53 receives a DNS query for a domain name and type for which you have created latency resource record sets, Amazon Route 53 selects the latency resource record set that has the lowest latency between the end user and the associated Amazon EC2 region. Amazon Route 53 then returns the value that is associated with the selected resource record set.
Note the following:
ResourceRecord
per latency resource record set.Name
and Type
elements as latency resource record sets.Geo location resource record sets only: A complex type that lets you control how Amazon Route 53 responds to DNS queries based on the geographic origin of the query. For example, if you want all queries from Africa to be routed to a web server with an IP address of 192.0.2.111
, create a resource record set with a Type
of A
and a ContinentCode
of AF
.
If you create separate resource record sets for overlapping geographic regions (for example, one resource record set for a continent and one for a country on the same continent), priority goes to the smallest geographic region. This allows you to route most queries for a continent to one resource and to route queries for a country on that continent to a different resource.
You cannot create two geolocation resource record sets that specify the same geographic location.
The value *
in the CountryCode
element matches all geographic locations that aren't specified in other geolocation resource record sets that have the same values for the Name
and Type
elements.
CountryCode
is *
, which handles both queries that come from locations for which you haven't created geolocation resource record sets and queries from IP addresses that aren't mapped to a location. If you don't create a *
resource record set, Amazon Route 53 returns a \"no answer\" response for queries from those locations.You cannot create non-geolocation resource record sets that have the same values for the Name
and Type
elements as geolocation resource record sets.
Failover resource record sets only: To configure failover, you add the Failover
element to two resource record sets. For one resource record set, you specify PRIMARY
as the value for Failover
; for the other resource record set, you specify SECONDARY
. In addition, you include the HealthCheckId
element and specify the health check that you want Amazon Route 53 to perform for each resource record set.
Except where noted, the following failover behaviors assume that you have included the HealthCheckId
element in both resource record sets:
HealthCheckId
element for the secondary resource record set, and if the primary resource record set is unhealthy, Amazon Route 53 always responds to DNS queries with the applicable value from the secondary resource record set. This is true regardless of the health of the associated endpoint.You cannot create non-failover resource record sets that have the same values for the Name
and Type
elements as failover resource record sets.
For failover alias resource record sets, you must also include the EvaluateTargetHealth
element and set the value to true.
For more information about configuring failover for Amazon Route 53, see Amazon Route 53 Health Checks and DNS Failover in the Amazon Route 53 Developer Guide.
Valid values: PRIMARY
| SECONDARY
The cache time to live for the current resource record set. Note the following:
TTL
. Amazon Route 53 uses the value of TTL
for the alias target. HealthCheckId
element), we recommend that you specify a TTL
of 60 seconds or less so clients respond quickly to changes in health status.TTL
.TTL
of 60 seconds for all of the non-alias weighted resource record sets that have the same name and type. Values other than 60 seconds (the TTL for load balancers) will change the effect of the values that you specify for Weight
.A complex type that contains the resource records for the current resource record set.
" }, "AliasTarget":{ "shape":"AliasTarget", "documentation":"Alias resource record sets only: Information about the AWS resource to which you are redirecting traffic.
" }, "HealthCheckId":{ "shape":"HealthCheckId", "documentation":"Health Check resource record sets only, not required for alias resource record sets: An identifier that is used to identify health check associated with the resource record set.
" }, "TrafficPolicyInstanceId":{"shape":"TrafficPolicyInstanceId"} }, "documentation":"A complex type that contains information about the current resource record set.
" }, "ResourceRecordSetFailover":{ "type":"string", "enum":[ "PRIMARY", "SECONDARY" ] }, "ResourceRecordSetIdentifier":{ "type":"string", "max":128, "min":1 }, "ResourceRecordSetRegion":{ "type":"string", "enum":[ "us-east-1", "us-west-1", "us-west-2", "eu-west-1", "eu-central-1", "ap-southeast-1", "ap-southeast-2", "ap-northeast-1", "sa-east-1", "cn-north-1" ], "max":64, "min":1 }, "ResourceRecordSetWeight":{ "type":"long", "max":255, "min":0 }, "ResourceRecordSets":{ "type":"list", "member":{ "shape":"ResourceRecordSet", "locationName":"ResourceRecordSet" } }, "ResourceRecords":{ "type":"list", "member":{ "shape":"ResourceRecord", "locationName":"ResourceRecord" }, "min":1 }, "ResourceTagSet":{ "type":"structure", "members":{ "ResourceType":{ "shape":"TagResourceType", "documentation":"The type of the resource.
- The resource type for health checks is healthcheck
.
- The resource type for hosted zones is hostedzone
.
The ID for the specified resource.
" }, "Tags":{ "shape":"TagList", "documentation":"The tags associated with the specified resource.
" } }, "documentation":"A complex type containing a resource and its associated tags.
" }, "ResourceTagSetList":{ "type":"list", "member":{ "shape":"ResourceTagSet", "locationName":"ResourceTagSet" } }, "ResourceURI":{ "type":"string", "max":1024 }, "SearchString":{ "type":"string", "max":255 }, "Status":{"type":"string"}, "StatusReport":{ "type":"structure", "members":{ "Status":{ "shape":"Status", "documentation":"The observed health check status.
" }, "CheckedTime":{ "shape":"TimeStamp", "documentation":"The date and time the health check status was observed, in the format YYYY-MM-DDThh:mm:ssZ
, as specified in the ISO 8601 standard (for example, 2009-11-19T19:37:58Z). The Z
after the time indicates that the time is listed in Coordinated Universal Time (UTC).
A complex type that contains information about the health check status for the current observation.
" }, "TTL":{ "type":"long", "max":2147483647, "min":0 }, "Tag":{ "type":"structure", "members":{ "Key":{ "shape":"TagKey", "documentation":"The key for a Tag
.
The value for a Tag
.
A single tag containing a key and value.
" }, "TagKey":{ "type":"string", "max":128 }, "TagKeyList":{ "type":"list", "member":{ "shape":"TagKey", "locationName":"Key" }, "max":10, "min":1 }, "TagList":{ "type":"list", "member":{ "shape":"Tag", "locationName":"Tag" }, "max":10, "min":1 }, "TagResourceId":{ "type":"string", "max":64 }, "TagResourceIdList":{ "type":"list", "member":{ "shape":"TagResourceId", "locationName":"ResourceId" }, "max":10, "min":1 }, "TagResourceType":{ "type":"string", "enum":[ "healthcheck", "hostedzone" ] }, "TagValue":{ "type":"string", "max":256 }, "ThrottlingException":{ "type":"structure", "members":{ "message":{"shape":"ErrorMessage"} }, "error":{"httpStatusCode":400}, "exception":true }, "TimeStamp":{"type":"timestamp"}, "TooManyHealthChecks":{ "type":"structure", "members":{ "message":{"shape":"ErrorMessage"} }, "exception":true }, "TooManyHostedZones":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"This error indicates that you've reached the maximum number of hosted zones that can be created for the current AWS account. You can request an increase to the limit on the Contact Us page.
", "error":{"httpStatusCode":400}, "exception":true }, "TooManyTrafficPolicies":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"You've created the maximum number of traffic policies that can be created for the current AWS account. You can request an increase to the limit on the Contact Us page.
", "error":{"httpStatusCode":400}, "exception":true }, "TooManyTrafficPolicyInstances":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"You've created the maximum number of traffic policy instances that can be created for the current AWS account. You can request an increase to the limit on the Contact Us page.
", "error":{"httpStatusCode":400}, "exception":true }, "TrafficPolicies":{ "type":"list", "member":{ "shape":"TrafficPolicy", "locationName":"TrafficPolicy" } }, "TrafficPolicy":{ "type":"structure", "required":[ "Id", "Version", "Name", "Type", "Document" ], "members":{ "Id":{"shape":"TrafficPolicyId"}, "Version":{"shape":"TrafficPolicyVersion"}, "Name":{"shape":"TrafficPolicyName"}, "Type":{"shape":"RRType"}, "Document":{"shape":"TrafficPolicyDocument"}, "Comment":{"shape":"TrafficPolicyComment"} } }, "TrafficPolicyAlreadyExists":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"A traffic policy that has the same value for Name
already exists.
Descriptive message for the error response.
" } }, "documentation":"One or more traffic policy instances were created by using the specified traffic policy.
", "error":{"httpStatusCode":400}, "exception":true }, "TrafficPolicyInstance":{ "type":"structure", "required":[ "Id", "HostedZoneId", "Name", "TTL", "State", "Message", "TrafficPolicyId", "TrafficPolicyVersion", "TrafficPolicyType" ], "members":{ "Id":{"shape":"TrafficPolicyInstanceId"}, "HostedZoneId":{"shape":"ResourceId"}, "Name":{"shape":"DNSName"}, "TTL":{"shape":"TTL"}, "State":{"shape":"TrafficPolicyInstanceState"}, "Message":{"shape":"Message"}, "TrafficPolicyId":{"shape":"TrafficPolicyId"}, "TrafficPolicyVersion":{"shape":"TrafficPolicyVersion"}, "TrafficPolicyType":{"shape":"RRType"} } }, "TrafficPolicyInstanceAlreadyExists":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"Traffic policy instance with given Id already exists.
", "error":{"httpStatusCode":409}, "exception":true }, "TrafficPolicyInstanceCount":{"type":"integer"}, "TrafficPolicyInstanceId":{ "type":"string", "max":36 }, "TrafficPolicyInstanceState":{"type":"string"}, "TrafficPolicyInstances":{ "type":"list", "member":{ "shape":"TrafficPolicyInstance", "locationName":"TrafficPolicyInstance" } }, "TrafficPolicyName":{ "type":"string", "max":512 }, "TrafficPolicySummaries":{ "type":"list", "member":{ "shape":"TrafficPolicySummary", "locationName":"TrafficPolicySummary" } }, "TrafficPolicySummary":{ "type":"structure", "required":[ "Id", "Name", "Type", "LatestVersion", "TrafficPolicyCount" ], "members":{ "Id":{"shape":"TrafficPolicyId"}, "Name":{"shape":"TrafficPolicyName"}, "Type":{"shape":"RRType"}, "LatestVersion":{"shape":"TrafficPolicyVersion"}, "TrafficPolicyCount":{"shape":"TrafficPolicyVersion"} } }, "TrafficPolicyVersion":{ "type":"integer", "max":1000, "min":1 }, "TrafficPolicyVersionMarker":{ "type":"string", "max":4 }, "UpdateHealthCheckRequest":{ "type":"structure", "required":["HealthCheckId"], "members":{ "HealthCheckId":{ "shape":"HealthCheckId", "documentation":"The ID of the health check to update.
", "location":"uri", "locationName":"HealthCheckId" }, "HealthCheckVersion":{ "shape":"HealthCheckVersion", "documentation":"Optional. When you specify a health check version, Amazon Route 53 compares this value with the current value in the health check, which prevents you from updating the health check when the versions don't match. Using HealthCheckVersion
lets you prevent overwriting another change to the health check.
The IP address of the resource that you want to check.
Specify this value only if you want to change it.
" }, "Port":{ "shape":"Port", "documentation":"The port on which you want Amazon Route 53 to open a connection to perform health checks.
Specify this value only if you want to change it.
" }, "ResourcePath":{ "shape":"ResourcePath", "documentation":"The path that you want Amazon Route 53 to request when performing health checks. The path can be any value for which your endpoint will return an HTTP status code of 2xx or 3xx when the endpoint is healthy, for example the file /docs/route53-health-check.html.
Specify this value only if you want to change it.
" }, "FullyQualifiedDomainName":{ "shape":"FullyQualifiedDomainName", "documentation":"Fully qualified domain name of the instance to be health checked.
Specify this value only if you want to change it.
" }, "SearchString":{ "shape":"SearchString", "documentation":"If the value of Type
is HTTP_STR_MATCH
or HTTP_STR_MATCH
, the string that you want Amazon Route 53 to search for in the response body from the specified resource. If the string appears in the response body, Amazon Route 53 considers the resource healthy.
Specify this value only if you want to change it.
" }, "FailureThreshold":{ "shape":"FailureThreshold", "documentation":"The number of consecutive health checks that an endpoint must pass or fail for Amazon Route 53 to change the current status of the endpoint from unhealthy to healthy or vice versa.
Valid values are integers between 1 and 10. For more information, see \"How Amazon Route 53 Determines Whether an Endpoint Is Healthy\" in the Amazon Route 53 Developer Guide.
Specify this value only if you want to change it.
" }, "Inverted":{ "shape":"Inverted", "documentation":"A boolean value that indicates whether the status of health check should be inverted. For example, if a health check is healthy but Inverted
is True
, then Amazon Route 53 considers the health check to be unhealthy.
Specify this value only if you want to change it.
" }, "HealthThreshold":{ "shape":"HealthThreshold", "documentation":"The minimum number of child health checks that must be healthy for Amazon Route 53 to consider the parent health check to be healthy. Valid values are integers between 0 and 256, inclusive.
Specify this value only if you want to change it.
" }, "ChildHealthChecks":{ "shape":"ChildHealthCheckList", "documentation":"For a specified parent health check, a list of HealthCheckId
values for the associated child health checks.
Specify this value only if you want to change it.
" } }, "documentation":">A complex type that contains information about the request to update a health check.
" }, "UpdateHealthCheckResponse":{ "type":"structure", "required":["HealthCheck"], "members":{ "HealthCheck":{"shape":"HealthCheck"} } }, "UpdateHostedZoneCommentRequest":{ "type":"structure", "required":["Id"], "members":{ "Id":{ "shape":"ResourceId", "documentation":"The ID of the hosted zone you want to update.
", "location":"uri", "locationName":"Id" }, "Comment":{ "shape":"ResourceDescription", "documentation":"A comment about your hosted zone.
" } }, "documentation":"A complex type that contains information about the request to update a hosted zone comment.
" }, "UpdateHostedZoneCommentResponse":{ "type":"structure", "required":["HostedZone"], "members":{ "HostedZone":{"shape":"HostedZone"} }, "documentation":"A complex type containing information about the specified hosted zone after the update.
" }, "UpdateTrafficPolicyCommentRequest":{ "type":"structure", "required":[ "Id", "Version", "Comment" ], "members":{ "Id":{ "shape":"TrafficPolicyId", "documentation":"The value of Id
for the traffic policy for which you want to update the comment.
The value of Version
for the traffic policy for which you want to update the comment.
The new comment for the specified traffic policy and version.
" } }, "documentation":"A complex type that contains information about the traffic policy for which you want to update the comment.
" }, "UpdateTrafficPolicyCommentResponse":{ "type":"structure", "required":["TrafficPolicy"], "members":{ "TrafficPolicy":{ "shape":"TrafficPolicy", "documentation":"A complex type that contains settings for the specified traffic policy.
" } }, "documentation":"A complex type that contains the response information for the traffic policy.
" }, "UpdateTrafficPolicyInstanceRequest":{ "type":"structure", "required":[ "Id", "TTL", "TrafficPolicyId", "TrafficPolicyVersion" ], "members":{ "Id":{ "shape":"TrafficPolicyInstanceId", "documentation":"The ID of the traffic policy instance that you want to update.
", "location":"uri", "locationName":"Id" }, "TTL":{ "shape":"TTL", "documentation":"The TTL that you want Amazon Route 53 to assign to all of the updated resource record sets.
" }, "TrafficPolicyId":{ "shape":"TrafficPolicyId", "documentation":"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.
" }, "TrafficPolicyVersion":{ "shape":"TrafficPolicyVersion", "documentation":"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.
" } }, "documentation":"A complex type that contains information about the resource record sets that you want to update based on a specified traffic policy instance.
" }, "UpdateTrafficPolicyInstanceResponse":{ "type":"structure", "required":["TrafficPolicyInstance"], "members":{ "TrafficPolicyInstance":{ "shape":"TrafficPolicyInstance", "documentation":"A complex type that contains settings for the updated traffic policy instance.
" } }, "documentation":"A complex type that contains information about the resource record sets that Amazon Route 53 created based on a specified traffic policy.
" }, "VPC":{ "type":"structure", "members":{ "VPCRegion":{"shape":"VPCRegion"}, "VPCId":{"shape":"VPCId"} } }, "VPCAssociationNotFound":{ "type":"structure", "members":{ "message":{ "shape":"ErrorMessage", "documentation":"Descriptive message for the error response.
" } }, "documentation":"The VPC you specified is not currently associated with the hosted zone.
", "error":{"httpStatusCode":404}, "exception":true }, "VPCId":{ "type":"string", "documentation":"A VPC ID
", "max":1024 }, "VPCRegion":{ "type":"string", "enum":[ "us-east-1", "us-west-1", "us-west-2", "eu-west-1", "eu-central-1", "ap-southeast-1", "ap-southeast-2", "ap-northeast-1", "sa-east-1", "cn-north-1" ], "max":64, "min":1 }, "VPCs":{ "type":"list", "member":{ "shape":"VPC", "locationName":"VPC" }, "documentation":"A list of VPCs
", "min":1 } } }