aws-sdk-servicediscovery 1.23.0 → 1.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 288018fa5ba020f7b997ec7874dba2796ff45d4cff74a7c865ff09e95a3ceeb9
-  data.tar.gz: 4b0b9045aa90813bbf97499dbac3eba9e6017c61d5ab9dd4bdbb67a8d4924fa9
+  metadata.gz: 8cf2b1138af75ced4032c47b5a4a9412e04f576d32de10a746ee42efc79ee182
+  data.tar.gz: 7c3cc6d31621dbe71be1f905e929ad16091208f4fd9350da24d281e1554c336a
 SHA512:
-  metadata.gz: 60d6fc999006b89a816f9d0ffb14050bb45ff61ed4e4e5cf789e89f9a08ccf4a7d59cfdbc209984bee63cc38db7c647e3c65c4c2aa367c838f3d6b2571831608
-  data.tar.gz: d55ed05fe7daa5bc11c97cab0cf269ae2f72810689cebb9a94e5a746940e6112ca754bc77faef95a9c8129cab6d7b0a770d3990a962c809790932b52c60e23de
+  metadata.gz: 5e6b81f4ac2ab800f898df508b8339a5a2ee96bd63eaac533f06b84cdb7fed86a5d972813d5483f7320789e8d8839857c9445b0c04a615ed740203a052194894
+  data.tar.gz: 5421aa11b5168d8592e57f1cae9be0cd806cd86498eada98c77093dcbda15efb10dc398c8edc01b0ab0b90032eff7492d8f53cd4dac46eb3e42f3c6b7919852a

data/lib/aws-sdk-servicediscovery.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -42,9 +44,9 @@ require_relative 'aws-sdk-servicediscovery/customizations'
 #
 # See {Errors} for more information.
 #
-# @service
+# @!group service
 module Aws::ServiceDiscovery
 
-  GEM_VERSION = '1.23.0'
+  GEM_VERSION = '1.28.0'
 
 end

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -24,6 +26,7 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
+require 'aws-sdk-core/plugins/http_checksum.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 
@@ -69,6 +72,7 @@ module Aws::ServiceDiscovery
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
+    add_plugin(Aws::Plugins::HttpChecksum)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
 
@@ -81,13 +85,28 @@ module Aws::ServiceDiscovery
     #     * `Aws::Credentials` - Used for configuring static, non-refreshing
     #       credentials.
     #
+    #     * `Aws::SharedCredentials` - Used for loading static credentials from a
+    #       shared file, such as `~/.aws/config`.
+    #
+    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #
+    #     * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
+    #       assume a role after providing credentials via the web.
+    #
+    #     * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
+    #       access token generated from `aws login`.
+    #
+    #     * `Aws::ProcessCredentials` - Used for loading credentials from a
+    #       process that outputs to stdout.
+    #
     #     * `Aws::InstanceProfileCredentials` - Used for loading credentials
     #       from an EC2 IMDS on an EC2 instance.
     #
-    #     * `Aws::SharedCredentials` - Used for loading credentials from a
-    #       shared file, such as `~/.aws/config`.
+    #     * `Aws::ECSCredentials` - Used for loading credentials from
+    #       instances running in ECS.
     #
-    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #     * `Aws::CognitoIdentityCredentials` - Used for loading credentials
+    #       from the Cognito Identity service.
     #
     #     When `:credentials` are not configured directly, the following
     #     locations will be searched for credentials:
@@ -97,10 +116,10 @@ module Aws::ServiceDiscovery
     #     * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
     #     * `~/.aws/credentials`
     #     * `~/.aws/config`
-    #     * EC2 IMDS instance profile - When used by default, the timeouts are
-    #       very aggressive. Construct and pass an instance of
-    #       `Aws::InstanceProfileCredentails` to enable retries and extended
-    #       timeouts.
+    #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
+    #       are very aggressive. Construct and pass an instance of
+    #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
+    #       enable retries and extended timeouts.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -161,7 +180,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 a valid HTTP(S) URI.
+    #     to test or custom 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
@@ -322,8 +341,8 @@ module Aws::ServiceDiscovery
     # an HTTP namespace can be discovered using a `DiscoverInstances`
     # request but can't be discovered using DNS.
     #
-    # For the current limit on the number of namespaces that you can create
-    # using the same AWS account, see [AWS Cloud Map Limits][1] in the *AWS
+    # For the current quota on the number of namespaces that you can create
+    # using the same AWS account, see [AWS Cloud Map quotas][1] in the *AWS
     # Cloud Map Developer Guide*.
     #
     #
