aws-sdk-servicediscovery 1.18.0 → 1.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 555a483b012a3dd7ec71f1b8553335da656224c6
-  data.tar.gz: 481dd0530b53490e0e5398f80dea5d7a705fd905
+SHA256:
+  metadata.gz: 288018fa5ba020f7b997ec7874dba2796ff45d4cff74a7c865ff09e95a3ceeb9
+  data.tar.gz: 4b0b9045aa90813bbf97499dbac3eba9e6017c61d5ab9dd4bdbb67a8d4924fa9
 SHA512:
-  metadata.gz: 7a92f158309d0bc4cfa8f2cfccce0534ef47a05a7d861cbae2bd8db24e352c64b60ff810ca9da876cb98dd9f9d91442edcc31474effdaaa3c680b832f463dbf1
-  data.tar.gz: f7add6814bd3a8fdde3b9fae56d9785261b73aa5d6421ca6ba95542d55f1ef02a1dc5938d865b60d85937de34bf84ef10030ca5a5c8c15184793b364dbe686e5
+  metadata.gz: 60d6fc999006b89a816f9d0ffb14050bb45ff61ed4e4e5cf789e89f9a08ccf4a7d59cfdbc209984bee63cc38db7c647e3c65c4c2aa367c838f3d6b2571831608
+  data.tar.gz: d55ed05fe7daa5bc11c97cab0cf269ae2f72810689cebb9a94e5a746940e6112ca754bc77faef95a9c8129cab6d7b0a770d3990a962c809790932b52c60e23de

data/lib/aws-sdk-servicediscovery.rb

@@ -24,17 +24,20 @@ require_relative 'aws-sdk-servicediscovery/customizations'
 # methods each accept a hash of request parameters and return a response
 # structure.
 #
+#     service_discovery = Aws::ServiceDiscovery::Client.new
+#     resp = service_discovery.create_http_namespace(params)
+#
 # See {Client} for more information.
 #
 # # Errors
 #
-# Errors returned from AWS Cloud Map all
-# extend {Errors::ServiceError}.
+# Errors returned from AWS Cloud Map are defined in the
+# {Errors} module and all extend {Errors::ServiceError}.
 #
 #     begin
 #       # do stuff
 #     rescue Aws::ServiceDiscovery::Errors::ServiceError
-#       # rescues all service API errors
+#       # rescues all AWS Cloud Map API errors
 #     end
 #
 # See {Errors} for more information.
@@ -42,6 +45,6 @@ require_relative 'aws-sdk-servicediscovery/customizations'
 # @service
 module Aws::ServiceDiscovery
 
-  GEM_VERSION = '1.18.0'
+  GEM_VERSION = '1.23.0'
 
 end

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

@@ -30,6 +30,18 @@ require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 Aws::Plugins::GlobalConfiguration.add_identifier(:servicediscovery)
 
 module Aws::ServiceDiscovery
+  # An API client for ServiceDiscovery.  To construct a client, you need to configure a `:region` and `:credentials`.
+  #
+  #     client = Aws::ServiceDiscovery::Client.new(
+  #       region: region_name,
+  #       credentials: credentials,
+  #       # ...
+  #     )
+  #
+  # For details on configuring region and credentials see
+  # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
+  #
+  # See {#initialize} for a full list of supported configuration options.
   class Client < Seahorse::Client::Base
 
     include Aws::ClientStubs
@@ -93,7 +105,7 @@ module Aws::ServiceDiscovery
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
     #     used to determine the service `:endpoint`. When not passed,
-    #     a default `:region` is search for in the following locations:
+    #     a default `:region` is searched for in the following locations:
     #
     #     * `Aws.config[:region]`
     #     * `ENV['AWS_REGION']`
@@ -108,6 +120,12 @@ module Aws::ServiceDiscovery
     #     When set to `true`, a thread polling for endpoints will be running in
     #     the background every 60 secs (default). Defaults to `false`.
     #
+    #   @option options [Boolean] :adaptive_retry_wait_to_fill (true)
+    #     Used only in `adaptive` retry mode.  When true, the request will sleep
+    #     until there is sufficent client side capacity to retry the request.
+    #     When false, the request will raise a `RetryCapacityNotAvailableError` and will
+    #     not retry instead of sleeping.
+    #
     #   @option options [Boolean] :client_side_monitoring (false)
     #     When `true`, client-side metrics will be collected for all API requests from
     #     this client.
