aws-sdk-servicediscovery 1.34.0 → 1.35.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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 995c80b3744ab84e37ee31750176408762a73e7fb97d8bef7c9fa24128708657
4
- data.tar.gz: 415505081bc5218c11ae643cd22ebb57343fd6dd644090c2464dfd9dca6b17d3
3
+ metadata.gz: 6f73c3cba52718cd49187f0e517a50725823f9a5e93a4dc64ec8da5dc7bb1e7c
4
+ data.tar.gz: 72a140daf32ced7dc254a7a10bd1ba72c1096d53b5783e5bf2318d28d0fda0dd
5
5
  SHA512:
6
- metadata.gz: 7be1c996ffaa01f5f3c59d4e9f76e3bfd7e2326f55be511cda1aa91b064b5ef93dd39c0099d582bc6fbc05765013d88bc603fb125ff7d4190a294a2719de78ba
7
- data.tar.gz: a063f7d05b748a907d430e589d93bc7861ed1200b7233b71592d6a24157833f11230f485be1b0042ccbaaf3d762f39b67d477db06f0b858f5255829b13c2ffc2
6
+ metadata.gz: d153878e57f5dd403d3f053b910c12ab6e213cda290a6b9753fa1600678d49152046a1b4cf9344b171dfcaa7d23ec61efc63fca36dc8584b895c8289d9dc84f4
7
+ data.tar.gz: 9d1c0375baaf29b0d084060f2080f59962ac05389f74e315fced821a95816e573f86ab8e0441b91f1e18391336b0b182b3fe24475a1ea9df40086bfe0e689dfa
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.35.0 (2021-05-06)
5
+ ------------------
6
+
7
+ * Feature - Bugfix: Improved input validation for RegisterInstance action, InstanceId field
8
+
4
9
  1.34.0 (2021-03-10)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.34.0
1
+ 1.35.0
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-servicediscovery/customizations'
48
48
  # @!group service
49
49
  module Aws::ServiceDiscovery
50
50
 
51
- GEM_VERSION = '1.34.0'
51
+ GEM_VERSION = '1.35.0'
52
52
 
53
53
  end
@@ -355,7 +355,7 @@ module Aws::ServiceDiscovery
355
355
  # @option params [String] :creator_request_id
356
356
  # A unique string that identifies the request and that allows failed
357
357
  # `CreateHttpNamespace` requests to be retried without the risk of
358
- # executing the operation twice. `CreatorRequestId` can be any unique
358
+ # running the operation twice. `CreatorRequestId` can be any unique
359
359
  # string, for example, a date/time stamp.
360
360
  #
361
361
  # **A suitable default value is auto-generated.** You should normally
@@ -366,9 +366,8 @@ module Aws::ServiceDiscovery
366
366
  #
367
367
  # @option params [Array<Types::Tag>] :tags
368
368
  # The tags to add to the namespace. Each tag consists of a key and an
369
- # optional value, both of which you define. Tag keys can have a maximum
370
- # character length of 128 characters, and tag values can have a maximum
371
- # length of 256 characters.
369
+ # optional value that you define. Tags keys can be up to 128 characters
370
+ # in length, and tag values can be up to 256 characters in length.
372
371
  #
373
372
  # @return [Types::CreateHttpNamespaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
374
373
  #
@@ -417,13 +416,13 @@ module Aws::ServiceDiscovery
417
416
  req.send_request(options)
418
417
  end
419
418
 
420
- # Creates a private namespace based on DNS, which will be visible only
421
- # inside a specified Amazon VPC. The namespace defines your service
422
- # naming scheme. For example, if you name your namespace `example.com`
423
- # and name your service `backend`, the resulting DNS name for the
424
- # service will be `backend.example.com`. For the current quota on the
425
- # number of namespaces that you can create using the same AWS account,
426
- # see [AWS Cloud Map Limits][1] in the *AWS Cloud Map Developer Guide*.
419
+ # Creates a private namespace based on DNS, which is visible only inside
420
+ # a specified Amazon VPC. The namespace defines your service naming
421
+ # scheme. For example, if you name your namespace `example.com` and name
422
+ # your service `backend`, the resulting DNS name for the service is
423
+ # `backend.example.com`. For the current quota on the number of
424
+ # namespaces that you can create using the same AWS account, see [AWS
425
+ # Cloud Map Limits][1] in the *AWS Cloud Map Developer Guide*.
427
426
  #
428
427
  #
429
428
  #
@@ -437,8 +436,8 @@ module Aws::ServiceDiscovery
437
436
  # @option params [String] :creator_request_id
438
437
  # A unique string that identifies the request and that allows failed
439
438
  # `CreatePrivateDnsNamespace` requests to be retried without the risk of
440
- # executing the operation twice. `CreatorRequestId` can be any unique
441
- # string, for example, a date/time stamp.
439
+ # running the operation twice. `CreatorRequestId` can be any unique
440
+ # string, for example, a date/timestamp.
442
441
  #
443
442
  # **A suitable default value is auto-generated.** You should normally
444
443
  # not need to pass this option.**
@@ -452,9 +451,8 @@ module Aws::ServiceDiscovery
452
451
  #
453
452
  # @option params [Array<Types::Tag>] :tags
454
453
  # The tags to add to the namespace. Each tag consists of a key and an
455
- # optional value, both of which you define. Tag keys can have a maximum
456
- # character length of 128 characters, and tag values can have a maximum
457
- # length of 256 characters.
454
+ # optional value that you define. Tags keys can be up to 128 characters
455
+ # in length, and tag values can be up to 256 characters in length.
458
456
  #
459
457
  # @return [Types::CreatePrivateDnsNamespaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
460
458
  #
@@ -504,10 +502,10 @@ module Aws::ServiceDiscovery
504
502
  req.send_request(options)
505
503
  end
506
504
 
507
- # Creates a public namespace based on DNS, which will be visible on the
505
+ # Creates a public namespace based on DNS, which is visible on the
508
506
  # internet. The namespace defines your service naming scheme. For
509
507
  # example, if you name your namespace `example.com` and name your
510
- # service `backend`, the resulting DNS name for the service will be
508
+ # service `backend`, the resulting DNS name for the service is
511
509
  # `backend.example.com`. For the current quota on the number of
512
510
  # namespaces that you can create using the same AWS account, see [AWS
513
511
  # Cloud Map Limits][1] in the *AWS Cloud Map Developer Guide*.
@@ -522,8 +520,8 @@ module Aws::ServiceDiscovery
522
520
  # @option params [String] :creator_request_id
523
521
  # A unique string that identifies the request and that allows failed
524
522
  # `CreatePublicDnsNamespace` requests to be retried without the risk of
525
- # executing the operation twice. `CreatorRequestId` can be any unique
526
- # string, for example, a date/time stamp.
523
+ # running the operation twice. `CreatorRequestId` can be any unique
524
+ # string, for example, a date/timestamp.
527
525
  #
528
526
  # **A suitable default value is auto-generated.** You should normally
529
527
  # not need to pass this option.**
@@ -533,9 +531,8 @@ module Aws::ServiceDiscovery
533
531
  #
534
532
  # @option params [Array<Types::Tag>] :tags
535
533
  # The tags to add to the namespace. Each tag consists of a key and an
536
- # optional value, both of which you define. Tag keys can have a maximum
537
- # character length of 128 characters, and tag values can have a maximum
538
- # length of 256 characters.
534
+ # optional value that you define. Tags keys can be up to 128 characters
535
+ # in length, and tag values can be up to 256 characters in length.
539
536
  #
540
537
  # @return [Types::CreatePublicDnsNamespaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
541
538
  #
@@ -619,12 +616,12 @@ module Aws::ServiceDiscovery
619
616
  # The name that you want to assign to the service.
620
617
  #
621
618
  # If you want AWS Cloud Map to create an `SRV` record when you register
622
- # an instance, and if you're using a system that requires a specific
623
- # `SRV` format, such as [HAProxy][1], specify the following for `Name`\:
619
+ # an instance and you're using a system that requires a specific `SRV`
620
+ # format, such as [HAProxy][1], specify the following for `Name`\:
624
621
  #
625
- # * Start the name with an underscore (\_), such as `_exampleservice`
622
+ # * Start the name with an underscore (\_), such as `_exampleservice`.
626
623
  #
627
- # * End the name with *.\_protocol*, such as `._tcp`
624
+ # * End the name with *.\_protocol*, such as `._tcp`.
628
625
  #
629
626
  # When you register an instance, AWS Cloud Map creates an `SRV` record
630
627
  # and assigns a name to the record by concatenating the service name and
@@ -632,11 +629,12 @@ module Aws::ServiceDiscovery
632
629
  #
633
630
  # `_exampleservice._tcp.example.com`
634
631
  #
635
- # <note markdown="1"> For a single DNS namespace, you cannot create two services with names
636
- # that differ only by case (such as EXAMPLE and example). Otherwise,
637
- # these services will have the same DNS name. However, you can create
638
- # multiple HTTP services with names that differ only by case because
639
- # HTTP services are case sensitive.
632
+ # <note markdown="1"> For services that are accessible by DNS queries, you can't create
633
+ # multiple services with names that differ only by case (such as EXAMPLE
634
+ # and example). Otherwise, these services have the same DNS name and
635
+ # can't be distinguished. However, if you use a namespace that's only
636
+ # accessible by API calls, then you can create services that with names
637
+ # that differ only by case.
640
638
  #
641
639
  # </note>
642
640
  #
@@ -646,12 +644,14 @@ module Aws::ServiceDiscovery
646
644
  #
647
645
  # @option params [String] :namespace_id
648
646
  # The ID of the namespace that you want to use to create the service.
647
+ # The namespace ID must be specified, but it can be specified either
648
+ # here or in the `DnsConfig` object.
649
649
  #
650
650
  # @option params [String] :creator_request_id
651
651
  # A unique string that identifies the request and that allows failed
652
- # `CreateService` requests to be retried without the risk of executing
653
- # the operation twice. `CreatorRequestId` can be any unique string, for
654
- # example, a date/time stamp.
652
+ # `CreateService` requests to be retried without the risk of running the
653
+ # operation twice. `CreatorRequestId` can be any unique string, for
654
+ # example, a date/timestamp.
655
655
  #
656
656
  # **A suitable default value is auto-generated.** You should normally
657
657
  # not need to pass this option.**
@@ -692,9 +692,8 @@ module Aws::ServiceDiscovery
692
692
  #
693
693
  # @option params [Array<Types::Tag>] :tags
694
694
  # The tags to add to the service. Each tag consists of a key and an
695
- # optional value, both of which you define. Tag keys can have a maximum
696
- # character length of 128 characters, and tag values can have a maximum
697
- # length of 256 characters.
695
+ # optional value that you define. Tags keys can be up to 128 characters
696
+ # in length, and tag values can be up to 256 characters in length.
698
697
  #
699
698
  # @option params [String] :type
700
699
  # If present, specifies that the service instances are only discoverable
@@ -950,8 +949,8 @@ module Aws::ServiceDiscovery
950
949
  # queries to discover instances.
951
950
  #
952
951
  # @option params [required, String] :namespace_name
953
- # The name of the namespace that you specified when you registered the
954
- # instance.
952
+ # The `HttpName` name of the namespace, found in the `HttpProperties`
953
+ # member of the `Properties` member of the namespace.
955
954
  #
956
955
  # @option params [required, String] :service_name
957
956
  # The name of the service that you specified when you registered the
