aws-sdk-servicediscovery 1.0.0 → 1.1.0

data/lib/aws-sdk-servicediscovery/client_api.rb

@@ -103,6 +103,7 @@ module Aws::ServiceDiscovery
     ResourceInUse = Shapes::StructureShape.new(name: 'ResourceInUse')
     ResourceLimitExceeded = Shapes::StructureShape.new(name: 'ResourceLimitExceeded')
     ResourcePath = Shapes::StringShape.new(name: 'ResourcePath')
+    RoutingPolicy = Shapes::StringShape.new(name: 'RoutingPolicy')
     Service = Shapes::StructureShape.new(name: 'Service')
     ServiceAlreadyExists = Shapes::StructureShape.new(name: 'ServiceAlreadyExists')
     ServiceChange = Shapes::StructureShape.new(name: 'ServiceChange')
@@ -166,6 +167,7 @@ module Aws::ServiceDiscovery
     DeregisterInstanceResponse.struct_class = Types::DeregisterInstanceResponse
 
     DnsConfig.add_member(:namespace_id, Shapes::ShapeRef.new(shape: ResourceId, required: true, location_name: "NamespaceId"))
+    DnsConfig.add_member(:routing_policy, Shapes::ShapeRef.new(shape: RoutingPolicy, location_name: "RoutingPolicy"))
     DnsConfig.add_member(:dns_records, Shapes::ShapeRef.new(shape: DnsRecordList, required: true, location_name: "DnsRecords"))
     DnsConfig.struct_class = Types::DnsConfig
 
@@ -218,7 +220,7 @@ module Aws::ServiceDiscovery
     GetServiceResponse.add_member(:service, Shapes::ShapeRef.new(shape: Service, location_name: "Service"))
     GetServiceResponse.struct_class = Types::GetServiceResponse
 
-    HealthCheckConfig.add_member(:type, Shapes::ShapeRef.new(shape: HealthCheckType, location_name: "Type"))
+    HealthCheckConfig.add_member(:type, Shapes::ShapeRef.new(shape: HealthCheckType, required: true, location_name: "Type"))
     HealthCheckConfig.add_member(:resource_path, Shapes::ShapeRef.new(shape: ResourcePath, location_name: "ResourcePath"))
     HealthCheckConfig.add_member(:failure_threshold, Shapes::ShapeRef.new(shape: FailureThreshold, location_name: "FailureThreshold"))
     HealthCheckConfig.struct_class = Types::HealthCheckConfig