@@ -132,6 +150,10 @@ module Aws::ServiceDiscovery
     #     When `true`, an attempt is made to coerce request parameters into
     #     the required types.
     #
+    #   @option options [Boolean] :correct_clock_skew (true)
+    #     Used only in `standard` and adaptive retry modes. Specifies whether to apply
+    #     a clock skew correction and retry requests with skewed client clocks.
+    #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
@@ -139,7 +161,7 @@ module Aws::ServiceDiscovery
     #   @option options [String] :endpoint
     #     The client endpoint is normally constructed from the `:region`
     #     option. You should only configure an `:endpoint` when connecting
-    #     to test endpoints. This should be avalid HTTP(S) URI.
+    #     to test endpoints. This should be a valid HTTP(S) URI.
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -154,7 +176,7 @@ module Aws::ServiceDiscovery
     #     requests fetching endpoints information. Defaults to 60 sec.
     #
     #   @option options [Boolean] :endpoint_discovery (false)
-    #     When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
+    #     When set to `true`, endpoint discovery will be enabled for operations when available.
     #
     #   @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
     #     The log formatter.
@@ -166,15 +188,29 @@ module Aws::ServiceDiscovery
     #     The Logger instance to send log messages to.  If this option
     #     is not set, logging will be disabled.
     #
+    #   @option options [Integer] :max_attempts (3)
+    #     An integer representing the maximum number attempts that will be made for
+    #     a single request, including the initial attempt.  For example,
+    #     setting this value to 5 will result in a request being retried up to
+    #     4 times. Used in `standard` and `adaptive` retry modes.
+    #
     #   @option options [String] :profile ("default")
     #     Used when loading credentials from the shared credentials file
     #     at HOME/.aws/credentials.  When not specified, 'default' is used.
     #
+    #   @option options [Proc] :retry_backoff
+    #     A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
+    #     This option is only used in the `legacy` retry mode.
+    #
     #   @option options [Float] :retry_base_delay (0.3)
-    #     The base delay in seconds used by the default backoff function.
+    #     The base delay in seconds used by the default backoff function. This option
+    #     is only used in the `legacy` retry mode.
     #
     #   @option options [Symbol] :retry_jitter (:none)
-    #     A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number.
+    #     A delay randomiser function used by the default backoff function.
+    #     Some predefined functions can be referenced by name - :none, :equal, :full,
+    #     otherwise a Proc that takes and returns a number. This option is only used
+    #     in the `legacy` retry mode.
     #
     #     @see https://www.awsarchitectureblog.com/2015/03/backoff.html
     #
@@ -182,11 +218,30 @@ module Aws::ServiceDiscovery
     #     The maximum number of times to retry failed requests.  Only
     #     ~ 500 level server errors and certain ~ 400 level client errors
     #     are retried.  Generally, these are throttling errors, data
-    #     checksum errors, networking errors, timeout errors and auth
-    #     errors from expired credentials.
+    #     checksum errors, networking errors, timeout errors, auth errors,
+    #     endpoint discovery, and errors from expired credentials.
+    #     This option is only used in the `legacy` retry mode.
     #
     #   @option options [Integer] :retry_max_delay (0)
-    #     The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function.
+    #     The maximum number of seconds to delay between retries (0 for no limit)
+    #     used by the default backoff function. This option is only used in the
+    #     `legacy` retry mode.
+    #
+    #   @option options [String] :retry_mode ("legacy")
+    #     Specifies which retry algorithm to use. Values are:
+    #
+    #     * `legacy` - The pre-existing retry behavior.  This is default value if
+    #       no retry mode is provided.
+    #
+    #     * `standard` - A standardized set of retry rules across the AWS SDKs.
+    #       This includes support for retry quotas, which limit the number of
+    #       unsuccessful retries a client can make.
+    #
+    #     * `adaptive` - An experimental retry mode that includes all the
+    #       functionality of `standard` mode along with automatic client side
+    #       throttling.  This is a provisional mode that may change behavior
+    #       in the future.
+    #
     #
     #   @option options [String] :secret_access_key
     #
@@ -219,16 +274,15 @@ module Aws::ServiceDiscovery
     #     requests through.  Formatted like 'http://proxy.com:123'.
     #
     #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before rasing a
