aws-sdk-servicediscovery 1.57.0 → 1.58.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: edc9e6808f3dac85b737774a08e261baf09de62d85ef3874dc0dcef3bdf270ba
-  data.tar.gz: 37b6716d308f5ca9704cfcf83eac6d2804aa57af7941291e0556e89ec8f4531f
+  metadata.gz: ae1d1594837bbff76d7c677c28bd18939beb0f522d9d21b14931ad93a152148c
+  data.tar.gz: 43303667288d9c438d008e81e3e6eddbdd1ea00705714198f6c9b28f3eb0b3ae
 SHA512:
-  metadata.gz: 17254c33244af0b48ccd620a294cc88c5af47ee63d355f3bcff9a15fc7300519b8b7fb8ac93c336fe463eda398c94e75222b4d53da829f1faf019433ae6f501e
-  data.tar.gz: 957e714bbdad6cb4bae33fa8fe582fd2cde228dd7149e40df8c5356836c5a7681540110c6e85a259b52b182ec7953ceaac6ebe4ef788d7b6b5b47b8484c735d3
+  metadata.gz: 56fbd130d1f165b0e2f96a85f0d1238e1ea3865254b46f332de28b1aae5acae1007b820177fa8d9fd25718947c7c569f52056a035a10476661950ee077e755d4
+  data.tar.gz: eef8fa8b4f77363601a3cbdcd6264ba9026e62cf356e7ca29908df0d8a6471070a918d5f0989ef8852d42b516b65a1f79023f21b11c2ef4f1aa3e976857f1fef

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.58.0 (2023-09-20)
+------------------
+
+* Feature - Adds a new DiscoverInstancesRevision API and also adds InstanceRevision field to the DiscoverInstances API response.
+
 1.57.0 (2023-09-19)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.57.0
+1.58.0

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

@@ -1044,8 +1044,10 @@ module Aws::ServiceDiscovery
 
     # 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.
+    # namespace. `DiscoverInstances` returns a randomized list of instances
+    # allowing customers to distribute traffic evenly across instances. For
+    # public and private DNS namespaces, you can also use DNS queries to
+    # discover instances.
     #
     # @option params [required, String] :namespace_name
     #   The `HttpName` name of the namespace. It's found in the
@@ -1099,6 +1101,7 @@ module Aws::ServiceDiscovery
     # @return [Types::DiscoverInstancesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DiscoverInstancesResponse#instances #instances} => Array<Types::HttpInstanceSummary>
+    #   * {Types::DiscoverInstancesResponse#instances_revision #instances_revision} => Integer
     #
     #
     # @example Example: Example: Discover registered instances
@@ -1152,6 +1155,7 @@ module Aws::ServiceDiscovery
     #   resp.instances[0].health_status #=> String, one of "HEALTHY", "UNHEALTHY", "UNKNOWN"
     #   resp.instances[0].attributes #=> Hash
     #   resp.instances[0].attributes["AttrKey"] #=> String
+    #   resp.instances_revision #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/DiscoverInstances AWS API Documentation
     #
@@ -1162,6 +1166,40 @@ module Aws::ServiceDiscovery
       req.send_request(options)
     end
 