@@ -345,16 +364,44 @@ module Aws::ServiceDiscovery
     # @option params [String] :description
     #   A description for the namespace.
     #
+    # @option params [Array<Types::Tag>] :tags
+    #   The tags to add to the namespace. Each tag consists of a key and an
+    #   optional value, both of which you define. Tag keys can have a maximum
+    #   character length of 128 characters, and tag values can have a maximum
+    #   length of 256 characters.
+    #
     # @return [Types::CreateHttpNamespaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateHttpNamespaceResponse#operation_id #operation_id} => String
     #
+    #
+    # @example Example: CreateHttpNamespace example
+    #
+    #   # This example creates an HTTP namespace.
+    #
+    #   resp = client.create_http_namespace({
+    #     creator_request_id: "example-creator-request-id-0001", 
+    #     description: "Example.com AWS Cloud Map HTTP Namespace", 
+    #     name: "example-http.com", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     operation_id: "httpvoqozuhfet5kzxoxg-a-response-example", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_http_namespace({
     #     name: "NamespaceName", # required
     #     creator_request_id: "ResourceId",
     #     description: "ResourceDescription",
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -374,7 +421,7 @@ module Aws::ServiceDiscovery
     # inside a specified Amazon VPC. The namespace defines your service
     # naming scheme. For example, if you name your namespace `example.com`
     # and name your service `backend`, the resulting DNS name for the
-    # service will be `backend.example.com`. For the current limit on the
+    # service will be `backend.example.com`. For the current quota on the
     # number of namespaces that you can create using the same AWS account,
     # see [AWS Cloud Map Limits][1] in the *AWS Cloud Map Developer Guide*.
     #
@@ -385,7 +432,7 @@ module Aws::ServiceDiscovery
     # @option params [required, String] :name
     #   The name that you want to assign to this namespace. When you create a
     #   private DNS namespace, AWS Cloud Map automatically creates an Amazon
-    #   Route 53 private hosted zone that has the same name as the namespace.
+    #   Route 53 private hosted zone that has the same name as the namespace.
     #
     # @option params [String] :creator_request_id
     #   A unique string that identifies the request and that allows failed
@@ -403,6 +450,12 @@ module Aws::ServiceDiscovery
     #   The ID of the Amazon VPC that you want to associate the namespace
     #   with.
     #
+    # @option params [Array<Types::Tag>] :tags
+    #   The tags to add to the namespace. Each tag consists of a key and an
+    #   optional value, both of which you define. Tag keys can have a maximum
+    #   character length of 128 characters, and tag values can have a maximum
+    #   length of 256 characters.
+    #
     # @return [Types::CreatePrivateDnsNamespaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreatePrivateDnsNamespaceResponse#operation_id #operation_id} => String
@@ -430,6 +483,12 @@ module Aws::ServiceDiscovery
     #     creator_request_id: "ResourceId",
     #     description: "ResourceDescription",
     #     vpc: "ResourceId", # required
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -449,7 +508,7 @@ module Aws::ServiceDiscovery
     # internet. The namespace defines your service naming scheme. For
     # example, if you name your namespace `example.com` and name your
     # service `backend`, the resulting DNS name for the service will be
-    # `backend.example.com`. For the current limit on the number of
+    # `backend.example.com`. For the current quota on the number of
     # namespaces that you can create using the same AWS account, see [AWS
     # Cloud Map Limits][1] in the *AWS Cloud Map Developer Guide*.
     #
@@ -472,16 +531,44 @@ module Aws::ServiceDiscovery
     # @option params [String] :description
     #   A description for the namespace.
     #
+    # @option params [Array<Types::Tag>] :tags
+    #   The tags to add to the namespace. Each tag consists of a key and an
+    #   optional value, both of which you define. Tag keys can have a maximum
+    #   character length of 128 characters, and tag values can have a maximum
+    #   length of 256 characters.
+    #
     # @return [Types::CreatePublicDnsNamespaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreatePublicDnsNamespaceResponse#operation_id #operation_id} => String
     #
