aws-sdk-servicediscovery 1.46.0 → 1.48.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-servicediscovery/client.rb +76 -33
- data/lib/aws-sdk-servicediscovery/endpoint_parameters.rb +69 -0
- data/lib/aws-sdk-servicediscovery/endpoint_provider.rb +121 -0
- data/lib/aws-sdk-servicediscovery/endpoints.rb +379 -0
- data/lib/aws-sdk-servicediscovery/plugins/endpoints.rb +120 -0
- data/lib/aws-sdk-servicediscovery/types.rb +154 -114
- data/lib/aws-sdk-servicediscovery.rb +5 -1
- metadata +8 -4
@@ -105,7 +105,7 @@ module Aws::ServiceDiscovery
|
|
105
105
|
# @!attribute [rw] name
|
106
106
|
# The name that you want to assign to this namespace. When you create
|
107
107
|
# a private DNS namespace, Cloud Map automatically creates an Amazon
|
108
|
-
# Route
|
108
|
+
# Route 53 private hosted zone that has the same name as the
|
109
109
|
# namespace.
|
110
110
|
# @return [String]
|
111
111
|
#
|
@@ -194,6 +194,11 @@ module Aws::ServiceDiscovery
|
|
194
194
|
#
|
195
195
|
# @!attribute [rw] name
|
196
196
|
# The name that you want to assign to this namespace.
|
197
|
+
#
|
198
|
+
# <note markdown="1"> Do not include sensitive information in the name. The name is
|
199
|
+
# publicly available using DNS queries.
|
200
|
+
#
|
201
|
+
# </note>
|
197
202
|
# @return [String]
|
198
203
|
#
|
199
204
|
# @!attribute [rw] creator_request_id
|
@@ -289,6 +294,11 @@ module Aws::ServiceDiscovery
|
|
289
294
|
# @!attribute [rw] name
|
290
295
|
# The name that you want to assign to the service.
|
291
296
|
#
|
297
|
+
# <note markdown="1"> Do not include sensitive information in the name if the namespace is
|
298
|
+
# discoverable by public DNS queries.
|
299
|
+
#
|
300
|
+
# </note>
|
301
|
+
#
|
292
302
|
# If you want Cloud Map to create an `SRV` record when you register an
|
293
303
|
# instance and you're using a system that requires a specific `SRV`
|
294
304
|
# format, such as [HAProxy][1], specify the following for `Name`\:
|
@@ -338,16 +348,16 @@ module Aws::ServiceDiscovery
|
|
338
348
|
# @return [String]
|
339
349
|
#
|
340
350
|
# @!attribute [rw] dns_config
|
341
|
-
# A complex type that contains information about the Amazon Route
|
351
|
+
# A complex type that contains information about the Amazon Route 53
|
342
352
|
# records that you want Cloud Map to create when you register an
|
343
353
|
# instance.
|
344
354
|
# @return [Types::DnsConfig]
|
345
355
|
#
|
346
356
|
# @!attribute [rw] health_check_config
|
347
357
|
# *Public DNS and HTTP namespaces only.* A complex type that contains
|
348
|
-
# settings for an optional Route
|
358
|
+
# settings for an optional Route 53 health check. If you specify
|
349
359
|
# settings for a health check, Cloud Map associates the health check
|
350
|
-
# with all the Route
|
360
|
+
# with all the Route 53 DNS records that you specify in `DnsConfig`.
|
351
361
|
#
|
352
362
|
# If you specify a health check configuration, you can specify either
|
353
363
|
# `HealthCheckCustomConfig` or `HealthCheckConfig` but not both.
|
@@ -632,10 +642,13 @@ module Aws::ServiceDiscovery
|
|
632
642
|
include Aws::Structure
|
633
643
|
end
|
634
644
|
|
635
|
-
# A complex type that contains information about the Amazon Route
|
645
|
+
# A complex type that contains information about the Amazon Route 53 DNS
|
636
646
|
# records that you want Cloud Map to create when you register an
|
637
647
|
# instance.
|
638
648
|
#
|
649
|
+
# The record types of a service can only be changed by deleting the
|
650
|
+
# service and recreating it with a new `Dnsconfig`.
|
651
|
+
#
|
639
652
|
# @note When making an API call, you may pass DnsConfig
|
640
653
|
# data as a hash:
|
641
654
|
#
|
@@ -651,11 +664,17 @@ module Aws::ServiceDiscovery
|
|
651
664
|
# }
|
652
665
|
#
|
653
666
|
# @!attribute [rw] namespace_id
|
667
|
+
# *Use NamespaceId in [Service][1] instead.*
|
668
|
+
#
|
654
669
|
# The ID of the namespace to use for DNS configuration.
|
670
|
+
#
|
671
|
+
#
|
672
|
+
#
|
673
|
+
# [1]: https://docs.aws.amazon.com/cloud-map/latest/api/API_Service.html
|
655
674
|
# @return [String]
|
656
675
|
#
|
657
676
|
# @!attribute [rw] routing_policy
|
658
|
-
# The routing policy that you want to apply to all Route
|
677
|
+
# The routing policy that you want to apply to all Route 53 DNS
|
659
678
|
# records that Cloud Map creates when you register an instance and
|
660
679
|
# specify this service.
|
661
680
|
#
|
@@ -669,43 +688,43 @@ module Aws::ServiceDiscovery
|
|
669
688
|
# MULTIVALUE
|
670
689
|
#
|
671
690
|
# : If you define a health check for the service and the health check
|
672
|
-
# is healthy, Route
|
691
|
+
# is healthy, Route 53 returns the applicable value for up to eight
|
673
692
|
# instances.
|
674
693
|
#
|
675
694
|
# For example, suppose that the service includes configurations for
|
676
695
|
# one `A` record and a health check. You use the service to register
|
677
|
-
# 10 instances. Route
|
696
|
+
# 10 instances. Route 53 responds to DNS queries with IP addresses
|
678
697
|
# for up to eight healthy instances. If fewer than eight instances
|
679
|
-
# are healthy, Route
|
698
|
+
# are healthy, Route 53 responds to every DNS query with the IP
|
680
699
|
# addresses for all of the healthy instances.
|
681
700
|
#
|
682
|
-
# If you don't define a health check for the service, Route
|
701
|
+
# If you don't define a health check for the service, Route 53
|
683
702
|
# assumes that all instances are healthy and returns the values for
|
684
703
|
# up to eight instances.
|
685
704
|
#
|
686
705
|
# For more information about the multivalue routing policy, see
|
687
|
-
# [Multivalue Answer Routing][1] in the *Route
|
706
|
+
# [Multivalue Answer Routing][1] in the *Route 53 Developer Guide*.
|
688
707
|
#
|
689
708
|
# WEIGHTED
|
690
709
|
#
|
691
|
-
# : Route
|
710
|
+
# : Route 53 returns the applicable value from one randomly selected
|
692
711
|
# instance from among the instances that you registered using the
|
693
712
|
# same service. Currently, all records have the same weight, so you
|
694
713
|
# can't route more or less traffic to any instances.
|
695
714
|
#
|
696
715
|
# For example, suppose that the service includes configurations for
|
697
716
|
# one `A` record and a health check. You use the service to register
|
698
|
-
# 10 instances. Route
|
717
|
+
# 10 instances. Route 53 responds to DNS queries with the IP address
|
699
718
|
# for one randomly selected instance from among the healthy
|
700
|
-
# instances. If no instances are healthy, Route
|
719
|
+
# instances. If no instances are healthy, Route 53 responds to DNS
|
701
720
|
# queries as if all of the instances were healthy.
|
702
721
|
#
|
703
|
-
# If you don't define a health check for the service, Route
|
722
|
+
# If you don't define a health check for the service, Route 53
|
704
723
|
# assumes that all instances are healthy and returns the applicable
|
705
724
|
# value for one randomly selected instance.
|
706
725
|
#
|
707
726
|
# For more information about the weighted routing policy, see
|
708
|
-
# [Weighted Routing][2] in the *Route
|
727
|
+
# [Weighted Routing][2] in the *Route 53 Developer Guide*.
|
709
728
|
#
|
710
729
|
#
|
711
730
|
#
|
@@ -714,7 +733,7 @@ module Aws::ServiceDiscovery
|
|
714
733
|
# @return [String]
|
715
734
|
#
|
716
735
|
# @!attribute [rw] dns_records
|
717
|
-
# An array that contains one `DnsRecord` object for each Route
|
736
|
+
# An array that contains one `DnsRecord` object for each Route 53 DNS
|
718
737
|
# record that you want Cloud Map to create when you register an
|
719
738
|
# instance.
|
720
739
|
# @return [Array<Types::DnsRecord>]
|
@@ -729,7 +748,7 @@ module Aws::ServiceDiscovery
|
|
729
748
|
include Aws::Structure
|
730
749
|
end
|
731
750
|
|
732
|
-
# A complex type that contains information about changes to the Route
|
751
|
+
# A complex type that contains information about changes to the Route 53
|
733
752
|
# DNS records that Cloud Map creates when you register an instance.
|
734
753
|
#
|
735
754
|
# @note When making an API call, you may pass DnsConfigChange
|
@@ -745,7 +764,7 @@ module Aws::ServiceDiscovery
|
|
745
764
|
# }
|
746
765
|
#
|
747
766
|
# @!attribute [rw] dns_records
|
748
|
-
# An array that contains one `DnsRecord` object for each Route
|
767
|
+
# An array that contains one `DnsRecord` object for each Route 53
|
749
768
|
# record that you want Cloud Map to create when you register an
|
750
769
|
# instance.
|
751
770
|
# @return [Array<Types::DnsRecord>]
|
@@ -758,11 +777,11 @@ module Aws::ServiceDiscovery
|
|
758
777
|
include Aws::Structure
|
759
778
|
end
|
760
779
|
|
761
|
-
# A complex type that contains the ID for the Route
|
780
|
+
# A complex type that contains the ID for the Route 53 hosted zone that
|
762
781
|
# Cloud Map creates when you create a namespace.
|
763
782
|
#
|
764
783
|
# @!attribute [rw] hosted_zone_id
|
765
|
-
# The ID for the Route
|
784
|
+
# The ID for the Route 53 hosted zone that Cloud Map creates when you
|
766
785
|
# create a namespace.
|
767
786
|
# @return [String]
|
768
787
|
#
|
@@ -779,7 +798,7 @@ module Aws::ServiceDiscovery
|
|
779
798
|
include Aws::Structure
|
780
799
|
end
|
781
800
|
|
782
|
-
# A complex type that contains information about the Route
|
801
|
+
# A complex type that contains information about the Route 53 DNS
|
783
802
|
# records that you want Cloud Map to create when you register an
|
784
803
|
# instance.
|
785
804
|
#
|
@@ -793,7 +812,7 @@ module Aws::ServiceDiscovery
|
|
793
812
|
#
|
794
813
|
# @!attribute [rw] type
|
795
814
|
# The type of the resource, which indicates the type of value that
|
796
|
-
# Route
|
815
|
+
# Route 53 returns in response to DNS queries. You can specify values
|
797
816
|
# for `Type` in the following combinations:
|
798
817
|
#
|
799
818
|
# * <b> <code>A</code> </b>
|
@@ -806,7 +825,7 @@ module Aws::ServiceDiscovery
|
|
806
825
|
#
|
807
826
|
# * <b> <code>CNAME</code> </b>
|
808
827
|
#
|
809
|
-
# If you want Cloud Map to create a Route
|
828
|
+
# If you want Cloud Map to create a Route 53 alias record when you
|
810
829
|
# register an instance, specify `A` or `AAAA` for `Type`.
|
811
830
|
#
|
812
831
|
# You specify other settings, such as the IP address for `A` and
|
@@ -817,17 +836,17 @@ module Aws::ServiceDiscovery
|
|
817
836
|
#
|
818
837
|
# A
|
819
838
|
#
|
820
|
-
# : Route
|
839
|
+
# : Route 53 returns the IP address of the resource in IPv4 format,
|
821
840
|
# such as 192.0.2.44.
|
822
841
|
#
|
823
842
|
# AAAA
|
824
843
|
#
|
825
|
-
# : Route
|
844
|
+
# : Route 53 returns the IP address of the resource in IPv6 format,
|
826
845
|
# such as 2001:0db8:85a3:0000:0000:abcd:0001:2345.
|
827
846
|
#
|
828
847
|
# CNAME
|
829
848
|
#
|
830
|
-
# : Route
|
849
|
+
# : Route 53 returns the domain name of the resource, such as
|
831
850
|
# www.example.com. Note the following:
|
832
851
|
#
|
833
852
|
# * You specify the domain name that you want to route traffic to
|
@@ -842,7 +861,7 @@ module Aws::ServiceDiscovery
|
|
842
861
|
#
|
843
862
|
# SRV
|
844
863
|
#
|
845
|
-
# : Route
|
864
|
+
# : Route 53 returns the value for an `SRV` record. The value for an
|
846
865
|
# `SRV` record uses the following values:
|
847
866
|
#
|
848
867
|
# `priority weight port service-hostname`
|
@@ -896,7 +915,7 @@ module Aws::ServiceDiscovery
|
|
896
915
|
# The amount of time, in seconds, that you want DNS resolvers to cache
|
897
916
|
# the settings for this record.
|
898
917
|
#
|
899
|
-
# <note markdown="1"> Alias records don't include a TTL because Route
|
918
|
+
# <note markdown="1"> Alias records don't include a TTL because Route 53 uses the TTL for
|
900
919
|
# the Amazon Web Services resource that an alias record routes traffic
|
901
920
|
# to. If you include the `AWS_ALIAS_DNS_NAME` attribute when you
|
902
921
|
# submit a [RegisterInstance][1] request, the `TTL` value is ignored.
|
@@ -1156,9 +1175,9 @@ module Aws::ServiceDiscovery
|
|
1156
1175
|
# If you specify a health check configuration, you can specify either
|
1157
1176
|
# `HealthCheckCustomConfig` or `HealthCheckConfig` but not both.
|
1158
1177
|
#
|
1159
|
-
# Health checks are basic Route
|
1178
|
+
# Health checks are basic Route 53 health checks that monitor an Amazon
|
1160
1179
|
# Web Services endpoint. For information about pricing for health
|
1161
|
-
# checks, see [Amazon Route
|
1180
|
+
# checks, see [Amazon Route 53 Pricing][1].
|
1162
1181
|
#
|
1163
1182
|
# Note the following about configuring health checks.
|
1164
1183
|
#
|
@@ -1167,7 +1186,7 @@ module Aws::ServiceDiscovery
|
|
1167
1186
|
# : If `DnsConfig` includes configurations for both `A` and `AAAA`
|
1168
1187
|
# records, Cloud Map creates a health check that uses the IPv4 address
|
1169
1188
|
# to check the health of the resource. If the endpoint tthat's
|
1170
|
-
# specified by the IPv4 address is unhealthy, Route
|
1189
|
+
# specified by the IPv4 address is unhealthy, Route 53 considers both
|
1171
1190
|
# the `A` and `AAAA` records to be unhealthy.
|
1172
1191
|
#
|
1173
1192
|
# CNAME records
|
@@ -1178,7 +1197,7 @@ module Aws::ServiceDiscovery
|
|
1178
1197
|
#
|
1179
1198
|
# Request interval
|
1180
1199
|
#
|
1181
|
-
# : A Route
|
1200
|
+
# : A Route 53 health checker in each health-checking Amazon Web
|
1182
1201
|
# Services Region sends a health check request to an endpoint every 30
|
1183
1202
|
# seconds. On average, your endpoint receives a health check request
|
1184
1203
|
# about every two seconds. However, health checkers don't coordinate
|
@@ -1188,30 +1207,30 @@ module Aws::ServiceDiscovery
|
|
1188
1207
|
#
|
1189
1208
|
# Health checking regions
|
1190
1209
|
#
|
1191
|
-
# : Health checkers perform checks from all Route
|
1210
|
+
# : Health checkers perform checks from all Route 53 health-checking
|
1192
1211
|
# Regions. For a list of the current Regions, see [Regions][2].
|
1193
1212
|
#
|
1194
1213
|
# Alias records
|
1195
1214
|
#
|
1196
1215
|
# : When you register an instance, if you include the
|
1197
|
-
# `AWS_ALIAS_DNS_NAME` attribute, Cloud Map creates a Route
|
1216
|
+
# `AWS_ALIAS_DNS_NAME` attribute, Cloud Map creates a Route 53 alias
|
1198
1217
|
# record. Note the following:
|
1199
1218
|
#
|
1200
|
-
# * Route
|
1219
|
+
# * Route 53 automatically sets `EvaluateTargetHealth` to true for
|
1201
1220
|
# alias records. When `EvaluateTargetHealth` is true, the alias
|
1202
1221
|
# record inherits the health of the referenced Amazon Web Services
|
1203
1222
|
# resource. such as an ELB load balancer. For more information, see
|
1204
1223
|
# [EvaluateTargetHealth][3].
|
1205
1224
|
#
|
1206
1225
|
# * If you include `HealthCheckConfig` and then use the service to
|
1207
|
-
# register an instance that creates an alias record, Route
|
1226
|
+
# register an instance that creates an alias record, Route 53
|
1208
1227
|
# doesn't create the health check.
|
1209
1228
|
#
|
1210
1229
|
# Charges for health checks
|
1211
1230
|
#
|
1212
|
-
# : Health checks are basic Route
|
1231
|
+
# : Health checks are basic Route 53 health checks that monitor an
|
1213
1232
|
# Amazon Web Services endpoint. For information about pricing for
|
1214
|
-
# health checks, see [Amazon Route
|
1233
|
+
# health checks, see [Amazon Route 53 Pricing][1].
|
1215
1234
|
#
|
1216
1235
|
#
|
1217
1236
|
#
|
@@ -1230,31 +1249,31 @@ module Aws::ServiceDiscovery
|
|
1230
1249
|
#
|
1231
1250
|
# @!attribute [rw] type
|
1232
1251
|
# The type of health check that you want to create, which indicates
|
1233
|
-
# how Route
|
1252
|
+
# how Route 53 determines whether an endpoint is healthy.
|
1234
1253
|
#
|
1235
1254
|
# You can't change the value of `Type` after you create a health
|
1236
1255
|
# check.
|
1237
1256
|
#
|
1238
1257
|
# You can create the following types of health checks:
|
1239
1258
|
#
|
1240
|
-
# * **HTTP**\: Route
|
1241
|
-
# successful, Route
|
1259
|
+
# * **HTTP**\: Route 53 tries to establish a TCP connection. If
|
1260
|
+
# successful, Route 53 submits an HTTP request and waits for an HTTP
|
1242
1261
|
# status code of 200 or greater and less than 400.
|
1243
1262
|
#
|
1244
|
-
# * **HTTPS**\: Route
|
1245
|
-
# successful, Route
|
1263
|
+
# * **HTTPS**\: Route 53 tries to establish a TCP connection. If
|
1264
|
+
# successful, Route 53 submits an HTTPS request and waits for an
|
1246
1265
|
# HTTP status code of 200 or greater and less than 400.
|
1247
1266
|
#
|
1248
1267
|
# If you specify HTTPS for the value of `Type`, the endpoint must
|
1249
1268
|
# support TLS v1.0 or later.
|
1250
1269
|
#
|
1251
|
-
# * **TCP**\: Route
|
1270
|
+
# * **TCP**\: Route 53 tries to establish a TCP connection.
|
1252
1271
|
#
|
1253
1272
|
# If you specify `TCP` for `Type`, don't specify a value for
|
1254
1273
|
# `ResourcePath`.
|
1255
1274
|
#
|
1256
|
-
# For more information, see [How Route
|
1257
|
-
# Endpoint Is Healthy][1] in the *Route
|
1275
|
+
# For more information, see [How Route 53 Determines Whether an
|
1276
|
+
# Endpoint Is Healthy][1] in the *Route 53 Developer Guide*.
|
1258
1277
|
#
|
1259
1278
|
#
|
1260
1279
|
#
|
@@ -1262,10 +1281,10 @@ module Aws::ServiceDiscovery
|
|
1262
1281
|
# @return [String]
|
1263
1282
|
#
|
1264
1283
|
# @!attribute [rw] resource_path
|
1265
|
-
# The path that you want Route
|
1284
|
+
# The path that you want Route 53 to request when performing health
|
1266
1285
|
# checks. The path can be any value that your endpoint returns an HTTP
|
1267
1286
|
# status code of a 2xx or 3xx format for when the endpoint is healthy.
|
1268
|
-
# An example file is `/docs/route53-health-check.html`. Route
|
1287
|
+
# An example file is `/docs/route53-health-check.html`. Route 53
|
1269
1288
|
# automatically adds the DNS name for the service. If you don't
|
1270
1289
|
# specify a value for `ResourcePath`, the default value is `/`.
|
1271
1290
|
#
|
@@ -1275,10 +1294,10 @@ module Aws::ServiceDiscovery
|
|
1275
1294
|
#
|
1276
1295
|
# @!attribute [rw] failure_threshold
|
1277
1296
|
# The number of consecutive health checks that an endpoint must pass
|
1278
|
-
# or fail for Route
|
1297
|
+
# or fail for Route 53 to change the current status of the endpoint
|
1279
1298
|
# from unhealthy to healthy or the other way around. For more
|
1280
|
-
# information, see [How Route
|
1281
|
-
# Healthy][1] in the *Route
|
1299
|
+
# information, see [How Route 53 Determines Whether an Endpoint Is
|
1300
|
+
# Healthy][1] in the *Route 53 Developer Guide*.
|
1282
1301
|
#
|
1283
1302
|
#
|
1284
1303
|
#
|
@@ -1508,15 +1527,20 @@ module Aws::ServiceDiscovery
|
|
1508
1527
|
#
|
1509
1528
|
# * For each attribute, the applicable value.
|
1510
1529
|
#
|
1530
|
+
# <note markdown="1"> Do not include sensitive information in the attributes if the
|
1531
|
+
# namespace is discoverable by public DNS queries.
|
1532
|
+
#
|
1533
|
+
# </note>
|
1534
|
+
#
|
1511
1535
|
# Supported attribute keys include the following:
|
1512
1536
|
#
|
1513
1537
|
# AWS\_ALIAS\_DNS\_NAME
|
1514
1538
|
#
|
1515
|
-
# : If you want Cloud Map to create a Route
|
1539
|
+
# : If you want Cloud Map to create a Route 53 alias record that
|
1516
1540
|
# routes traffic to an Elastic Load Balancing load balancer, specify
|
1517
1541
|
# the DNS name that's associated with the load balancer. For
|
1518
1542
|
# information about how to get the DNS name, see
|
1519
|
-
# [AliasTarget->DNSName][1] in the *Route
|
1543
|
+
# [AliasTarget->DNSName][1] in the *Route 53 API Reference*.
|
1520
1544
|
#
|
1521
1545
|
# Note the following:
|
1522
1546
|
#
|
@@ -1556,7 +1580,7 @@ module Aws::ServiceDiscovery
|
|
1556
1580
|
# AWS\_INSTANCE\_CNAME
|
1557
1581
|
#
|
1558
1582
|
# : If the service configuration includes a `CNAME` record, the domain
|
1559
|
-
# name that you want Route
|
1583
|
+
# name that you want Route 53 to return in response to DNS queries
|
1560
1584
|
# (for example, `example.com`).
|
1561
1585
|
#
|
1562
1586
|
# This value is required if the service specified by `ServiceId`
|
@@ -1565,7 +1589,7 @@ module Aws::ServiceDiscovery
|
|
1565
1589
|
# AWS\_INSTANCE\_IPV4
|
1566
1590
|
#
|
1567
1591
|
# : If the service configuration includes an `A` record, the IPv4
|
1568
|
-
# address that you want Route
|
1592
|
+
# address that you want Route 53 to return in response to DNS
|
1569
1593
|
# queries (for example, `192.0.2.44`).
|
1570
1594
|
#
|
1571
1595
|
# This value is required if the service specified by `ServiceId`
|
@@ -1576,7 +1600,7 @@ module Aws::ServiceDiscovery
|
|
1576
1600
|
# AWS\_INSTANCE\_IPV6
|
1577
1601
|
#
|
1578
1602
|
# : If the service configuration includes an `AAAA` record, the IPv6
|
1579
|
-
# address that you want Route
|
1603
|
+
# address that you want Route 53 to return in response to DNS
|
1580
1604
|
# queries (for example, `2001:0db8:85a3:0000:0000:abcd:0001:2345`).
|
1581
1605
|
#
|
1582
1606
|
# This value is required if the service specified by `ServiceId`
|
@@ -1587,13 +1611,13 @@ module Aws::ServiceDiscovery
|
|
1587
1611
|
# AWS\_INSTANCE\_PORT
|
1588
1612
|
#
|
1589
1613
|
# : If the service includes an `SRV` record, the value that you want
|
1590
|
-
# Route
|
1614
|
+
# Route 53 to return for the port.
|
1591
1615
|
#
|
1592
1616
|
# If the service includes `HealthCheckConfig`, the port on the
|
1593
|
-
# endpoint that you want Route
|
1617
|
+
# endpoint that you want Route 53 to send requests to.
|
1594
1618
|
#
|
1595
1619
|
# This value is required if you specified settings for an `SRV`
|
1596
|
-
# record or a Route
|
1620
|
+
# record or a Route 53 health check when you created the service.
|
1597
1621
|
#
|
1598
1622
|
#
|
1599
1623
|
#
|
@@ -1664,25 +1688,25 @@ module Aws::ServiceDiscovery
|
|
1664
1688
|
#
|
1665
1689
|
# AWS\_INSTANCE\_CNAME
|
1666
1690
|
#
|
1667
|
-
# : For a `CNAME` record, the domain name that Route
|
1691
|
+
# : For a `CNAME` record, the domain name that Route 53 returns in
|
1668
1692
|
# response to DNS queries (for example, `example.com`).
|
1669
1693
|
#
|
1670
1694
|
# AWS\_INSTANCE\_IPV4
|
1671
1695
|
#
|
1672
|
-
# : For an `A` record, the IPv4 address that Route
|
1696
|
+
# : For an `A` record, the IPv4 address that Route 53 returns in
|
1673
1697
|
# response to DNS queries (for example, `192.0.2.44`).
|
1674
1698
|
#
|
1675
1699
|
# AWS\_INSTANCE\_IPV6
|
1676
1700
|
#
|
1677
|
-
# : For an `AAAA` record, the IPv6 address that Route
|
1701
|
+
# : For an `AAAA` record, the IPv6 address that Route 53 returns in
|
1678
1702
|
# response to DNS queries (for example,
|
1679
1703
|
# `2001:0db8:85a3:0000:0000:abcd:0001:2345`).
|
1680
1704
|
#
|
1681
1705
|
# AWS\_INSTANCE\_PORT
|
1682
1706
|
#
|
1683
|
-
# : For an `SRV` record, the value that Route
|
1707
|
+
# : For an `SRV` record, the value that Route 53 returns for the port.
|
1684
1708
|
# In addition, if the service includes `HealthCheckConfig`, the port
|
1685
|
-
# on the endpoint that Route
|
1709
|
+
# on the endpoint that Route 53 sends requests to.
|
1686
1710
|
# @return [Hash<String,String>]
|
1687
1711
|
#
|
1688
1712
|
# @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/InstanceSummary AWS API Documentation
|
@@ -1776,9 +1800,9 @@ module Aws::ServiceDiscovery
|
|
1776
1800
|
# max_results: 1,
|
1777
1801
|
# filters: [
|
1778
1802
|
# {
|
1779
|
-
# name: "TYPE", # required, accepts TYPE
|
1803
|
+
# name: "TYPE", # required, accepts TYPE, NAME, HTTP_NAME
|
1780
1804
|
# values: ["FilterValue"], # required
|
1781
|
-
# condition: "EQ", # accepts EQ, IN, BETWEEN
|
1805
|
+
# condition: "EQ", # accepts EQ, IN, BETWEEN, BEGINS_WITH
|
1782
1806
|
# },
|
1783
1807
|
# ],
|
1784
1808
|
# }
|
@@ -1863,7 +1887,7 @@ module Aws::ServiceDiscovery
|
|
1863
1887
|
# {
|
1864
1888
|
# name: "NAMESPACE_ID", # required, accepts NAMESPACE_ID, SERVICE_ID, STATUS, TYPE, UPDATE_DATE
|
1865
1889
|
# values: ["FilterValue"], # required
|
1866
|
-
# condition: "EQ", # accepts EQ, IN, BETWEEN
|
1890
|
+
# condition: "EQ", # accepts EQ, IN, BETWEEN, BEGINS_WITH
|
1867
1891
|
# },
|
1868
1892
|
# ],
|
1869
1893
|
# }
|
@@ -1949,7 +1973,7 @@ module Aws::ServiceDiscovery
|
|
1949
1973
|
# {
|
1950
1974
|
# name: "NAMESPACE_ID", # required, accepts NAMESPACE_ID
|
1951
1975
|
# values: ["FilterValue"], # required
|
1952
|
-
# condition: "EQ", # accepts EQ, IN, BETWEEN
|
1976
|
+
# condition: "EQ", # accepts EQ, IN, BETWEEN, BEGINS_WITH
|
1953
1977
|
# },
|
1954
1978
|
# ],
|
1955
1979
|
# }
|
@@ -2162,42 +2186,47 @@ module Aws::ServiceDiscovery
|
|
2162
2186
|
# data as a hash:
|
2163
2187
|
#
|
2164
2188
|
# {
|
2165
|
-
# name: "TYPE", # required, accepts TYPE
|
2189
|
+
# name: "TYPE", # required, accepts TYPE, NAME, HTTP_NAME
|
2166
2190
|
# values: ["FilterValue"], # required
|
2167
|
-
# condition: "EQ", # accepts EQ, IN, BETWEEN
|
2191
|
+
# condition: "EQ", # accepts EQ, IN, BETWEEN, BEGINS_WITH
|
2168
2192
|
# }
|
2169
2193
|
#
|
2170
2194
|
# @!attribute [rw] name
|
2171
|
-
# Specify
|
2172
|
-
#
|
2195
|
+
# Specify the namespaces that you want to get using one of the
|
2196
|
+
# following.
|
2173
2197
|
#
|
2174
|
-
#
|
2175
|
-
# If you specify `EQ` for `Condition`, specify either `DNS_PUBLIC` or
|
2176
|
-
# `DNS_PRIVATE`.
|
2198
|
+
# * `TYPE`\: Gets the namespaces of the specified type.
|
2177
2199
|
#
|
2178
|
-
#
|
2179
|
-
# `DNS_PRIVATE`, or both.
|
2180
|
-
# @return [Array<String>]
|
2200
|
+
# * `NAME`\: Gets the namespaces with the specified name.
|
2181
2201
|
#
|
2182
|
-
#
|
2183
|
-
#
|
2184
|
-
#
|
2185
|
-
#
|
2202
|
+
# * `HTTP_NAME`\: Gets the namespaces with the specified HTTP name.
|
2203
|
+
# @return [String]
|
2204
|
+
#
|
2205
|
+
# @!attribute [rw] values
|
2206
|
+
# Specify the values that are applicable to the value that you specify
|
2207
|
+
# for `Name`.
|
2186
2208
|
#
|
2187
|
-
#
|
2209
|
+
# * `TYPE`\: Specify `HTTP`, `DNS_PUBLIC`, or `DNS_PRIVATE`.
|
2188
2210
|
#
|
2189
|
-
#
|
2190
|
-
#
|
2191
|
-
# is the default condition and can be omitted.
|
2211
|
+
# * `NAME`\: Specify the name of the namespace, which is found in
|
2212
|
+
# `Namespace.Name`.
|
2192
2213
|
#
|
2193
|
-
#
|
2214
|
+
# * `HTTP_NAME`\: Specify the HTTP name of the namespace, which is
|
2215
|
+
# found in `Namespace.Properties.HttpProperties.HttpName`.
|
2216
|
+
# @return [Array<String>]
|
2194
2217
|
#
|
2195
|
-
#
|
2196
|
-
#
|
2218
|
+
# @!attribute [rw] condition
|
2219
|
+
# Specify the operator that you want to use to determine whether a
|
2220
|
+
# namespace matches the specified value. Valid values for `Condition`
|
2221
|
+
# are one of the following.
|
2197
2222
|
#
|
2198
|
-
#
|
2223
|
+
# * `EQ`\: When you specify `EQ` for `Condition`, you can specify only
|
2224
|
+
# one value. `EQ` is supported for `TYPE`, `NAME`, and `HTTP_NAME`.
|
2225
|
+
# `EQ` is the default condition and can be omitted.
|
2199
2226
|
#
|
2200
|
-
#
|
2227
|
+
# * `BEGINS_WITH`\: When you specify `BEGINS_WITH` for `Condition`,
|
2228
|
+
# you can specify only one value. `BEGINS_WITH` is supported for
|
2229
|
+
# `TYPE`, `NAME`, and `HTTP_NAME`.
|
2201
2230
|
# @return [String]
|
2202
2231
|
#
|
2203
2232
|
# @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/NamespaceFilter AWS API Documentation
|
@@ -2227,7 +2256,7 @@ module Aws::ServiceDiscovery
|
|
2227
2256
|
# namespace type.
|
2228
2257
|
#
|
2229
2258
|
# @!attribute [rw] dns_properties
|
2230
|
-
# A complex type that contains the ID for the Route
|
2259
|
+
# A complex type that contains the ID for the Route 53 hosted zone
|
2231
2260
|
# that Cloud Map creates when you create a namespace.
|
2232
2261
|
# @return [Types::DnsProperties]
|
2233
2262
|
#
|
@@ -2257,7 +2286,7 @@ module Aws::ServiceDiscovery
|
|
2257
2286
|
#
|
2258
2287
|
# @!attribute [rw] name
|
2259
2288
|
# The name of the namespace. When you create a namespace, Cloud Map
|
2260
|
-
# automatically creates a Route
|
2289
|
+
# automatically creates a Route 53 hosted zone that has the same name
|
2261
2290
|
# as the namespace.
|
2262
2291
|
# @return [String]
|
2263
2292
|
#
|
@@ -2407,7 +2436,7 @@ module Aws::ServiceDiscovery
|
|
2407
2436
|
# {
|
2408
2437
|
# name: "NAMESPACE_ID", # required, accepts NAMESPACE_ID, SERVICE_ID, STATUS, TYPE, UPDATE_DATE
|
2409
2438
|
# values: ["FilterValue"], # required
|
2410
|
-
# condition: "EQ", # accepts EQ, IN, BETWEEN
|
2439
|
+
# condition: "EQ", # accepts EQ, IN, BETWEEN, BEGINS_WITH
|
2411
2440
|
# }
|
2412
2441
|
#
|
2413
2442
|
# @!attribute [rw] name
|
@@ -2830,6 +2859,13 @@ module Aws::ServiceDiscovery
|
|
2830
2859
|
#
|
2831
2860
|
# </note>
|
2832
2861
|
#
|
2862
|
+
# <note markdown="1"> Do not include sensitive information in `InstanceId` if the
|
2863
|
+
# namespace is discoverable by public DNS queries and any `Type`
|
2864
|
+
# member of `DnsRecord` for the service contains `SRV` because the
|
2865
|
+
# `InstanceId` is discoverable by public DNS queries.
|
2866
|
+
#
|
2867
|
+
# </note>
|
2868
|
+
#
|
2833
2869
|
#
|
2834
2870
|
#
|
2835
2871
|
# [1]: https://docs.aws.amazon.com/cloud-map/latest/api/API_DnsRecord.html#cloudmap-Type-DnsRecord-Type
|
@@ -2857,15 +2893,20 @@ module Aws::ServiceDiscovery
|
|
2857
2893
|
#
|
2858
2894
|
# * For each attribute, the applicable value.
|
2859
2895
|
#
|
2896
|
+
# <note markdown="1"> Do not include sensitive information in the attributes if the
|
2897
|
+
# namespace is discoverable by public DNS queries.
|
2898
|
+
#
|
2899
|
+
# </note>
|
2900
|
+
#
|
2860
2901
|
# Supported attribute keys include the following:
|
2861
2902
|
#
|
2862
2903
|
# AWS\_ALIAS\_DNS\_NAME
|
2863
2904
|
#
|
2864
|
-
# : If you want Cloud Map to create an Amazon Route
|
2905
|
+
# : If you want Cloud Map to create an Amazon Route 53 alias record
|
2865
2906
|
# that routes traffic to an Elastic Load Balancing load balancer,
|
2866
2907
|
# specify the DNS name that's associated with the load balancer.
|
2867
2908
|
# For information about how to get the DNS name, see "DNSName" in
|
2868
|
-
# the topic [AliasTarget][1] in the *Route
|
2909
|
+
# the topic [AliasTarget][1] in the *Route 53 API Reference*.
|
2869
2910
|
#
|
2870
2911
|
# Note the following:
|
2871
2912
|
#
|
@@ -2877,7 +2918,7 @@ module Aws::ServiceDiscovery
|
|
2877
2918
|
# `RoutingPolicy` must be `WEIGHTED`.
|
2878
2919
|
#
|
2879
2920
|
# * If the service that's specified by `ServiceId` includes
|
2880
|
-
# `HealthCheckConfig` settings, Cloud Map will create the Route
|
2921
|
+
# `HealthCheckConfig` settings, Cloud Map will create the Route 53
|
2881
2922
|
# health check, but it doesn't associate the health check with
|
2882
2923
|
# the alias record.
|
2883
2924
|
#
|
@@ -2908,7 +2949,7 @@ module Aws::ServiceDiscovery
|
|
2908
2949
|
# AWS\_INSTANCE\_CNAME
|
2909
2950
|
#
|
2910
2951
|
# : If the service configuration includes a `CNAME` record, the domain
|
2911
|
-
# name that you want Route
|
2952
|
+
# name that you want Route 53 to return in response to DNS queries
|
2912
2953
|
# (for example, `example.com`).
|
2913
2954
|
#
|
2914
2955
|
# This value is required if the service specified by `ServiceId`
|
@@ -2917,7 +2958,7 @@ module Aws::ServiceDiscovery
|
|
2917
2958
|
# AWS\_INSTANCE\_IPV4
|
2918
2959
|
#
|
2919
2960
|
# : If the service configuration includes an `A` record, the IPv4
|
2920
|
-
# address that you want Route
|
2961
|
+
# address that you want Route 53 to return in response to DNS
|
2921
2962
|
# queries (for example, `192.0.2.44`).
|
2922
2963
|
#
|
2923
2964
|
# This value is required if the service specified by `ServiceId`
|
@@ -2928,7 +2969,7 @@ module Aws::ServiceDiscovery
|
|
2928
2969
|
# AWS\_INSTANCE\_IPV6
|
2929
2970
|
#
|
2930
2971
|
# : If the service configuration includes an `AAAA` record, the IPv6
|
2931
|
-
# address that you want Route
|
2972
|
+
# address that you want Route 53 to return in response to DNS
|
2932
2973
|
# queries (for example, `2001:0db8:85a3:0000:0000:abcd:0001:2345`).
|
2933
2974
|
#
|
2934
2975
|
# This value is required if the service specified by `ServiceId`
|
@@ -2939,13 +2980,13 @@ module Aws::ServiceDiscovery
|
|
2939
2980
|
# AWS\_INSTANCE\_PORT
|
2940
2981
|
#
|
2941
2982
|
# : If the service includes an `SRV` record, the value that you want
|
2942
|
-
# Route
|
2983
|
+
# Route 53 to return for the port.
|
2943
2984
|
#
|
2944
2985
|
# If the service includes `HealthCheckConfig`, the port on the
|
2945
|
-
# endpoint that you want Route
|
2986
|
+
# endpoint that you want Route 53 to send requests to.
|
2946
2987
|
#
|
2947
2988
|
# This value is required if you specified settings for an `SRV`
|
2948
|
-
# record or a Route
|
2989
|
+
# record or a Route 53 health check when you created the service.
|
2949
2990
|
#
|
2950
2991
|
# Custom attributes
|
2951
2992
|
#
|
@@ -3125,9 +3166,12 @@ module Aws::ServiceDiscovery
|
|
3125
3166
|
# @return [Integer]
|
3126
3167
|
#
|
3127
3168
|
# @!attribute [rw] dns_config
|
3128
|
-
# A complex type that contains information about the Route
|
3169
|
+
# A complex type that contains information about the Route 53 DNS
|
3129
3170
|
# records that you want Cloud Map to create when you register an
|
3130
3171
|
# instance.
|
3172
|
+
#
|
3173
|
+
# The record types of a service can only be changed by deleting the
|
3174
|
+
# service and recreating it with a new `Dnsconfig`.
|
3131
3175
|
# @return [Types::DnsConfig]
|
3132
3176
|
#
|
3133
3177
|
# @!attribute [rw] type
|
@@ -3156,7 +3200,7 @@ module Aws::ServiceDiscovery
|
|
3156
3200
|
# that you specify in `DnsConfig`.
|
3157
3201
|
#
|
3158
3202
|
# For information about the charges for health checks, see [Amazon
|
3159
|
-
# Route
|
3203
|
+
# Route 53 Pricing][1].
|
3160
3204
|
#
|
3161
3205
|
#
|
3162
3206
|
#
|
@@ -3255,7 +3299,7 @@ module Aws::ServiceDiscovery
|
|
3255
3299
|
# @return [String]
|
3256
3300
|
#
|
3257
3301
|
# @!attribute [rw] dns_config
|
3258
|
-
# Information about the Route
|
3302
|
+
# Information about the Route 53 DNS records that you want Cloud Map
|
3259
3303
|
# to create when you register an instance.
|
3260
3304
|
# @return [Types::DnsConfigChange]
|
3261
3305
|
#
|
@@ -3285,7 +3329,7 @@ module Aws::ServiceDiscovery
|
|
3285
3329
|
# {
|
3286
3330
|
# name: "NAMESPACE_ID", # required, accepts NAMESPACE_ID
|
3287
3331
|
# values: ["FilterValue"], # required
|
3288
|
-
# condition: "EQ", # accepts EQ, IN, BETWEEN
|
3332
|
+
# condition: "EQ", # accepts EQ, IN, BETWEEN, BEGINS_WITH
|
3289
3333
|
# }
|
3290
3334
|
#
|
3291
3335
|
# @!attribute [rw] name
|
@@ -3305,11 +3349,7 @@ module Aws::ServiceDiscovery
|
|
3305
3349
|
# * `EQ`\: When you specify `EQ`, specify one namespace ID for
|
3306
3350
|
# `Values`. `EQ` is the default condition and can be omitted.
|
3307
3351
|
#
|
3308
|
-
#
|
3309
|
-
# namespaces that you want `ListServices` to return a list of
|
3310
|
-
# services for.
|
3311
|
-
#
|
3312
|
-
# * `BETWEEN`\: Not applicable.
|
3352
|
+
# ^
|
3313
3353
|
# @return [String]
|
3314
3354
|
#
|
3315
3355
|
# @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/ServiceFilter AWS API Documentation
|
@@ -3381,7 +3421,7 @@ module Aws::ServiceDiscovery
|
|
3381
3421
|
# @return [Integer]
|
3382
3422
|
#
|
3383
3423
|
# @!attribute [rw] dns_config
|
3384
|
-
# Information about the Route
|
3424
|
+
# Information about the Route 53 DNS records that you want Cloud Map
|
3385
3425
|
# to create when you register an instance.
|
3386
3426
|
# @return [Types::DnsConfig]
|
3387
3427
|
#
|