+    # Discovers the increasing revision associated with an instance.
+    #
+    # @option params [required, String] :namespace_name
+    #   The `HttpName` name of the namespace. It's found in the
+    #   `HttpProperties` member of the `Properties` member of the namespace.
+    #
+    # @option params [required, String] :service_name
+    #   The name of the service that you specified when you registered the
+    #   instance.
+    #
+    # @return [Types::DiscoverInstancesRevisionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DiscoverInstancesRevisionResponse#instances_revision #instances_revision} => Integer
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.discover_instances_revision({
+    #     namespace_name: "NamespaceName", # required
+    #     service_name: "ServiceName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.instances_revision #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/DiscoverInstancesRevision AWS API Documentation
+    #
+    # @overload discover_instances_revision(params = {})
+    # @param [Hash] params ({})
+    def discover_instances_revision(params = {}, options = {})
+      req = build_request(:discover_instances_revision, params)
+      req.send_request(options)
+    end
+
     # Gets information about a specified instance.
     #
     # @option params [required, String] :service_id
@@ -1378,7 +1416,7 @@ module Aws::ServiceDiscovery
     end
 
     # Gets information about any operation that returns an operation ID in
-    # the response, such as a `CreateService` request.
+    # the response, such as a `CreateHttpNamespace` request.
     #
     # <note markdown="1"> To get a list of operations that match specified criteria, see
     # [ListOperations][1].
@@ -2120,7 +2158,7 @@ module Aws::ServiceDiscovery
     #       health check, but it doesn't associate the health check with the
     #       alias record.
     #
-    #     * Auto naming currently doesn't support creating alias records that
+    #     * Cloud Map currently doesn't support creating alias records that
     #       route traffic to Amazon Web Services resources other than Elastic
     #       Load Balancing load balancers.
     #
@@ -2661,7 +2699,7 @@ module Aws::ServiceDiscovery
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-servicediscovery'
-      context[:gem_version] = '1.57.0'
+      context[:gem_version] = '1.58.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -37,6 +37,8 @@ module Aws::ServiceDiscovery
     DeregisterInstanceResponse = Shapes::StructureShape.new(name: 'DeregisterInstanceResponse')
     DiscoverInstancesRequest = Shapes::StructureShape.new(name: 'DiscoverInstancesRequest')
     DiscoverInstancesResponse = Shapes::StructureShape.new(name: 'DiscoverInstancesResponse')
+    DiscoverInstancesRevisionRequest = Shapes::StructureShape.new(name: 'DiscoverInstancesRevisionRequest')
+    DiscoverInstancesRevisionResponse = Shapes::StructureShape.new(name: 'DiscoverInstancesRevisionResponse')
     DiscoverMaxResults = Shapes::IntegerShape.new(name: 'DiscoverMaxResults')
     DnsConfig = Shapes::StructureShape.new(name: 'DnsConfig')
     DnsConfigChange = Shapes::StructureShape.new(name: 'DnsConfigChange')
@@ -137,6 +139,7 @@ module Aws::ServiceDiscovery
     ResourceLimitExceeded = Shapes::StructureShape.new(name: 'ResourceLimitExceeded')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     ResourcePath = Shapes::StringShape.new(name: 'ResourcePath')
+    Revision = Shapes::IntegerShape.new(name: 'Revision')
     RoutingPolicy = Shapes::StringShape.new(name: 'RoutingPolicy')
     SOA = Shapes::StructureShape.new(name: 'SOA')
     SOAChange = Shapes::StructureShape.new(name: 'SOAChange')
@@ -250,8 +253,16 @@ module Aws::ServiceDiscovery
     DiscoverInstancesRequest.struct_class = Types::DiscoverInstancesRequest
 
     DiscoverInstancesResponse.add_member(:instances, Shapes::ShapeRef.new(shape: HttpInstanceSummaryList, location_name: "Instances"))
+    DiscoverInstancesResponse.add_member(:instances_revision, Shapes::ShapeRef.new(shape: Revision, location_name: "InstancesRevision"))
     DiscoverInstancesResponse.struct_class = Types::DiscoverInstancesResponse
 
+    DiscoverInstancesRevisionRequest.add_member(:namespace_name, Shapes::ShapeRef.new(shape: NamespaceName, required: true, location_name: "NamespaceName"))
+    DiscoverInstancesRevisionRequest.add_member(:service_name, Shapes::ShapeRef.new(shape: ServiceName, required: true, location_name: "ServiceName"))
+    DiscoverInstancesRevisionRequest.struct_class = Types::DiscoverInstancesRevisionRequest
+
+    DiscoverInstancesRevisionResponse.add_member(:instances_revision, Shapes::ShapeRef.new(shape: Revision, location_name: "InstancesRevision"))
+    DiscoverInstancesRevisionResponse.struct_class = Types::DiscoverInstancesRevisionResponse
+
     DnsConfig.add_member(:namespace_id, Shapes::ShapeRef.new(shape: ResourceId, deprecated: true, location_name: "NamespaceId", metadata: {"deprecatedMessage"=>"Top level attribute in request should be used to reference namespace-id"}))
     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"))
@@ -758,6 +769,21 @@ module Aws::ServiceDiscovery
         o.errors << Shapes::ShapeRef.new(shape: RequestLimitExceeded)
       end)
 
+      api.add_operation(:discover_instances_revision, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DiscoverInstancesRevision"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.endpoint_pattern = {
+          "hostPrefix" => "data-",
+        }
+        o.input = Shapes::ShapeRef.new(shape: DiscoverInstancesRevisionRequest)
+        o.output = Shapes::ShapeRef.new(shape: DiscoverInstancesRevisionResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceNotFound)
+        o.errors << Shapes::ShapeRef.new(shape: NamespaceNotFound)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidInput)
+        o.errors << Shapes::ShapeRef.new(shape: RequestLimitExceeded)
+      end)
+
       api.add_operation(:get_instance, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetInstance"
         o.http_method = "POST"

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

@@ -124,6 +124,20 @@ module Aws::ServiceDiscovery
       end
     end
 
+    class DiscoverInstancesRevision
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::ServiceDiscovery::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class GetInstance
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-servicediscovery/plugins/endpoints.rb

@@ -72,6 +72,8 @@ module Aws::ServiceDiscovery
             Aws::ServiceDiscovery::Endpoints::DeregisterInstance.build(context)
           when :discover_instances
             Aws::ServiceDiscovery::Endpoints::DiscoverInstances.build(context)
+          when :discover_instances_revision
+            Aws::ServiceDiscovery::Endpoints::DiscoverInstancesRevision.build(context)
           when :get_instance
             Aws::ServiceDiscovery::Endpoints::GetInstance.build(context)
           when :get_instances_health_status

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

@@ -501,10 +501,52 @@ module Aws::ServiceDiscovery
     #   registered instance.
     #   @return [Array<Types::HttpInstanceSummary>]
     #
+    # @!attribute [rw] instances_revision
+    #   The increasing revision associated to the response Instances list.
+    #   If a new instance is registered or deregistered, the
+    #   `InstancesRevision` updates. The health status updates don't update
+    #   `InstancesRevision`.
+    #   @return [Integer]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/DiscoverInstancesResponse AWS API Documentation
     #
     class DiscoverInstancesResponse < Struct.new(
-      :instances)
+      :instances,
+      :instances_revision)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] namespace_name
+    #   The `HttpName` name of the namespace. It's found in the
+    #   `HttpProperties` member of the `Properties` member of the namespace.
+    #   @return [String]
+    #
+    # @!attribute [rw] service_name
+    #   The name of the service that you specified when you registered the
+    #   instance.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/DiscoverInstancesRevisionRequest AWS API Documentation
+    #
+    class DiscoverInstancesRevisionRequest < Struct.new(
+      :namespace_name,
+      :service_name)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] instances_revision
+    #   The increasing revision associated to the response Instances list.
+    #   If a new instance is registered or deregistered, the
+    #   `InstancesRevision` updates. The health status updates don't update
+    #   `InstancesRevision`.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/DiscoverInstancesRevisionResponse AWS API Documentation
+    #
+    class DiscoverInstancesRevisionResponse < Struct.new(
+      :instances_revision)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2494,8 +2536,8 @@ module Aws::ServiceDiscovery
     #       health check, but it doesn't associate the health check with
     #       the alias record.
     #
-    #     * Auto naming currently doesn't support creating alias records
-    #       that route traffic to Amazon Web Services resources other than
+    #     * Cloud Map currently doesn't support creating alias records that
+    #       route traffic to Amazon Web Services resources other than
     #       Elastic Load Balancing load balancers.
     #
     #     * If you specify a value for `AWS_ALIAS_DNS_NAME`, don't specify

data/lib/aws-sdk-servicediscovery.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-servicediscovery/customizations'
 # @!group service
 module Aws::ServiceDiscovery
 
-  GEM_VERSION = '1.57.0'
+  GEM_VERSION = '1.58.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-servicediscovery
 version: !ruby/object:Gem::Version
-  version: 1.57.0
+  version: 1.58.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-19 00:00:00.000000000 Z
+date: 2023-09-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core