+    #
+    # @example Example: CreatePublicDnsNamespace example
+    #
+    #   # This example creates a public namespace based on DNS.
+    #
+    #   resp = client.create_public_dns_namespace({
+    #     creator_request_id: "example-creator-request-id-0003", 
+    #     description: "Example.com AWS Cloud Map Public DNS Namespace", 
+    #     name: "example-public-dns.com", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     operation_id: "dns2voqozuhfet5kzxoxg-a-response-example", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_public_dns_namespace({
     #     name: "NamespaceName", # required
     #     creator_request_id: "ResourceId",
     #     description: "ResourceDescription",
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -501,17 +588,17 @@ module Aws::ServiceDiscovery
     # entities:
     #
     # * For public and private DNS namespaces, one of the following
-    #   combinations of DNS records in Amazon Route 53:
+    #   combinations of DNS records in Amazon Route 53:
     #
-    #   * A
+    #   * `A`
     #
-    #   * AAAA
+    #   * `AAAA`
     #
-    #   * A and AAAA
+    #   * `A` and `AAAA`
     #
-    #   * SRV
+    #   * `SRV`
     #
-    #   * CNAME
+    #   * `CNAME`
     #
     # * Optionally, a health check
     #
@@ -519,7 +606,7 @@ module Aws::ServiceDiscovery
     # 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
+    # For the current quota on the number of instances that you can register
     # using the same namespace and using the same service, see [AWS Cloud
     # Map Limits][2] in the *AWS Cloud Map Developer Guide*.
     #
@@ -531,17 +618,17 @@ module Aws::ServiceDiscovery
     # @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`\:
+    #   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:
+    #   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`
     #
@@ -565,15 +652,15 @@ module Aws::ServiceDiscovery
     #   A description for the service.
     #
     # @option params [Types::DnsConfig] :dns_config
-    #   A complex type that contains information about the Amazon Route 53
+    #   A complex type that contains information about the Amazon Route 53
     #   records that you want AWS Cloud Map to create when you register an
     #   instance.
     #
     # @option params [Types::HealthCheckConfig] :health_check_config
     #   *Public DNS and HTTP namespaces only.* A complex type that contains
-    #   settings for an optional Route 53 health check. If you specify
+    #   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`.
+    #   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.
@@ -595,6 +682,12 @@ module Aws::ServiceDiscovery
     #   You can't add, update, or delete a `HealthCheckCustomConfig`
     #   configuration from an existing service.
     #
+    # @option params [Array<Types::Tag>] :tags
+    #   The tags to add to the service. Each tag consists of a key and an
+    #   optional value, both of which you define. Tag keys can have a maximum
+    #   character length of 128 characters, and tag values can have a maximum
+    #   length of 256 characters.
+    #
     # @return [Types::CreateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateServiceResponse#service #service} => Types::Service
@@ -667,6 +760,12 @@ module Aws::ServiceDiscovery
     #     health_check_custom_config: {
     #       failure_threshold: 1,
     #     },
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -777,7 +876,7 @@ module Aws::ServiceDiscovery
       req.send_request(options)
     end
 
-    # Deletes the Amazon Route 53 DNS records and health check, if any, that
+    # Deletes the Amazon Route 53 DNS records and health check, if any, that
     # AWS Cloud Map created for the specified instance.
     #
     # @option params [required, String] :service_id
@@ -933,6 +1032,30 @@ module Aws::ServiceDiscovery
     #
     #   * {Types::GetInstanceResponse#instance #instance} => Types::Instance
     #
+    #
+    # @example Example: GetInstance example
+    #
+    #   # This example gets information about a specified instance.
+    #
+    #   resp = client.get_instance({
+    #     instance_id: "i-abcd1234", 
+    #     service_id: "srv-e4anhexample0004", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     instance: {
+    #       attributes: {
+    #         "AWS_INSTANCE_IPV4" => "192.0.2.44", 
+    #         "AWS_INSTANCE_PORT" => "80", 
+    #         "color" => "green", 
+    #         "region" => "us-west-2", 
+    #         "stage" => "beta", 
+    #       }, 
+    #       id: "i-abcd1234", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_instance({
@@ -1004,6 +1127,23 @@ module Aws::ServiceDiscovery
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
+    #
+    # @example Example: GetInstancesHealthStatus example
+    #
+    #   # This example gets the current health status of one or more instances that are associate with a specified service.
+    #
+    #   resp = client.get_instances_health_status({
+    #     service_id: "srv-e4anhexample0004", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     status: {
+    #       "i-abcd1234" => "HEALTHY", 
+    #       "i-abcd1235" => "UNHEALTHY", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_instances_health_status({
@@ -1037,6 +1177,35 @@ module Aws::ServiceDiscovery
     #
     #   * {Types::GetNamespaceResponse#namespace #namespace} => Types::Namespace
     #