@@ -966,7 +965,7 @@ module Aws::ServiceDiscovery
966
965
  # @option params [Hash<String,String>] :query_parameters
967
966
  # Filters to scope the results based on custom attributes for the
968
967
  # instance. For example, `\{version=v1, az=1a\}`. Only instances that
969
- # match all the specified key-value pairs will be returned.
968
+ # match all the specified key-value pairs are returned.
970
969
  #
971
970
  # @option params [Hash<String,String>] :optional_parameters
972
971
  # Opportunistic filters to scope the results based on custom attributes.
@@ -1966,100 +1965,101 @@ module Aws::ServiceDiscovery
1966
1965
  #
1967
1966
  # Supported attribute keys include the following:
1968
1967
  #
1969
- # **AWS\_ALIAS\_DNS\_NAME**
1968
+ # AWS\_ALIAS\_DNS\_NAME
1970
1969
  #
1971
- # If you want AWS Cloud Map to create an Amazon Route 53 alias record
1972
- # that routes traffic to an Elastic Load Balancing load balancer,
1973
- # specify the DNS name that is associated with the load balancer. For
1974
- # information about how to get the DNS name, see "DNSName" in the
1975
- # topic [AliasTarget][1] in the *Route 53 API Reference*.
1970
+ # : If you want AWS Cloud Map to create an Amazon Route 53 alias record
1971
+ # that routes traffic to an Elastic Load Balancing load balancer,
1972
+ # specify the DNS name that is associated with the load balancer. For
1973
+ # information about how to get the DNS name, see "DNSName" in the
1974
+ # topic [AliasTarget][1] in the *Route 53 API Reference*.
1976
1975
  #
1977
- # Note the following:
1976
+ # Note the following:
1978
1977
  #
1979
- # * The configuration for the service that is specified by `ServiceId`
1980
- # must include settings for an `A` record, an `AAAA` record, or both.
1978
+ # * The configuration for the service that is specified by `ServiceId`
1979
+ # must include settings for an `A` record, an `AAAA` record, or
1980
+ # both.
1981
1981
  #
1982
- # * In the service that is specified by `ServiceId`, the value of
1983
- # `RoutingPolicy` must be `WEIGHTED`.
1982
+ # * In the service that is specified by `ServiceId`, the value of
1983
+ # `RoutingPolicy` must be `WEIGHTED`.
1984
1984
  #
1985
- # * If the service that is specified by `ServiceId` includes
1986
- # `HealthCheckConfig` settings, AWS Cloud Map will create the Route 53
1987
- # health check, but it won't associate the health check with the
1988
- # alias record.
1985
+ # * If the service that is specified by `ServiceId` includes
1986
+ # `HealthCheckConfig` settings, AWS Cloud Map will create the
1987
+ # Route 53 health check, but it doesn't associate the health check
1988
+ # with the alias record.
1989
1989
  #
1990
- # * Auto naming currently doesn't support creating alias records that
1991
- # route traffic to AWS resources other than Elastic Load Balancing
1992
- # load balancers.
1990
+ # * Auto naming currently doesn't support creating alias records that
1991
+ # route traffic to AWS resources other than Elastic Load Balancing
1992
+ # load balancers.
1993
1993
  #
1994
- # * If you specify a value for `AWS_ALIAS_DNS_NAME`, don't specify
1995
- # values for any of the `AWS_INSTANCE` attributes.
1994
+ # * If you specify a value for `AWS_ALIAS_DNS_NAME`, don't specify
1995
+ # values for any of the `AWS_INSTANCE` attributes.
1996
1996
  #
1997
- # **AWS\_EC2\_INSTANCE\_ID**
1997
+ # AWS\_EC2\_INSTANCE\_ID
1998
1998
  #
1999
- # *HTTP namespaces only.* The Amazon EC2 instance ID for the instance.
2000
- # If the `AWS_EC2_INSTANCE_ID` attribute is specified, then the only
2001
- # other attribute that can be specified is `AWS_INIT_HEALTH_STATUS`.
2002
- # When the `AWS_EC2_INSTANCE_ID` attribute is specified, then the
2003
- # `AWS_INSTANCE_IPV4` attribute will be filled out with the primary
2004
- # private IPv4 address.
1999
+ # : *HTTP namespaces only.* The Amazon EC2 instance ID for the instance.
2000
+ # If the `AWS_EC2_INSTANCE_ID` attribute is specified, then the only
2001
+ # other attribute that can be specified is `AWS_INIT_HEALTH_STATUS`.
2002
+ # When the `AWS_EC2_INSTANCE_ID` attribute is specified, then the
2003
+ # `AWS_INSTANCE_IPV4` attribute will be filled out with the primary
2004
+ # private IPv4 address.
2005
2005
  #
2006
- # **AWS\_INIT\_HEALTH\_STATUS**
2006
+ # AWS\_INIT\_HEALTH\_STATUS
2007
2007
  #
2008
- # If the service configuration includes `HealthCheckCustomConfig`, you
2009
- # can optionally use `AWS_INIT_HEALTH_STATUS` to specify the initial
2010
- # status of the custom health check, `HEALTHY` or `UNHEALTHY`. If you
2011
- # don't specify a value for `AWS_INIT_HEALTH_STATUS`, the initial
2012
- # status is `HEALTHY`.
2008
+ # : If the service configuration includes `HealthCheckCustomConfig`, you
2009
+ # can optionally use `AWS_INIT_HEALTH_STATUS` to specify the initial
2010
+ # status of the custom health check, `HEALTHY` or `UNHEALTHY`. If you
2011
+ # don't specify a value for `AWS_INIT_HEALTH_STATUS`, the initial
2012
+ # status is `HEALTHY`.
2013
2013
  #
2014
- # **AWS\_INSTANCE\_CNAME**
2014
+ # AWS\_INSTANCE\_CNAME
2015
2015
  #
2016
- # If the service configuration includes a `CNAME` record, the domain
2017
- # name that you want Route 53 to return in response to DNS queries, for
2018
- # example, `example.com`.
2016
+ # : If the service configuration includes a `CNAME` record, the domain
2017
+ # name that you want Route 53 to return in response to DNS queries,
2018
+ # for example, `example.com`.
2019
2019
  #
2020
- # This value is required if the service specified by `ServiceId`
2021
- # includes settings for an `CNAME` record.
2020
+ # This value is required if the service specified by `ServiceId`
2021
+ # includes settings for an `CNAME` record.
2022
2022
  #
2023
- # **AWS\_INSTANCE\_IPV4**
2023
+ # AWS\_INSTANCE\_IPV4
2024
2024
  #
2025
- # If the service configuration includes an `A` record, the IPv4 address
2026
- # that you want Route 53 to return in response to DNS queries, for
2027
- # example, `192.0.2.44`.
2025
+ # : If the service configuration includes an `A` record, the IPv4
2026
+ # address that you want Route 53 to return in response to DNS queries,
2027
+ # for example, `192.0.2.44`.
2028
2028
  #
2029
- # This value is required if the service specified by `ServiceId`
2030
- # includes settings for an `A` record. If the service includes settings
2031
- # for an `SRV` record, you must specify a value for `AWS_INSTANCE_IPV4`,
2032
- # `AWS_INSTANCE_IPV6`, or both.
2029
+ # This value is required if the service specified by `ServiceId`
2030
+ # includes settings for an `A` record. If the service includes
2031
+ # settings for an `SRV` record, you must specify a value for
2032
+ # `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
2033
2033
  #
2034
- # **AWS\_INSTANCE\_IPV6**
2034
+ # AWS\_INSTANCE\_IPV6
2035
2035
  #
2036
- # If the service configuration includes an `AAAA` record, the IPv6
2037
- # address that you want Route 53 to return in response to DNS queries,
2038
- # for example, `2001:0db8:85a3:0000:0000:abcd:0001:2345`.
2036
+ # : If the service configuration includes an `AAAA` record, the IPv6
2037
+ # address that you want Route 53 to return in response to DNS queries,
2038
+ # for example, `2001:0db8:85a3:0000:0000:abcd:0001:2345`.
2039
2039
  #
2040
- # This value is required if the service specified by `ServiceId`
2041
- # includes settings for an `AAAA` record. If the service includes
2042
- # settings for an `SRV` record, you must specify a value for
2043
- # `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
2040
+ # This value is required if the service specified by `ServiceId`
2041
+ # includes settings for an `AAAA` record. If the service includes
2042
+ # settings for an `SRV` record, you must specify a value for
2043
+ # `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
2044
2044
  #
2045
- # **AWS\_INSTANCE\_PORT**
2045
+ # AWS\_INSTANCE\_PORT
2046
2046
  #
2047
- # If the service includes an `SRV` record, the value that you want
2048
- # Route 53 to return for the port.
2047
+ # : If the service includes an `SRV` record, the value that you want
2048
+ # Route 53 to return for the port.
2049
2049
  #
2050
- # If the service includes `HealthCheckConfig`, the port on the endpoint
2051
- # that you want Route 53 to send requests to.
2050
+ # If the service includes `HealthCheckConfig`, the port on the
2051
+ # endpoint that you want Route 53 to send requests to.
2052
2052
  #
2053
- # This value is required if you specified settings for an `SRV` record
2054
- # or a Route 53 health check when you created the service.
2053
+ # This value is required if you specified settings for an `SRV` record
2054
+ # or a Route 53 health check when you created the service.
2055
2055
  #
2056
- # **Custom attributes**
2056
+ # Custom attributes
2057
2057
  #
2058
- # You can add up to 30 custom attributes. For each key-value pair, the
2059
- # maximum length of the attribute name is 255 characters, and the
2060
- # maximum length of the attribute value is 1,024 characters. The total
2061
- # size of all provided attributes (sum of all keys and values) must not
2062
- # exceed 5,000 characters.
2058
+ # : You can add up to 30 custom attributes. For each key-value pair, the
2059
+ # maximum length of the attribute name is 255 characters, and the
2060
+ # maximum length of the attribute value is 1,024 characters. The total
2061
+ # size of all provided attributes (sum of all keys and values) must
2062
+ # not exceed 5,000 characters.
2063
2063
  #
2064
2064
  #
2065
2065
  #
@@ -2093,7 +2093,7 @@ module Aws::ServiceDiscovery
2093
2093
  #
2094
2094
  # resp = client.register_instance({
2095
2095
  # service_id: "ResourceId", # required
2096
- # instance_id: "ResourceId", # required
2096
+ # instance_id: "InstanceId", # required
2097
2097
  # creator_request_id: "ResourceId",
2098
2098
  # attributes: { # required
2099
2099
  # "AttrKey" => "AttrValue",
@@ -2288,7 +2288,7 @@ module Aws::ServiceDiscovery
2288
2288
  # are deleted from the service.
2289
2289
  #
2290
2290
  # * If you omit an existing `HealthCheckCustomConfig` configuration from
2291
- # an `UpdateService` request, the configuration is not deleted from
2291
+ # an `UpdateService` request, the configuration isn't deleted from
2292
2292
  # the service.
2293
2293
  #
2294
2294
  # When you update settings for a service, AWS Cloud Map also updates the
@@ -2382,7 +2382,7 @@ module Aws::ServiceDiscovery
2382
2382
  params: params,
2383
2383
  config: config)
2384
2384
  context[:gem_name] = 'aws-sdk-servicediscovery'
2385
- context[:gem_version] = '1.34.0'
2385
+ context[:gem_version] = '1.35.0'
2386
2386
  Seahorse::Client::Request.new(handlers, context)