+    #     seconds to wait when opening a HTTP session before raising a
     #     `Timeout::Error`.
     #
     #   @option options [Integer] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
-    #     safely be set
-    #     per-request on the session yeidled by {#session_for}.
+    #     safely be set per-request on the session.
     #
     #   @option options [Float] :http_idle_timeout (5) The number of
-    #     seconds a connection is allowed to sit idble before it is
+    #     seconds a connection is allowed to sit idle before it is
     #     considered stale.  Stale connections are closed and removed
     #     from the pool before making a request.
     #
@@ -237,7 +291,7 @@ module Aws::ServiceDiscovery
     #     request body.  This option has no effect unless the request has
     #     "Expect" header set to "100-continue".  Defaults to `nil` which
     #     disables this behaviour.  This value can safely be set per
-    #     request on the session yeidled by {#session_for}.
+    #     request on the session.
     #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
@@ -274,7 +328,7 @@ module Aws::ServiceDiscovery
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/cloud-map/latest/dg/cloud-map-limits.html
+    # [1]: https://docs.aws.amazon.com/cloud-map/latest/dg/cloud-map-limits.html
     #
     # @option params [required, String] :name
     #   The name that you want to assign to this namespace.
@@ -326,7 +380,7 @@ module Aws::ServiceDiscovery
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/cloud-map/latest/dg/cloud-map-limits.html
+    # [1]: https://docs.aws.amazon.com/cloud-map/latest/dg/cloud-map-limits.html
     #
     # @option params [required, String] :name
     #   The name that you want to assign to this namespace. When you create a
@@ -353,6 +407,22 @@ module Aws::ServiceDiscovery
     #
     #   * {Types::CreatePrivateDnsNamespaceResponse#operation_id #operation_id} => String
     #
+    #
+    # @example Example: Example: Create private DNS namespace
+    #
+    #   # Example: Create private DNS namespace
+    #
+    #   resp = client.create_private_dns_namespace({
+    #     creator_request_id: "eedd6892-50f3-41b2-8af9-611d6e1d1a8c", 
+    #     name: "example.com", 
+    #     vpc: "vpc-1c56417b", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     operation_id: "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_private_dns_namespace({
@@ -385,7 +455,7 @@ module Aws::ServiceDiscovery
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/cloud-map/latest/dg/cloud-map-limits.html
+    # [1]: https://docs.aws.amazon.com/cloud-map/latest/dg/cloud-map-limits.html
     #
     # @option params [required, String] :name
     #   The name that you want to assign to this namespace.
@@ -445,21 +515,40 @@ module Aws::ServiceDiscovery
     #
     # * Optionally, a health check
     #
-    # After you create the service, you can submit a RegisterInstance
+    # After you create the service, you can submit a [RegisterInstance][1]
     # request, and AWS Cloud Map uses the values in the configuration to
     # create the specified entities.
     #
     # For the current limit on the number of instances that you can register
     # using the same namespace and using the same service, see [AWS Cloud
-    # Map Limits][1] in the *AWS Cloud Map Developer Guide*.
+    # Map Limits][2] in the *AWS Cloud Map Developer Guide*.
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/cloud-map/latest/dg/cloud-map-limits.html
+    # [1]: https://docs.aws.amazon.com/cloud-map/latest/api/API_RegisterInstance.html
+    # [2]: https://docs.aws.amazon.com/cloud-map/latest/dg/cloud-map-limits.html
     #
     # @option params [required, String] :name
     #   The name that you want to assign to the service.
     #
+    #   If you want AWS Cloud Map to create an SRV record when you register an
+    #   instance, and if you're using a system that requires a specific SRV
+    #   format, such as [HAProxy][1], specify the following for `Name`\:
+    #
+    #   * Start the name with an underscore (\_), such as `_exampleservice`
+    #
+    #   * End the name with *.\_protocol*, such as `._tcp`
+    #
+    #   When you register an instance, AWS Cloud Map creates an SRV record and
+    #   assigns a name to the record by concatenating the service name and the
+    #   namespace name, for example:
+    #
+    #   `_exampleservice._tcp.example.com`
+    #
+    #
+    #
+    #   [1]: http://www.haproxy.org/
+    #
     # @option params [String] :namespace_id
     #   The ID of the namespace that you want to use to create the service.
     #