@@ -574,6 +576,7 @@ module Aws::ServiceDiscovery
         o.http_request_uri = "/"
         o.input = Shapes::ShapeRef.new(shape: ListServicesRequest)
         o.output = Shapes::ShapeRef.new(shape: ListServicesResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidInput)
         o[:pager] = Aws::Pager.new(
           limit_key: "max_results",
           tokens: {

data/lib/aws-sdk-servicediscovery/types.rb

@@ -25,9 +25,10 @@ module Aws::ServiceDiscovery
     #   @return [String]
     #
     # @!attribute [rw] creator_request_id
-    #   An optional parameter that you can use to resolve concurrent
-    #   creation requests. `CreatorRequestId` helps to determine if a
-    #   specific client owns the namespace.
+    #   A unique string that identifies the request and that allows failed
+    #   `CreatePrivateDnsNamespace` requests to be retried without the risk
+    #   of executing the operation twice. `CreatorRequestId` can be any
+    #   unique string, for example, a date/time stamp.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.
@@ -78,9 +79,10 @@ module Aws::ServiceDiscovery
     #   @return [String]
     #
     # @!attribute [rw] creator_request_id
-    #   An optional parameter that you can use to resolve concurrent
-    #   creation requests. `CreatorRequestId` helps to determine if a
-    #   specific client owns the namespace.
+    #   A unique string that identifies the request and that allows failed
+    #   `CreatePublicDnsNamespace` requests to be retried without the risk
+    #   of executing the operation twice. `CreatorRequestId` can be any
+    #   unique string, for example, a date/time stamp.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.
@@ -120,15 +122,16 @@ module Aws::ServiceDiscovery
     #         description: "ResourceDescription",
     #         dns_config: { # required
     #           namespace_id: "ResourceId", # required
+    #           routing_policy: "MULTIVALUE", # accepts MULTIVALUE, WEIGHTED
     #           dns_records: [ # required
     #             {
-    #               type: "SRV", # required, accepts SRV, A, AAAA
+    #               type: "SRV", # required, accepts SRV, A, AAAA, CNAME
     #               ttl: 1, # required
     #             },
     #           ],
     #         },
     #         health_check_config: {
-    #           type: "HTTP", # accepts HTTP, HTTPS, TCP
+    #           type: "HTTP", # required, accepts HTTP, HTTPS, TCP
     #           resource_path: "ResourcePath",
     #           failure_threshold: 1,
     #         },
@@ -139,9 +142,10 @@ module Aws::ServiceDiscovery
     #   @return [String]
     #
     # @!attribute [rw] creator_request_id
-    #   An optional parameter that you can use to resolve concurrent
-    #   creation requests. `CreatorRequestId` helps to determine if a
-    #   specific client owns the namespace.
+    #   A unique string that identifies the request and that allows failed
+    #   `CreateService` requests to be retried without the risk of executing
+    #   the operation twice. `CreatorRequestId` can be any unique string,
+    #   for example, a date/time stamp.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.
@@ -152,32 +156,18 @@ module Aws::ServiceDiscovery
     #   @return [String]
     #
     # @!attribute [rw] dns_config
-    #   A complex type that contains information about the resource record
-    #   sets that you want Amazon Route 53 to create when you register an
-    #   instance.
+    #   A complex type that contains information about the records that you
+    #   want Route 53 to create when you register an instance.
     #   @return [Types::DnsConfig]
     #
     # @!attribute [rw] health_check_config
     #   *Public DNS namespaces only.* A complex type that contains settings
     #   for an optional health check. If you specify settings for a health
-    #   check, Amazon Route 53 associates the health check with all the
-    #   resource record sets that you specify in `DnsConfig`.
-    #
-    #   <note markdown="1"> The health check uses 30 seconds as the request interval. This is
-    #   the number of seconds between the time that each Amazon Route 53
-    #   health checker gets a response from your endpoint and the time that
-    #   it sends the next health check request. A health checker in each
-    #   data center around the world sends your endpoint a health check
-    #   request every 30 seconds. On average, your endpoint receives a
-    #   health check request about every two seconds. Health checkers in
-    #   different data centers don't coordinate with one another, so
-    #   you'll sometimes see several requests per second followed by a few
-    #   seconds with no health checks at all.
-    #
-    #    </note>
+    #   check, Route 53 associates the health check with all the records
+    #   that you specify in `DnsConfig`.
     #
-    #   For information about the charges for health checks, see [Amazon
-    #   Route 53 Pricing][1].
+    #   For information about the charges for health checks, see [Route 53
+    #   Pricing][1].
     #
     #
     #
@@ -295,18 +285,18 @@ module Aws::ServiceDiscovery
       include Aws::Structure
     end
 
-    # A complex type that contains information about the resource record
-    # sets that you want Amazon Route 53 to create when you register an
-    # instance.
+    # A complex type that contains information about the records that you
+    # want Amazon Route 53 to create when you register an instance.
     #
     # @note When making an API call, you may pass DnsConfig
     #   data as a hash:
     #
     #       {
     #         namespace_id: "ResourceId", # required
+    #         routing_policy: "MULTIVALUE", # accepts MULTIVALUE, WEIGHTED
     #         dns_records: [ # required
     #           {
-    #             type: "SRV", # required, accepts SRV, A, AAAA
+    #             type: "SRV", # required, accepts SRV, A, AAAA, CNAME
     #             ttl: 1, # required
     #           },
     #         ],
@@ -316,23 +306,80 @@ module Aws::ServiceDiscovery
     #   The ID of the namespace to use for DNS configuration.
     #   @return [String]
     #
+    # @!attribute [rw] routing_policy
+    #   The routing policy that you want to apply to all records that Route
+    #   53 creates when you register an instance and specify this service.
+    #
+    #   <note markdown="1"> If you want to use this service to register instances that create
+    #   alias records, specify `WEIGHTED` for the routing policy.
+    #
+    #    </note>
+    #
+    #   You can specify the following values:
+    #
+    #   **MULTIVALUE**
+    #
+    #   If you define a health check for the service and the health check is
+    #   healthy, Route 53 returns the applicable value for up to eight
+    #   instances.
+    #
+    #   For example, suppose the service includes configurations for one A
+    #   record and a health check, and you use the service to register 10
+    #   instances. Route 53 responds to DNS queries with IP addresses for up
+    #   to eight healthy instances. If fewer than eight instances are
+    #   healthy, Route 53 responds to every DNS query with the IP addresses
+    #   for all of the healthy instances.
+    #
+    #   If you don't define a health check for the service, Route 53
+    #   assumes that all instances are healthy and returns the values for up
+    #   to eight instances.
+    #
+    #   For more information about the multivalue routing policy, see
+    #   [Multivalue Answer Routing][1] in the *Route 53 Developer Guide*.
+    #
+    #   **WEIGHTED**
+    #
+    #   Route 53 returns the applicable value from one randomly selected
+    #   instance from among the instances that you registered using the same
+    #   service. Currently, all records have the same weight, so you can't
+    #   route more or less traffic to any instances.
+    #
+    #   For example, suppose the service includes configurations for one A
+    #   record and a health check, and you use the service to register 10
+    #   instances. Route 53 responds to DNS queries with the IP address for
+    #   one randomly selected instance from among the healthy instances. If
+    #   no instances are healthy, Route 53 responds to DNS queries as if all
+    #   of the instances were healthy.
+    #
+    #   If you don't define a health check for the service, Route 53
+    #   assumes that all instances are healthy and returns the applicable
+    #   value for one randomly selected instance.
+    #
+    #   For more information about the weighted routing policy, see
+    #   [Weighted Routing][2] in the *Route 53 Developer Guide*.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-multivalue
+    #   [2]: http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-weighted
+    #   @return [String]
+    #
     # @!attribute [rw] dns_records
-    #   An array that contains one `DnsRecord` object for each resource
-    #   record set that you want Amazon Route 53 to create when you register
-    #   an instance.
+    #   An array that contains one `DnsRecord` object for each record that
+    #   you want Route 53 to create when you register an instance.
     #   @return [Array<Types::DnsRecord>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/DnsConfig AWS API Documentation
     #
     class DnsConfig < Struct.new(
       :namespace_id,
+      :routing_policy,
       :dns_records)
       include Aws::Structure
     end
 
-    # A complex type that contains information about changes to the resource
-    # record sets that Amazon Route 53 creates when you register an
-    # instance.
+    # A complex type that contains information about changes to the records
+    # that Route 53 creates when you register an instance.
     #
     # @note When making an API call, you may pass DnsConfigChange
     #   data as a hash:
@@ -340,16 +387,15 @@ module Aws::ServiceDiscovery
     #       {
     #         dns_records: [ # required
     #           {
-    #             type: "SRV", # required, accepts SRV, A, AAAA
+    #             type: "SRV", # required, accepts SRV, A, AAAA, CNAME
     #             ttl: 1, # required
     #           },
     #         ],
     #       }
     #
     # @!attribute [rw] dns_records
-    #   An array that contains one `DnsRecord` object for each resource
-    #   record set that you want Amazon Route 53 to create when you register
-    #   an instance.
+    #   An array that contains one `DnsRecord` object for each record that
+    #   you want Route 53 to create when you register an instance.
     #   @return [Array<Types::DnsRecord>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/DnsConfigChange AWS API Documentation
@@ -359,12 +405,12 @@ module Aws::ServiceDiscovery
       include Aws::Structure
     end
 
-    # A complex type that contains the ID for the hosted zone that Amazon
-    # Route 53 creates when you create a namespace.
+    # A complex type that contains the ID for the hosted zone that Route 53
+    # creates when you create a namespace.
     #
     # @!attribute [rw] hosted_zone_id
-    #   The ID for the hosted zone that Amazon Route 53 creates when you
-    #   create a namespace.
+    #   The ID for the hosted zone that Route 53 creates when you create a
+    #   namespace.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/DnsProperties AWS API Documentation
@@ -374,43 +420,116 @@ module Aws::ServiceDiscovery
       include Aws::Structure
     end
 
-    # A complex type that contains information about the resource record
-    # sets that you want Amazon Route 53 to create when you register an
-    # instance.
+    # A complex type that contains information about the records that you
+    # want Route 53 to create when you register an instance.
     #
     # @note When making an API call, you may pass DnsRecord
     #   data as a hash:
     #
     #       {
-    #         type: "SRV", # required, accepts SRV, A, AAAA
+    #         type: "SRV", # required, accepts SRV, A, AAAA, CNAME
     #         ttl: 1, # required
     #       }
     #
     # @!attribute [rw] type
-    #   The type of the resource, which indicates the value that Amazon
-    #   Route 53 returns in response to DNS queries. The following values
-    #   are supported:
+    #   The type of the resource, which indicates the type of value that
+    #   Route 53 returns in response to DNS queries.
     #
-    #   * **A**\: Amazon Route 53 returns the IP address of the resource in
-    #     IPv4 format, such as 192.0.2.44.
+    #   Note the following:
     #
-    #   * **AAAA**\: Amazon Route 53 returns the IP address of the resource
-    #     in IPv6 format, such as 2001:0db8:85a3:0000:0000:abcd:0001:2345.
+    #   * **A, AAAA, and SRV records: You can specify settings for a maximum
+    #     of one A, one AAAA, and one SRV record. You can specify them in
+    #     any combination.**
     #
-    #   * **SRV**\: Amazon Route 53 returns the value for an SRV record. The
-    #     value for an SRV record uses the following template, which can't
-    #     be changed:
+    #   * **CNAME records:** If you specify `CNAME` for `Type`, you can't
+    #     define any other records. This is a limitation of DNS—you can't
+    #     create a CNAME record and any other type of record that has the
+    #     same name as a CNAME record.
     #
-    #     `priority weight port resource-record-set-name`
+    #   * **Alias records:** If you want Route 53 to create an alias record
+    #     when you register an instance, specify `A` or `AAAA` for `Type`.
     #
-    #     The values of `priority` and `weight` are both set to 1. The value
-    #     of port comes from the value that you specify for `Port` when you
-    #     submit a RegisterInstance request.
+    #   * **All records:** You specify settings other than `TTL` and `Type`
+    #     when you register an instance.
+    #
+    #   The following values are supported:
+    #
+    #   **A**
+    #
+    #   Route 53 returns the IP address of the resource in IPv4 format, such
+    #   as 192.0.2.44.
+    #
+    #   **AAAA**
+    #
+    #   Route 53 returns the IP address of the resource in IPv6 format, such
+    #   as 2001:0db8:85a3:0000:0000:abcd:0001:2345.
+    #
+    #   **CNAME**
+    #
+    #   Route 53 returns the domain name of the resource, such as
+    #   www.example.com. Note the following:
+    #
+    #   * You specify the domain name that you want to route traffic to when
+    #     you register an instance. For more information, see
+    #     RegisterInstanceRequest$Attributes.
+    #
+    #   * You must specify `WEIGHTED` for the value of `RoutingPolicy`.
+    #
+    #   * You can't specify both `CNAME` for `Type` and settings for
+    #     `HealthCheckConfig`. If you do, the request will fail with an
+    #     `InvalidInput` error.
+    #
+    #   **SRV**
+    #
+    #   Route 53 returns the value for an SRV record. The value for an SRV
+    #   record uses the following values:
+    #
+    #   `priority weight port service-hostname`
+    #
+    #   Note the following about the values:
+    #
+    #   * The values of `priority` and `weight` are both set to `1` and
+    #     can't be changed.
+    #
+    #   * The value of `port` comes from the value that you specify for the
+    #     `AWS_INSTANCE_PORT` attribute when you submit a RegisterInstance
+    #     request.
+    #
+    #   * The value of `service-hostname` is a concatenation of the
+    #     following values:
+    #
+    #     * The value that you specify for `InstanceId` when you register an
+    #       instance.
+    #
+    #     * The name of the service.
+    #
+    #     * The name of the namespace.
+    #
+    #     For example, if the value of `InstanceId` is `test`, the name of
+    #     the service is `backend`, and the name of the namespace is
+    #     `example.com`, the value of `service-hostname` is:
+    #
+    #     `test.backend.example.com`
+    #
+    #   If you specify settings for an SRV record and if you specify values
+    #   for `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both in the
+    #   `RegisterInstance` request, Route 53 automatically creates `A`
+    #   and/or `AAAA` records that have the same name as the value of
+    #   `service-hostname` in the SRV record. You can ignore these records.
     #   @return [String]
     #
     # @!attribute [rw] ttl
     #   The amount of time, in seconds, that you want DNS resolvers to cache
-    #   the settings for this resource record set.
+    #   the settings for this record.
+    #
+    #   <note markdown="1"> Alias records don't include a TTL because Route 53 uses the TTL for
+    #   the AWS resource that an alias record routes traffic to. If you
+    #   include the `AWS_ALIAS_DNS_NAME` attribute when you submit a
+    #   RegisterInstance request, the `TTL` value is ignored. Always specify
+    #   a TTL for the service; you can use a service to register instances
+    #   that create either alias or non-alias records.
+    #
+    #    </note>
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/DnsRecord AWS API Documentation
@@ -472,20 +591,23 @@ module Aws::ServiceDiscovery
     #
     # @!attribute [rw] instances
     #   An array that contains the IDs of all the instances that you want to
-    #   get the health status for. To get the IDs for the instances that
-    #   you've created by using a specified service, submit a ListInstances
-    #   request.
+    #   get the health status for.
     #
     #   If you omit `Instances`, Amazon Route 53 returns the health status
     #   for all the instances that are associated with the specified
     #   service.
+    #
+    #   <note markdown="1"> To get the IDs for the instances that you've registered by using a
+    #   specified service, submit a ListInstances request.
+    #
+    #    </note>
     #   @return [Array<String>]
     #
     # @!attribute [rw] max_results
-    #   The maximum number of instances that you want Amazon Route 53 to
-    #   return in the response to a `GetInstancesHealthStatus` request. If
-    #   you don't specify a value for `MaxResults`, Amazon Route 53 returns
-    #   up to 100 instances.
+    #   The maximum number of instances that you want Route 53 to return in
+    #   the response to a `GetInstancesHealthStatus` request. If you don't
+    #   specify a value for `MaxResults`, Route 53 returns up to 100
+    #   instances.
     #   @return [Integer]
     #
     # @!attribute [rw] next_token
@@ -619,61 +741,95 @@ module Aws::ServiceDiscovery
     # *Public DNS namespaces only.* A complex type that contains settings
     # for an optional health check. If you specify settings for a health
     # check, Amazon Route 53 associates the health check with all the
-    # resource record sets that you specify in `DnsConfig`.
+    # records that you specify in `DnsConfig`.
+    #
+    # **A and AAAA records**
+    #
+    # If `DnsConfig` includes configurations for both A and AAAA records,
+    # Route 53 creates a health check that uses the IPv4 address to check
+    # the health of the resource. If the endpoint that is specified by the
+    # IPv4 address is unhealthy, Route 53 considers both the A and AAAA
+    # records to be unhealthy.
+    #
+    # **CNAME records**
+    #
+    # You can't specify settings for `HealthCheckConfig` when the
+    # `DNSConfig` includes `CNAME` for the value of `Type`. If you do, the
+    # `CreateService` request will fail with an `InvalidInput` error.
     #
-    # <note markdown="1"> The health check uses 30 seconds as the request interval. This is the
-    # number of seconds between the time that each Amazon Route 53 health
-    # checker gets a response from your endpoint and the time that it sends
-    # the next health check request. A health checker in each data center
-    # around the world sends your endpoint a health check request every 30
-    # seconds. On average, your endpoint receives a health check request
-    # about every two seconds. Health checkers in different data centers
-    # don't coordinate with one another, so you'll sometimes see several
-    # requests per second followed by a few seconds with no health checks at
-    # all.
+    # **Request interval**
     #
-    #  </note>
+    # The health check uses 30 seconds as the request interval. This is the
+    # number of seconds between the time that each Route 53 health checker
+    # gets a response from your endpoint and the time that it sends the next
+    # health check request. A health checker in each data center around the
+    # world sends your endpoint a health check request every 30 seconds. On
+    # average, your endpoint receives a health check request about every two
+    # seconds. Health checkers in different data centers don't coordinate
+    # with one another, so you'll sometimes see several requests per second
+    # followed by a few seconds with no health checks at all.
     #
-    # For information about the charges for health checks, see [Amazon Route
-    # 53 Pricing][1].
+    # **Health checking regions**
     #
+    # Health checkers perform checks from all Route 53 health-checking
+    # regions. For a list of the current regions, see [Regions][1].
     #
+    # **Alias records**
     #
-    # [1]: http://aws.amazon.com/route53/pricing
+    # When you register an instance, if you include the `AWS_ALIAS_DNS_NAME`
+    # attribute, Route 53 creates an alias record. Note the following:
+    #
+    # * Route 53 automatically sets `EvaluateTargetHealth` to true for alias
+    #   records. When `EvaluateTargetHealth` is true, the alias record
+    #   inherits the health of the referenced AWS resource. such as an ELB
+    #   load balancer. For more information, see [EvaluateTargetHealth][2].
+    #
+    # * If you include `HealthCheckConfig` and then use the service to
+    #   register an instance that creates an alias record, Route 53 doesn't
+    #   create the health check.
+    #
+    # For information about the charges for health checks, see [Route 53
+    # Pricing][3].
+    #
+    #
+    #
+    # [1]: http://docs.aws.amazon.com/Route53/latest/APIReference/API_HealthCheckConfig.html#Route53-Type-HealthCheckConfig-Regions
+    # [2]: http://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth
+    # [3]: http://aws.amazon.com/route53/pricing
     #
     # @note When making an API call, you may pass HealthCheckConfig
     #   data as a hash:
     #
     #       {
-    #         type: "HTTP", # accepts HTTP, HTTPS, TCP
+    #         type: "HTTP", # required, accepts HTTP, HTTPS, TCP
     #         resource_path: "ResourcePath",
     #         failure_threshold: 1,
     #       }
     #
     # @!attribute [rw] type
     #   The type of health check that you want to create, which indicates
-    #   how Amazon Route 53 determines whether an endpoint is healthy.
+    #   how Route 53 determines whether an endpoint is healthy.
     #
     #   You can't change the value of `Type` after you create a health
     #   check.
     #
     #   You can create the following types of health checks:
     #
-    #   * **HTTP**\: Amazon Route 53 tries to establish a TCP connection. If
-    #     successful, Amazon Route 53 submits an HTTP request and waits for
-    #     an HTTP status code of 200 or greater and less than 400.
+    #   * **HTTP**\: Route 53 tries to establish a TCP connection. If
+    #     successful, Route 53 submits an HTTP request and waits for an HTTP
+    #     status code of 200 or greater and less than 400.
     #
-    #   * **HTTPS**\: Amazon Route 53 tries to establish a TCP connection.
-    #     If successful, Amazon Route 53 submits an HTTPS request and waits
-    #     for an HTTP status code of 200 or greater and less than 400.
+    #   * **HTTPS**\: Route 53 tries to establish a TCP connection. If
+    #     successful, Route 53 submits an HTTPS request and waits for an
+    #     HTTP status code of 200 or greater and less than 400.
     #
     #     If you specify HTTPS for the value of `Type`, the endpoint must
     #     support TLS v1.0 or later.
     #
-    #   * **TCP**\: Amazon Route 53 tries to establish a TCP connection.
+    #   * **TCP**\: Route 53 tries to establish a TCP connection.
     #
-    #   For more information, see [How Amazon Route 53 Determines Whether an
-    #   Endpoint Is Healthy][1] in the *Amazon Route 53 Developer Guide*.
+    #   For more information, see [How Route 53 Determines Whether an
+    #   Endpoint Is Healthy][1] in the *Route 53 Developer Guide*.
     #
     #
     #
@@ -681,20 +837,20 @@ module Aws::ServiceDiscovery
     #   @return [String]
     #
     # @!attribute [rw] resource_path
-    #   The path that you want Amazon Route 53 to request when performing
-    #   health checks. The path can be any value for which your endpoint
-    #   will return an HTTP status code of 2xx or 3xx when the endpoint is
-    #   healthy, such as the file `/docs/route53-health-check.html`. Amazon
-    #   Route 53 automatically adds the DNS name for the service and a
-    #   leading forward slash (`/`) character.
+    #   The path that you want Route 53 to request when performing health
+    #   checks. The path can be any value for which your endpoint will
+    #   return an HTTP status code of 2xx or 3xx when the endpoint is
+    #   healthy, such as the file `/docs/route53-health-check.html`. Route
+    #   53 automatically adds the DNS name for the service and a leading
+    #   forward slash (`/`) character.
     #   @return [String]
     #
     # @!attribute [rw] failure_threshold
     #   The number of consecutive health checks that an endpoint must pass
-    #   or fail for Amazon Route 53 to change the current status of the
-    #   endpoint from unhealthy to healthy or vice versa. For more
-    #   information, see [How Amazon Route 53 Determines Whether an Endpoint
-    #   Is Healthy][1] in the *Amazon Route 53 Developer Guide*.
+    #   or fail for Route 53 to change the current status of the endpoint
+    #   from unhealthy to healthy or vice versa. For more information, see
+    #   [How Route 53 Determines Whether an Endpoint Is Healthy][1] in the
+    #   *Route 53 Developer Guide*.
     #
     #
     #
@@ -717,41 +873,115 @@ module Aws::ServiceDiscovery
     #   An identifier that you want to associate with the instance. Note the
     #   following:
     #
+    #   * If the service that is specified by `ServiceId` includes settings
+    #     for an SRV record, the value of `InstanceId` is automatically
+    #     included as part of the value for the SRV record. For more
+    #     information, see DnsRecord$Type.
+    #
     #   * You can use this value to update an existing instance.
     #
-    #   * To associate a new instance, you must specify a value that is
-    #     unique among instances that you associate by using the same
+    #   * To register a new instance, you must specify a value that is
+    #     unique among instances that you register by using the same
     #     service.
+    #
+    #   * If you specify an existing `InstanceId` and `ServiceId`, Route 53
+    #     updates the existing records. If there's also an existing health
+    #     check, Route 53 deletes the old health check and creates a new
+    #     one.
+    #
+    #     <note markdown="1"> The health check isn't deleted immediately, so it will still
+    #     appear for a while if you submit a `ListHealthChecks` request, for
+    #     example.
+    #
+    #      </note>
     #   @return [String]
     #
     # @!attribute [rw] creator_request_id
-    #   An optional parameter that you can use to resolve concurrent
-    #   creation requests. `CreatorRequestId` helps to determine if a
-    #   specific client owns the namespace.
+    #   A unique string that identifies the request and that allows failed
+    #   `RegisterInstance` requests to be retried without the risk of
+    #   executing the operation twice. You must use a unique
+    #   `CreatorRequestId` string every time you submit a `RegisterInstance`
+    #   request if you're registering additional instances for the same
+    #   namespace and service. `CreatorRequestId` can be any unique string,
+    #   for example, a date/time stamp.
     #   @return [String]
     #
     # @!attribute [rw] attributes
-    #   A string map that contains attribute keys and values. Supported
-    #   attribute keys include the following:
-    #
-    #   * `AWS_INSTANCE_PORT`\: The port on the endpoint that you want
-    #     Amazon Route 53 to perform health checks on. This value is also
-    #     used for the port value in an SRV record if the service that you
-    #     specify includes an SRV record. For more information, see
-    #     CreateService.
-    #
-    #   * `AWS_INSTANCE_IP`\: If the service that you specify contains a
-    #     resource record set template for an A or AAAA record, the IP
-    #     address that you want Amazon Route 53 to use for the value of the
-    #     A record.
-    #
-    #   * `AWS_INSTANCE_WEIGHT`\: The weight value in an SRV record if the
-    #     service that you specify includes an SRV record. You can also
-    #     specify a default weight that is applied to all instances in the
-    #     `Service` configuration. For more information, see CreateService.
-    #
-    #   * `AWS_INSTANCE_PRIORITY`\: The priority value in an SRV record if
-    #     the service that you specify includes an SRV record.
+    #   A string map that contains the following information for the service
+    #   that you specify in `ServiceId`\:
+    #
+    #   * The attributes that apply to the records that are defined in the
+    #     service.
+    #
+    #   * For each attribute, the applicable value.
+    #
+    #   Supported attribute keys include the following:
+    #
+    #   * `AWS_ALIAS_DNS_NAME`\: If you want Route 53 to create an alias
+    #     record that routes traffic to an Elastic Load Balancing load
+    #     balancer, specify the DNS name that is associated with the load
+    #     balancer. For information about how to get the DNS name, see
+    #     "DNSName" in the topic [AliasTarget][1].
+    #
+    #     Note the following:
+    #
+    #     * The configuration for the service that is specified by
+    #       `ServiceId` must include settings for an A record, an AAAA
+    #       record, or both.
+    #
+    #     * In the service that is specified by `ServiceId`, the value of
+    #       `RoutingPolicy` must be `WEIGHTED`.
+    #
+    #     * If the service that is specified by `ServiceId` includes
+    #       `HealthCheckConfig` settings, Route 53 will create the health
+    #       check, but it won't associate the health check with the alias
+    #       record.
+    #
+    #     * Auto naming currently doesn't support creating alias records
+    #       that route traffic to AWS resources other than ELB load
+    #       balancers.
+    #
+    #     * If you specify a value for `AWS_ALIAS_DNS_NAME`, don't specify
+    #       values for any of the `AWS_INSTANCE` attributes.
+    #
+    #   * `AWS_INSTANCE_CNAME`\: If the service configuration includes a
+    #     CNAME record, the domain name that you want Route 53 to return in
+    #     response to DNS queries, for example, `example.com`.
+    #
+    #     This value is required if the service specified by `ServiceId`
+    #     includes settings for an CNAME record.
+    #
+    #   * `AWS_INSTANCE_IPV4`\: If the service configuration includes an A
+    #     record, the IPv4 address that you want Route 53 to return in
+    #     response to DNS queries, for example, `192.0.2.44`.
+    #
+    #     This value is required if the service specified by `ServiceId`
+    #     includes settings for an A record. Either `AWS_INSTANCE_IPV4` or
+    #     `AWS_INSTANCE_IPV6` is required if the service includes settings
+    #     for an SRV record.
+    #
+    #   * `AWS_INSTANCE_IPV6`\: If the service configuration includes an
+    #     AAAA record, the IPv6 address that you want Route 53 to return in
+    #     response to DNS queries, for example,
+    #     `2001:0db8:85a3:0000:0000:abcd:0001:2345`.
+    #
+    #     This value is required if the service specified by `ServiceId`
+    #     includes settings for an AAAA record. Either `AWS_INSTANCE_IPV4`
+    #     or `AWS_INSTANCE_IPV6` is required if the service includes
+    #     settings for an SRV record.
+    #
+    #   * `AWS_INSTANCE_PORT`\: If the service includes an SRV record, the
+    #     value that you want Route 53 to return for the port. In addition,
+    #     if the service includes `HealthCheckConfig`, the port on the
+    #     endpoint that you want Route 53 to send requests to. For more
+    #     information, see CreateService.
+    #
+    #     This value is required if you specified settings for an SRV record
+    #     when you created the service.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/http:/docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html
     #   @return [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/Instance AWS API Documentation
@@ -764,7 +994,7 @@ module Aws::ServiceDiscovery
     end
 
     # A complex type that contains information about the instances that you
-    # created by using a specified service.
+    # registered by using a specified service.
     #
     # @!attribute [rw] id
     #   The ID for an instance that you created by using a specified
@@ -772,19 +1002,33 @@ module Aws::ServiceDiscovery
     #   @return [String]
     #
     # @!attribute [rw] attributes
-    #   A string map that contain attribute keys and values for an instance.
+    #   A string map that contains the following information:
+    #
+    #   * The attributes that are associate with the instance.
+    #
+    #   * For each attribute, the applicable value.
+    #
     #   Supported attribute keys include the following:
     #
-    #   * `AWS_INSTANCE_PORT`\: The port on the endpoint that you want
-    #     Amazon Route 53 to perform health checks on. This value is also
-    #     used for the port value in an SRV record if the service that you
-    #     specify includes an SRV record. For more information, see
-    #     CreateService.
+    #   * `AWS_ALIAS_DNS_NAME`\: For an alias record that routes traffic to
+    #     an Elastic Load Balancing load balancer, the DNS name that is
+    #     associated with the load balancer.
+    #
+    #   * `AWS_INSTANCE_CNAME`\: For a CNAME record, the domain name that
+    #     Route 53 returns in response to DNS queries, for example,
+    #     `example.com`.
+    #
+    #   * `AWS_INSTANCE_IPV4`\: For an A record, the IPv4 address that Route
+    #     53 returns in response to DNS queries, for example, `192.0.2.44`.
+    #
+    #   * `AWS_INSTANCE_IPV6`\: For an AAAA record, the IPv6 address that
+    #     Route 53 returns in response to DNS queries, for example,
+    #     `2001:0db8:85a3:0000:0000:abcd:0001:2345`.
     #
-    #   * `AWS_INSTANCE_IP`\: If the service that you specify contains a
-    #     resource record set template for an A or AAAA record, the IP
-    #     address that you want Amazon Route 53 to use for the value of the
-    #     A record.
+    #   * `AWS_INSTANCE_PORT`\: For an SRV record, the value that Route 53
+    #     returns for the port. In addition, if the service includes
+    #     `HealthCheckConfig`, the port on the endpoint that Route 53 sends
+    #     requests to.
     #   @return [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/InstanceSummary AWS API Documentation
@@ -820,7 +1064,7 @@ module Aws::ServiceDiscovery
     # @!attribute [rw] max_results
     #   The maximum number of instances that you want Amazon Route 53 to
     #   return in the response to a `ListInstances` request. If you don't
-    #   specify a value for `MaxResults`, Amazon Route 53 returns up to 100
+    #   specify a value for `MaxResults`, Route 53 returns up to 100
     #   instances.
     #   @return [Integer]
     #
@@ -871,16 +1115,24 @@ module Aws::ServiceDiscovery
     # @!attribute [rw] next_token
     #   For the first `ListNamespaces` request, omit this value.
     #
-    #   If more than `MaxResults` namespaces match the specified criteria,
-    #   you can submit another `ListNamespaces` request to get the next
-    #   group of results. Specify the value of `NextToken` from the previous
-    #   response in the next request.
+    #   If the response contains `NextToken`, submit another
+    #   `ListNamespaces` request to get the next group of results. Specify
+    #   the value of `NextToken` from the previous response in the next
+    #   request.
+    #
+    #   <note markdown="1"> Route 53 gets `MaxResults` namespaces and then filters them based on
+    #   the specified criteria. It's possible that no namespaces in the
+    #   first `MaxResults` namespaces matched the specified criteria but
+    #   that subsequent groups of `MaxResults` namespaces do contain
+    #   namespaces that match the criteria.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] max_results
     #   The maximum number of namespaces that you want Amazon Route 53 to
     #   return in the response to a `ListNamespaces` request. If you don't
-    #   specify a value for `MaxResults`, Amazon Route 53 returns up to 100
+    #   specify a value for `MaxResults`, Route 53 returns up to 100
     #   namespaces.
     #   @return [Integer]
     #
@@ -888,8 +1140,8 @@ module Aws::ServiceDiscovery
     #   A complex type that contains specifications for the namespaces that
     #   you want to list.
     #
-    #   If you specify more than one filter, an operation must match all
-    #   filters to be returned by ListNamespaces.
+    #   If you specify more than one filter, a namespace must match all
+    #   filters to be returned by `ListNamespaces`.
     #   @return [Array<Types::NamespaceFilter>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/ListNamespacesRequest AWS API Documentation
@@ -907,10 +1159,18 @@ module Aws::ServiceDiscovery
     #   @return [Array<Types::NamespaceSummary>]
     #
     # @!attribute [rw] next_token
-    #   If more than `MaxResults` namespaces match the specified criteria,
-    #   you can submit another `ListNamespaces` request to get the next
-    #   group of results. Specify the value of `NextToken` from the previous
-    #   response in the next request.
+    #   If the response contains `NextToken`, submit another
+    #   `ListNamespaces` request to get the next group of results. Specify
+    #   the value of `NextToken` from the previous response in the next
+    #   request.
+    #
+    #   <note markdown="1"> Route 53 gets `MaxResults` namespaces and then filters them based on
+    #   the specified criteria. It's possible that no namespaces in the
+    #   first `MaxResults` namespaces matched the specified criteria but
+    #   that subsequent groups of `MaxResults` namespaces do contain
+    #   namespaces that match the criteria.
+    #
+    #    </note>
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/ListNamespacesResponse AWS API Documentation
@@ -939,17 +1199,24 @@ module Aws::ServiceDiscovery
     # @!attribute [rw] next_token
     #   For the first `ListOperations` request, omit this value.
     #
-    #   If more than `MaxResults` operations match the specified criteria,
-    #   you can submit another `ListOperations` request to get the next
-    #   group of results. Specify the value of `NextToken` from the previous
-    #   response in the next request.
+    #   If the response contains `NextToken`, submit another
+    #   `ListOperations` request to get the next group of results. Specify
+    #   the value of `NextToken` from the previous response in the next
+    #   request.
+    #
+    #   <note markdown="1"> Route 53 gets `MaxResults` operations and then filters them based on
+    #   the specified criteria. It's possible that no operations in the
+    #   first `MaxResults` operations matched the specified criteria but
+    #   that subsequent groups of `MaxResults` operations do contain
+    #   operations that match the criteria.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] max_results
     #   The maximum number of items that you want Amazon Route 53 to return
     #   in the response to a `ListOperations` request. If you don't specify
-    #   a value for `MaxResults`, Amazon Route 53 returns up to 100
-    #   operations.
+    #   a value for `MaxResults`, Route 53 returns up to 100 operations.
     #   @return [Integer]
     #
     # @!attribute [rw] filters
@@ -976,10 +1243,18 @@ module Aws::ServiceDiscovery
     #   @return [Array<Types::OperationSummary>]
     #
     # @!attribute [rw] next_token
-    #   If more than `MaxResults` operations match the specified criteria,
-    #   you can submit another `ListOperations` request to get the next
-    #   group of results. Specify the value of `NextToken` from the previous
-    #   response in the next request.
+    #   If the response contains `NextToken`, submit another
+    #   `ListOperations` request to get the next group of results. Specify
+    #   the value of `NextToken` from the previous response in the next
+    #   request.
+    #
+    #   <note markdown="1"> Route 53 gets `MaxResults` operations and then filters them based on
+    #   the specified criteria. It's possible that no operations in the
+    #   first `MaxResults` operations matched the specified criteria but
+    #   that subsequent groups of `MaxResults` operations do contain
+    #   operations that match the criteria.
+    #
+    #    </note>
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/ListOperationsResponse AWS API Documentation
@@ -1008,16 +1283,23 @@ module Aws::ServiceDiscovery
     # @!attribute [rw] next_token
     #   For the first `ListServices` request, omit this value.
     #
-    #   If more than `MaxResults` services match the specified criteria, you
-    #   can submit another `ListServices` request to get the next group of
-    #   results. Specify the value of `NextToken` from the previous response
-    #   in the next request.
+    #   If the response contains `NextToken`, submit another `ListServices`
+    #   request to get the next group of results. Specify the value of
+    #   `NextToken` from the previous response in the next request.
+    #
+    #   <note markdown="1"> Route 53 gets `MaxResults` services and then filters them based on
+    #   the specified criteria. It's possible that no services in the first
+    #   `MaxResults` services matched the specified criteria but that
+    #   subsequent groups of `MaxResults` services do contain services that
+    #   match the criteria.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] max_results
     #   The maximum number of services that you want Amazon Route 53 to
     #   return in the response to a `ListServices` request. If you don't
-    #   specify a value for `MaxResults`, Amazon Route 53 returns up to 100
+    #   specify a value for `MaxResults`, Route 53 returns up to 100
     #   services.
     #   @return [Integer]
     #
@@ -1044,11 +1326,17 @@ module Aws::ServiceDiscovery
     #   @return [Array<Types::ServiceSummary>]
     #
     # @!attribute [rw] next_token
-    #   If more than `MaxResults` operations match the specified criteria,
-    #   the value of `NextToken` is the first service in the next group of
-    #   services that were created by the current AWS account. To get the
-    #   next group, specify the value of `NextToken` from the previous
-    #   response in the next request.
+    #   If the response contains `NextToken`, submit another `ListServices`
+    #   request to get the next group of results. Specify the value of
+    #   `NextToken` from the previous response in the next request.
+    #
+    #   <note markdown="1"> Route 53 gets `MaxResults` services and then filters them based on
+    #   the specified criteria. It's possible that no services in the first
+    #   `MaxResults` services matched the specified criteria but that
+    #   subsequent groups of `MaxResults` services do contain services that
+    #   match the criteria.
+    #
+    #    </note>
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/ListServicesResponse AWS API Documentation
@@ -1066,7 +1354,7 @@ module Aws::ServiceDiscovery
     #   @return [String]
     #
     # @!attribute [rw] arn
-    #   The Amazon Resource Name (ARN) that Amazon Route 53 assigns to the
+    #   The Amazon Resource Name (ARN) that Route 53 assigns to the
     #   namespace when you create it.
     #   @return [String]
     #
@@ -1095,13 +1383,15 @@ module Aws::ServiceDiscovery
     #
     # @!attribute [rw] create_date
     #   The date that the namespace was created, in Unix date/time format
-    #   and Coordinated Universal Time (UTC).
+    #   and Coordinated Universal Time (UTC). The value of `CreateDate` is
+    #   accurate to milliseconds. For example, the value `1516925490.087`
+    #   represents Friday, January 26, 2018 12:11:30.087 AM.
     #   @return [Time]
     #
     # @!attribute [rw] creator_request_id
-    #   An optional parameter that you can use to resolve concurrent
-    #   creation requests. `CreatorRequestId` helps to determine if a
-    #   specific client owns the namespace.
+    #   A unique string that identifies the request and that allows failed
+    #   requests to be retried without the risk of executing an operation
+    #   twice.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/Namespace AWS API Documentation
@@ -1154,6 +1444,8 @@ module Aws::ServiceDiscovery
     #
     #   * `IN`\: When you specify `IN` for the condition, you can choose to
     #     list public namespaces, private namespaces, or both.
+    #
+    #   * `BETWEEN`\: Not applicable
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/NamespaceFilter AWS API Documentation
@@ -1169,8 +1461,8 @@ module Aws::ServiceDiscovery
     # namespace type.
     #
     # @!attribute [rw] dns_properties
-    #   A complex type that contains the ID for the hosted zone that Amazon
-    #   Route 53 creates when you create a namespace.
+    #   A complex type that contains the ID for the hosted zone that Route
+    #   53 creates when you create a namespace.
     #   @return [Types::DnsProperties]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/NamespaceProperties AWS API Documentation
@@ -1187,13 +1479,13 @@ module Aws::ServiceDiscovery
     #   @return [String]
     #
     # @!attribute [rw] arn
-    #   The Amazon Resource Name (ARN) that Amazon Route 53 assigns to the
+    #   The Amazon Resource Name (ARN) that Route 53 assigns to the
     #   namespace when you create it.
     #   @return [String]
     #
     # @!attribute [rw] name
-    #   The name of the namespace. When you create a namespace, Amazon Route
-    #   53 automatically creates a hosted zone that has the same name as the
+    #   The name of the namespace. When you create a namespace, Route 53
+    #   automatically creates a hosted zone that has the same name as the
     #   namespace.
     #   @return [String]
     #
@@ -1227,7 +1519,7 @@ module Aws::ServiceDiscovery
     #   * **SUBMITTED**\: This is the initial state immediately after you
     #     submit a request.
     #
-    #   * **PENDING**\: Amazon Route 53 is performing the operation.
+    #   * **PENDING**\: Route 53 is performing the operation.
     #
     #   * **SUCCESS**\: The operation succeeded.
     #
@@ -1241,18 +1533,38 @@ module Aws::ServiceDiscovery
     #   @return [String]
     #
     # @!attribute [rw] error_code
-    #   The code associated with `ErrorMessage`.
+    #   The code associated with `ErrorMessage`. Values for `ErrorCode`
+    #   include the following:
+    #
+    #   * `ACCESS_DENIED`
+    #
+    #   * `CANNOT_CREATE_HOSTED_ZONE`
+    #
+    #   * `EXPIRED_TOKEN`
+    #
+    #   * `HOSTED_ZONE_NOT_FOUND`
+    #
+    #   * `INTERNAL_FAILURE`
+    #
+    #   * `INVALID_CHANGE_BATCH`
+    #
+    #   * `THROTTLED_REQUEST`
     #   @return [String]
     #
     # @!attribute [rw] create_date
     #   The date and time that the request was submitted, in Unix date/time
-    #   format and Coordinated Universal Time (UTC).
+    #   format and Coordinated Universal Time (UTC). The value of
+    #   `CreateDate` is accurate to milliseconds. For example, the value
+    #   `1516925490.087` represents Friday, January 26, 2018 12:11:30.087
+    #   AM.
     #   @return [Time]
     #
     # @!attribute [rw] update_date
     #   The date and time that the value of `Status` changed to the current
     #   value, in Unix date/time format and Coordinated Universal Time
-    #   (UTC).
+    #   (UTC). The value of `UpdateDate` is accurate to milliseconds. For
+    #   example, the value `1516925490.087` represents Friday, January 26,
+    #   2018 12:11:30.087 AM.
     #   @return [Time]
     #
     # @!attribute [rw] targets
@@ -1345,9 +1657,9 @@ module Aws::ServiceDiscovery
     #     `TYPE`. An operation must match one of the specified values to be
     #     returned in the response.
     #
-    #   * `BETWEEN`\: Specify two values, a start date and an end date. The
-    #     start date must be the first value. `BETWEEN` is supported for
-    #     `U`.
+    #   * `BETWEEN`\: Specify a start date and an end date in Unix date/time
+    #     format and Coordinated Universal Time (UTC). The start date must
+    #     be the first value. `BETWEEN` is supported for `UPDATE_DATE`.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/OperationFilter AWS API Documentation
@@ -1372,7 +1684,7 @@ module Aws::ServiceDiscovery
     #   * **SUBMITTED**\: This is the initial state immediately after you
     #     submit a request.
     #
-    #   * **PENDING**\: Amazon Route 53 is performing the operation.
+    #   * **PENDING**\: Route 53 is performing the operation.
     #
     #   * **SUCCESS**\: The operation succeeded.
     #
@@ -1402,49 +1714,133 @@ module Aws::ServiceDiscovery
     #
     # @!attribute [rw] service_id
     #   The ID of the service that you want to use for settings for the
-    #   resource record sets and health check that Amazon Route 53 will
-    #   create.
+    #   records and health check that Route 53 will create.
     #   @return [String]
     #
     # @!attribute [rw] instance_id
     #   An identifier that you want to associate with the instance. Note the
     #   following:
     #
+    #   * If the service that is specified by `ServiceId` includes settings
+    #     for an SRV record, the value of `InstanceId` is automatically
+    #     included as part of the value for the SRV record. For more
+    #     information, see DnsRecord$Type.
+    #
     #   * You can use this value to update an existing instance.
     #
     #   * To register a new instance, you must specify a value that is
     #     unique among instances that you register by using the same
     #     service.
+    #
+    #   * If you specify an existing `InstanceId` and `ServiceId`, Route 53
+    #     updates the existing records. If there's also an existing health
+    #     check, Route 53 deletes the old health check and creates a new
+    #     one.
+    #
+    #     <note markdown="1"> The health check isn't deleted immediately, so it will still
+    #     appear for a while if you submit a `ListHealthChecks` request, for
+    #     example.
+    #
+    #      </note>
     #   @return [String]
     #
     # @!attribute [rw] creator_request_id
-    #   An optional parameter that you can use to resolve concurrent
-    #   creation requests. `CreatorRequestId` helps to determine if a
-    #   specific client owns the namespace.
+    #   A unique string that identifies the request and that allows failed
+    #   `RegisterInstance` requests to be retried without the risk of
+    #   executing the operation twice. You must use a unique
+    #   `CreatorRequestId` string every time you submit a `RegisterInstance`
+    #   request if you're registering additional instances for the same
+    #   namespace and service. `CreatorRequestId` can be any unique string,
+    #   for example, a date/time stamp.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.
     #   @return [String]
     #
     # @!attribute [rw] attributes
-    #   A string map that contain attribute keys and values. Supported
-    #   attribute keys include the following:
-    #
-    #   * `AWS_INSTANCE_PORT`\: The port on the endpoint that you want
-    #     Amazon Route 53 to perform health checks on. This value is also
-    #     used for the port value in an SRV record if the service that you
-    #     specify includes an SRV record. For more information, see
-    #     CreateService.
-    #
-    #   * `AWS_INSTANCE_IPV4`\: If the service that you specify contains a
-    #     resource record set template for an A record, the IPv4 address
-    #     that you want Amazon Route 53 to use for the value of the A
-    #     record.
+    #   A string map that contains the following information for the service
+    #   that you specify in `ServiceId`\:
     #
-    #   * `AWS_INSTANCE_IPV6`\: If the service that you specify contains a
-    #     resource record set template for an AAAA record, the IPv6 address
-    #     that you want Amazon Route 53 to use for the value of the AAAA
+    #   * The attributes that apply to the records that are defined in the
+    #     service.
+    #
+    #   * For each attribute, the applicable value.
+    #
+    #   Supported attribute keys include the following:
+    #
+    #   **AWS\_ALIAS\_DNS\_NAME**
+    #
+    #   ****
+    #
+    #   If you want Route 53 to create an alias record that routes traffic
+    #   to an Elastic Load Balancing load balancer, specify the DNS name
+    #   that is associated with the load balancer. For information about how
+    #   to get the DNS name, see "DNSName" in the topic [AliasTarget][1].
+    #
+    #   Note the following:
+    #
+    #   * The configuration for the service that is specified by `ServiceId`
+    #     must include settings for an A record, an AAAA record, or both.
+    #
+    #   * In the service that is specified by `ServiceId`, the value of
+    #     `RoutingPolicy` must be `WEIGHTED`.
+    #
+    #   * If the service that is specified by `ServiceId` includes
+    #     `HealthCheckConfig` settings, Route 53 will create the health
+    #     check, but it won't associate the health check with the alias
     #     record.
+    #
+    #   * Auto naming currently doesn't support creating alias records that
+    #     route traffic to AWS resources other than ELB load balancers.
+    #
+    #   * If you specify a value for `AWS_ALIAS_DNS_NAME`, don't specify
+    #     values for any of the `AWS_INSTANCE` attributes.
+    #
+    #   **AWS\_INSTANCE\_CNAME**
+    #
+    #   If the service configuration includes a CNAME record, the domain
+    #   name that you want Route 53 to return in response to DNS queries,
+    #   for example, `example.com`.
+    #
+    #   This value is required if the service specified by `ServiceId`
+    #   includes settings for an CNAME record.
+    #
+    #   **AWS\_INSTANCE\_IPV4**
+    #
+    #   If the service configuration includes an A record, the IPv4 address
+    #   that you want Route 53 to return in response to DNS queries, for
+    #   example, `192.0.2.44`.
+    #
+    #   This value is required if the service specified by `ServiceId`
+    #   includes settings for an A record. Either `AWS_INSTANCE_IPV4` or
+    #   `AWS_INSTANCE_IPV6` is required if the service includes settings for
+    #   an SRV record.
+    #
+    #   **AWS\_INSTANCE\_IPV6**
+    #
+    #   If the service configuration includes an AAAA record, the IPv6
+    #   address that you want Route 53 to return in response to DNS queries,
+    #   for example, `2001:0db8:85a3:0000:0000:abcd:0001:2345`.
+    #
+    #   This value is required if the service specified by `ServiceId`
+    #   includes settings for an AAAA record. Either `AWS_INSTANCE_IPV4` or
+    #   `AWS_INSTANCE_IPV6` is required if the service includes settings for
+    #   an SRV record.
+    #
+    #   **AWS\_INSTANCE\_PORT**
+    #
+    #   If the service includes an SRV record, the value that you want Route
+    #   53 to return for the port.
+    #
+    #   If the service includes `HealthCheckConfig`, the port on the
+    #   endpoint that you want Route 53 to send requests to.
+    #
+    #   This value is required if you specified settings for an SRV record
+    #   when you created the service.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/http:/docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html
     #   @return [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/RegisterInstanceRequest AWS API Documentation
@@ -1472,13 +1868,12 @@ module Aws::ServiceDiscovery
     # A complex type that contains information about the specified service.
     #
     # @!attribute [rw] id
-    #   The ID that Amazon Route 53 assigned to the service when you created
-    #   it.
+    #   The ID that Route 53 assigned to the service when you created it.
     #   @return [String]
     #
     # @!attribute [rw] arn
-    #   The Amazon Resource Name (ARN) that Amazon Route 53 assigns to the
-    #   service when you create it.
+    #   The Amazon Resource Name (ARN) that Route 53 assigns to the service
+    #   when you create it.
     #   @return [String]
     #
     # @!attribute [rw] name
@@ -1496,32 +1891,18 @@ module Aws::ServiceDiscovery
     #   @return [Integer]
     #
     # @!attribute [rw] dns_config
-    #   A complex type that contains information about the resource record
-    #   sets that you want Amazon Route 53 to create when you register an
-    #   instance.
+    #   A complex type that contains information about the records that you
+    #   want Route 53 to create when you register an instance.
     #   @return [Types::DnsConfig]
     #
     # @!attribute [rw] health_check_config
     #   *Public DNS namespaces only.* A complex type that contains settings
     #   for an optional health check. If you specify settings for a health
-    #   check, Amazon Route 53 associates the health check with all the
-    #   resource record sets that you specify in `DnsConfig`.
-    #
-    #   <note markdown="1"> The health check uses 30 seconds as the request interval. This is
-    #   the number of seconds between the time that each Amazon Route 53
-    #   health checker gets a response from your endpoint and the time that
-    #   it sends the next health check request. A health checker in each
-    #   data center around the world sends your endpoint a health check
-    #   request every 30 seconds. On average, your endpoint receives a
-    #   health check request about every two seconds. Health checkers in
-    #   different data centers don't coordinate with one another, so
-    #   you'll sometimes see several requests per second followed by a few
-    #   seconds with no health checks at all.
+    #   check, Route 53 associates the health check with all the records
+    #   that you specify in `DnsConfig`.
     #
-    #    </note>
-    #
-    #   For information about the charges for health checks, see [Amazon
-    #   Route 53 Pricing][1].
+    #   For information about the charges for health checks, see [Route 53
+    #   Pricing][1].
     #
     #
     #
@@ -1530,13 +1911,16 @@ module Aws::ServiceDiscovery
     #
     # @!attribute [rw] create_date
     #   The date and time that the service was created, in Unix format and
-    #   Coordinated Universal Time (UTC).
+    #   Coordinated Universal Time (UTC). The value of `CreateDate` is
+    #   accurate to milliseconds. For example, the value `1516925490.087`
+    #   represents Friday, January 26, 2018 12:11:30.087 AM.
     #   @return [Time]
     #
     # @!attribute [rw] creator_request_id
-    #   An optional parameter that you can use to resolve concurrent
-    #   creation requests. `CreatorRequestId` helps to determine if a
-    #   specific client owns the namespace.
+    #   A unique string that identifies the request and that allows failed
+    #   requests to be retried without the risk of executing the operation
+    #   twice. `CreatorRequestId` can be any unique string, for example, a
+    #   date/time stamp.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/Service AWS API Documentation
@@ -1564,13 +1948,13 @@ module Aws::ServiceDiscovery
     #         dns_config: { # required
     #           dns_records: [ # required
     #             {
-    #               type: "SRV", # required, accepts SRV, A, AAAA
+    #               type: "SRV", # required, accepts SRV, A, AAAA, CNAME
     #               ttl: 1, # required
     #             },
     #           ],
     #         },
     #         health_check_config: {
-    #           type: "HTTP", # accepts HTTP, HTTPS, TCP
+    #           type: "HTTP", # required, accepts HTTP, HTTPS, TCP
     #           resource_path: "ResourcePath",
     #           failure_threshold: 1,
     #         },
@@ -1581,36 +1965,72 @@ module Aws::ServiceDiscovery
     #   @return [String]
     #
     # @!attribute [rw] dns_config
-    #   A complex type that contains information about the resource record
-    #   sets that you want Amazon Route 53 to create when you register an
-    #   instance.
+    #   A complex type that contains information about the records that you
+    #   want Route 53 to create when you register an instance.
     #   @return [Types::DnsConfigChange]
     #
     # @!attribute [rw] health_check_config
     #   *Public DNS namespaces only.* A complex type that contains settings
     #   for an optional health check. If you specify settings for a health
     #   check, Amazon Route 53 associates the health check with all the
-    #   resource record sets that you specify in `DnsConfig`.
-    #
-    #   <note markdown="1"> The health check uses 30 seconds as the request interval. This is
-    #   the number of seconds between the time that each Amazon Route 53
-    #   health checker gets a response from your endpoint and the time that
-    #   it sends the next health check request. A health checker in each
-    #   data center around the world sends your endpoint a health check
-    #   request every 30 seconds. On average, your endpoint receives a
-    #   health check request about every two seconds. Health checkers in
-    #   different data centers don't coordinate with one another, so
-    #   you'll sometimes see several requests per second followed by a few
-    #   seconds with no health checks at all.
+    #   records that you specify in `DnsConfig`.
     #
-    #    </note>
+    #   **A and AAAA records**
     #
-    #   For information about the charges for health checks, see [Amazon
-    #   Route 53 Pricing][1].
+    #   If `DnsConfig` includes configurations for both A and AAAA records,
+    #   Route 53 creates a health check that uses the IPv4 address to check
+    #   the health of the resource. If the endpoint that is specified by the
+    #   IPv4 address is unhealthy, Route 53 considers both the A and AAAA
+    #   records to be unhealthy.
     #
+    #   **CNAME records**
     #
+    #   You can't specify settings for `HealthCheckConfig` when the
+    #   `DNSConfig` includes `CNAME` for the value of `Type`. If you do, the
+    #   `CreateService` request will fail with an `InvalidInput` error.
     #
-    #   [1]: http://aws.amazon.com/route53/pricing
+    #   **Request interval**
+    #
+    #   The health check uses 30 seconds as the request interval. This is
+    #   the number of seconds between the time that each Route 53 health
+    #   checker gets a response from your endpoint and the time that it
+    #   sends the next health check request. A health checker in each data
+    #   center around the world sends your endpoint a health check request
+    #   every 30 seconds. On average, your endpoint receives a health check
+    #   request about every two seconds. Health checkers in different data
+    #   centers don't coordinate with one another, so you'll sometimes see
+    #   several requests per second followed by a few seconds with no health
+    #   checks at all.
+    #
+    #   **Health checking regions**
+    #
+    #   Health checkers perform checks from all Route 53 health-checking
+    #   regions. For a list of the current regions, see [Regions][1].
+    #
+    #   **Alias records**
+    #
+    #   When you register an instance, if you include the
+    #   `AWS_ALIAS_DNS_NAME` attribute, Route 53 creates an alias record.
+    #   Note the following:
+    #
+    #   * Route 53 automatically sets `EvaluateTargetHealth` to true for
+    #     alias records. When `EvaluateTargetHealth` is true, the alias
+    #     record inherits the health of the referenced AWS resource. such as
+    #     an ELB load balancer. For more information, see
+    #     [EvaluateTargetHealth][2].
+    #
+    #   * If you include `HealthCheckConfig` and then use the service to
+    #     register an instance that creates an alias record, Route 53
+    #     doesn't create the health check.
+    #
+    #   For information about the charges for health checks, see [Route 53
+    #   Pricing][3].
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/Route53/latest/APIReference/API_HealthCheckConfig.html#Route53-Type-HealthCheckConfig-Regions
+    #   [2]: http://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth
+    #   [3]: http://aws.amazon.com/route53/pricing
     #   @return [Types::HealthCheckConfig]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/ServiceChange AWS API Documentation
@@ -1654,6 +2074,8 @@ module Aws::ServiceDiscovery
     #   * `IN`\: When you specify `IN`, specify a list of the IDs for the
     #     namespaces that you want `ListServices` to return a list of
     #     services for.
+    #
+    #   * `BETWEEN`\: Not applicable.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/ServiceFilter AWS API Documentation
@@ -1668,13 +2090,12 @@ module Aws::ServiceDiscovery
     # A complex type that contains information about a specified service.
     #
     # @!attribute [rw] id
-    #   The ID that Amazon Route 53 assigned to the service when you created
-    #   it.
+    #   The ID that Route 53 assigned to the service when you created it.
     #   @return [String]
     #
     # @!attribute [rw] arn
-    #   The Amazon Resource Name (ARN) that Amazon Route 53 assigns to the
-    #   service when you create it.
+    #   The Amazon Resource Name (ARN) that Route 53 assigns to the service
+    #   when you create it.
     #   @return [String]
     #
     # @!attribute [rw] name
@@ -1712,13 +2133,13 @@ module Aws::ServiceDiscovery
     #           dns_config: { # required
     #             dns_records: [ # required
     #               {
-    #                 type: "SRV", # required, accepts SRV, A, AAAA
+    #                 type: "SRV", # required, accepts SRV, A, AAAA, CNAME
     #                 ttl: 1, # required
     #               },
     #             ],
     #           },
     #           health_check_config: {
-    #             type: "HTTP", # accepts HTTP, HTTPS, TCP
+    #             type: "HTTP", # required, accepts HTTP, HTTPS, TCP
     #             resource_path: "ResourcePath",
     #             failure_threshold: 1,
     #           },