2387
2387
  end
2388
2388
 
@@ -69,6 +69,7 @@ module Aws::ServiceDiscovery
69
69
  HttpProperties = Shapes::StructureShape.new(name: 'HttpProperties')
70
70
  Instance = Shapes::StructureShape.new(name: 'Instance')
71
71
  InstanceHealthStatusMap = Shapes::MapShape.new(name: 'InstanceHealthStatusMap')
72
+ InstanceId = Shapes::StringShape.new(name: 'InstanceId')
72
73
  InstanceIdList = Shapes::ListShape.new(name: 'InstanceIdList')
73
74
  InstanceNotFound = Shapes::StructureShape.new(name: 'InstanceNotFound')
74
75
  InstanceSummary = Shapes::StructureShape.new(name: 'InstanceSummary')
@@ -444,7 +445,7 @@ module Aws::ServiceDiscovery
444
445
  OperationTargetsMap.value = Shapes::ShapeRef.new(shape: ResourceId)
445
446
 
446
447
  RegisterInstanceRequest.add_member(:service_id, Shapes::ShapeRef.new(shape: ResourceId, required: true, location_name: "ServiceId"))
447
- RegisterInstanceRequest.add_member(:instance_id, Shapes::ShapeRef.new(shape: ResourceId, required: true, location_name: "InstanceId"))
448
+ RegisterInstanceRequest.add_member(:instance_id, Shapes::ShapeRef.new(shape: InstanceId, required: true, location_name: "InstanceId"))
448
449
  RegisterInstanceRequest.add_member(:creator_request_id, Shapes::ShapeRef.new(shape: ResourceId, location_name: "CreatorRequestId", metadata: {"idempotencyToken"=>true}))
449
450
  RegisterInstanceRequest.add_member(:attributes, Shapes::ShapeRef.new(shape: Attributes, required: true, location_name: "Attributes"))
450
451
  RegisterInstanceRequest.struct_class = Types::RegisterInstanceRequest
@@ -32,7 +32,7 @@ module Aws::ServiceDiscovery
32
32
  # @!attribute [rw] creator_request_id
33
33
  # A unique string that identifies the request and that allows failed
34
34
  # `CreateHttpNamespace` requests to be retried without the risk of
35
- # executing the operation twice. `CreatorRequestId` can be any unique
35
+ # running the operation twice. `CreatorRequestId` can be any unique
36
36
  # string, for example, a date/time stamp.
37
37
  #
38
38
  # **A suitable default value is auto-generated.** You should normally
@@ -45,9 +45,9 @@ module Aws::ServiceDiscovery
45
45
  #
46
46
  # @!attribute [rw] tags
47
47
  # The tags to add to the namespace. Each tag consists of a key and an
48
- # optional value, both of which you define. Tag keys can have a
49
- # maximum character length of 128 characters, and tag values can have
50
- # a maximum length of 256 characters.
48
+ # optional value that you define. Tags keys can be up to 128
49
+ # characters in length, and tag values can be up to 256 characters in
50
+ # length.
51
51
  # @return [Array<Types::Tag>]
52
52
  #
53
53
  # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/CreateHttpNamespaceRequest AWS API Documentation
@@ -105,8 +105,8 @@ module Aws::ServiceDiscovery
105
105
  # @!attribute [rw] creator_request_id
106
106
  # A unique string that identifies the request and that allows failed
107
107
  # `CreatePrivateDnsNamespace` requests to be retried without the risk
108
- # of executing the operation twice. `CreatorRequestId` can be any
109
- # unique string, for example, a date/time stamp.
108
+ # of running the operation twice. `CreatorRequestId` can be any unique
109
+ # string, for example, a date/timestamp.
110
110
  #
111
111
  # **A suitable default value is auto-generated.** You should normally
112
112
  # not need to pass this option.
@@ -123,9 +123,9 @@ module Aws::ServiceDiscovery
123
123
  #
124
124
  # @!attribute [rw] tags
125
125
  # The tags to add to the namespace. Each tag consists of a key and an
126
- # optional value, both of which you define. Tag keys can have a
127
- # maximum character length of 128 characters, and tag values can have
128
- # a maximum length of 256 characters.
126
+ # optional value that you define. Tags keys can be up to 128
127
+ # characters in length, and tag values can be up to 256 characters in
128
+ # length.
129
129
  # @return [Array<Types::Tag>]
130
130
  #
131
131
  # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/CreatePrivateDnsNamespaceRequest AWS API Documentation
@@ -180,8 +180,8 @@ module Aws::ServiceDiscovery
180
180
  # @!attribute [rw] creator_request_id
181
181
  # A unique string that identifies the request and that allows failed
182
182
  # `CreatePublicDnsNamespace` requests to be retried without the risk
183
- # of executing the operation twice. `CreatorRequestId` can be any
184
- # unique string, for example, a date/time stamp.
183
+ # of running the operation twice. `CreatorRequestId` can be any unique
184
+ # string, for example, a date/timestamp.
185
185
  #
186
186
  # **A suitable default value is auto-generated.** You should normally
187
187
  # not need to pass this option.
@@ -193,9 +193,9 @@ module Aws::ServiceDiscovery
193
193
  #
194
194
  # @!attribute [rw] tags
195
195
  # The tags to add to the namespace. Each tag consists of a key and an
196
- # optional value, both of which you define. Tag keys can have a
197
- # maximum character length of 128 characters, and tag values can have
198
- # a maximum length of 256 characters.
196
+ # optional value that you define. Tags keys can be up to 128
197
+ # characters in length, and tag values can be up to 256 characters in
198
+ # length.
199
199
  # @return [Array<Types::Tag>]
200
200
  #
201
201
  # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/CreatePublicDnsNamespaceRequest AWS API Documentation
@@ -266,13 +266,13 @@ module Aws::ServiceDiscovery
266
266
  # The name that you want to assign to the service.
267
267
  #
268
268
  # If you want AWS Cloud Map to create an `SRV` record when you
269
- # register an instance, and if you're using a system that requires a
269
+ # register an instance and you're using a system that requires a
270
270
  # specific `SRV` format, such as [HAProxy][1], specify the following
271
271
  # for `Name`\:
272
272
  #
273
- # * Start the name with an underscore (\_), such as `_exampleservice`
273
+ # * Start the name with an underscore (\_), such as `_exampleservice`.
274
274
  #
275
- # * End the name with *.\_protocol*, such as `._tcp`
275
+ # * End the name with *.\_protocol*, such as `._tcp`.
276
276
  #
277
277
  # When you register an instance, AWS Cloud Map creates an `SRV` record
278
278
  # and assigns a name to the record by concatenating the service name
@@ -280,11 +280,12 @@ module Aws::ServiceDiscovery
280
280
  #
281
281
  # `_exampleservice._tcp.example.com`
282
282
  #
283
- # <note markdown="1"> For a single DNS namespace, you cannot create two services with
284
- # names that differ only by case (such as EXAMPLE and example).
285
- # Otherwise, these services will have the same DNS name. However, you
286
- # can create multiple HTTP services with names that differ only by
287
- # case because HTTP services are case sensitive.
283
+ # <note markdown="1"> For services that are accessible by DNS queries, you can't create
284
+ # multiple services with names that differ only by case (such as
285
+ # EXAMPLE and example). Otherwise, these services have the same DNS
286
+ # name and can't be distinguished. However, if you use a namespace
287
+ # that's only accessible by API calls, then you can create services
288
+ # that with names that differ only by case.
288
289
  #
289
290
  # </note>
290
291
  #
@@ -295,13 +296,15 @@ module Aws::ServiceDiscovery
295
296
  #
296
297
  # @!attribute [rw] namespace_id
297
298
  # The ID of the namespace that you want to use to create the service.
299
+ # The namespace ID must be specified, but it can be specified either
300
+ # here or in the `DnsConfig` object.
298
301
  # @return [String]
299
302
  #
300
303
  # @!attribute [rw] creator_request_id
301
304
  # A unique string that identifies the request and that allows failed
302
- # `CreateService` requests to be retried without the risk of executing
305
+ # `CreateService` requests to be retried without the risk of running
303
306
  # the operation twice. `CreatorRequestId` can be any unique string,
304
- # for example, a date/time stamp.
307
+ # for example, a date/timestamp.
305
308
  #
306
309
  # **A suitable default value is auto-generated.** You should normally
307
310
  # not need to pass this option.
@@ -348,9 +351,9 @@ module Aws::ServiceDiscovery
348
351
  #
349
352
  # @!attribute [rw] tags
350
353
  # The tags to add to the service. Each tag consists of a key and an
351
- # optional value, both of which you define. Tag keys can have a
352
- # maximum character length of 128 characters, and tag values can have
353
- # a maximum length of 256 characters.
354
+ # optional value that you define. Tags keys can be up to 128
355
+ # characters in length, and tag values can be up to 256 characters in
356
+ # length.
354
357
  # @return [Array<Types::Tag>]
355
358
  #
356
359
  # @!attribute [rw] type
@@ -388,8 +391,8 @@ module Aws::ServiceDiscovery
388
391
  include Aws::Structure
389
392
  end
390
393
 
391
- # The health check for the instance that is specified by `ServiceId` and
392
- # `InstanceId` is not a custom health check.
394
+ # The health check for the instance that's specified by `ServiceId` and
395
+ # `InstanceId` isn't a custom health check.
393
396
  #
394
397
  # @!attribute [rw] message
395
398
  # @return [String]
@@ -526,8 +529,8 @@ module Aws::ServiceDiscovery
526
529
  # }
527
530
  #
528
531
  # @!attribute [rw] namespace_name
529
- # The name of the namespace that you specified when you registered the
530
- # instance.
532
+ # The `HttpName` name of the namespace, found in the `HttpProperties`
533
+ # member of the `Properties` member of the namespace.
531
534
  # @return [String]
532
535
  #
533
536
  # @!attribute [rw] service_name
@@ -545,7 +548,7 @@ module Aws::ServiceDiscovery
545
548
  # @!attribute [rw] query_parameters
546
549
  # Filters to scope the results based on custom attributes for the
547
550
  # instance. For example, `\{version=v1, az=1a\}`. Only instances that
548
- # match all the specified key-value pairs will be returned.
551
+ # match all the specified key-value pairs are returned.
549
552
  # @return [Hash<String,String>]
550
553
  #
551
554
  # @!attribute [rw] optional_parameters
@@ -621,46 +624,46 @@ module Aws::ServiceDiscovery
621
624
  #
622
625
  # You can specify the following values:
623
626
  #
624
- # **MULTIVALUE**
627
+ # MULTIVALUE
625
628
  #
626
- # If you define a health check for the service and the health check is
627
- # healthy, Route 53 returns the applicable value for up to eight
628
- # instances.
629
+ # : If you define a health check for the service and the health check
630
+ # is healthy, Route 53 returns the applicable value for up to eight
631
+ # instances.
629
632
  #
630
- # For example, suppose the service includes configurations for one `A`
631
- # record and a health check, and you use the service to register 10
632
- # instances. Route 53 responds to DNS queries with IP addresses for up
633
- # to eight healthy instances. If fewer than eight instances are
634
- # healthy, Route 53 responds to every DNS query with the IP addresses
635
- # for all of the healthy instances.
633
+ # For example, suppose that the service includes configurations for
634
+ # one `A` record and a health check. You use the service to register
635
+ # 10 instances. Route 53 responds to DNS queries with IP addresses
636
+ # for up to eight healthy instances. If fewer than eight instances
637
+ # are healthy, Route 53 responds to every DNS query with the IP
638
+ # addresses for all of the healthy instances.
636
639
  #