@@ -481,10 +570,10 @@ module Aws::ServiceDiscovery
     #   instance.
     #
     # @option params [Types::HealthCheckConfig] :health_check_config
-    #   *Public DNS namespaces only.* A complex type that contains settings
-    #   for an optional Route 53 health check. If you specify settings for a
-    #   health check, AWS Cloud Map associates the health check with all the
-    #   Route 53 DNS records that you specify in `DnsConfig`.
+    #   *Public DNS and HTTP namespaces only.* A complex type that contains
+    #   settings for an optional Route 53 health check. If you specify
+    #   settings for a health check, AWS Cloud Map associates the health check
+    #   with all the Route 53 DNS records that you specify in `DnsConfig`.
     #
     #   If you specify a health check configuration, you can specify either
     #   `HealthCheckCustomConfig` or `HealthCheckConfig` but not both.
@@ -503,10 +592,56 @@ module Aws::ServiceDiscovery
     #   If you specify a health check configuration, you can specify either
     #   `HealthCheckCustomConfig` or `HealthCheckConfig` but not both.
     #
+    #   You can't add, update, or delete a `HealthCheckCustomConfig`
+    #   configuration from an existing service.
+    #
     # @return [Types::CreateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateServiceResponse#service #service} => Types::Service
     #
+    #
+    # @example Example: Example: Create service
+    #
+    #   # Example: Create service
+    #
+    #   resp = client.create_service({
+    #     creator_request_id: "567c1193-6b00-4308-bd57-ad38a8822d25", 
+    #     dns_config: {
+    #       dns_records: [
+    #         {
+    #           ttl: 60, 
+    #           type: "A", 
+    #         }, 
+    #       ], 
+    #       namespace_id: "ns-ylexjili4cdxy3xm", 
+    #       routing_policy: "MULTIVALUE", 
+    #     }, 
+    #     name: "myservice", 
+    #     namespace_id: "ns-ylexjili4cdxy3xm", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     service: {
+    #       arn: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita", 
+    #       create_date: Time.parse(1587081768.334), 
+    #       creator_request_id: "567c1193-6b00-4308-bd57-ad38a8822d25", 
+    #       dns_config: {
+    #         dns_records: [
+    #           {
+    #             ttl: 60, 
+    #             type: "A", 
+    #           }, 
+    #         ], 
+    #         namespace_id: "ns-ylexjili4cdxy3xm", 
+    #         routing_policy: "MULTIVALUE", 
+    #       }, 
+    #       id: "srv-p5zdwlg5uvvzjita", 
+    #       name: "myservice", 
+    #       namespace_id: "ns-ylexjili4cdxy3xm", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_service({
@@ -573,6 +708,20 @@ module Aws::ServiceDiscovery
     #
     #   * {Types::DeleteNamespaceResponse#operation_id #operation_id} => String
     #
+    #
+    # @example Example: Example: Delete namespace
+    #
+    #   # Example: Delete namespace
+    #
+    #   resp = client.delete_namespace({
+    #     id: "ns-ylexjili4cdxy3xm", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     operation_id: "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k98y6drk", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_namespace({
@@ -600,6 +749,19 @@ module Aws::ServiceDiscovery
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: Example: Delete service
+    #
+    #   # Example: Delete service
+    #
+    #   resp = client.delete_service({
+    #     id: "srv-p5zdwlg5uvvzjita", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_service({
@@ -622,12 +784,32 @@ module Aws::ServiceDiscovery
     #   The ID of the service that the instance is associated with.
     #
     # @option params [required, String] :instance_id
-    #   The value that you specified for `Id` in the RegisterInstance request.
+    #   The value that you specified for `Id` in the [RegisterInstance][1]
+    #   request.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/cloud-map/latest/api/API_RegisterInstance.html
     #
     # @return [Types::DeregisterInstanceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DeregisterInstanceResponse#operation_id #operation_id} => String
     #
+    #
+    # @example Example: Example: Deregister a service instance
+    #
+    #   # Example: Deregister a service instance
+    #
+    #   resp = client.deregister_instance({
+    #     instance_id: "myservice-53", 
+    #     service_id: "srv-p5zdwlg5uvvzjita", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     operation_id: "4yejorelbukcjzpnr6tlmrghsjwpngf4-k98rnaiq", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.deregister_instance({
@@ -649,6 +831,9 @@ module Aws::ServiceDiscovery
     end
 
     # Discovers registered instances for a specified namespace and service.