+    #
+    # @example Example: GetNamespace example
+    #
+    #   # This example gets information about a specified namespace.
+    #
+    #   resp = client.get_namespace({
+    #     id: "ns-e4anhexample0004", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     namespace: {
+    #       arn: "arn:aws:servicediscovery:us-west-2: 123456789120:namespace/ns-e1tpmexample0001", 
+    #       create_date: Time.parse("20181118T211712Z"), 
+    #       creator_request_id: "example-creator-request-id-0001", 
+    #       description: "Example.com AWS Cloud Map HTTP Namespace", 
+    #       id: "ns-e1tpmexample0001", 
+    #       name: "example-http.com", 
+    #       properties: {
+    #         dns_properties: {
+    #         }, 
+    #         http_properties: {
+    #           http_name: "example-http.com", 
+    #         }, 
+    #       }, 
+    #       type: "HTTP", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_namespace({
@@ -1143,6 +1312,33 @@ module Aws::ServiceDiscovery
     #
     #   * {Types::GetServiceResponse#service #service} => Types::Service
     #
+    #
+    # @example Example: GetService Example
+    #
+    #   # This example gets the settings for a specified service.
+    #
+    #   resp = client.get_service({
+    #     id: "srv-e4anhexample0004", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     service: {
+    #       arn: "arn:aws:servicediscovery:us-west-2:123456789120:service/srv-e4anhexample0004", 
+    #       create_date: Time.parse("20181118T211707Z"), 
+    #       creator_request_id: "example-creator-request-id-0004", 
+    #       description: "Example.com AWS Cloud Map HTTP Service", 
+    #       health_check_config: {
+    #         failure_threshold: 3, 
+    #         resource_path: "/", 
+    #         type: "HTTPS", 
+    #       }, 
+    #       id: "srv-e4anhexample0004", 
+    #       name: "example-http-service", 
+    #       namespace_id: "ns-e4anhexample0004", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_service({
@@ -1421,6 +1617,42 @@ module Aws::ServiceDiscovery
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
+    #
+    # @example Example: ListOperations Example
+    #
+    #   # This example gets the operations that have a STATUS of either PENDING or SUCCESS.
+    #
+    #   resp = client.list_operations({
+    #     filters: [
+    #       {
+    #         condition: "IN", 
+    #         name: "STATUS", 
+    #         values: [
+    #           "PENDING", 
+    #           "SUCCESS", 
+    #         ], 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     operations: [
+    #       {
+    #         id: "76yy8ovhpdz0plmjzbsnqgnrqvpv2qdt-kexample", 
+    #         status: "SUCCESS", 
+    #       }, 
+    #       {
+    #         id: "prysnyzpji3u2ciy45nke83x2zanl7yk-dexample", 
+    #         status: "SUCCESS", 
+    #       }, 
+    #       {
+    #         id: "ko4ekftir7kzlbechsh7xvcdgcpk66gh-7example", 
+    #         status: "PENDING", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_operations({
@@ -1560,6 +1792,60 @@ module Aws::ServiceDiscovery
       req.send_request(options)
     end
 
+    # Lists tags for the specified resource.
+    #
+    # @option params [required, String] :resource_arn
+    #   The Amazon Resource Name (ARN) of the resource that you want to
+    #   retrieve tags for.
+    #
+    # @return [Types::ListTagsForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListTagsForResourceResponse#tags #tags} => Array&lt;Types::Tag&gt;
+    #
+    #
+    # @example Example: ListTagsForResource example
+    #
+    #   # This example lists the tags of a resource.
+    #
+    #   resp = client.list_tags_for_resource({
+    #     resource_arn: "arn:aws:servicediscovery:us-east-1:123456789012:namespace/ns-ylexjili4cdxy3xm", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     tags: [
+    #       {
+    #         key: "Project", 
+    #         value: "Zeta", 
+    #       }, 
+    #       {
+    #         key: "Department", 
+    #         value: "Engineering", 
+    #       }, 
+    #     ], 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_tags_for_resource({
+    #     resource_arn: "AmazonResourceName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.tags #=> Array
+    #   resp.tags[0].key #=> String
+    #   resp.tags[0].value #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/ListTagsForResource AWS API Documentation
+    #
+    # @overload list_tags_for_resource(params = {})
+    # @param [Hash] params ({})
+    def list_tags_for_resource(params = {}, options = {})
+      req = build_request(:list_tags_for_resource, params)
+      req.send_request(options)
+    end
+
     # Creates or updates one or more records and, optionally, creates a
     # health check based on the settings in a specified service. When you
     # submit a `RegisterInstance` request, the following occurs:
@@ -1590,7 +1876,7 @@ module Aws::ServiceDiscovery
     # * **If you didn't specify a health check configuration**\: returns
     #   all the records
     #
-    # For the current limit on the number of instances that you can register
+    # For the current quota on the number of instances that you can register
     # using the same namespace and using the same service, see [AWS Cloud
     # Map Limits][2] in the *AWS Cloud Map Developer Guide*.
     #
@@ -1608,8 +1894,8 @@ module Aws::ServiceDiscovery
     #   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
+    #     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 &gt; Type][1].
     #
     #   * You can use this value to update an existing instance.
@@ -1656,33 +1942,41 @@ module Aws::ServiceDiscovery
     #
     #   **AWS\_ALIAS\_DNS\_NAME**
     #
-    #   ****
-    #
-    #   If you want AWS Cloud Map to create an Amazon Route 53 alias record
+    #   If you want AWS Cloud Map to create an Amazon Route 53 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] in the *Route 53 API Reference*.
+    #   topic [AliasTarget][1] in the *Route 53 API Reference*.
     #
     #   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.
+    #     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, AWS Cloud Map will create the Route 53
+    #     `HealthCheckConfig` settings, AWS Cloud Map will create the Route 53
     #     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.
+    #     route traffic to AWS resources other than Elastic Load Balancing
+    #     load balancers.
     #
     #   * If you specify a value for `AWS_ALIAS_DNS_NAME`, don't specify
     #     values for any of the `AWS_INSTANCE` attributes.
     #
+    #   **AWS\_EC2\_INSTANCE\_ID**
+    #
+    #   *HTTP namespaces only.* The Amazon EC2 instance ID for the instance.
+    #   If the `AWS_EC2_INSTANCE_ID` attribute is specified, then the only
+    #   other attribute that can be specified is `AWS_INIT_HEALTH_STATUS`.
+    #   When the `AWS_EC2_INSTANCE_ID` attribute is specified, then the
+    #   `AWS_INSTANCE_IPV4` attribute will be filled out with the primary
+    #   private IPv4 address.
+    #
     #   **AWS\_INIT\_HEALTH\_STATUS**
     #
     #   If the service configuration includes `HealthCheckCustomConfig`, you
@@ -1693,51 +1987,53 @@ module Aws::ServiceDiscovery
     #
     #   **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
+    #   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.
+    #   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
+    #   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. If the service includes settings
-    #   for an SRV record, you must specify a value for `AWS_INSTANCE_IPV4`,
+    #   includes settings for an `A` record. If the service includes settings
+    #   for an `SRV` record, you must specify a value for `AWS_INSTANCE_IPV4`,
     #   `AWS_INSTANCE_IPV6`, or both.
     #
     #   **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`.
+    #   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. If the service includes settings
-    #   for an SRV record, you must specify a value for `AWS_INSTANCE_IPV4`,
-    #   `AWS_INSTANCE_IPV6`, or both.
+    #   includes settings for an `AAAA` record. If the service includes
+    #   settings for an `SRV` record, you must specify a value for
+    #   `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
     #
     #   **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 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.
+    #   that you want Route 53 to send requests to.
     #
-    #   This value is required if you specified settings for an SRV record or
-    #   a Route 53 health check 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**
     #
     #   You can add up to 30 custom attributes. For each key-value pair, the
     #   maximum length of the attribute name is 255 characters, and the
-    #   maximum length of the attribute value is 1,024 characters.
+    #   maximum length of the attribute value is 1,024 characters. The total
+    #   size of all provided attributes (sum of all keys and values) must not
+    #   exceed 5,000 characters.
     #
     #
     #
@@ -1791,13 +2087,114 @@ module Aws::ServiceDiscovery
       req.send_request(options)
     end
 