637
- # If you don't define a health check for the service, Route 53
638
- # assumes that all instances are healthy and returns the values for up
639
- # to eight instances.
640
+ # If you don't define a health check for the service, Route 53
641
+ # assumes that all instances are healthy and returns the values for
642
+ # up to eight instances.
640
643
  #
641
- # For more information about the multivalue routing policy, see
642
- # [Multivalue Answer Routing][1] in the *Route 53 Developer Guide*.
644
+ # For more information about the multivalue routing policy, see
645
+ # [Multivalue Answer Routing][1] in the *Route 53 Developer Guide*.
643
646
  #
644
- # **WEIGHTED**
647
+ # WEIGHTED
645
648
  #
646
- # Route 53 returns the applicable value from one randomly selected
647
- # instance from among the instances that you registered using the same
648
- # service. Currently, all records have the same weight, so you can't
649
- # route more or less traffic to any instances.
649
+ # : Route 53 returns the applicable value from one randomly selected
650
+ # instance from among the instances that you registered using the
651
+ # same service. Currently, all records have the same weight, so you
652
+ # can't route more or less traffic to any instances.
650
653
  #
651
- # For example, suppose the service includes configurations for one `A`
652
- # record and a health check, and you use the service to register 10
653
- # instances. Route 53 responds to DNS queries with the IP address for
654
- # one randomly selected instance from among the healthy instances. If
655
- # no instances are healthy, Route 53 responds to DNS queries as if all
656
- # of the instances were healthy.
654
+ # For example, suppose that the service includes configurations for
655
+ # one `A` record and a health check. You use the service to register
656
+ # 10 instances. Route 53 responds to DNS queries with the IP address
657
+ # for one randomly selected instance from among the healthy
658
+ # instances. If no instances are healthy, Route 53 responds to DNS
659
+ # queries as if all of the instances were healthy.
657
660
  #
658
- # If you don't define a health check for the service, Route 53
659
- # assumes that all instances are healthy and returns the applicable
660
- # value for one randomly selected instance.
661
+ # If you don't define a health check for the service, Route 53
662
+ # assumes that all instances are healthy and returns the applicable
663
+ # value for one randomly selected instance.
661
664
  #
662
- # For more information about the weighted routing policy, see
663
- # [Weighted Routing][2] in the *Route 53 Developer Guide*.
665
+ # For more information about the weighted routing policy, see
666
+ # [Weighted Routing][2] in the *Route 53 Developer Guide*.
664
667
  #
665
668
  #
666
669
  #
@@ -746,15 +749,15 @@ module Aws::ServiceDiscovery
746
749
  # Route 53 returns in response to DNS queries. You can specify values
747
750
  # for `Type` in the following combinations:
748
751
  #
749
- # * `A`
752
+ # * <b> <code>A</code> </b>
750
753
  #
751
- # * `AAAA`
754
+ # * <b> <code>AAAA</code> </b>
752
755
  #
753
- # * `A` and `AAAA`
756
+ # * <b> <code>A</code> </b> and <b> <code>AAAA</code> </b>
754
757
  #
755
- # * `SRV`
758
+ # * <b> <code>SRV</code> </b>
756
759
  #
757
- # * `CNAME`
760
+ # * <b> <code>CNAME</code> </b>
758
761
  #
759
762
  # If you want AWS Cloud Map to create a Route 53 alias record when you
760
763
  # register an instance, specify `A` or `AAAA` for `Type`.
@@ -765,62 +768,81 @@ module Aws::ServiceDiscovery
765
768
  #
766
769
  # The following values are supported:
767
770
  #
768
- # `A` <b> <code> </b> </p> <p>Route 53 returns the IP address of the
769
- # resource in IPv4 format, such as 192.0.2.44.</p> <p>
770
- # <code>AAAA</code> <b> <code> </b> </p> <p>Route 53 returns the IP
771
- # address of the resource in IPv6 format, such as
772
- # 2001:0db8:85a3:0000:0000:abcd:0001:2345.</p> <p> <code>CNAME</code>
773
- # <b> <code> </b> </p> <p>Route 53 returns the domain name of the
774
- # resource, such as www.example.com. Note the following:</p> <ul> <li>
775
- # <p>You specify the domain name that you want to route traffic to
776
- # when you register an instance. For more information, see <a
777
- # href="https://docs.aws.amazon.com/cloud-map/latest/api/API_RegisterInstance.html#cloudmap-RegisterInstance-request-Attributes">Attributes</a>
778
- # in the topic <a
779
- # href="https://docs.aws.amazon.com/cloud-map/latest/api/API_RegisterInstance.html">RegisterInstance</a>.</p>
780
- # </li> <li> <p>You must specify <code>WEIGHTED</code> for the value
781
- # of <code>RoutingPolicy</code>.</p> </li> <li> <p>You can't specify
782
- # both <code>CNAME</code> for <code>Type</code> and settings for
783
- # <code>HealthCheckConfig</code>. If you do, the request will fail
784
- # with an <code>InvalidInput</code> error.</p> </li> </ul> <p>
785
- # <b>SRV</b> </p> <p>Route 53 returns the value for an
786
- # <code>SRV</code> record. The value for an <code>SRV</code> record
787
- # uses the following values:</p> <p> <code>priority weight port
788
- # service-hostname</code> </p> <p>Note the following about the
789
- # values:</p> <ul> <li> <p>The values of <code>priority</code> and
790
- # <code>weight</code> are both set to <code>1</code> and can't be
791
- # changed. </p> </li> <li> <p>The value of <code>port</code> comes
792
- # from the value that you specify for the
793
- # <code>AWS_INSTANCE_PORT</code> attribute when you submit a <a
794
- # href="https://docs.aws.amazon.com/cloud-map/latest/api/API_RegisterInstance.html">RegisterInstance</a>
795
- # request. </p> </li> <li> <p>The value of
796
- # <code>service-hostname</code> is a concatenation of the following
797
- # values:</p> <ul> <li> <p>The value that you specify for
798
- # <code>InstanceId</code> when you register an instance.</p> </li>
799
- # <li> <p>The name of the service.</p> </li> <li> <p>The name of the
800
- # namespace. </p> </li> </ul> <p>For example, if the value of
801
- # <code>InstanceId</code> is <code>test</code>, the name of the
802
- # service is <code>backend</code>, and the name of the namespace is
803
- # <code>example.com</code>, the value of <code>service-hostname</code>
804
- # is:</p> <p> <code>test.backend.example.com</code> </p> </li> </ul>
805
- # <p>If you specify settings for an <code>SRV</code> record, note the
806
- # following:</p> <ul> <li> <p>If you specify values for
807
- # <code>AWS_INSTANCE_IPV4</code>, <code>AWS_INSTANCE_IPV6</code>, or
808
- # both in the <code>RegisterInstance</code> request, AWS Cloud Map
809
- # automatically creates <code>A</code> and/or <code>AAAA</code>
810
- # records that have the same name as the value of
811
- # <code>service-hostname</code> in the <code>SRV</code> record. You
812
- # can ignore these records.</p> </li> <li> <p>If you're using a system
813
- # that requires a specific <code>SRV</code> format, such as HAProxy,
814
- # see the <a
815
- # href="https://docs.aws.amazon.com/cloud-map/latest/api/API_CreateService.html#cloudmap-CreateService-request-Name">Name</a>
816
- # element in the documentation about <code>CreateService</code> for
817
- # information about how to specify the correct name format.</p> </li>
818
- # </ul>
819
- # </code></b></p></code></b></p></code></b>
771
+ # A
772
+ #
773
+ # : Route 53 returns the IP address of the resource in IPv4 format,
774
+ # such as 192.0.2.44.
775
+ #
776
+ # AAAA
777
+ #
778
+ # : Route 53 returns the IP address of the resource in IPv6 format,
779
+ # such as 2001:0db8:85a3:0000:0000:abcd:0001:2345.
780
+ #
781
+ # CNAME
782
+ #
783
+ # : Route 53 returns the domain name of the resource, such as
784
+ # www.example.com. Note the following:
785
+ #
786
+ # * You specify the domain name that you want to route traffic to
787
+ # when you register an instance. For more information, see
788
+ # [Attributes][2] in the topic [RegisterInstance][1].
789
+ #
790
+ # * You must specify `WEIGHTED` for the value of `RoutingPolicy`.
791
+ #
792
+ # * You can't specify both `CNAME` for `Type` and settings for
793
+ # `HealthCheckConfig`. If you do, the request will fail with an
794
+ # `InvalidInput` error.
795
+ #
796
+ # SRV
797
+ #
798
+ # : Route 53 returns the value for an `SRV` record. The value for an
799
+ # `SRV` record uses the following values:
800
+ #
801
+ # `priority weight port service-hostname`
802
+ #
803
+ # Note the following about the values:
804
+ #
805
+ # * The values of `priority` and `weight` are both set to `1` and
806
+ # can't be changed.
807
+ #
808
+ # * The value of `port` comes from the value that you specify for
809
+ # the `AWS_INSTANCE_PORT` attribute when you submit a
810
+ # [RegisterInstance][1] request.
811
+ #
812
+ # * The value of `service-hostname` is a concatenation of the
813
+ # following values:
814
+ #
815
+ # * The value that you specify for `InstanceId` when you register
816
+ # an instance.
817
+ #
818
+ # * The name of the service.
819
+ #
820
+ # * The name of the namespace.
821
+ #
822
+ # For example, if the value of `InstanceId` is `test`, the name of
823
+ # the service is `backend`, and the name of the namespace is
824
+ # `example.com`, the value of `service-hostname` is the following:
825
+ #
826
+ # `test.backend.example.com`
827
+ #
828
+ # If you specify settings for an `SRV` record, note the following:
829
+ #
830
+ # * If you specify values for `AWS_INSTANCE_IPV4`,
831
+ # `AWS_INSTANCE_IPV6`, or both in the `RegisterInstance` request,
832
+ # AWS Cloud Map automatically creates `A` and/or `AAAA` records
833
+ # that have the same name as the value of `service-hostname` in
834
+ # the `SRV` record. You can ignore these records.
835
+ #
836
+ # * If you're using a system that requires a specific `SRV` format,
837
+ # such as HAProxy, see the [Name][3] element in the documentation
838
+ # about `CreateService` for information about how to specify the
839
+ # correct name format.
820
840
  #
821
841
  #
822
842
  #
823
843
  # [1]: https://docs.aws.amazon.com/cloud-map/latest/api/API_RegisterInstance.html
844
+ # [2]: https://docs.aws.amazon.com/cloud-map/latest/api/API_RegisterInstance.html#cloudmap-RegisterInstance-request-Attributes
845
+ # [3]: https://docs.aws.amazon.com/cloud-map/latest/api/API_CreateService.html#cloudmap-CreateService-request-Name
824
846
  # @return [String]
825
847
  #
826
848
  # @!attribute [rw] ttl
@@ -1093,54 +1115,55 @@ module Aws::ServiceDiscovery
1093
1115
  #
1094
1116
  # Note the following about configuring health checks.
1095
1117
  #
1096
- # <b> <code>A</code> and <code>AAAA</code> records</b>
1118
+ # A and AAAA records
1097
1119
  #
