aws-sdk-route53 1.12.0 → 1.13.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/lib/aws-sdk-route53.rb +1 -1
- data/lib/aws-sdk-route53/client.rb +303 -243
- data/lib/aws-sdk-route53/client_api.rb +3 -0
- data/lib/aws-sdk-route53/types.rb +618 -413
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: da2e915d566e8545f51836e5e00750aecaec4496
|
4
|
+
data.tar.gz: d66c2945818f75f2536d817b5f2b064900d32cb6
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 22eb3e7d417de58c1fe3ace90962f24635094f40506d20d0bd6f1c4854f40682088a898ab192179b30dc21e7624c78234c7fbf5b419068ec4f707d8f597a41f1
|
7
|
+
data.tar.gz: 75830d1462e949b53350a791a3073c1f592c91576f8766f6bebddcc1bbc11cbb4be8dd167a2a37dec4172acbe0cd160c5fa008c499184e191c70cd160a164bd2
|
data/lib/aws-sdk-route53.rb
CHANGED
@@ -274,30 +274,30 @@ module Aws::Route53
|
|
274
274
|
# `ChangeResourceRecordSetsRequest` element. The request body contains a
|
275
275
|
# list of change items, known as a change batch. Change batches are
|
276
276
|
# considered transactional changes. When using the Amazon Route 53 API
|
277
|
-
# to change resource record sets,
|
278
|
-
#
|
279
|
-
#
|
280
|
-
#
|
277
|
+
# to change resource record sets, Route 53 either makes all or none of
|
278
|
+
# the changes in a change batch request. This ensures that Route 53
|
279
|
+
# never partially implements the intended changes to the resource record
|
280
|
+
# sets in a hosted zone.
|
281
281
|
#
|
282
282
|
# For example, a change batch request that deletes the `CNAME` record
|
283
283
|
# for www.example.com and creates an alias resource record set for
|
284
|
-
# www.example.com.
|
285
|
-
#
|
284
|
+
# www.example.com. Route 53 deletes the first resource record set and
|
285
|
+
# creates the second resource record set in a single operation. If
|
286
286
|
# either the `DELETE` or the `CREATE` action fails, then both changes
|
287
287
|
# (plus any other changes in the batch) fail, and the original `CNAME`
|
288
288
|
# record continues to exist.
|
289
289
|
#
|
290
290
|
# Due to the nature of transactional changes, you can't delete the same
|
291
291
|
# resource record set more than once in a single change batch. If you
|
292
|
-
# attempt to delete the same change batch more than once,
|
293
|
-
#
|
292
|
+
# attempt to delete the same change batch more than once, Route 53
|
293
|
+
# returns an `InvalidChangeBatch` error.
|
294
294
|
#
|
295
295
|
# **Traffic Flow**
|
296
296
|
#
|
297
297
|
# To create resource record sets for complex routing configurations, use
|
298
|
-
# either the traffic flow visual editor in the
|
299
|
-
#
|
300
|
-
#
|
298
|
+
# either the traffic flow visual editor in the Route 53 console or the
|
299
|
+
# API actions for traffic policies and traffic policy instances. Save
|
300
|
+
# the configuration as a traffic policy, then associate the traffic
|
301
301
|
# policy with one or more domain names (such as example.com) or
|
302
302
|
# subdomain names (such as www.example.com), in the same hosted zone or
|
303
303
|
# in multiple hosted zones. You can roll back the updates if the new
|
@@ -317,8 +317,8 @@ module Aws::Route53
|
|
317
317
|
# specified values.
|
318
318
|
#
|
319
319
|
# * `UPSERT`\: If a resource record set does not already exist, AWS
|
320
|
-
# creates it. If a resource set does exist,
|
321
|
-
#
|
320
|
+
# creates it. If a resource set does exist, Route 53 updates it with
|
321
|
+
# the values in the request.
|
322
322
|
#
|
323
323
|
# **Syntaxes for Creating, Updating, and Deleting Resource Record Sets**
|
324
324
|
#
|
@@ -334,15 +334,14 @@ module Aws::Route53
|
|
334
334
|
# that you can create, delete, or update by using
|
335
335
|
# `ChangeResourceRecordSets`.
|
336
336
|
#
|
337
|
-
# **Change Propagation to
|
337
|
+
# **Change Propagation to Route 53 DNS Servers**
|
338
338
|
#
|
339
|
-
# When you submit a `ChangeResourceRecordSets` request,
|
340
|
-
# propagates your changes to all of the
|
341
|
-
#
|
339
|
+
# When you submit a `ChangeResourceRecordSets` request, Route 53
|
340
|
+
# propagates your changes to all of the Route 53 authoritative DNS
|
341
|
+
# servers. While your changes are propagating, `GetChange` returns a
|
342
342
|
# status of `PENDING`. When propagation is complete, `GetChange` returns
|
343
|
-
# a status of `INSYNC`. Changes generally propagate to all
|
344
|
-
#
|
345
|
-
# GetChange.
|
343
|
+
# a status of `INSYNC`. Changes generally propagate to all Route 53 name
|
344
|
+
# servers within 60 seconds. For more information, see GetChange.
|
346
345
|
#
|
347
346
|
# **Limits on ChangeResourceRecordSets Requests**
|
348
347
|
#
|
@@ -1103,16 +1102,16 @@ module Aws::Route53
|
|
1103
1102
|
# (ELB) load balancer, do not create Amazon Route 53 health checks for
|
1104
1103
|
# the EC2 instances. When you register an EC2 instance with a load
|
1105
1104
|
# balancer, you configure settings for an ELB health check, which
|
1106
|
-
# performs a similar function to
|
1105
|
+
# performs a similar function to a Route 53 health check.
|
1107
1106
|
#
|
1108
1107
|
# **Private Hosted Zones**
|
1109
1108
|
#
|
1110
1109
|
# You can associate health checks with failover resource record sets in
|
1111
1110
|
# a private hosted zone. Note the following:
|
1112
1111
|
#
|
1113
|
-
# *
|
1114
|
-
#
|
1115
|
-
#
|
1112
|
+
# * Route 53 health checkers are outside the VPC. To check the health of
|
1113
|
+
# an endpoint within a VPC by IP address, you must assign a public IP
|
1114
|
+
# address to the instance in the VPC.
|
1116
1115
|
#
|
1117
1116
|
# * You can configure a health checker to check the health of an
|
1118
1117
|
# external resource that the instance relies on, such as a database
|
@@ -1139,26 +1138,23 @@ module Aws::Route53
|
|
1139
1138
|
# * If you send a `CreateHealthCheck` request with the same
|
1140
1139
|
# `CallerReference` and settings as a previous request, and if the
|
1141
1140
|
# health check doesn't exist, Amazon Route 53 creates the health
|
1142
|
-
# check. If the health check does exist,
|
1143
|
-
#
|
1141
|
+
# check. If the health check does exist, Route 53 returns the settings
|
1142
|
+
# for the existing health check.
|
1144
1143
|
#
|
1145
1144
|
# * If you send a `CreateHealthCheck` request with the same
|
1146
1145
|
# `CallerReference` as a deleted health check, regardless of the
|
1147
|
-
# settings,
|
1148
|
-
# error.
|
1146
|
+
# settings, Route 53 returns a `HealthCheckAlreadyExists` error.
|
1149
1147
|
#
|
1150
1148
|
# * If you send a `CreateHealthCheck` request with the same
|
1151
1149
|
# `CallerReference` as an existing health check but with different
|
1152
|
-
# settings,
|
1153
|
-
# error.
|
1150
|
+
# settings, Route 53 returns a `HealthCheckAlreadyExists` error.
|
1154
1151
|
#
|
1155
1152
|
# * If you send a `CreateHealthCheck` request with a unique
|
1156
1153
|
# `CallerReference` but settings identical to an existing health
|
1157
|
-
# check,
|
1154
|
+
# check, Route 53 creates the health check.
|
1158
1155
|
#
|
1159
1156
|
# @option params [required, Types::HealthCheckConfig] :health_check_config
|
1160
|
-
# A complex type that contains
|
1161
|
-
# request.
|
1157
|
+
# A complex type that contains settings for a new health check.
|
1162
1158
|
#
|
1163
1159
|
# @return [Types::CreateHealthCheckResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1164
1160
|
#
|
@@ -1180,6 +1176,7 @@ module Aws::Route53
|
|
1180
1176
|
# failure_threshold: 1,
|
1181
1177
|
# measure_latency: false,
|
1182
1178
|
# inverted: false,
|
1179
|
+
# disabled: false,
|
1183
1180
|
# health_threshold: 1,
|
1184
1181
|
# child_health_checks: ["HealthCheckId"],
|
1185
1182
|
# enable_sni: false,
|
@@ -1208,6 +1205,7 @@ module Aws::Route53
|
|
1208
1205
|
# resp.health_check.health_check_config.failure_threshold #=> Integer
|
1209
1206
|
# resp.health_check.health_check_config.measure_latency #=> Boolean
|
1210
1207
|
# resp.health_check.health_check_config.inverted #=> Boolean
|
1208
|
+
# resp.health_check.health_check_config.disabled #=> Boolean
|
1211
1209
|
# resp.health_check.health_check_config.health_threshold #=> Integer
|
1212
1210
|
# resp.health_check.health_check_config.child_health_checks #=> Array
|
1213
1211
|
# resp.health_check.health_check_config.child_health_checks[0] #=> String
|
@@ -1239,11 +1237,15 @@ module Aws::Route53
|
|
1239
1237
|
req.send_request(options)
|
1240
1238
|
end
|
1241
1239
|
|
1242
|
-
# Creates a new public hosted zone
|
1243
|
-
#
|
1244
|
-
# such as example.com, and its subdomains
|
1245
|
-
#
|
1246
|
-
#
|
1240
|
+
# Creates a new public or private hosted zone. You create records in a
|
1241
|
+
# public hosted zone to define how you want to route traffic on the
|
1242
|
+
# internet for a domain, such as example.com, and its subdomains
|
1243
|
+
# (apex.example.com, acme.example.com). You create records in a private
|
1244
|
+
# hosted zone to define how you want to route traffic for a domain and
|
1245
|
+
# its subdomains within one or more Amazon Virtual Private Clouds
|
1246
|
+
# (Amazon VPCs).
|
1247
|
+
#
|
1248
|
+
# You can't convert a public hosted zone to a private hosted zone or
|
1247
1249
|
# vice versa. Instead, you must create a new hosted zone with the same
|
1248
1250
|
# name and create new resource record sets.
|
1249
1251
|
#
|
@@ -1252,48 +1254,49 @@ module Aws::Route53
|
|
1252
1254
|
#
|
1253
1255
|
# Note the following:
|
1254
1256
|
#
|
1255
|
-
# * You can't create a hosted zone for a top-level domain (TLD)
|
1257
|
+
# * You can't create a hosted zone for a top-level domain (TLD) such as
|
1258
|
+
# .com.
|
1256
1259
|
#
|
1257
|
-
# * Amazon Route 53 automatically creates a
|
1258
|
-
# NS records for the zone. For more
|
1259
|
-
# records, see [NS and SOA Records that
|
1260
|
-
# Hosted Zone][2] in the *Amazon Route 53
|
1260
|
+
# * For public hosted zones, Amazon Route 53 automatically creates a
|
1261
|
+
# default SOA record and four NS records for the zone. For more
|
1262
|
+
# information about SOA and NS records, see [NS and SOA Records that
|
1263
|
+
# Route 53 Creates for a Hosted Zone][2] in the *Amazon Route 53
|
1264
|
+
# Developer Guide*.
|
1261
1265
|
#
|
1262
|
-
# If you want to use the same name servers for multiple hosted
|
1263
|
-
# you can optionally associate a reusable delegation set with
|
1264
|
-
# hosted zone. See the `DelegationSetId` element.
|
1266
|
+
# If you want to use the same name servers for multiple public hosted
|
1267
|
+
# zones, you can optionally associate a reusable delegation set with
|
1268
|
+
# the hosted zone. See the `DelegationSetId` element.
|
1265
1269
|
#
|
1266
|
-
# * If your domain is registered with a registrar other than
|
1267
|
-
#
|
1268
|
-
#
|
1269
|
-
# [
|
1270
|
-
# Route 53 Developer Guide*.
|
1270
|
+
# * If your domain is registered with a registrar other than Route 53,
|
1271
|
+
# you must update the name servers with your registrar to make Route
|
1272
|
+
# 53 the DNS service for the domain. For more information, see
|
1273
|
+
# [Migrating DNS Service for an Existing Domain to Amazon Route 53][3]
|
1274
|
+
# in the *Amazon Route 53 Developer Guide*.
|
1271
1275
|
#
|
1272
1276
|
# When you submit a `CreateHostedZone` request, the initial status of
|
1273
|
-
# the hosted zone is `PENDING`.
|
1274
|
-
# are not yet available on all
|
1275
|
-
# and SOA records are available, the status of the
|
1276
|
-
# `INSYNC`.
|
1277
|
+
# the hosted zone is `PENDING`. For public hosted zones, this means that
|
1278
|
+
# the NS and SOA records are not yet available on all Route 53 DNS
|
1279
|
+
# servers. When the NS and SOA records are available, the status of the
|
1280
|
+
# zone changes to `INSYNC`.
|
1277
1281
|
#
|
1278
1282
|
#
|
1279
1283
|
#
|
1280
1284
|
# [1]: http://aws.amazon.com/route53/pricing/
|
1281
1285
|
# [2]: http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/SOA-NSrecords.html
|
1282
|
-
# [3]: http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/
|
1286
|
+
# [3]: http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/MigratingDNS.html
|
1283
1287
|
#
|
1284
1288
|
# @option params [required, String] :name
|
1285
|
-
# The name of the domain.
|
1286
|
-
#
|
1287
|
-
#
|
1288
|
-
#
|
1289
|
-
# Amazon Route 53 treats *www.example.com* (without a trailing dot) and
|
1289
|
+
# The name of the domain. Specify a fully qualified domain name, for
|
1290
|
+
# example, *www.example.com*. The trailing dot is optional; Amazon Route
|
1291
|
+
# 53 assumes that the domain name is fully qualified. This means that
|
1292
|
+
# Route 53 treats *www.example.com* (without a trailing dot) and
|
1290
1293
|
# *www.example.com.* (with a trailing dot) as identical.
|
1291
1294
|
#
|
1292
1295
|
# If you're creating a public hosted zone, this is the name you have
|
1293
1296
|
# registered with your DNS registrar. If your domain name is registered
|
1294
|
-
# with a registrar other than
|
1295
|
-
#
|
1296
|
-
#
|
1297
|
+
# with a registrar other than Route 53, change the name servers for your
|
1298
|
+
# domain to the set of `NameServers` that `CreateHostedZone` returns in
|
1299
|
+
# `DelegationSet`.
|
1297
1300
|
#
|
1298
1301
|
# @option params [Types::VPC] :vpc
|
1299
1302
|
# (Private hosted zones only) A complex type that contains information
|
@@ -1386,10 +1389,10 @@ module Aws::Route53
|
|
1386
1389
|
# query logging configuration, Amazon Route 53 begins to publish log
|
1387
1390
|
# data to an Amazon CloudWatch Logs log group.
|
1388
1391
|
#
|
1389
|
-
# DNS query logs contain information about the queries that
|
1390
|
-
#
|
1392
|
+
# DNS query logs contain information about the queries that Route 53
|
1393
|
+
# receives for a specified public hosted zone, such as the following:
|
1391
1394
|
#
|
1392
|
-
# *
|
1395
|
+
# * Route 53 edge location that responded to the DNS query
|
1393
1396
|
#
|
1394
1397
|
# * Domain or subdomain that was requested
|
1395
1398
|
#
|
@@ -1402,8 +1405,8 @@ module Aws::Route53
|
|
1402
1405
|
# : Before you create a query logging configuration, perform the
|
1403
1406
|
# following operations.
|
1404
1407
|
#
|
1405
|
-
# <note markdown="1"> If you create a query logging configuration using the
|
1406
|
-
#
|
1408
|
+
# <note markdown="1"> If you create a query logging configuration using the Route 53
|
1409
|
+
# console, Route 53 performs these operations automatically.
|
1407
1410
|
#
|
1408
1411
|
# </note>
|
1409
1412
|
#
|
@@ -1423,15 +1426,15 @@ module Aws::Route53
|
|
1423
1426
|
#
|
1424
1427
|
# In the next step, you'll create a resource policy, which
|
1425
1428
|
# controls access to one or more log groups and the associated
|
1426
|
-
# AWS resources, such as
|
1427
|
-
#
|
1428
|
-
#
|
1429
|
-
#
|
1430
|
-
#
|
1429
|
+
# AWS resources, such as Route 53 hosted zones. There's a limit
|
1430
|
+
# on the number of resource policies that you can create, so we
|
1431
|
+
# recommend that you use a consistent prefix so you can use the
|
1432
|
+
# same resource policy for all the log groups that you create
|
1433
|
+
# for query logging.
|
1431
1434
|
#
|
1432
1435
|
# 2. Create a CloudWatch Logs resource policy, and give it the
|
1433
|
-
# permissions that
|
1434
|
-
#
|
1436
|
+
# permissions that Route 53 needs to create log streams and to
|
1437
|
+
# send query logs to log streams. For the value of `Resource`,
|
1435
1438
|
# specify the ARN for the log group that you created in the
|
1436
1439
|
# previous step. To use the same resource policy for all the
|
1437
1440
|
# CloudWatch Logs log groups that you created for query logging
|
@@ -1448,13 +1451,13 @@ module Aws::Route53
|
|
1448
1451
|
#
|
1449
1452
|
# Log Streams and Edge Locations
|
1450
1453
|
#
|
1451
|
-
# : When
|
1452
|
-
#
|
1454
|
+
# : When Route 53 finishes creating the configuration for DNS query
|
1455
|
+
# logging, it does the following:
|
1453
1456
|
#
|
1454
1457
|
# * Creates a log stream for an edge location the first time that the
|
1455
1458
|
# edge location responds to DNS queries for the specified hosted
|
1456
|
-
# zone. That log stream is used to log all queries that
|
1457
|
-
#
|
1459
|
+
# zone. That log stream is used to log all queries that Route 53
|
1460
|
+
# responds to for that edge location.
|
1458
1461
|
#
|
1459
1462
|
# * Begins to send query logs to the applicable log stream.
|
1460
1463
|
#
|
@@ -1467,23 +1470,22 @@ module Aws::Route53
|
|
1467
1470
|
# corresponds with the International Air Transport Association airport
|
1468
1471
|
# code for an airport near the edge location. (These abbreviations
|
1469
1472
|
# might change in the future.) For a list of edge locations, see "The
|
1470
|
-
#
|
1471
|
-
# Details][1] page.
|
1473
|
+
# Route 53 Global Network" on the [Route 53 Product Details][1] page.
|
1472
1474
|
#
|
1473
1475
|
# Queries That Are Logged
|
1474
1476
|
#
|
1475
1477
|
# : Query logs contain only the queries that DNS resolvers forward to
|
1476
|
-
#
|
1477
|
-
#
|
1478
|
-
#
|
1479
|
-
#
|
1480
|
-
#
|
1481
|
-
#
|
1482
|
-
#
|
1483
|
-
#
|
1484
|
-
#
|
1485
|
-
#
|
1486
|
-
#
|
1478
|
+
# Route 53. If a DNS resolver has already cached the response to a
|
1479
|
+
# query (such as the IP address for a load balancer for example.com),
|
1480
|
+
# the resolver will continue to return the cached response. It
|
1481
|
+
# doesn't forward another query to Route 53 until the TTL for the
|
1482
|
+
# corresponding resource record set expires. Depending on how many DNS
|
1483
|
+
# queries are submitted for a resource record set, and depending on
|
1484
|
+
# the TTL for that resource record set, query logs might contain
|
1485
|
+
# information about only one query out of every several thousand
|
1486
|
+
# queries that are submitted to DNS. For more information about how
|
1487
|
+
# DNS works, see [Routing Internet Traffic to Your Website or Web
|
1488
|
+
# Application][2] in the *Amazon Route 53 Developer Guide*.
|
1487
1489
|
#
|
1488
1490
|
# Log File Format
|
1489
1491
|
#
|
@@ -1498,9 +1500,9 @@ module Aws::Route53
|
|
1498
1500
|
#
|
1499
1501
|
# How to Stop Logging
|
1500
1502
|
#
|
1501
|
-
# : If you want
|
1502
|
-
#
|
1503
|
-
#
|
1503
|
+
# : If you want Route 53 to stop sending query logs to CloudWatch Logs,
|
1504
|
+
# delete the query logging configuration. For more information, see
|
1505
|
+
# DeleteQueryLoggingConfig.
|
1504
1506
|
#
|
1505
1507
|
#
|
1506
1508
|
#
|
@@ -1711,14 +1713,15 @@ module Aws::Route53
|
|
1711
1713
|
# `CreateTrafficPolicyInstance` created.
|
1712
1714
|
#
|
1713
1715
|
# @option params [required, String] :hosted_zone_id
|
1714
|
-
# The ID of the hosted zone
|
1715
|
-
# resource record sets by using the configuration in a traffic
|
1716
|
+
# The ID of the hosted zone that you want Amazon Route 53 to create
|
1717
|
+
# resource record sets in by using the configuration in a traffic
|
1718
|
+
# policy.
|
1716
1719
|
#
|
1717
1720
|
# @option params [required, String] :name
|
1718
1721
|
# The domain name (such as example.com) or subdomain name (such as
|
1719
1722
|
# www.example.com) for which Amazon Route 53 responds to DNS queries by
|
1720
|
-
# using the resource record sets that
|
1721
|
-
#
|
1723
|
+
# using the resource record sets that Route 53 creates for this traffic
|
1724
|
+
# policy instance.
|
1722
1725
|
#
|
1723
1726
|
# @option params [required, Integer] :ttl
|
1724
1727
|
# (Optional) The TTL that you want Amazon Route 53 to assign to all of
|
@@ -1931,7 +1934,7 @@ module Aws::Route53
|
|
1931
1934
|
# record and NS resource record sets. If the hosted zone contains other
|
1932
1935
|
# resource record sets, you must delete them before you can delete the
|
1933
1936
|
# hosted zone. If you try to delete a hosted zone that contains other
|
1934
|
-
# resource record sets, the request fails, and
|
1937
|
+
# resource record sets, the request fails, and Route 53 returns a
|
1935
1938
|
# `HostedZoneNotEmpty` error. For information about deleting records
|
1936
1939
|
# from your hosted zone, see ChangeResourceRecordSets.
|
1937
1940
|
#
|
@@ -1975,8 +1978,8 @@ module Aws::Route53
|
|
1975
1978
|
|
1976
1979
|
# Deletes a configuration for DNS query logging. If you delete a
|
1977
1980
|
# configuration, Amazon Route 53 stops sending query logs to CloudWatch
|
1978
|
-
# Logs.
|
1979
|
-
#
|
1981
|
+
# Logs. Route 53 doesn't delete any logs that are already in CloudWatch
|
1982
|
+
# Logs.
|
1980
1983
|
#
|
1981
1984
|
# For more information about DNS query logs, see
|
1982
1985
|
# CreateQueryLoggingConfig.
|
@@ -2059,8 +2062,8 @@ module Aws::Route53
|
|
2059
2062
|
# Deletes a traffic policy instance and all of the resource record sets
|
2060
2063
|
# that Amazon Route 53 created when you created the instance.
|
2061
2064
|
#
|
2062
|
-
# <note markdown="1"> In the
|
2063
|
-
#
|
2065
|
+
# <note markdown="1"> In the Route 53 console, traffic policy instances are known as policy
|
2066
|
+
# records.
|
2064
2067
|
#
|
2065
2068
|
# </note>
|
2066
2069
|
#
|
@@ -2132,15 +2135,16 @@ module Aws::Route53
|
|
2132
2135
|
req.send_request(options)
|
2133
2136
|
end
|
2134
2137
|
|
2135
|
-
# Disassociates a VPC from a Amazon Route 53 private hosted zone.
|
2138
|
+
# Disassociates a VPC from a Amazon Route 53 private hosted zone. Note
|
2139
|
+
# the following:
|
2136
2140
|
#
|
2137
|
-
#
|
2141
|
+
# * You can't disassociate the last VPC from a private hosted zone.
|
2138
2142
|
#
|
2139
|
-
#
|
2143
|
+
# * You can't convert a private hosted zone into a public hosted zone.
|
2140
2144
|
#
|
2141
|
-
# You can
|
2142
|
-
#
|
2143
|
-
#
|
2145
|
+
# * You can submit a `DisassociateVPCFromHostedZone` request using
|
2146
|
+
# either the account that created the hosted zone or the account that
|
2147
|
+
# created the VPC.
|
2144
2148
|
#
|
2145
2149
|
# @option params [required, String] :hosted_zone_id
|
2146
2150
|
# The ID of the private hosted zone that you want to disassociate a VPC
|
@@ -2249,8 +2253,8 @@ module Aws::Route53
|
|
2249
2253
|
# propagated to all Amazon Route 53 DNS servers. This is the initial
|
2250
2254
|
# status of all change batch requests.
|
2251
2255
|
#
|
2252
|
-
# * `INSYNC` indicates that the changes have propagated to all
|
2253
|
-
#
|
2256
|
+
# * `INSYNC` indicates that the changes have propagated to all Route 53
|
2257
|
+
# DNS servers.
|
2254
2258
|
#
|
2255
2259
|
# @option params [required, String] :id
|
2256
2260
|
# The ID of the change batch request. The value that you specify here is
|
@@ -2316,19 +2320,19 @@ module Aws::Route53
|
|
2316
2320
|
# Use the following syntax to determine whether a continent is supported
|
2317
2321
|
# for geolocation:
|
2318
2322
|
#
|
2319
|
-
# `GET /2013-04-01/geolocation?
|
2323
|
+
# `GET /2013-04-01/geolocation?continentcode=two-letter abbreviation for
|
2320
2324
|
# a continent `
|
2321
2325
|
#
|
2322
2326
|
# Use the following syntax to determine whether a country is supported
|
2323
2327
|
# for geolocation:
|
2324
2328
|
#
|
2325
|
-
# `GET /2013-04-01/geolocation?
|
2329
|
+
# `GET /2013-04-01/geolocation?countrycode=two-character country code `
|
2326
2330
|
#
|
2327
2331
|
# Use the following syntax to determine whether a subdivision of a
|
2328
2332
|
# country is supported for geolocation:
|
2329
2333
|
#
|
2330
|
-
# `GET /2013-04-01/geolocation?
|
2331
|
-
# code&
|
2334
|
+
# `GET /2013-04-01/geolocation?countrycode=two-character country
|
2335
|
+
# code&subdivisioncode=subdivision code `
|
2332
2336
|
#
|
2333
2337
|
# @option params [String] :continent_code
|
2334
2338
|
# Amazon Route 53 supports the following continent codes:
|
@@ -2357,9 +2361,9 @@ module Aws::Route53
|
|
2357
2361
|
#
|
2358
2362
|
# @option params [String] :subdivision_code
|
2359
2363
|
# Amazon Route 53 uses the one- to three-letter subdivision codes that
|
2360
|
-
# are specified in [ISO standard 3166-1 alpha-2][1].
|
2361
|
-
#
|
2362
|
-
# `
|
2364
|
+
# are specified in [ISO standard 3166-1 alpha-2][1]. Route 53 doesn't
|
2365
|
+
# support subdivision codes for all countries. If you specify
|
2366
|
+
# `subdivisioncode`, you must also specify `countrycode`.
|
2363
2367
|
#
|
2364
2368
|
#
|
2365
2369
|
#
|
@@ -2429,6 +2433,7 @@ module Aws::Route53
|
|
2429
2433
|
# resp.health_check.health_check_config.failure_threshold #=> Integer
|
2430
2434
|
# resp.health_check.health_check_config.measure_latency #=> Boolean
|
2431
2435
|
# resp.health_check.health_check_config.inverted #=> Boolean
|
2436
|
+
# resp.health_check.health_check_config.disabled #=> Boolean
|
2432
2437
|
# resp.health_check.health_check_config.health_threshold #=> Integer
|
2433
2438
|
# resp.health_check.health_check_config.child_health_checks #=> Array
|
2434
2439
|
# resp.health_check.health_check_config.child_health_checks[0] #=> String
|
@@ -2873,8 +2878,8 @@ module Aws::Route53
|
|
2873
2878
|
#
|
2874
2879
|
# </note>
|
2875
2880
|
#
|
2876
|
-
# <note markdown="1"> In the
|
2877
|
-
#
|
2881
|
+
# <note markdown="1"> In the Route 53 console, traffic policy instances are known as policy
|
2882
|
+
# records.
|
2878
2883
|
#
|
2879
2884
|
# </note>
|
2880
2885
|
#
|
@@ -2933,7 +2938,7 @@ module Aws::Route53
|
|
2933
2938
|
req.send_request(options)
|
2934
2939
|
end
|
2935
2940
|
|
2936
|
-
# Retrieves a list of supported
|
2941
|
+
# Retrieves a list of supported geographic locations.
|
2937
2942
|
#
|
2938
2943
|
# Countries are listed first, and continents are listed last. If Amazon
|
2939
2944
|
# Route 53 supports subdivisions for a country (for example, states or
|
@@ -2942,26 +2947,26 @@ module Aws::Route53
|
|
2942
2947
|
#
|
2943
2948
|
# @option params [String] :start_continent_code
|
2944
2949
|
# The code for the continent with which you want to start listing
|
2945
|
-
# locations that Amazon Route 53 supports for geolocation. If
|
2946
|
-
#
|
2947
|
-
#
|
2948
|
-
#
|
2949
|
-
#
|
2950
|
-
#
|
2951
|
-
# Include `
|
2952
|
-
# Don't include `
|
2950
|
+
# locations that Amazon Route 53 supports for geolocation. If Route 53
|
2951
|
+
# has already returned a page or more of results, if `IsTruncated` is
|
2952
|
+
# true, and if `NextContinentCode` from the previous response has a
|
2953
|
+
# value, enter that value in `startcontinentcode` to return the next
|
2954
|
+
# page of results.
|
2955
|
+
#
|
2956
|
+
# Include `startcontinentcode` only if you want to list continents.
|
2957
|
+
# Don't include `startcontinentcode` when you're listing countries or
|
2953
2958
|
# countries with their subdivisions.
|
2954
2959
|
#
|
2955
2960
|
# @option params [String] :start_country_code
|
2956
2961
|
# The code for the country with which you want to start listing
|
2957
|
-
# locations that Amazon Route 53 supports for geolocation. If
|
2958
|
-
#
|
2959
|
-
# `
|
2960
|
-
#
|
2961
|
-
#
|
2962
|
+
# locations that Amazon Route 53 supports for geolocation. If Route 53
|
2963
|
+
# has already returned a page or more of results, if `IsTruncated` is
|
2964
|
+
# `true`, and if `NextCountryCode` from the previous response has a
|
2965
|
+
# value, enter that value in `startcountrycode` to return the next page
|
2966
|
+
# of results.
|
2962
2967
|
#
|
2963
|
-
#
|
2964
|
-
#
|
2968
|
+
# Route 53 uses the two-letter country codes that are specified in [ISO
|
2969
|
+
# standard 3166-1 alpha-2][1].
|
2965
2970
|
#
|
2966
2971
|
#
|
2967
2972
|
#
|
@@ -2970,18 +2975,18 @@ module Aws::Route53
|
|
2970
2975
|
# @option params [String] :start_subdivision_code
|
2971
2976
|
# The code for the subdivision (for example, state or province) with
|
2972
2977
|
# which you want to start listing locations that Amazon Route 53
|
2973
|
-
# supports for geolocation. If
|
2974
|
-
#
|
2978
|
+
# supports for geolocation. If Route 53 has already returned a page or
|
2979
|
+
# more of results, if `IsTruncated` is `true`, and if
|
2975
2980
|
# `NextSubdivisionCode` from the previous response has a value, enter
|
2976
|
-
# that value in `
|
2981
|
+
# that value in `startsubdivisioncode` to return the next page of
|
2977
2982
|
# results.
|
2978
2983
|
#
|
2979
2984
|
# To list subdivisions of a country, you must include both
|
2980
|
-
# `
|
2985
|
+
# `startcountrycode` and `startsubdivisioncode`.
|
2981
2986
|
#
|
2982
2987
|
# @option params [Integer] :max_items
|
2983
2988
|
# (Optional) The maximum number of geolocations to be included in the
|
2984
|
-
# response body for this request. If more than `
|
2989
|
+
# response body for this request. If more than `maxitems` geolocations
|
2985
2990
|
# remain to be listed, then the value of the `IsTruncated` element in
|
2986
2991
|
# the response is `true`.
|
2987
2992
|
#
|
@@ -3046,7 +3051,7 @@ module Aws::Route53
|
|
3046
3051
|
# The maximum number of health checks that you want `ListHealthChecks`
|
3047
3052
|
# to return in response to the current request. Amazon Route 53 returns
|
3048
3053
|
# a maximum of 100 items. If you set `MaxItems` to a value greater than
|
3049
|
-
# 100,
|
3054
|
+
# 100, Route 53 returns only the first 100 health checks.
|
3050
3055
|
#
|
3051
3056
|
# @return [Types::ListHealthChecksResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3052
3057
|
#
|
@@ -3080,6 +3085,7 @@ module Aws::Route53
|
|
3080
3085
|
# resp.health_checks[0].health_check_config.failure_threshold #=> Integer
|
3081
3086
|
# resp.health_checks[0].health_check_config.measure_latency #=> Boolean
|
3082
3087
|
# resp.health_checks[0].health_check_config.inverted #=> Boolean
|
3088
|
+
# resp.health_checks[0].health_check_config.disabled #=> Boolean
|
3083
3089
|
# resp.health_checks[0].health_check_config.health_threshold #=> Integer
|
3084
3090
|
# resp.health_checks[0].health_check_config.child_health_checks #=> Array
|
3085
3091
|
# resp.health_checks[0].health_check_config.child_health_checks[0] #=> String
|
@@ -3138,8 +3144,8 @@ module Aws::Route53
|
|
3138
3144
|
# (Optional) The maximum number of hosted zones that you want Amazon
|
3139
3145
|
# Route 53 to return. If you have more than `maxitems` hosted zones, the
|
3140
3146
|
# value of `IsTruncated` in the response is `true`, and the value of
|
3141
|
-
# `NextMarker` is the hosted zone ID of the first hosted zone that
|
3142
|
-
#
|
3147
|
+
# `NextMarker` is the hosted zone ID of the first hosted zone that Route
|
3148
|
+
# 53 will return if you submit another request.
|
3143
3149
|
#
|
3144
3150
|
# @option params [String] :delegation_set_id
|
3145
3151
|
# If you're using reusable delegation sets and you want to list all of
|
@@ -3213,10 +3219,10 @@ module Aws::Route53
|
|
3213
3219
|
# internationalized domain names, see [DNS Domain Name Format][1] in the
|
3214
3220
|
# *Amazon Route 53 Developer Guide*.
|
3215
3221
|
#
|
3216
|
-
#
|
3217
|
-
#
|
3218
|
-
#
|
3219
|
-
#
|
3222
|
+
# Route 53 returns up to 100 items in each response. If you have a lot
|
3223
|
+
# of hosted zones, use the `MaxItems` parameter to list them in groups
|
3224
|
+
# of up to 100. The response includes values that help navigate from one
|
3225
|
+
# group of `MaxItems` hosted zones to the next:
|
3220
3226
|
#
|
3221
3227
|
# * The `DNSName` and `HostedZoneId` elements in the response contain
|
3222
3228
|
# the values, if any, specified for the `dnsname` and `hostedzoneid`
|
@@ -3359,8 +3365,8 @@ module Aws::Route53
|
|
3359
3365
|
# the value of ListQueryLoggingConfigsResponse$NextToken in the response
|
3360
3366
|
# to get the next page of results.
|
3361
3367
|
#
|
3362
|
-
# If you don't specify a value for `MaxResults`,
|
3363
|
-
#
|
3368
|
+
# If you don't specify a value for `MaxResults`, Route 53 returns up to
|
3369
|
+
# 100 configurations.
|
3364
3370
|
#
|
3365
3371
|
# @return [Types::ListQueryLoggingConfigsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3366
3372
|
#
|
@@ -3396,19 +3402,27 @@ module Aws::Route53
|
|
3396
3402
|
#
|
3397
3403
|
# `ListResourceRecordSets` returns up to 100 resource record sets at a
|
3398
3404
|
# time in ASCII order, beginning at a position specified by the `name`
|
3399
|
-
# and `type` elements.
|
3400
|
-
#
|
3405
|
+
# and `type` elements.
|
3406
|
+
#
|
3407
|
+
# **Sort order**
|
3408
|
+
#
|
3409
|
+
# `ListResourceRecordSets` sorts results first by DNS name with the
|
3410
|
+
# labels reversed, for example:
|
3401
3411
|
#
|
3402
3412
|
# `com.example.www.`
|
3403
3413
|
#
|
3404
|
-
# Note the trailing dot, which can change the sort order
|
3405
|
-
#
|
3414
|
+
# Note the trailing dot, which can change the sort order when the record
|
3415
|
+
# name contains characters that appear before `.` (decimal 46) in the
|
3416
|
+
# ASCII table. These characters include the following: `! " # $ % & ' (
|
3417
|
+
# ) * + , -`
|
3406
3418
|
#
|
3407
|
-
# When multiple records have the same DNS name,
|
3408
|
-
# by the record type.
|
3419
|
+
# When multiple records have the same DNS name, `ListResourceRecordSets`
|
3420
|
+
# sorts results by the record type.
|
3409
3421
|
#
|
3410
|
-
#
|
3411
|
-
#
|
3422
|
+
# **Specifying where to start listing records**
|
3423
|
+
#
|
3424
|
+
# You can use the name and type elements to specify the resource record
|
3425
|
+
# set that the list begins with:
|
3412
3426
|
#
|
3413
3427
|
# If you do not specify Name or Type
|
3414
3428
|
#
|
@@ -3430,9 +3444,13 @@ module Aws::Route53
|
|
3430
3444
|
# whose name is greater than or equal to `Name`, and whose type is
|
3431
3445
|
# greater than or equal to `Type`.
|
3432
3446
|
#
|
3447
|
+
# **Resource record sets that are PENDING**
|
3448
|
+
#
|
3433
3449
|
# This action returns the most current version of the records. This
|
3434
3450
|
# includes records that are `PENDING`, and that are not yet available on
|
3435
|
-
# all
|
3451
|
+
# all Route 53 DNS servers.
|
3452
|
+
#
|
3453
|
+
# **Changing resource record sets**
|
3436
3454
|
#
|
3437
3455
|
# To ensure that you get an accurate listing of the resource record sets
|
3438
3456
|
# for a hosted zone at a point in time, do not submit a
|
@@ -3441,6 +3459,15 @@ module Aws::Route53
|
|
3441
3459
|
# may display results without the latest changes while other pages
|
3442
3460
|
# display results with the latest changes.
|
3443
3461
|
#
|
3462
|
+
# **Displaying the next page of results**
|
3463
|
+
#
|
3464
|
+
# If a `ListResourceRecordSets` command returns more than one page of
|
3465
|
+
# results, the value of `IsTruncated` is `true`. To display the next
|
3466
|
+
# page of results, get the values of `NextRecordName`, `NextRecordType`,
|
3467
|
+
# and `NextRecordIdentifier` (if any) from the response. Then submit
|
3468
|
+
# another `ListResourceRecordSets` request, and specify those values for
|
3469
|
+
# `StartRecordName`, `StartRecordType`, and `StartRecordIdentifier`.
|
3470
|
+
#
|
3444
3471
|
# @option params [required, String] :hosted_zone_id
|
3445
3472
|
# The ID of the hosted zone that contains the resource record sets that
|
3446
3473
|
# you want to list.
|
@@ -3456,9 +3483,9 @@ module Aws::Route53
|
|
3456
3483
|
# `CNAME` \| `MX` \| `NAPTR` \| `NS` \| `PTR` \| `SOA` \| `SPF` \| `SRV`
|
3457
3484
|
# \| `TXT`
|
3458
3485
|
#
|
3459
|
-
# Values for weighted, latency,
|
3460
|
-
# `A` \| `AAAA` \| `CAA` \| `CNAME` \| `MX` \| `NAPTR` \|
|
3461
|
-
# \| `SRV` \| `TXT`
|
3486
|
+
# Values for weighted, latency, geolocation, and failover resource
|
3487
|
+
# record sets: `A` \| `AAAA` \| `CAA` \| `CNAME` \| `MX` \| `NAPTR` \|
|
3488
|
+
# `PTR` \| `SPF` \| `SRV` \| `TXT`
|
3462
3489
|
#
|
3463
3490
|
# Values for alias resource record sets:
|
3464
3491
|
#
|
@@ -3565,7 +3592,7 @@ module Aws::Route53
|
|
3565
3592
|
# @option params [Integer] :max_items
|
3566
3593
|
# The number of reusable delegation sets that you want Amazon Route 53
|
3567
3594
|
# to return in the response to this request. If you specify a value
|
3568
|
-
# greater than 100,
|
3595
|
+
# greater than 100, Route 53 returns only the first 100 reusable
|
3569
3596
|
# delegation sets.
|
3570
3597
|
#
|
3571
3598
|
# @return [Types::ListReusableDelegationSetsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
@@ -3704,7 +3731,7 @@ module Aws::Route53
|
|
3704
3731
|
|
3705
3732
|
# Gets information about the latest version for every traffic policy
|
3706
3733
|
# that is associated with the current AWS account. Policies are listed
|
3707
|
-
# in the order
|
3734
|
+
# in the order that they were created in.
|
3708
3735
|
#
|
3709
3736
|
# @option params [String] :traffic_policy_id_marker
|
3710
3737
|
# (Conditional) For your first request to `ListTrafficPolicies`, don't
|
@@ -3722,8 +3749,8 @@ module Aws::Route53
|
|
3722
3749
|
# Route 53 to return in response to this request. If you have more than
|
3723
3750
|
# `MaxItems` traffic policies, the value of `IsTruncated` in the
|
3724
3751
|
# response is `true`, and the value of `TrafficPolicyIdMarker` is the ID
|
3725
|
-
# of the first traffic policy that
|
3726
|
-
#
|
3752
|
+
# of the first traffic policy that Route 53 will return if you submit
|
3753
|
+
# another request.
|
3727
3754
|
#
|
3728
3755
|
# @return [Types::ListTrafficPoliciesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3729
3756
|
#
|
@@ -3770,8 +3797,8 @@ module Aws::Route53
|
|
3770
3797
|
#
|
3771
3798
|
# </note>
|
3772
3799
|
#
|
3773
|
-
#
|
3774
|
-
#
|
3800
|
+
# Route 53 returns a maximum of 100 items in each response. If you have
|
3801
|
+
# a lot of traffic policy instances, you can use the `MaxItems`
|
3775
3802
|
# parameter to list them in groups of up to 100.
|
3776
3803
|
#
|
3777
3804
|
# @option params [String] :hosted_zone_id_marker
|
@@ -3875,8 +3902,8 @@ module Aws::Route53
|
|
3875
3902
|
#
|
3876
3903
|
# </note>
|
3877
3904
|
#
|
3878
|
-
#
|
3879
|
-
#
|
3905
|
+
# Route 53 returns a maximum of 100 items in each response. If you have
|
3906
|
+
# a lot of traffic policy instances, you can use the `MaxItems`
|
3880
3907
|
# parameter to list them in groups of up to 100.
|
3881
3908
|
#
|
3882
3909
|
# @option params [required, String] :hosted_zone_id
|
@@ -3971,8 +3998,8 @@ module Aws::Route53
|
|
3971
3998
|
#
|
3972
3999
|
# </note>
|
3973
4000
|
#
|
3974
|
-
#
|
3975
|
-
#
|
4001
|
+
# Route 53 returns a maximum of 100 items in each response. If you have
|
4002
|
+
# a lot of traffic policy instances, you can use the `MaxItems`
|
3976
4003
|
# parameter to list them in groups of up to 100.
|
3977
4004
|
#
|
3978
4005
|
# @option params [required, String] :traffic_policy_id
|
@@ -4110,7 +4137,7 @@ module Aws::Route53
|
|
4110
4137
|
# specified traffic policy has more than `MaxItems` versions, the value
|
4111
4138
|
# of `IsTruncated` in the response is `true`, and the value of the
|
4112
4139
|
# `TrafficPolicyVersionMarker` element is the ID of the first version
|
4113
|
-
# that
|
4140
|
+
# that Route 53 will return if you submit another request.
|
4114
4141
|
#
|
4115
4142
|
# @return [Types::ListTrafficPolicyVersionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4116
4143
|
#
|
@@ -4170,7 +4197,7 @@ module Aws::Route53
|
|
4170
4197
|
# @option params [String] :max_results
|
4171
4198
|
# *Optional*\: An integer that specifies the maximum number of VPCs that
|
4172
4199
|
# you want Amazon Route 53 to return. If you don't specify a value for
|
4173
|
-
# `MaxResults`,
|
4200
|
+
# `MaxResults`, Route 53 returns up to 50 VPCs per page.
|
4174
4201
|
#
|
4175
4202
|
# @return [Types::ListVPCAssociationAuthorizationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4176
4203
|
#
|
@@ -4239,6 +4266,13 @@ module Aws::Route53
|
|
4239
4266
|
# from 192.0.2.0/24. The default value is 24 bits for IPv4 addresses and
|
4240
4267
|
# 64 bits for IPv6 addresses.
|
4241
4268
|
#
|
4269
|
+
# The range of valid values depends on whether `edns0clientsubnetip` is
|
4270
|
+
# an IPv4 or an IPv6 address:
|
4271
|
+
#
|
4272
|
+
# * **IPv4**\: Specify a value between 0 and 32
|
4273
|
+
#
|
4274
|
+
# * **IPv6**\: Specify a value between 0 and 128
|
4275
|
+
#
|
4242
4276
|
# @return [Types::TestDNSAnswerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4243
4277
|
#
|
4244
4278
|
# * {Types::TestDNSAnswerResponse#nameserver #nameserver} => String
|
@@ -4302,26 +4336,25 @@ module Aws::Route53
|
|
4302
4336
|
# We recommend that you use `GetHealthCheck` or `ListHealthChecks` to
|
4303
4337
|
# get the current value of `HealthCheckVersion` for the health check
|
4304
4338
|
# that you want to update, and that you include that value in your
|
4305
|
-
# `UpdateHealthCheck` request. This prevents
|
4306
|
-
#
|
4339
|
+
# `UpdateHealthCheck` request. This prevents Route 53 from overwriting
|
4340
|
+
# an intervening update:
|
4307
4341
|
#
|
4308
4342
|
# * If the value in the `UpdateHealthCheck` request matches the value of
|
4309
|
-
# `HealthCheckVersion` in the health check,
|
4310
|
-
#
|
4343
|
+
# `HealthCheckVersion` in the health check, Route 53 updates the
|
4344
|
+
# health check with the new settings.
|
4311
4345
|
#
|
4312
4346
|
# * If the value of `HealthCheckVersion` in the health check is greater,
|
4313
|
-
# the health check was changed after you got the version number.
|
4314
|
-
#
|
4347
|
+
# the health check was changed after you got the version number. Route
|
4348
|
+
# 53 does not update the health check, and it returns a
|
4315
4349
|
# `HealthCheckVersionMismatch` error.
|
4316
4350
|
#
|
4317
4351
|
# @option params [String] :ip_address
|
4318
4352
|
# The IPv4 or IPv6 IP address for the endpoint that you want Amazon
|
4319
4353
|
# Route 53 to perform health checks on. If you don't specify a value
|
4320
|
-
# for `IPAddress`,
|
4321
|
-
#
|
4322
|
-
#
|
4323
|
-
#
|
4324
|
-
# endpoint.
|
4354
|
+
# for `IPAddress`, Route 53 sends a DNS request to resolve the domain
|
4355
|
+
# name that you specify in `FullyQualifiedDomainName` at the interval
|
4356
|
+
# that you specify in `RequestInterval`. Using an IP address that is
|
4357
|
+
# returned by DNS, Route 53 then checks the health of the endpoint.
|
4325
4358
|
#
|
4326
4359
|
# Use one of the following formats for the value of `IPAddress`\:
|
4327
4360
|
#
|
@@ -4355,8 +4388,8 @@ module Aws::Route53
|
|
4355
4388
|
# For more information, see
|
4356
4389
|
# UpdateHealthCheckRequest$FullyQualifiedDomainName.
|
4357
4390
|
#
|
4358
|
-
# Constraints:
|
4359
|
-
#
|
4391
|
+
# Constraints: Route 53 can't check the health of endpoints for which
|
4392
|
+
# the IP address is in local, private, non-routable, or multicast
|
4360
4393
|
# ranges. For more information about IP addresses for which you can't
|
4361
4394
|
# create health checks, see the following documents:
|
4362
4395
|
#
|
@@ -4382,7 +4415,9 @@ module Aws::Route53
|
|
4382
4415
|
# The path that you want Amazon Route 53 to request when performing
|
4383
4416
|
# health checks. The path can be any value for which your endpoint will
|
4384
4417
|
# return an HTTP status code of 2xx or 3xx when the endpoint is healthy,
|
4385
|
-
# for example the file /docs/route53-health-check.html.
|
4418
|
+
# for example the file /docs/route53-health-check.html. You can also
|
4419
|
+
# include query string parameters, for example,
|
4420
|
+
# `/welcome.html?language=jp&login=y`.
|
4386
4421
|
#
|
4387
4422
|
# Specify this value only if you want to change it.
|
4388
4423
|
#
|
@@ -4398,43 +4433,43 @@ module Aws::Route53
|
|
4398
4433
|
#
|
4399
4434
|
# **If you specify a value for** `IPAddress`\:
|
4400
4435
|
#
|
4401
|
-
#
|
4402
|
-
#
|
4436
|
+
# Route 53 sends health check requests to the specified IPv4 or IPv6
|
4437
|
+
# address and passes the value of `FullyQualifiedDomainName` in the
|
4403
4438
|
# `Host` header for all health checks except TCP health checks. This is
|
4404
4439
|
# typically the fully qualified DNS name of the endpoint on which you
|
4405
|
-
# want
|
4440
|
+
# want Route 53 to perform health checks.
|
4406
4441
|
#
|
4407
|
-
# When
|
4442
|
+
# When Route 53 checks the health of an endpoint, here is how it
|
4408
4443
|
# constructs the `Host` header:
|
4409
4444
|
#
|
4410
4445
|
# * If you specify a value of `80` for `Port` and `HTTP` or
|
4411
|
-
# `HTTP_STR_MATCH` for `Type`,
|
4446
|
+
# `HTTP_STR_MATCH` for `Type`, Route 53 passes the value of
|
4412
4447
|
# `FullyQualifiedDomainName` to the endpoint in the `Host` header.
|
4413
4448
|
#
|
4414
4449
|
# * If you specify a value of `443` for `Port` and `HTTPS` or
|
4415
|
-
# `HTTPS_STR_MATCH` for `Type`,
|
4450
|
+
# `HTTPS_STR_MATCH` for `Type`, Route 53 passes the value of
|
4416
4451
|
# `FullyQualifiedDomainName` to the endpoint in the `Host` header.
|
4417
4452
|
#
|
4418
4453
|
# * If you specify another value for `Port` and any value except `TCP`
|
4419
|
-
# for `Type`,
|
4454
|
+
# for `Type`, Route 53 passes <i>
|
4420
4455
|
# <code>FullyQualifiedDomainName</code>\:<code>Port</code> </i> to the
|
4421
4456
|
# endpoint in the `Host` header.
|
4422
4457
|
#
|
4423
|
-
# If you don't specify a value for `FullyQualifiedDomainName`,
|
4424
|
-
#
|
4425
|
-
#
|
4458
|
+
# If you don't specify a value for `FullyQualifiedDomainName`, Route 53
|
4459
|
+
# substitutes the value of `IPAddress` in the `Host` header in each of
|
4460
|
+
# the above cases.
|
4426
4461
|
#
|
4427
4462
|
# **If you don't specify a value for** `IPAddress`\:
|
4428
4463
|
#
|
4429
|
-
# If you don't specify a value for `IPAddress`,
|
4430
|
-
#
|
4431
|
-
#
|
4432
|
-
#
|
4433
|
-
#
|
4464
|
+
# If you don't specify a value for `IPAddress`, Route 53 sends a DNS
|
4465
|
+
# request to the domain that you specify in `FullyQualifiedDomainName`
|
4466
|
+
# at the interval you specify in `RequestInterval`. Using an IPv4
|
4467
|
+
# address that is returned by DNS, Route 53 then checks the health of
|
4468
|
+
# the endpoint.
|
4434
4469
|
#
|
4435
|
-
# <note markdown="1"> If you don't specify a value for `IPAddress`,
|
4436
|
-
#
|
4437
|
-
#
|
4470
|
+
# <note markdown="1"> If you don't specify a value for `IPAddress`, Route 53 uses only IPv4
|
4471
|
+
# to send health checks to the endpoint. If there's no resource record
|
4472
|
+
# set with a type of A for the name that you specify for
|
4438
4473
|
# `FullyQualifiedDomainName`, the health check fails with a "DNS
|
4439
4474
|
# resolution failed" error.
|
4440
4475
|
#
|
@@ -4455,17 +4490,17 @@ module Aws::Route53
|
|
4455
4490
|
# will be unpredictable.
|
4456
4491
|
#
|
4457
4492
|
# In addition, if the value of `Type` is `HTTP`, `HTTPS`,
|
4458
|
-
# `HTTP_STR_MATCH`, or `HTTPS_STR_MATCH`,
|
4459
|
-
#
|
4460
|
-
#
|
4461
|
-
#
|
4493
|
+
# `HTTP_STR_MATCH`, or `HTTPS_STR_MATCH`, Route 53 passes the value of
|
4494
|
+
# `FullyQualifiedDomainName` in the `Host` header, as it does when you
|
4495
|
+
# specify a value for `IPAddress`. If the value of `Type` is `TCP`,
|
4496
|
+
# Route 53 doesn't pass a `Host` header.
|
4462
4497
|
#
|
4463
4498
|
# @option params [String] :search_string
|
4464
4499
|
# If the value of `Type` is `HTTP_STR_MATCH` or `HTTP_STR_MATCH`, the
|
4465
4500
|
# string that you want Amazon Route 53 to search for in the response
|
4466
4501
|
# body from the specified resource. If the string appears in the
|
4467
|
-
# response body,
|
4468
|
-
#
|
4502
|
+
# response body, Route 53 considers the resource healthy. (You can't
|
4503
|
+
# change the value of `Type` when you update a health check.)
|
4469
4504
|
#
|
4470
4505
|
# @option params [Integer] :failure_threshold
|
4471
4506
|
# The number of consecutive health checks that an endpoint must pass or
|
@@ -4486,6 +4521,32 @@ module Aws::Route53
|
|
4486
4521
|
# health check, for example, to consider a health check unhealthy when
|
4487
4522
|
# it otherwise would be considered healthy.
|
4488
4523
|
#
|
4524
|
+
# @option params [Boolean] :disabled
|
4525
|
+
# Stops Route 53 from performing health checks. When you disable a
|
4526
|
+
# health check, here's what happens:
|
4527
|
+
#
|
4528
|
+
# * **Health checks that check the health of endpoints:** Route 53 stops
|
4529
|
+
# submitting requests to your application, server, or other resource.
|
4530
|
+
#
|
4531
|
+
# * **Calculated health checks:** Route 53 stops aggregating the status
|
4532
|
+
# of the referenced health checks.
|
4533
|
+
#
|
4534
|
+
# * **Health checks that monitor CloudWatch alarms:** Route 53 stops
|
4535
|
+
# monitoring the corresponding CloudWatch metrics.
|
4536
|
+
#
|
4537
|
+
# After you disable a health check, Route 53 considers the status of the
|
4538
|
+
# health check to always be healthy. If you configured DNS failover,
|
4539
|
+
# Route 53 continues to route traffic to the corresponding resources. If
|
4540
|
+
# you want to stop routing traffic to a resource, change the value of
|
4541
|
+
# UpdateHealthCheckRequest$Inverted.
|
4542
|
+
#
|
4543
|
+
# Charges for a health check still apply when the health check is
|
4544
|
+
# disabled. For more information, see [Amazon Route 53 Pricing][1].
|
4545
|
+
#
|
4546
|
+
#
|
4547
|
+
#
|
4548
|
+
# [1]: http://aws.amazon.com/route53/pricing/
|
4549
|
+
#
|
4489
4550
|
# @option params [Integer] :health_threshold
|
4490
4551
|
# The number of child health checks that are associated with a
|
4491
4552
|
# `CALCULATED` health that Amazon Route 53 must consider healthy for the
|
@@ -4497,11 +4558,10 @@ module Aws::Route53
|
|
4497
4558
|
# Note the following:
|
4498
4559
|
#
|
4499
4560
|
# * If you specify a number greater than the number of child health
|
4500
|
-
# checks,
|
4501
|
-
# unhealthy.
|
4561
|
+
# checks, Route 53 always considers this health check to be unhealthy.
|
4502
4562
|
#
|
4503
|
-
# * If you specify `0`,
|
4504
|
-
#
|
4563
|
+
# * If you specify `0`, Route 53 always considers this health check to
|
4564
|
+
# be healthy.
|
4505
4565
|
#
|
4506
4566
|
# @option params [Array<String>] :child_health_checks
|
4507
4567
|
# A complex type that contains one `ChildHealthCheck` element for each
|
@@ -4540,24 +4600,22 @@ module Aws::Route53
|
|
4540
4600
|
#
|
4541
4601
|
# @option params [Types::AlarmIdentifier] :alarm_identifier
|
4542
4602
|
# A complex type that identifies the CloudWatch alarm that you want
|
4543
|
-
# Amazon Route 53 health checkers to use to determine whether
|
4544
|
-
# health check is healthy.
|
4603
|
+
# Amazon Route 53 health checkers to use to determine whether the
|
4604
|
+
# specified health check is healthy.
|
4545
4605
|
#
|
4546
4606
|
# @option params [String] :insufficient_data_health_status
|
4547
4607
|
# When CloudWatch has insufficient data about the metric to determine
|
4548
4608
|
# the alarm state, the status that you want Amazon Route 53 to assign to
|
4549
4609
|
# the health check:
|
4550
4610
|
#
|
4551
|
-
# * `Healthy`\:
|
4552
|
-
# healthy.
|
4611
|
+
# * `Healthy`\: Route 53 considers the health check to be healthy.
|
4553
4612
|
#
|
4554
|
-
# * `Unhealthy`\:
|
4555
|
-
# unhealthy.
|
4613
|
+
# * `Unhealthy`\: Route 53 considers the health check to be unhealthy.
|
4556
4614
|
#
|
4557
|
-
# * `LastKnownStatus`\:
|
4558
|
-
#
|
4559
|
-
#
|
4560
|
-
#
|
4615
|
+
# * `LastKnownStatus`\: Route 53 uses the status of the health check
|
4616
|
+
# from the last time CloudWatch had sufficient data to determine the
|
4617
|
+
# alarm state. For new health checks that have no last known status,
|
4618
|
+
# the default status for the health check is healthy.
|
4561
4619
|
#
|
4562
4620
|
# @option params [Array<String>] :reset_elements
|
4563
4621
|
# A complex type that contains one `ResettableElementName` element for
|
@@ -4567,14 +4625,14 @@ module Aws::Route53
|
|
4567
4625
|
# * `ChildHealthChecks`\: Amazon Route 53 resets
|
4568
4626
|
# HealthCheckConfig$ChildHealthChecks to null.
|
4569
4627
|
#
|
4570
|
-
# * `FullyQualifiedDomainName`\:
|
4628
|
+
# * `FullyQualifiedDomainName`\: Route 53 resets
|
4571
4629
|
# HealthCheckConfig$FullyQualifiedDomainName to null.
|
4572
4630
|
#
|
4573
|
-
# * `Regions`\:
|
4574
|
-
#
|
4631
|
+
# * `Regions`\: Route 53 resets the HealthCheckConfig$Regions list to
|
4632
|
+
# the default set of regions.
|
4575
4633
|
#
|
4576
|
-
# * `ResourcePath`\:
|
4577
|
-
#
|
4634
|
+
# * `ResourcePath`\: Route 53 resets HealthCheckConfig$ResourcePath to
|
4635
|
+
# null.
|
4578
4636
|
#
|
4579
4637
|
# @return [Types::UpdateHealthCheckResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4580
4638
|
#
|
@@ -4592,6 +4650,7 @@ module Aws::Route53
|
|
4592
4650
|
# search_string: "SearchString",
|
4593
4651
|
# failure_threshold: 1,
|
4594
4652
|
# inverted: false,
|
4653
|
+
# disabled: false,
|
4595
4654
|
# health_threshold: 1,
|
4596
4655
|
# child_health_checks: ["HealthCheckId"],
|
4597
4656
|
# enable_sni: false,
|
@@ -4620,6 +4679,7 @@ module Aws::Route53
|
|
4620
4679
|
# resp.health_check.health_check_config.failure_threshold #=> Integer
|
4621
4680
|
# resp.health_check.health_check_config.measure_latency #=> Boolean
|
4622
4681
|
# resp.health_check.health_check_config.inverted #=> Boolean
|
4682
|
+
# resp.health_check.health_check_config.disabled #=> Boolean
|
4623
4683
|
# resp.health_check.health_check_config.health_threshold #=> Integer
|
4624
4684
|
# resp.health_check.health_check_config.child_health_checks #=> Array
|
4625
4685
|
# resp.health_check.health_check_config.child_health_checks[0] #=> String
|
@@ -4740,20 +4800,20 @@ module Aws::Route53
|
|
4740
4800
|
# When you update a traffic policy instance, Amazon Route 53 continues
|
4741
4801
|
# to respond to DNS queries for the root resource record set name (such
|
4742
4802
|
# as example.com) while it replaces one group of resource record sets
|
4743
|
-
# with another.
|
4803
|
+
# with another. Route 53 performs the following operations:
|
4744
4804
|
#
|
4745
|
-
# 1.
|
4746
|
-
#
|
4805
|
+
# 1. Route 53 creates a new group of resource record sets based on the
|
4806
|
+
# specified traffic policy. This is true regardless of how
|
4747
4807
|
# significant the differences are between the existing resource
|
4748
4808
|
# record sets and the new resource record sets.
|
4749
4809
|
#
|
4750
|
-
# 2. When all of the new resource record sets have been created,
|
4751
|
-
#
|
4752
|
-
#
|
4753
|
-
#
|
4810
|
+
# 2. When all of the new resource record sets have been created, Route
|
4811
|
+
# 53 starts to respond to DNS queries for the root resource record
|
4812
|
+
# set name (such as example.com) by using the new resource record
|
4813
|
+
# sets.
|
4754
4814
|
#
|
4755
|
-
# 3.
|
4756
|
-
#
|
4815
|
+
# 3. Route 53 deletes the old group of resource record sets that are
|
4816
|
+
# associated with the root resource record set name.
|
4757
4817
|
#
|
4758
4818
|
# @option params [required, String] :id
|
4759
4819
|
# The ID of the traffic policy instance that you want to update.
|
@@ -4818,7 +4878,7 @@ module Aws::Route53
|
|
4818
4878
|
params: params,
|
4819
4879
|
config: config)
|
4820
4880
|
context[:gem_name] = 'aws-sdk-route53'
|
4821
|
-
context[:gem_version] = '1.
|
4881
|
+
context[:gem_version] = '1.13.0'
|
4822
4882
|
Seahorse::Client::Request.new(handlers, context)
|
4823
4883
|
end
|
4824
4884
|
|