+    # Adds one or more tags to the specified resource.
+    #
+    # @option params [required, String] :resource_arn
+    #   The Amazon Resource Name (ARN) of the resource that you want to
+    #   retrieve tags for.
+    #
+    # @option params [required, Array<Types::Tag>] :tags
+    #   The tags to add to the specified resource. Specifying the tag key is
+    #   required. You can set the value of a tag to an empty string, but you
+    #   can't set the value of a tag to null.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    #
+    # @example Example: TagResource example
+    #
+    #   # This example adds "Department" and "Project" tags to a resource.
+    #
+    #   resp = client.tag_resource({
+    #     resource_arn: "arn:aws:servicediscovery:us-east-1:123456789012:namespace/ns-ylexjili4cdxy3xm", 
+    #     tags: [
+    #       {
+    #         key: "Department", 
+    #         value: "Engineering", 
+    #       }, 
+    #       {
+    #         key: "Project", 
+    #         value: "Zeta", 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.tag_resource({
+    #     resource_arn: "AmazonResourceName", # required
+    #     tags: [ # required
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
+    #       },
+    #     ],
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/TagResource AWS API Documentation
+    #
+    # @overload tag_resource(params = {})
+    # @param [Hash] params ({})
+    def tag_resource(params = {}, options = {})
+      req = build_request(:tag_resource, params)
+      req.send_request(options)
+    end
+
+    # Removes one or more tags from the specified resource.
+    #
+    # @option params [required, String] :resource_arn
+    #   The Amazon Resource Name (ARN) of the resource that you want to
+    #   retrieve tags for.
+    #
+    # @option params [required, Array<String>] :tag_keys
+    #   The tag keys to remove from the specified resource.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    #
+    # @example Example: UntagResource example
+    #
+    #   # This example removes the "Department" and "Project" tags from a resource.
+    #
+    #   resp = client.untag_resource({
+    #     resource_arn: "arn:aws:servicediscovery:us-east-1:123456789012:namespace/ns-ylexjili4cdxy3xm", 
+    #     tag_keys: [
+    #       "Project", 
+    #       "Department", 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.untag_resource({
+    #     resource_arn: "AmazonResourceName", # required
+    #     tag_keys: ["TagKey"], # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/UntagResource AWS API Documentation
+    #
+    # @overload untag_resource(params = {})
+    # @param [Hash] params ({})
+    def untag_resource(params = {}, options = {})
+      req = build_request(:untag_resource, params)
+      req.send_request(options)
+    end
+
     # Submits a request to change the health status of a custom health check
     # to healthy or unhealthy.
     #
     # You can use `UpdateInstanceCustomHealthStatus` to change the status
     # only for custom health checks, which you define using
     # `HealthCheckCustomConfig` when you create a service. You can't use it
-    # to change the status for Route 53 health checks, which you define
+    # to change the status for Route 53 health checks, which you define
     # using `HealthCheckConfig`.
     #
     # For more information, see [HealthCheckCustomConfig][1].
@@ -1818,6 +2215,18 @@ module Aws::ServiceDiscovery
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: UpdateInstanceCustomHealthStatus Example
+    #
+    #   # This example submits a request to change the health status of an instance associated with a service with a custom health
+    #   # check to HEALTHY.
+    #
+    #   resp = client.update_instance_custom_health_status({
+    #     instance_id: "i-abcd1234", 
+    #     service_id: "srv-e4anhexample0004", 
+    #     status: "HEALTHY", 
+    #   })
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_instance_custom_health_status({
@@ -1870,13 +2279,42 @@ module Aws::ServiceDiscovery
     #
     #   * {Types::UpdateServiceResponse#operation_id #operation_id} => String
     #
+    #
+    # @example Example: UpdateService Example
+    #
+    #   # This example submits a request to replace the DnsConfig and HealthCheckConfig settings of a specified service.
+    #
+    #   resp = client.update_service({
+    #     id: "srv-e4anhexample0004", 
+    #     service: {
+    #       dns_config: {
+    #         dns_records: [
+    #           {
+    #             ttl: 60, 
+    #             type: "A", 
+    #           }, 
+    #         ], 
+    #       }, 
+    #       health_check_config: {
+    #         failure_threshold: 2, 
+    #         resource_path: "/", 
+    #         type: "HTTP", 
+    #       }, 
+    #     }, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     operation_id: "m35hsdrkxwjffm3xef4bxyy6vc3ewakx-jdn3y5g5", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_service({
     #     id: "ResourceId", # required
     #     service: { # required
     #       description: "ResourceDescription",
-    #       dns_config: { # required
+    #       dns_config: {
     #         dns_records: [ # required
     #           {
     #             type: "SRV", # required, accepts SRV, A, AAAA, CNAME
@@ -1918,7 +2356,7 @@ module Aws::ServiceDiscovery
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-servicediscovery'
-      context[:gem_version] = '1.23.0'
+      context[:gem_version] = '1.28.0'
       Seahorse::Client::Request.new(handlers, context)
     end