+    # You can use `DiscoverInstances` to discover instances for any type of
+    # namespace. For public and private DNS namespaces, you can also use DNS
+    # queries to discover instances.
     #
     # @option params [required, String] :namespace_name
     #   The name of the namespace that you specified when you registered the
@@ -659,9 +844,10 @@ module Aws::ServiceDiscovery
     #   instance.
     #
     # @option params [Integer] :max_results
-    #   The maximum number of instances that you want Cloud Map to return in
-    #   the response to a `DiscoverInstances` request. If you don't specify a
-    #   value for `MaxResults`, Cloud Map returns up to 100 instances.
+    #   The maximum number of instances that you want AWS Cloud Map to return
+    #   in the response to a `DiscoverInstances` request. If you don't
+    #   specify a value for `MaxResults`, AWS Cloud Map returns up to 100
+    #   instances.
     #
     # @option params [Hash<String,String>] :query_parameters
     #   A string map that contains attributes with values that you can use to
@@ -676,6 +862,34 @@ module Aws::ServiceDiscovery
     #
     #   * {Types::DiscoverInstancesResponse#instances #instances} => Array&lt;Types::HttpInstanceSummary&gt;
     #
+    #
+    # @example Example: Example: Discover registered instances
+    #
+    #   # Example: Discover registered instances
+    #
+    #   resp = client.discover_instances({
+    #     health_status: "ALL", 
+    #     max_results: 10, 
+    #     namespace_name: "example.com", 
+    #     service_name: "myservice", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     instances: [
+    #       {
+    #         attributes: {
+    #           "AWS_INSTANCE_IPV4" => "172.2.1.3", 
+    #           "AWS_INSTANCE_PORT" => "808", 
+    #         }, 
+    #         health_status: "UNKNOWN", 
+    #         instance_id: "myservice-53", 
+    #         namespace_name: "example.com", 
+    #         service_name: "myservice", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.discover_instances({
@@ -761,10 +975,14 @@ module Aws::ServiceDiscovery
     #   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.
+    #   specified service, submit a [ListInstances][1] request.
     #
     #    </note>
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/cloud-map/latest/api/API_ListInstances.html
+    #
     # @option params [Integer] :max_results
     #   The maximum number of instances that you want AWS Cloud Map to return
     #   in the response to a `GetInstancesHealthStatus` request. If you don't
@@ -784,6 +1002,8 @@ module Aws::ServiceDiscovery
     #   * {Types::GetInstancesHealthStatusResponse#status #status} => Hash&lt;String,String&gt;
     #   * {Types::GetInstancesHealthStatusResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_instances_health_status({
@@ -849,10 +1069,14 @@ module Aws::ServiceDiscovery
     # the response, such as a `CreateService` request.
     #
     # <note markdown="1"> To get a list of operations that match specified criteria, see
-    # ListOperations.
+    # [ListOperations][1].
     #
     #  </note>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/cloud-map/latest/api/API_ListOperations.html
+    #
     # @option params [required, String] :operation_id
     #   The ID of the operation that you want to get more information about.
     #
@@ -860,6 +1084,29 @@ module Aws::ServiceDiscovery
     #
     #   * {Types::GetOperationResponse#operation #operation} => Types::Operation
     #
+    #
+    # @example Example: Example: Get operation result
+    #
+    #   # Example: Get operation result
+    #
+    #   resp = client.get_operation({
+    #     operation_id: "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     operation: {
+    #       create_date: Time.parse(1587055860.121), 
+    #       id: "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd", 
+    #       status: "SUCCESS", 
+    #       targets: {
+    #         "NAMESPACE" => "ns-ylexjili4cdxy3xm", 
+    #       }, 
+    #       type: "CREATE_NAMESPACE", 
+    #       update_date: Time.parse(1587055900.469), 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_operation({
@@ -955,6 +1202,30 @@ module Aws::ServiceDiscovery
     #   * {Types::ListInstancesResponse#instances #instances} => Array&lt;Types::InstanceSummary&gt;
     #   * {Types::ListInstancesResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    #