1098
- # If `DnsConfig` includes configurations for both `A` and `AAAA`
1099
- # records, AWS Cloud Map creates a health check that uses the IPv4
1100
- # address to check the health of the resource. If the endpoint that is
1101
- # specified by the IPv4 address is unhealthy, Route 53 considers both
1102
- # the `A` and `AAAA` records to be unhealthy.
1120
+ # : If `DnsConfig` includes configurations for both `A` and `AAAA`
1121
+ # records, AWS Cloud Map creates a health check that uses the IPv4
1122
+ # address to check the health of the resource. If the endpoint that is
1123
+ # specified by the IPv4 address is unhealthy, Route 53 considers both
1124
+ # the `A` and `AAAA` records to be unhealthy.
1103
1125
  #
1104
- # <b> <code>CNAME</code> records</b>
1126
+ # CNAME records
1105
1127
  #
1106
- # You can't specify settings for `HealthCheckConfig` when the
1107
- # `DNSConfig` includes `CNAME` for the value of `Type`. If you do, the
1108
- # `CreateService` request will fail with an `InvalidInput` error.
1128
+ # : You can't specify settings for `HealthCheckConfig` when the
1129
+ # `DNSConfig` includes `CNAME` for the value of `Type`. If you do, the
1130
+ # `CreateService` request will fail with an `InvalidInput` error.
1109
1131
  #
1110
- # **Request interval**
1132
+ # Request interval
1111
1133
  #
1112
- # A Route 53 health checker in each health-checking region sends a
1113
- # health check request to an endpoint every 30 seconds. On average, your
1114
- # endpoint receives a health check request about every two seconds.
1115
- # However, health checkers don't coordinate with one another, so
1116
- # you'll sometimes see several requests per second followed by a few
1117
- # seconds with no health checks at all.
1134
+ # : A Route 53 health checker in each health-checking region sends a
1135
+ # health check request to an endpoint every 30 seconds. On average,
1136
+ # your endpoint receives a health check request about every two
1137
+ # seconds. However, health checkers don't coordinate with one
1138
+ # another, so you'll sometimes see several requests per second
1139
+ # followed by a few seconds with no health checks at all.
1118
1140
  #
1119
- # **Health checking regions**
1141
+ # Health checking regions
1120
1142
  #
1121
- # Health checkers perform checks from all Route 53 health-checking
1122
- # regions. For a list of the current regions, see [Regions][2].
1143
+ # : Health checkers perform checks from all Route 53 health-checking
1144
+ # regions. For a list of the current regions, see [Regions][2].
1123
1145
  #
1124
- # **Alias records**
1146
+ # Alias records
1125
1147
  #
1126
- # When you register an instance, if you include the `AWS_ALIAS_DNS_NAME`
1127
- # attribute, AWS Cloud Map creates a Route 53 alias record. Note the
1128
- # following:
1148
+ # : When you register an instance, if you include the
1149
+ # `AWS_ALIAS_DNS_NAME` attribute, AWS Cloud Map creates a Route 53
1150
+ # alias record. Note the following:
1129
1151
  #
1130
- # * Route 53 automatically sets `EvaluateTargetHealth` to true for alias
1131
- # records. When `EvaluateTargetHealth` is true, the alias record
1132
- # inherits the health of the referenced AWS resource. such as an ELB
1133
- # load balancer. For more information, see [EvaluateTargetHealth][3].
1152
+ # * Route 53 automatically sets `EvaluateTargetHealth` to true for
1153
+ # alias records. When `EvaluateTargetHealth` is true, the alias
1154
+ # record inherits the health of the referenced AWS resource. such as
1155
+ # an ELB load balancer. For more information, see
1156
+ # [EvaluateTargetHealth][3].
1134
1157
  #
1135
- # * If you include `HealthCheckConfig` and then use the service to
1136
- # register an instance that creates an alias record, Route 53 doesn't
1137
- # create the health check.
1158
+ # * If you include `HealthCheckConfig` and then use the service to
1159
+ # register an instance that creates an alias record, Route 53
1160
+ # doesn't create the health check.
1138
1161
  #
1139
- # **Charges for health checks**
1162
+ # Charges for health checks
1140
1163
  #
1141
- # Health checks are basic Route 53 health checks that monitor an AWS
1142
- # endpoint. For information about pricing for health checks, see [Amazon
1143
- # Route 53 Pricing][1].
1164
+ # : Health checks are basic Route 53 health checks that monitor an AWS
1165
+ # endpoint. For information about pricing for health checks, see
1166
+ # [Amazon Route 53 Pricing][1].
1144
1167
  #
1145
1168
  #
1146
1169
  #
@@ -1192,8 +1215,8 @@ module Aws::ServiceDiscovery
1192
1215
  #
1193
1216
  # @!attribute [rw] resource_path
1194
1217
  # The path that you want Route 53 to request when performing health
1195
- # checks. The path can be any value for which your endpoint will
1196
- # return an HTTP status code of 2xx or 3xx when the endpoint is
1218
+ # checks. The path can be any value for which your endpoint returns an
1219
+ # HTTP status code of a 2xx or 3xx format when the endpoint is
1197
1220
  # healthy, such as the file `/docs/route53-health-check.html`.
1198
1221
  # Route 53 automatically adds the DNS name for the service. If you
1199
1222
  # don't specify a value for `ResourcePath`, the default value is `/`.
@@ -1205,9 +1228,9 @@ module Aws::ServiceDiscovery
1205
1228
  # @!attribute [rw] failure_threshold
1206
1229
  # The number of consecutive health checks that an endpoint must pass
1207
1230
  # or fail for Route 53 to change the current status of the endpoint
1208
- # from unhealthy to healthy or vice versa. For more information, see
1209
- # [How Route 53 Determines Whether an Endpoint Is Healthy][1] in the
1210
- # *Route 53 Developer Guide*.
1231
+ # from unhealthy to healthy or the other way around. For more
1232
+ # information, see [How Route 53 Determines Whether an Endpoint Is
1233
+ # Healthy][1] in the *Route 53 Developer Guide*.
1211
1234
  #
1212
1235
  #
1213
1236
  #
@@ -1327,8 +1350,9 @@ module Aws::ServiceDiscovery
1327
1350
  # @return [String]
1328
1351
  #
1329
1352
  # @!attribute [rw] namespace_name
1330
- # The name of the namespace that you specified when you registered the
1331
- # instance.
1353
+ # ` </p> The HttpName name of the namespace, found in the
1354
+ # HttpProperties member of the Properties member of the namespace.
1355
+ # `
1332
1356
  # @return [String]
1333
1357
  #
1334
1358
  # @!attribute [rw] service_name
@@ -1427,87 +1451,94 @@ module Aws::ServiceDiscovery
1427
1451
  #
1428
1452
  # Supported attribute keys include the following:
1429
1453
  #
1430
- # **AWS\_ALIAS\_DNS\_NAME**
1454
+ # AWS\_ALIAS\_DNS\_NAME
1431
1455
  #
1432
- # ****
1456
+ # : If you want AWS Cloud Map to create a Route 53 alias record that
1457
+ # routes traffic to an Elastic Load Balancing load balancer, specify
1458
+ # the DNS name that is associated with the load balancer. For
1459
+ # information about how to get the DNS name, see
1460
+ # [AliasTarget-&gt;DNSName][1] in the *Route 53 API Reference*.
1433
1461
  #
1434
- # If you want AWS Cloud Map to create a Route 53 alias record that
1435
- # routes traffic to an Elastic Load Balancing load balancer, specify
1436
- # the DNS name that is associated with the load balancer. For
1437
- # information about how to get the DNS name, see "DNSName" in the
1438
- # topic [AliasTarget][1].
1462
+ # Note the following:
1439
1463
  #
1440
- # Note the following:
1464
+ # * The configuration for the service that is specified by
1465
+ # `ServiceId` must include settings for an `A` record, an `AAAA`
1466
+ # record, or both.
1441
1467
  #
1442
- # * The configuration for the service that is specified by `ServiceId`
1443
- # must include settings for an `A` record, an `AAAA` record, or
1444
- # both.
1468
+ # * In the service that is specified by `ServiceId`, the value of
1469
+ # `RoutingPolicy` must be `WEIGHTED`.
1445
1470
  #
1446
- # * In the service that is specified by `ServiceId`, the value of
1447
- # `RoutingPolicy` must be `WEIGHTED`.
1471
+ # * If the service that is specified by `ServiceId` includes
1472
+ # `HealthCheckConfig` settings, AWS Cloud Map creates the health
1473
+ # check, but it won't associate the health check with the alias
1474
+ # record.
1448
1475
  #
1449
- # * If the service that is specified by `ServiceId` includes
1450
- # `HealthCheckConfig` settings, AWS Cloud Map will create the health
1451
- # check, but it won't associate the health check with the alias
1452
- # record.
1476
+ # * Auto naming currently doesn't support creating alias records
1477
+ # that route traffic to AWS resources other than ELB load
1478
+ # balancers.
1453
1479
  #
1454
- # * Auto naming currently doesn't support creating alias records that
1455
- # route traffic to AWS resources other than ELB load balancers.
1480
+ # * If you specify a value for `AWS_ALIAS_DNS_NAME`, don't specify
1481
+ # values for any of the `AWS_INSTANCE` attributes.
1456
1482
  #
1457
- # * If you specify a value for `AWS_ALIAS_DNS_NAME`, don't specify
1458
- # values for any of the `AWS_INSTANCE` attributes.
1483
+ # AWS\_EC2\_INSTANCE\_ID
1459
1484
  #
1460
- # **AWS\_EC2\_INSTANCE\_ID**
1485
+ # : *HTTP namespaces only.* The Amazon EC2 instance ID for the
1486
+ # instance. The `AWS_INSTANCE_IPV4` attribute contains the primary
1487
+ # private IPv4 address.
1461
1488
  #
1462
- # *HTTP namespaces only.* The Amazon EC2 instance ID for the instance.
1463
- # The `AWS_INSTANCE_IPV4` attribute contains the primary private IPv4
1464
- # address.
1489
+ # AWS\_INIT\_HEALTH\_STATUS
1465
1490
  #
1466
- # **AWS\_INSTANCE\_CNAME**
1491
+ # : If the service configuration includes `HealthCheckCustomConfig`,
1492
+ # you can optionally use `AWS_INIT_HEALTH_STATUS` to specify the
1493
+ # initial status of the custom health check, `HEALTHY` or
1494
+ # `UNHEALTHY`. If you don't specify a value for
1495
+ # `AWS_INIT_HEALTH_STATUS`, the initial status is `HEALTHY`.
1467
1496
  #
1468
- # If the service configuration includes a `CNAME` record, the domain
1469
- # name that you want Route 53 to return in response to DNS queries,
1470
- # for example, `example.com`.
1497
+ # AWS\_INSTANCE\_CNAME
1471
1498
  #
1472
- # This value is required if the service specified by `ServiceId`
1473
- # includes settings for an `CNAME` record.
1499
+ # : If the service configuration includes a `CNAME` record, the domain
1500
+ # name that you want Route 53 to return in response to DNS queries,
1501
+ # for example, `example.com`.
1474
1502
  #
1475
- # **AWS\_INSTANCE\_IPV4**
1503
+ # This value is required if the service specified by `ServiceId`
1504
+ # includes settings for an `CNAME` record.
1476
1505
  #
1477
- # If the service configuration includes an `A` record, the IPv4
1478
- # address that you want Route 53 to return in response to DNS queries,
1479
- # for example, `192.0.2.44`.
1506
+ # AWS\_INSTANCE\_IPV4
1480
1507
  #
1481
- # This value is required if the service specified by `ServiceId`
1482
- # includes settings for an `A` record. If the service includes
1483
- # settings for an `SRV` record, you must specify a value for
1484
- # `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
1508
+ # : If the service configuration includes an `A` record, the IPv4
1509
+ # address that you want Route 53 to return in response to DNS
1510
+ # queries, for example, `192.0.2.44`.
1485
1511
  #
1486
- # **AWS\_INSTANCE\_IPV6**
1512
+ # This value is required if the service specified by `ServiceId`
1513
+ # includes settings for an `A` record. If the service includes
1514
+ # settings for an `SRV` record, you must specify a value for
1515
+ # `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
1487
1516
  #
1488
- # If the service configuration includes an `AAAA` record, the IPv6
1489
- # address that you want Route 53 to return in response to DNS queries,
1490
- # for example, `2001:0db8:85a3:0000:0000:abcd:0001:2345`.
1517
+ # AWS\_INSTANCE\_IPV6
1491
1518
  #
1492
- # This value is required if the service specified by `ServiceId`
1493
- # includes settings for an `AAAA` record. If the service includes
1494
- # settings for an `SRV` record, you must specify a value for
1495
- # `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
1519
+ # : If the service configuration includes an `AAAA` record, the IPv6
1520
+ # address that you want Route 53 to return in response to DNS
1521
+ # queries, for example, `2001:0db8:85a3:0000:0000:abcd:0001:2345`.
1496
1522
  #
1497
- # **AWS\_INSTANCE\_PORT**
1523
+ # This value is required if the service specified by `ServiceId`
1524
+ # includes settings for an `AAAA` record. If the service includes
1525
+ # settings for an `SRV` record, you must specify a value for
1526
+ # `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
1498
1527
  #
1499
- # If the service includes an `SRV` record, the value that you want
1500
- # Route 53 to return for the port.
1528
+ # AWS\_INSTANCE\_PORT
1501
1529
  #
1502
- # If the service includes `HealthCheckConfig`, the port on the
1503
- # endpoint that you want Route 53 to send requests to.
1530
+ # : If the service includes an `SRV` record, the value that you want
1531
+ # Route 53 to return for the port.
1504
1532
  #
1505
- # This value is required if you specified settings for an `SRV` record
1506
- # or a Route 53 health check when you created the service.
1533
+ # If the service includes `HealthCheckConfig`, the port on the
1534
+ # endpoint that you want Route 53 to send requests to.
1507
1535
  #
1536
+ # This value is required if you specified settings for an `SRV`
1537
+ # record or a Route 53 health check when you created the service.
1508
1538
  #
1509
1539
  #
1510
- # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html
1540
+ #
1541
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-DNSName
1511
1542
  # @return [Hash<String,String>]
1512
1543
  #
1513
1544
  # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/Instance AWS API Documentation
@@ -1551,31 +1582,48 @@ module Aws::ServiceDiscovery
1551
1582
  #
1552
1583
  # Supported attribute keys include the following:
1553
1584
  #
1554
- # * `AWS_ALIAS_DNS_NAME`\: For an alias record that routes traffic to
1555
- # an Elastic Load Balancing load balancer, the DNS name that is
1556
- # associated with the load balancer.
1585
+ # AWS\_ALIAS\_DNS\_NAME
1586
+ #
1587
+ # : For an alias record that routes traffic to an Elastic Load
1588
+ # Balancing load balancer, the DNS name that is associated with the
1589
+ # load balancer.
1590
+ #
1591
+ # AWS\_EC2\_INSTANCE\_ID (HTTP namespaces only)
1592
+ #
1593
+ # : The Amazon EC2 instance ID for the instance. When the
1594
+ # `AWS_EC2_INSTANCE_ID` attribute is specified, then the
1595
+ # `AWS_INSTANCE_IPV4` attribute contains the primary private IPv4
1596
+ # address.
1597
+ #
1598
+ # AWS\_INIT\_HEALTH\_STATUS
1599
+ #
1600
+ # : If the service configuration includes `HealthCheckCustomConfig`,
1601
+ # you can optionally use `AWS_INIT_HEALTH_STATUS` to specify the
1602
+ # initial status of the custom health check, `HEALTHY` or
1603
+ # `UNHEALTHY`. If you don't specify a value for
1604
+ # `AWS_INIT_HEALTH_STATUS`, the initial status is `HEALTHY`.
1557
1605
  #
1558
- # * `AWS_EC2_INSTANCE_ID`\: (HTTP namespaces only) The Amazon EC2
1559
- # instance ID for the instance. When the `AWS_EC2_INSTANCE_ID`
1560
- # attribute is specified, then the `AWS_INSTANCE_IPV4` attribute
1561
- # contains the primary private IPv4 address.
1606
+ # AWS\_INSTANCE\_CNAME
1562
1607
  #
1563
- # * `AWS_INSTANCE_CNAME`\: For a `CNAME` record, the domain name that
1564
- # Route 53 returns in response to DNS queries, for example,
1565
- # `example.com`.
1608
+ # : For a `CNAME` record, the domain name that Route 53 returns in
1609
+ # response to DNS queries, for example, `example.com`.
1566
1610
  #
1567
- # * `AWS_INSTANCE_IPV4`\: For an `A` record, the IPv4 address that
1568
- # Route 53 returns in response to DNS queries, for example,
1569
- # `192.0.2.44`.
1611
+ # AWS\_INSTANCE\_IPV4
1570
1612
  #
1571
- # * `AWS_INSTANCE_IPV6`\: For an `AAAA` record, the IPv6 address that
1572
- # Route 53 returns in response to DNS queries, for example,
1613
+ # : For an `A` record, the IPv4 address that Route 53 returns in
1614
+ # response to DNS queries, for example, `192.0.2.44`.
1615
+ #
1616
+ # AWS\_INSTANCE\_IPV6
1617
+ #
1618
+ # : For an `AAAA` record, the IPv6 address that Route 53 returns in
1619
+ # response to DNS queries, for example,
1573
1620
  # `2001:0db8:85a3:0000:0000:abcd:0001:2345`.
1574
1621
  #
1575
- # * `AWS_INSTANCE_PORT`\: For an `SRV` record, the value that Route 53
1576
- # returns for the port. In addition, if the service includes
1577
- # `HealthCheckConfig`, the port on the endpoint that Route 53 sends
1578
- # requests to.
1622
+ # AWS\_INSTANCE\_PORT
1623
+ #
1624
+ # : For an `SRV` record, the value that Route 53 returns for the port.
1625
+ # In addition, if the service includes `HealthCheckConfig`, the port
1626
+ # on the endpoint that Route 53 sends requests to.
1579
1627
  # @return [Hash<String,String>]
1580
1628
  #
1581
1629
  # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/InstanceSummary AWS API Documentation
@@ -1968,14 +2016,20 @@ module Aws::ServiceDiscovery
1968
2016
  # The type of the namespace. The methods for discovering instances
1969
2017
  # depends on the value that you specify:
1970
2018
  #
1971
- # * `HTTP`\: Instances can be discovered only programmatically, using
1972
- # the AWS Cloud Map `DiscoverInstances` API.
2019
+ # HTTP
2020
+ #
2021
+ # : Instances can be discovered only programmatically, using the AWS
2022
+ # Cloud Map `DiscoverInstances` API.
2023
+ #
2024
+ # DNS\_PUBLIC
2025
+ #
2026
+ # : Instances can be discovered using public DNS queries and using the
2027
+ # `DiscoverInstances` API.
1973
2028
  #
1974
- # * `DNS_PUBLIC`\: Instances can be discovered using public DNS
1975
- # queries and using the `DiscoverInstances` API.
2029
+ # DNS\_PRIVATE
1976
2030
  #
1977
- # * `DNS_PRIVATE`\: Instances can be discovered using DNS queries in
1978
- # VPCs and using the `DiscoverInstances` API.
2031
+ # : Instances can be discovered using DNS queries in VPCs and using
2032
+ # the `DiscoverInstances` API.
1979
2033
  # @return [String]
1980
2034
  #
1981
2035
  # @!attribute [rw] description
@@ -2001,7 +2055,7 @@ module Aws::ServiceDiscovery
2001
2055
  #
2002
2056
  # @!attribute [rw] creator_request_id
2003
2057
  # A unique string that identifies the request and that allows failed
2004
- # requests to be retried without the risk of executing an operation
2058
+ # requests to be retried without the risk of running an operation
2005
2059
  # twice.
2006
2060
  # @return [String]
2007
2061
  #
@@ -2073,14 +2127,20 @@ module Aws::ServiceDiscovery
2073
2127
  # `ListNamespaces` returns a namespace. Valid values for `condition`
2074
2128
  # include:
2075
2129
  #
2076
- # * `EQ`\: When you specify `EQ` for the condition, you can choose to
2077
- # list only public namespaces or private namespaces, but not both.
2078
- # `EQ` is the default condition and can be omitted.
2130
+ # EQ
2079
2131
  #
2080
- # * `IN`\: When you specify `IN` for the condition, you can choose to
2081
- # list public namespaces, private namespaces, or both.
2132
+ # : When you specify `EQ` for the condition, you can choose to list
2133
+ # only public namespaces or private namespaces, but not both. `EQ`
2134
+ # is the default condition and can be omitted.
2082
2135
  #
2083
- # * `BETWEEN`\: Not applicable
2136
+ # IN
2137
+ #
2138
+ # : When you specify `IN` for the condition, you can choose to list
2139
+ # public namespaces, private namespaces, or both.
2140
+ #
2141
+ # BETWEEN
2142
+ #
2143
+ # : Not applicable
2084
2144
  # @return [String]
2085
2145
  #
2086
2146
  # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/NamespaceFilter AWS API Documentation
@@ -2157,8 +2217,7 @@ module Aws::ServiceDiscovery
2157
2217
  # @return [Integer]
2158
2218
  #
2159
2219
  # @!attribute [rw] properties
2160
- # A complex type that contains information that is specific to the
2161
- # namespace type.
2220
+ # The properties of the namespace.
2162
2221
  # @return [Types::NamespaceProperties]
2163
2222
  #
2164
2223
  # @!attribute [rw] create_date
@@ -2193,15 +2252,21 @@ module Aws::ServiceDiscovery
2193
2252
  # @!attribute [rw] status
2194
2253
  # The status of the operation. Values include the following:
2195
2254
  #
2196
- # * **SUBMITTED**\: This is the initial state immediately after you
2197
- # submit a request.
2255
+ # SUBMITTED
2198
2256
  #
2199
- # * **PENDING**\: AWS Cloud Map is performing the operation.
2257
+ # : This is the initial state immediately after you submit a request.
2200
2258
  #
2201
- # * **SUCCESS**\: The operation succeeded.
2259
+ # PENDING
2202
2260
  #
2203
- # * **FAIL**\: The operation failed. For the failure reason, see
2204
- # `ErrorMessage`.
2261
+ # : AWS Cloud Map is performing the operation.
2262
+ #
2263
+ # SUCCESS
2264
+ #
2265
+ # : The operation succeeded.
2266
+ #
2267
+ # FAIL
2268
+ #
2269
+ # : The operation failed. For the failure reason, see `ErrorMessage`.
2205
2270
  # @return [String]
2206
2271
  #
2207
2272
  # @!attribute [rw] error_message
@@ -2247,14 +2312,17 @@ module Aws::ServiceDiscovery
2247
2312
  # @!attribute [rw] targets