+    # @example Example: Example: List service instances
+    #
+    #   # Example: List service instances
+    #
+    #   resp = client.list_instances({
+    #     service_id: "srv-qzpwvt2tfqcegapy", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     instances: [
+    #       {
+    #         attributes: {
+    #           "AWS_INSTANCE_IPV4" => "172.2.1.3", 
+    #           "AWS_INSTANCE_PORT" => "808", 
+    #         }, 
+    #         id: "i-06bdabbae60f65a4e", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_instances({
@@ -1015,6 +1286,67 @@ module Aws::ServiceDiscovery
     #   * {Types::ListNamespacesResponse#namespaces #namespaces} => Array&lt;Types::NamespaceSummary&gt;
     #   * {Types::ListNamespacesResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    #
+    # @example Example: Example: List namespaces
+    #
+    #   # Example: List namespaces
+    #
+    #   resp = client.list_namespaces({
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     namespaces: [
+    #       {
+    #         arn: "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-a3ccy2e7e3a7rile", 
+    #         create_date: Time.parse(1585354387.357), 
+    #         id: "ns-a3ccy2e7e3a7rile", 
+    #         name: "local", 
+    #         properties: {
+    #           dns_properties: {
+    #             hosted_zone_id: "Z06752353VBUDTC32S84S", 
+    #           }, 
+    #           http_properties: {
+    #             http_name: "local", 
+    #           }, 
+    #         }, 
+    #         type: "DNS_PRIVATE", 
+    #       }, 
+    #       {
+    #         arn: "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-pocfyjtrsmwtvcxx", 
+    #         create_date: Time.parse(1586468974.698), 
+    #         description: "My second namespace", 
+    #         id: "ns-pocfyjtrsmwtvcxx", 
+    #         name: "My-second-namespace", 
+    #         properties: {
+    #           dns_properties: {
+    #           }, 
+    #           http_properties: {
+    #             http_name: "My-second-namespace", 
+    #           }, 
+    #         }, 
+    #         type: "HTTP", 
+    #       }, 
+    #       {
+    #         arn: "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-ylexjili4cdxy3xm", 
+    #         create_date: Time.parse(1587055896.798), 
+    #         id: "ns-ylexjili4cdxy3xm", 
+    #         name: "example.com", 
+    #         properties: {
+    #           dns_properties: {
+    #             hosted_zone_id: "Z09983722P0QME1B3KC8I", 
+    #           }, 
+    #           http_properties: {
+    #             http_name: "example.com", 
+    #           }, 
+    #         }, 
+    #         type: "DNS_PRIVATE", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_namespaces({
@@ -1087,6 +1419,8 @@ module Aws::ServiceDiscovery
     #   * {Types::ListOperationsResponse#operations #operations} => Array&lt;Types::OperationSummary&gt;
     #   * {Types::ListOperationsResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_operations({
@@ -1152,6 +1486,37 @@ module Aws::ServiceDiscovery
     #   * {Types::ListServicesResponse#services #services} => Array&lt;Types::ServiceSummary&gt;
     #   * {Types::ListServicesResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    #
+    # @example Example: Example: List services
+    #
+    #   # Example: List services
+    #
+    #   resp = client.list_services({
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     services: [
+    #       {
+    #         arn: "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita", 
+    #         create_date: Time.parse(1587081768.334), 
+    #         dns_config: {
+    #           dns_records: [
+    #             {
+    #               ttl: 60, 
+    #               type: "A", 
+    #             }, 
+    #           ], 
+    #           routing_policy: "MULTIVALUE", 
+    #         }, 
+    #         id: "srv-p5zdwlg5uvvzjita", 
+    #         name: "myservice", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_services({
@@ -1212,7 +1577,7 @@ module Aws::ServiceDiscovery
     # One `RegisterInstance` request must complete before you can submit
     # another request and specify the same service ID and instance ID.
     #
-    # For more information, see CreateService.
+    # For more information, see [CreateService][1].
     #
     # When AWS Cloud Map receives a DNS query for the specified DNS name, it
     # returns the applicable value:
@@ -1227,11 +1592,12 @@ module Aws::ServiceDiscovery
     #
     # For the current limit on the number of instances that you can register
     # using the same namespace and using the same service, see [AWS Cloud
-    # Map Limits][1] in the *AWS Cloud Map Developer Guide*.
+    # Map Limits][2] in the *AWS Cloud Map Developer Guide*.
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/cloud-map/latest/dg/cloud-map-limits.html
+    # [1]: https://docs.aws.amazon.com/cloud-map/latest/api/API_CreateService.html
+    # [2]: https://docs.aws.amazon.com/cloud-map/latest/dg/cloud-map-limits.html
     #
     # @option params [required, String] :service_id
     #   The ID of the service that you want to use for settings for the
@@ -1244,7 +1610,7 @@ module Aws::ServiceDiscovery
     #   * 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.
+    #     information, see [DnsRecord &gt; Type][1].
     #
     #   * You can use this value to update an existing instance.
     #
@@ -1261,6 +1627,10 @@ module Aws::ServiceDiscovery
     #
     #      </note>
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/cloud-map/latest/api/API_DnsRecord.html#cloudmap-Type-DnsRecord-Type
+    #
     # @option params [String] :creator_request_id
     #   A unique string that identifies the request and that allows failed
     #   `RegisterInstance` requests to be retried without the risk of
@@ -1360,8 +1730,8 @@ module Aws::ServiceDiscovery
     #   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.
+    #   This value is required if you specified settings for an SRV record or
+    #   a Route 53 health check when you created the service.
     #
     #   **Custom attributes**
     #
@@ -1371,12 +1741,32 @@ module Aws::ServiceDiscovery
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html
+    #   [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html
     #
     # @return [Types::RegisterInstanceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::RegisterInstanceResponse#operation_id #operation_id} => String
     #
+    #
+    # @example Example: Example: Register Instance
+    #
+    #   # Example: Register Instance
+    #
+    #   resp = client.register_instance({
+    #     attributes: {
+    #       "AWS_INSTANCE_IPV4" => "172.2.1.3", 
+    #       "AWS_INSTANCE_PORT" => "808", 
+    #     }, 
+    #     creator_request_id: "7a48a98a-72e6-4849-bfa7-1a458e030d7b", 
+    #     instance_id: "myservice-53", 
+    #     service_id: "srv-p5zdwlg5uvvzjita", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     operation_id: "4yejorelbukcjzpnr6tlmrghsjwpngf4-k95yg2u7", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.register_instance({
@@ -1410,7 +1800,11 @@ module Aws::ServiceDiscovery
     # to change the status for Route 53 health checks, which you define
     # using `HealthCheckConfig`.
     #
-    # For more information, see HealthCheckCustomConfig.
+    # For more information, see [HealthCheckCustomConfig][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/cloud-map/latest/api/API_HealthCheckCustomConfig.html
     #
     # @option params [required, String] :service_id
     #   The ID of the service that includes the configuration for the custom
@@ -1443,21 +1837,28 @@ module Aws::ServiceDiscovery
 
     # Submits a request to perform the following operations:
     #
-    # * Add or delete `DnsRecords` configurations
-    #
     # * Update the TTL setting for existing `DnsRecords` configurations
     #
     # * Add, update, or delete `HealthCheckConfig` for a specified service
     #
-    # For public and private DNS namespaces, you must specify all
-    # `DnsRecords` configurations (and, optionally, `HealthCheckConfig`)
-    # that you want to appear in the updated service. Any current
-    # configurations that don't appear in an `UpdateService` request are
-    # deleted.
+    #   <note markdown="1"> You can't add, update, or delete a `HealthCheckCustomConfig`
+    #   configuration.
+    #
+    #    </note>
+    #
+    # For public and private DNS namespaces, note the following:
+    #
+    # * If you omit any existing `DnsRecords` or `HealthCheckConfig`
+    #   configurations from an `UpdateService` request, the configurations
+    #   are deleted from the service.
+    #
+    # * If you omit an existing `HealthCheckCustomConfig` configuration from
+    #   an `UpdateService` request, the configuration is not deleted from
+    #   the service.
     #
-    # When you update the TTL setting for a service, AWS Cloud Map also
-    # updates the corresponding settings in all the records and health
-    # checks that were created by using the specified service.
+    # When you update settings for a service, AWS Cloud Map also updates the
+    # corresponding settings in all the records and health checks that were
+    # created by using the specified service.
     #
     # @option params [required, String] :id
     #   The ID of the service that you want to update.
@@ -1517,7 +1918,7 @@ module Aws::ServiceDiscovery
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-servicediscovery'
-      context[:gem_version] = '1.18.0'
+      context[:gem_version] = '1.23.0'
       Seahorse::Client::Request.new(handlers, context)
     end