2248
2313
  # The name of the target entity that is associated with the operation:
2249
2314
  #
2250
- # * **NAMESPACE**\: The namespace ID is returned in the `ResourceId`
2251
- # property.
2315
+ # NAMESPACE
2252
2316
  #
2253
- # * **SERVICE**\: The service ID is returned in the `ResourceId`
2254
- # property.
2317
+ # : The namespace ID is returned in the `ResourceId` property.
2255
2318
  #
2256
- # * **INSTANCE**\: The instance ID is returned in the `ResourceId`
2257
- # property.
2319
+ # SERVICE
2320
+ #
2321
+ # : The service ID is returned in the `ResourceId` property.
2322
+ #
2323
+ # INSTANCE
2324
+ #
2325
+ # : The instance ID is returned in the `ResourceId` property.
2258
2326
  # @return [Hash<String,String>]
2259
2327
  #
2260
2328
  # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/Operation AWS API Documentation
@@ -2403,7 +2471,7 @@ module Aws::ServiceDiscovery
2403
2471
  #
2404
2472
  # {
2405
2473
  # service_id: "ResourceId", # required
2406
- # instance_id: "ResourceId", # required
2474
+ # instance_id: "InstanceId", # required
2407
2475
  # creator_request_id: "ResourceId",
2408
2476
  # attributes: { # required
2409
2477
  # "AttrKey" => "AttrValue",
@@ -2470,101 +2538,102 @@ module Aws::ServiceDiscovery
2470
2538
  #
2471
2539
  # Supported attribute keys include the following:
2472
2540
  #
2473
- # **AWS\_ALIAS\_DNS\_NAME**
2541
+ # AWS\_ALIAS\_DNS\_NAME
2474
2542
  #
2475
- # If you want AWS Cloud Map to create an Amazon Route 53 alias record
2476
- # that routes traffic to an Elastic Load Balancing load balancer,
2477
- # specify the DNS name that is associated with the load balancer. For
2478
- # information about how to get the DNS name, see "DNSName" in the
2479
- # topic [AliasTarget][1] in the *Route 53 API Reference*.
2543
+ # : If you want AWS Cloud Map to create an Amazon Route 53 alias
2544
+ # record that routes traffic to an Elastic Load Balancing load
2545
+ # balancer, specify the DNS name that is associated with the load
2546
+ # balancer. For information about how to get the DNS name, see
2547
+ # "DNSName" in the topic [AliasTarget][1] in the *Route 53 API
2548
+ # Reference*.
2480
2549
  #
2481
- # Note the following:
2550
+ # Note the following:
2482
2551
  #
2483
- # * The configuration for the service that is specified by `ServiceId`
2484
- # must include settings for an `A` record, an `AAAA` record, or
2485
- # both.
2552
+ # * The configuration for the service that is specified by
2553
+ # `ServiceId` must include settings for an `A` record, an `AAAA`
2554
+ # record, or both.
2486
2555
  #
2487
- # * In the service that is specified by `ServiceId`, the value of
2488
- # `RoutingPolicy` must be `WEIGHTED`.
2556
+ # * In the service that is specified by `ServiceId`, the value of
2557
+ # `RoutingPolicy` must be `WEIGHTED`.
2489
2558
  #
2490
- # * If the service that is specified by `ServiceId` includes
2491
- # `HealthCheckConfig` settings, AWS Cloud Map will create the
2492
- # Route 53 health check, but it won't associate the health check
2493
- # with the alias record.
2559
+ # * If the service that is specified by `ServiceId` includes
2560
+ # `HealthCheckConfig` settings, AWS Cloud Map will create the
2561
+ # Route 53 health check, but it doesn't associate the health
2562
+ # check with the alias record.
2494
2563
  #
2495
- # * Auto naming currently doesn't support creating alias records that
2496
- # route traffic to AWS resources other than Elastic Load Balancing
2497
- # load balancers.
2564
+ # * Auto naming currently doesn't support creating alias records
2565
+ # that route traffic to AWS resources other than Elastic Load
2566
+ # Balancing load balancers.
2498
2567
  #
2499
- # * If you specify a value for `AWS_ALIAS_DNS_NAME`, don't specify
2500
- # values for any of the `AWS_INSTANCE` attributes.
2568
+ # * If you specify a value for `AWS_ALIAS_DNS_NAME`, don't specify
2569
+ # values for any of the `AWS_INSTANCE` attributes.
2501
2570
  #
2502
- # **AWS\_EC2\_INSTANCE\_ID**
2571
+ # AWS\_EC2\_INSTANCE\_ID
2503
2572
  #
2504
- # *HTTP namespaces only.* The Amazon EC2 instance ID for the instance.
2505
- # If the `AWS_EC2_INSTANCE_ID` attribute is specified, then the only
2506
- # other attribute that can be specified is `AWS_INIT_HEALTH_STATUS`.
2507
- # When the `AWS_EC2_INSTANCE_ID` attribute is specified, then the
2508
- # `AWS_INSTANCE_IPV4` attribute will be filled out with the primary
2509
- # private IPv4 address.
2573
+ # : *HTTP namespaces only.* The Amazon EC2 instance ID for the
2574
+ # instance. If the `AWS_EC2_INSTANCE_ID` attribute is specified,
2575
+ # then the only other attribute that can be specified is
2576
+ # `AWS_INIT_HEALTH_STATUS`. When the `AWS_EC2_INSTANCE_ID` attribute
2577
+ # is specified, then the `AWS_INSTANCE_IPV4` attribute will be
2578
+ # filled out with the primary private IPv4 address.
2510
2579
  #
2511
- # **AWS\_INIT\_HEALTH\_STATUS**
2580
+ # AWS\_INIT\_HEALTH\_STATUS
2512
2581
  #
2513
- # If the service configuration includes `HealthCheckCustomConfig`, you
2514
- # can optionally use `AWS_INIT_HEALTH_STATUS` to specify the initial
2515
- # status of the custom health check, `HEALTHY` or `UNHEALTHY`. If you
2516
- # don't specify a value for `AWS_INIT_HEALTH_STATUS`, the initial
2517
- # status is `HEALTHY`.
2582
+ # : If the service configuration includes `HealthCheckCustomConfig`,
2583
+ # you can optionally use `AWS_INIT_HEALTH_STATUS` to specify the
2584
+ # initial status of the custom health check, `HEALTHY` or
2585
+ # `UNHEALTHY`. If you don't specify a value for
2586
+ # `AWS_INIT_HEALTH_STATUS`, the initial status is `HEALTHY`.
2518
2587
  #
2519
- # **AWS\_INSTANCE\_CNAME**
2588
+ # AWS\_INSTANCE\_CNAME
2520
2589
  #
2521
- # If the service configuration includes a `CNAME` record, the domain
2522
- # name that you want Route 53 to return in response to DNS queries,
2523
- # for example, `example.com`.
2590
+ # : If the service configuration includes a `CNAME` record, the domain
2591
+ # name that you want Route 53 to return in response to DNS queries,
2592
+ # for example, `example.com`.
2524
2593
  #
2525
- # This value is required if the service specified by `ServiceId`
2526
- # includes settings for an `CNAME` record.
2594
+ # This value is required if the service specified by `ServiceId`
2595
+ # includes settings for an `CNAME` record.
2527
2596
  #
2528
- # **AWS\_INSTANCE\_IPV4**
2597
+ # AWS\_INSTANCE\_IPV4
2529
2598
  #
2530
- # If the service configuration includes an `A` record, the IPv4
2531
- # address that you want Route 53 to return in response to DNS queries,
2532
- # for example, `192.0.2.44`.
2599
+ # : If the service configuration includes an `A` record, the IPv4
2600
+ # address that you want Route 53 to return in response to DNS
2601
+ # queries, for example, `192.0.2.44`.
2533
2602
  #
2534
- # This value is required if the service specified by `ServiceId`
2535
- # includes settings for an `A` record. If the service includes
2536
- # settings for an `SRV` record, you must specify a value for
2537
- # `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
2603
+ # This value is required if the service specified by `ServiceId`
2604
+ # includes settings for an `A` record. If the service includes
2605
+ # settings for an `SRV` record, you must specify a value for
2606
+ # `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
2538
2607
  #
2539
- # **AWS\_INSTANCE\_IPV6**
2608
+ # AWS\_INSTANCE\_IPV6
2540
2609
  #
2541
- # If the service configuration includes an `AAAA` record, the IPv6
2542
- # address that you want Route 53 to return in response to DNS queries,
2543
- # for example, `2001:0db8:85a3:0000:0000:abcd:0001:2345`.
2610
+ # : If the service configuration includes an `AAAA` record, the IPv6
2611
+ # address that you want Route 53 to return in response to DNS
2612
+ # queries, for example, `2001:0db8:85a3:0000:0000:abcd:0001:2345`.
2544
2613
  #
2545
- # This value is required if the service specified by `ServiceId`
2546
- # includes settings for an `AAAA` record. If the service includes
2547
- # settings for an `SRV` record, you must specify a value for
2548
- # `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
2614
+ # This value is required if the service specified by `ServiceId`
2615
+ # includes settings for an `AAAA` record. If the service includes
2616
+ # settings for an `SRV` record, you must specify a value for
2617
+ # `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
2549
2618
  #
2550
- # **AWS\_INSTANCE\_PORT**
2619
+ # AWS\_INSTANCE\_PORT
2551
2620
  #
2552
- # If the service includes an `SRV` record, the value that you want
2553
- # Route 53 to return for the port.
2621
+ # : If the service includes an `SRV` record, the value that you want
2622
+ # Route 53 to return for the port.
2554
2623
  #
2555
- # If the service includes `HealthCheckConfig`, the port on the
2556
- # endpoint that you want Route 53 to send requests to.
2624
+ # If the service includes `HealthCheckConfig`, the port on the
2625
+ # endpoint that you want Route 53 to send requests to.
2557
2626
  #
2558
- # This value is required if you specified settings for an `SRV` record
2559
- # or a Route 53 health check when you created the service.
2627
+ # This value is required if you specified settings for an `SRV`
2628
+ # record or a Route 53 health check when you created the service.
2560
2629
  #
2561
- # **Custom attributes**
2630
+ # Custom attributes
2562
2631
  #
2563
- # You can add up to 30 custom attributes. For each key-value pair, the
2564
- # maximum length of the attribute name is 255 characters, and the
2565
- # maximum length of the attribute value is 1,024 characters. The total
2566
- # size of all provided attributes (sum of all keys and values) must
2567
- # not exceed 5,000 characters.
2632
+ # : You can add up to 30 custom attributes. For each key-value pair,
2633
+ # the maximum length of the attribute name is 255 characters, and
2634
+ # the maximum length of the attribute value is 1,024 characters. The
2635
+ # total size of all provided attributes (sum of all keys and values)
2636
+ # must not exceed 5,000 characters.
2568
2637
  #
2569
2638
  #
2570
2639
  #
@@ -2749,9 +2818,9 @@ module Aws::ServiceDiscovery
2749
2818
  #
2750
2819
  # @!attribute [rw] creator_request_id
2751
2820
  # A unique string that identifies the request and that allows failed
2752
- # requests to be retried without the risk of executing the operation
2821
+ # requests to be retried without the risk of running the operation
2753
2822
  # twice. `CreatorRequestId` can be any unique string, for example, a
2754
- # date/time stamp.
2823
+ # date/timestamp.
2755
2824
  # @return [String]
2756
2825
  #
2757
2826
  # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/Service AWS API Documentation
@@ -2824,81 +2893,15 @@ module Aws::ServiceDiscovery
2824
2893
  # @return [String]
2825
2894
  #
2826
2895
  # @!attribute [rw] dns_config
2827
- # A complex type that contains information about the Route 53 DNS
2828
- # records that you want AWS Cloud Map to create when you register an
2829
- # instance.
2896
+ # Information about the Route 53 DNS records that you want AWS Cloud
2897
+ # Map to create when you register an instance.
2830
2898
  # @return [Types::DnsConfigChange]
2831
2899
  #
2832
2900
  # @!attribute [rw] health_check_config
2833
- # *Public DNS and HTTP namespaces only.* A complex type that contains
2834
- # settings for an optional health check. If you specify settings for a
2835
- # health check, AWS Cloud Map associates the health check with the
2836
- # records that you specify in `DnsConfig`.
2837
- #
2838
- # If you specify a health check configuration, you can specify either
2839
- # `HealthCheckCustomConfig` or `HealthCheckConfig` but not both.
2840
- #
2841
- # Health checks are basic Route 53 health checks that monitor an AWS
2842
- # endpoint. For information about pricing for health checks, see
2843
- # [Amazon Route 53 Pricing][1].
2844
- #
2845
- # Note the following about configuring health checks.
2846
- #
2847
- # <b> <code>A</code> and <code>AAAA</code> records</b>
2848
- #
2849
- # If `DnsConfig` includes configurations for both `A` and `AAAA`
2850
- # records, AWS Cloud Map creates a health check that uses the IPv4
2851
- # address to check the health of the resource. If the endpoint that is
2852
- # specified by the IPv4 address is unhealthy, Route 53 considers both
2853
- # the `A` and `AAAA` records to be unhealthy.
2854
- #
2855
- # <b> <code>CNAME</code> records</b>
2856
- #
2857
- # You can't specify settings for `HealthCheckConfig` when the
2858
- # `DNSConfig` includes `CNAME` for the value of `Type`. If you do, the
2859
- # `CreateService` request will fail with an `InvalidInput` error.
2860
- #
2861
- # **Request interval**
2862
- #
2863
- # A Route 53 health checker in each health-checking region sends a
2864
- # health check request to an endpoint every 30 seconds. On average,
2865
- # your endpoint receives a health check request about every two
2866
- # seconds. However, health checkers don't coordinate with one
2867
- # another, so you'll sometimes see several requests per second
2868
- # followed by a few seconds with no health checks at all.
2869
- #
2870
- # **Health checking regions**
2871
- #
2872
- # Health checkers perform checks from all Route 53 health-checking
2873
- # regions. For a list of the current regions, see [Regions][2].
2874
- #
2875
- # **Alias records**
2876
- #
2877
- # When you register an instance, if you include the
2878
- # `AWS_ALIAS_DNS_NAME` attribute, AWS Cloud Map creates a Route 53
2879
- # alias record. Note the following:
2880
- #
2881
- # * Route 53 automatically sets `EvaluateTargetHealth` to true for
2882
- # alias records. When `EvaluateTargetHealth` is true, the alias
2883
- # record inherits the health of the referenced AWS resource. such as
2884
- # an ELB load balancer. For more information, see
2885
- # [EvaluateTargetHealth][3].
2886
- #
2887
- # * If you include `HealthCheckConfig` and then use the service to
2888
- # register an instance that creates an alias record, Route 53
2889
- # doesn't create the health check.
2890
- #
2891
- # **Charges for health checks**
2892
- #
2893
- # Health checks are basic Route 53 health checks that monitor an AWS
2894
- # endpoint. For information about pricing for health checks, see
2895
- # [Amazon Route 53 Pricing][1].
2896
- #
2897
- #
2898
- #
2899
- # [1]: http://aws.amazon.com/route53/pricing/
2900
- # [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_HealthCheckConfig.html#Route53-Type-HealthCheckConfig-Regions
2901
- # [3]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth
2901
+ # *Public DNS and HTTP namespaces only.* Settings for an optional
2902
+ # health check. If you specify settings for a health check, AWS Cloud
2903
+ # Map associates the health check with the records that you specify in
2904
+ # `DnsConfig`.
2902
2905
  # @return [Types::HealthCheckConfig]
2903
2906
  #
2904
2907
  # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/ServiceChange AWS API Documentation
@@ -3017,88 +3020,22 @@ module Aws::ServiceDiscovery
3017
3020
  # @return [Integer]
3018
3021
  #
3019
3022
  # @!attribute [rw] dns_config
3020
- # A complex type that contains information about the Amazon Route 53
3021
- # DNS records that you want AWS Cloud Map to create when you register
3022
- # an instance.
3023
+ # Information about the Route 53 DNS records that you want AWS Cloud
3024
+ # Map to create when you register an instance.
3023
3025
  # @return [Types::DnsConfig]
3024
3026
  #
3025
3027
  # @!attribute [rw] health_check_config
3026
- # *Public DNS and HTTP namespaces only.* A complex type that contains
3027
- # settings for an optional health check. If you specify settings for a
3028
- # health check, AWS Cloud Map associates the health check with the
3029
- # records that you specify in `DnsConfig`.
3030
- #
3031
- # If you specify a health check configuration, you can specify either
3032
- # `HealthCheckCustomConfig` or `HealthCheckConfig` but not both.
3033
- #
3034
- # Health checks are basic Route 53 health checks that monitor an AWS
3035
- # endpoint. For information about pricing for health checks, see
3036
- # [Amazon Route 53 Pricing][1].
3037
- #
3038
- # Note the following about configuring health checks.
3039
- #
3040
- # <b> <code>A</code> and <code>AAAA</code> records</b>
3041
- #
3042
- # If `DnsConfig` includes configurations for both `A` and `AAAA`
3043
- # records, AWS Cloud Map creates a health check that uses the IPv4
3044
- # address to check the health of the resource. If the endpoint that is
3045
- # specified by the IPv4 address is unhealthy, Route 53 considers both
3046
- # the `A` and `AAAA` records to be unhealthy.
3047
- #
3048
- # <b> <code>CNAME</code> records</b>
3049
- #
3050
- # You can't specify settings for `HealthCheckConfig` when the
3051
- # `DNSConfig` includes `CNAME` for the value of `Type`. If you do, the
3052
- # `CreateService` request will fail with an `InvalidInput` error.
3053
- #
3054
- # **Request interval**
3055
- #
3056
- # A Route 53 health checker in each health-checking region sends a
3057
- # health check request to an endpoint every 30 seconds. On average,
3058
- # your endpoint receives a health check request about every two
3059
- # seconds. However, health checkers don't coordinate with one
3060
- # another, so you'll sometimes see several requests per second
3061
- # followed by a few seconds with no health checks at all.
3062
- #
3063
- # **Health checking regions**
3064
- #
3065
- # Health checkers perform checks from all Route 53 health-checking
3066
- # regions. For a list of the current regions, see [Regions][2].
3067
- #
3068
- # **Alias records**
3069
- #
3070
- # When you register an instance, if you include the
3071
- # `AWS_ALIAS_DNS_NAME` attribute, AWS Cloud Map creates a Route 53
3072
- # alias record. Note the following:
3073
- #
3074
- # * Route 53 automatically sets `EvaluateTargetHealth` to true for
3075
- # alias records. When `EvaluateTargetHealth` is true, the alias
3076
- # record inherits the health of the referenced AWS resource. such as
3077
- # an ELB load balancer. For more information, see
3078
- # [EvaluateTargetHealth][3].
3079
- #
3080
- # * If you include `HealthCheckConfig` and then use the service to
3081
- # register an instance that creates an alias record, Route 53
3082
- # doesn't create the health check.
3083
- #
3084
- # **Charges for health checks**
3085
- #
3086
- # Health checks are basic Route 53 health checks that monitor an AWS
3087
- # endpoint. For information about pricing for health checks, see
3088
- # [Amazon Route 53 Pricing][1].
3089
- #
3090
- #
3091
- #
3092
- # [1]: http://aws.amazon.com/route53/pricing/
3093
- # [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_HealthCheckConfig.html#Route53-Type-HealthCheckConfig-Regions
3094
- # [3]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth
3028
+ # *Public DNS and HTTP namespaces only.* Settings for an optional
3029
+ # health check. If you specify settings for a health check, AWS Cloud
3030
+ # Map associates the health check with the records that you specify in
3031
+ # `DnsConfig`.
3095
3032
  # @return [Types::HealthCheckConfig]
3096
3033
  #
3097
3034
  # @!attribute [rw] health_check_custom_config
3098
- # A complex type that contains information about an optional custom
3099
- # health check. A custom health check, which requires that you use a
3100
- # third-party health checker to evaluate the health of your resources,
3101
- # is useful in the following circumstances:
3035
+ # Information about an optional custom health check. A custom health
3036
+ # check, which requires that you use a third-party health checker to
3037
+ # evaluate the health of your resources, is useful in the following
3038
+ # circumstances:
3102
3039
  #
3103
3040
  # * You can't use a health check that is defined by
3104
3041
  # `HealthCheckConfig` because the resource isn't available over the
@@ -3111,48 +3048,6 @@ module Aws::ServiceDiscovery
3111
3048
  #
3112
3049
  # If you specify a health check configuration, you can specify either
3113
3050
  # `HealthCheckCustomConfig` or `HealthCheckConfig` but not both.
3114
- #
3115
- # To change the status of a custom health check, submit an
3116
- # `UpdateInstanceCustomHealthStatus` request. AWS Cloud Map doesn't
3117
- # monitor the status of the resource, it just keeps a record of the
3118
- # status specified in the most recent
3119
- # `UpdateInstanceCustomHealthStatus` request.
3120
- #
3121
- # Here's how custom health checks work:
3122
- #
3123
- # 1. You create a service and specify a value for `FailureThreshold`.
3124
- #
3125
- # The failure threshold indicates the number of 30-second
3126
- # intervals you want AWS Cloud Map to wait between the time that
3127
- # your application sends an [UpdateInstanceCustomHealthStatus][1]
3128
- # request and the time that AWS Cloud Map stops routing internet
3129
- # traffic to the corresponding resource.
3130
- #
3131
- # 2. You register an instance.
3132
- #
3133
- # 3. You configure a third-party health checker to monitor the
3134
- # resource that is associated with the new instance.
3135
- #
3136
- # <note markdown="1"> AWS Cloud Map doesn't check the health of the resource
3137
- # directly.
3138
- #
3139
- # </note>
3140
- #
3141
- # 4. The third-party health-checker determines that the resource is
3142
- # unhealthy and notifies your application.
3143
- #
3144
- # 5. Your application submits an `UpdateInstanceCustomHealthStatus`
3145
- # request.
3146
- #
3147
- # 6. AWS Cloud Map waits for (`FailureThreshold` x 30) seconds.
3148
- #
3149
- # 7. If another `UpdateInstanceCustomHealthStatus` request doesn't
3150
- # arrive during that time to change the status back to healthy,
3151
- # AWS Cloud Map stops routing traffic to the resource.
3152
- #
3153
- #
3154
- #
3155
- # [1]: https://docs.aws.amazon.com/cloud-map/latest/api/API_UpdateInstanceCustomHealthStatus.html
3156
3051
  # @return [Types::HealthCheckCustomConfig]
3157
3052
  #
3158
3053
  # @!attribute [rw] create_date