aws-sdk-comprehend 1.27.0 → 1.32.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 8af6730466ffa724762d57c8da0bfffa77d80ead
-  data.tar.gz: c799744b9ea369f2c288d9907181f608179f22b1
+SHA256:
+  metadata.gz: 88507252bd7d574910b1fb93e096de5243d0418ef747eaf004c3a5b5b09f51a0
+  data.tar.gz: 575459559b1e04b95ed9dab7006453d76d53b54096a531b6f04f3186da9209b9
 SHA512:
-  metadata.gz: 9b4b04cdcc1f2d8733688afd98b159eb1d3d263aca3c8adefe93f5dae1a5c0b87c8479e498928b1cdd1ebd2a13a47716c2954b62b85115250ba1ac0d39b6fd3c
-  data.tar.gz: 3e565534e4d90f0a33f599f758404f3264a84c74216a98d536eccb1c9db2db5c4040d993521ea439988d448da52c6788cd4c30161c1395e696204f0d920d808d
+  metadata.gz: 0bf8ae20c3106a01c223a5c0947092671101376377ee1b5e0d485ea1114fb20ca7e15ac87009eadd6336629b38e2610dad13ba30cb0b69ae8c672b4da7dabf70
+  data.tar.gz: 780ecb883b5463082f98b2a0544478ed541d5409888b281e576f5b16ef03cc19f251be06412f21527b8be9d754c9d47eb6160661f3dfab420d97cfd6541f7546

data/lib/aws-sdk-comprehend.rb

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

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

@@ -30,6 +30,18 @@ require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 Aws::Plugins::GlobalConfiguration.add_identifier(:comprehend)
 
 module Aws::Comprehend
+  # An API client for Comprehend.  To construct a client, you need to configure a `:region` and `:credentials`.
+  #
+  #     client = Aws::Comprehend::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::Comprehend
     #   @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::Comprehend
     #     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::Comprehend
     #     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::Comprehend
     #   @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::Comprehend
     #     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::Comprehend
     #     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::Comprehend
     #     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::Comprehend
     #     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::Comprehend
     #     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`.
@@ -321,9 +375,8 @@ module Aws::Comprehend
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
-    #   primary languages supported by Amazon Comprehend: German ("de"),
-    #   English ("en"), Spanish ("es"), French ("fr"), Italian ("it"),
-    #   or Portuguese ("pt"). All documents must be in the same language.
+    #   primary languages supported by Amazon Comprehend. All documents must
+    #   be in the same language.
     #
     # @return [Types::BatchDetectEntitiesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -370,9 +423,8 @@ module Aws::Comprehend
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
-    #   primary languages supported by Amazon Comprehend: German ("de"),
-    #   English ("en"), Spanish ("es"), French ("fr"), Italian ("it"),
-    #   or Portuguese ("pt"). All documents must be in the same language.
+    #   primary languages supported by Amazon Comprehend. All documents must
+    #   be in the same language.
     #
     # @return [Types::BatchDetectKeyPhrasesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -420,9 +472,8 @@ module Aws::Comprehend
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
-    #   primary languages supported by Amazon Comprehend: German ("de"),
-    #   English ("en"), Spanish ("es"), French ("fr"), Italian ("it"),
-    #   or Portuguese ("pt"). All documents must be in the same language.
+    #   primary languages supported by Amazon Comprehend. All documents must
+    #   be in the same language.
     #
     # @return [Types::BatchDetectSentimentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -470,7 +521,7 @@ module Aws::Comprehend
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
-    #   primary languages supported by Amazon Comprehend: German ("de"),
+    #   following languages supported by Amazon Comprehend: German ("de"),
     #   English ("en"), Spanish ("es"), French ("fr"), Italian ("it"),
     #   or Portuguese ("pt"). All documents must be in the same language.
     #
@@ -511,6 +562,46 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Creates a new document classification request to analyze a single
+    # document in real-time, using a previously created and trained custom
+    # model and an endpoint.
+    #
+    # @option params [required, String] :text
+    #   The document text to be analyzed.
+    #
+    # @option params [required, String] :endpoint_arn
+    #   The Amazon Resource Number (ARN) of the endpoint.
+    #
+    # @return [Types::ClassifyDocumentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ClassifyDocumentResponse#classes #classes} => Array&lt;Types::DocumentClass&gt;
+    #   * {Types::ClassifyDocumentResponse#labels #labels} => Array&lt;Types::DocumentLabel&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.classify_document({
+    #     text: "String", # required
+    #     endpoint_arn: "DocumentClassifierEndpointArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.classes #=> Array
+    #   resp.classes[0].name #=> String
+    #   resp.classes[0].score #=> Float
+    #   resp.labels #=> Array
+    #   resp.labels[0].name #=> String
+    #   resp.labels[0].score #=> Float
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/ClassifyDocument AWS API Documentation
+    #
+    # @overload classify_document(params = {})
+    # @param [Hash] params ({})
+    def classify_document(params = {}, options = {})
+      req = build_request(:classify_document, params)
+      req.send_request(options)
+    end
+
     # Creates a new document classifier that you can use to categorize
     # documents. To create a classifier you provide a set of training
     # documents that labeled with the categories that you want to use. After
@@ -548,7 +639,7 @@ module Aws::Comprehend
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
-    #   primary languages supported by Amazon Comprehend: German ("de"),
+    #   following languages supported by Amazon Comprehend: German ("de"),
     #   English ("en"), Spanish ("es"), French ("fr"), Italian ("it"),
     #   or Portuguese ("pt"). All documents must be in the same language.
     #
@@ -572,6 +663,14 @@ module Aws::Comprehend
     #
     #   [1]: https://docs.aws.amazon.com/vpc/latest/userguide/what-is-amazon-vpc.html
     #
+    # @option params [String] :mode
+    #   Indicates the mode in which the classifier will be trained. The
+    #   classifier can be trained in multi-class mode, which identifies one
+    #   and only one class for each document, or multi-label mode, which
+    #   identifies one or more labels for each document. In multi-label mode,
+    #   multiple labels for an individual document are separated by a
+    #   delimiter. The default delimiter between labels is a pipe (\|).
+    #
     # @return [Types::CreateDocumentClassifierResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateDocumentClassifierResponse#document_classifier_arn #document_classifier_arn} => String
@@ -589,6 +688,7 @@ module Aws::Comprehend
     #     ],
     #     input_data_config: { # required
     #       s3_uri: "S3Uri", # required
+    #       label_delimiter: "LabelDelimiter",
     #     },
     #     output_data_config: {
     #       s3_uri: "S3Uri",
@@ -601,6 +701,7 @@ module Aws::Comprehend
     #       security_group_ids: ["SecurityGroupId"], # required
     #       subnets: ["SubnetId"], # required
     #     },
+    #     mode: "MULTI_CLASS", # accepts MULTI_CLASS, MULTI_LABEL
     #   })
     #
     # @example Response structure
@@ -616,6 +717,68 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Creates a model-specific endpoint for synchronous inference for a
+    # previously trained custom model
+    #
+    # @option params [required, String] :endpoint_name
+    #   This is the descriptive suffix that becomes part of the `EndpointArn`
+    #   used for all subsequent requests to this resource.
+    #
+    # @option params [required, String] :model_arn
+    #   The Amazon Resource Number (ARN) of the model to which the endpoint
+    #   will be attached.
+    #
+    # @option params [required, Integer] :desired_inference_units
+    #   The desired number of inference units to be used by the model using
+    #   this endpoint. Each inference unit represents of a throughput of 100
+    #   characters per second.
+    #
+    # @option params [String] :client_request_token
+    #   An idempotency token provided by the customer. If this token matches a
+    #   previous endpoint creation request, Amazon Comprehend will not return
+    #   a `ResourceInUseException`.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    # @option params [Array<Types::Tag>] :tags
+    #   Tags associated with the endpoint being created. A tag is a key-value
+    #   pair that adds metadata to the endpoint. For example, a tag with
+    #   "Sales" as the key might be added to an endpoint to indicate its use
+    #   by the sales department.
+    #
+    # @return [Types::CreateEndpointResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateEndpointResponse#endpoint_arn #endpoint_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_endpoint({
+    #     endpoint_name: "ComprehendEndpointName", # required
+    #     model_arn: "ComprehendModelArn", # required
+    #     desired_inference_units: 1, # required
+    #     client_request_token: "ClientRequestTokenString",
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue",
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.endpoint_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/CreateEndpoint AWS API Documentation
+    #
+    # @overload create_endpoint(params = {})
+    # @param [Hash] params ({})
+    def create_endpoint(params = {}, options = {})
+      req = build_request(:create_endpoint, params)
+      req.send_request(options)
+    end
+
     # Creates an entity recognizer using submitted files. After your
     # `CreateEntityRecognizer` request is submitted, you can check job
     # status using the API.
@@ -758,6 +921,30 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Deletes a model-specific endpoint for a previously-trained custom
+    # model. All endpoints must be deleted in order for the model to be
+    # deleted.
+    #
+    # @option params [required, String] :endpoint_arn
+    #   The Amazon Resource Number (ARN) of the endpoint being deleted.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_endpoint({
+    #     endpoint_arn: "ComprehendEndpointArn", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DeleteEndpoint AWS API Documentation
+    #
+    # @overload delete_endpoint(params = {})
+    # @param [Hash] params ({})
+    def delete_endpoint(params = {}, options = {})
+      req = build_request(:delete_endpoint, params)
+      req.send_request(options)
+    end
+
     # Deletes an entity recognizer.
     #
     # Only those recognizers that are in terminated states (IN\_ERROR,
@@ -862,6 +1049,7 @@ module Aws::Comprehend
     #   resp.document_classifier_properties.training_start_time #=> Time
     #   resp.document_classifier_properties.training_end_time #=> Time
     #   resp.document_classifier_properties.input_data_config.s3_uri #=> String
+    #   resp.document_classifier_properties.input_data_config.label_delimiter #=> String
     #   resp.document_classifier_properties.output_data_config.s3_uri #=> String
     #   resp.document_classifier_properties.output_data_config.kms_key_id #=> String
     #   resp.document_classifier_properties.classifier_metadata.number_of_labels #=> Integer
@@ -871,12 +1059,17 @@ module Aws::Comprehend
     #   resp.document_classifier_properties.classifier_metadata.evaluation_metrics.precision #=> Float
     #   resp.document_classifier_properties.classifier_metadata.evaluation_metrics.recall #=> Float
     #   resp.document_classifier_properties.classifier_metadata.evaluation_metrics.f1_score #=> Float
+    #   resp.document_classifier_properties.classifier_metadata.evaluation_metrics.micro_precision #=> Float
+    #   resp.document_classifier_properties.classifier_metadata.evaluation_metrics.micro_recall #=> Float
+    #   resp.document_classifier_properties.classifier_metadata.evaluation_metrics.micro_f1_score #=> Float
+    #   resp.document_classifier_properties.classifier_metadata.evaluation_metrics.hamming_loss #=> Float
     #   resp.document_classifier_properties.data_access_role_arn #=> String
     #   resp.document_classifier_properties.volume_kms_key_id #=> String
     #   resp.document_classifier_properties.vpc_config.security_group_ids #=> Array
     #   resp.document_classifier_properties.vpc_config.security_group_ids[0] #=> String
     #   resp.document_classifier_properties.vpc_config.subnets #=> Array
     #   resp.document_classifier_properties.vpc_config.subnets[0] #=> String
+    #   resp.document_classifier_properties.mode #=> String, one of "MULTI_CLASS", "MULTI_LABEL"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DescribeDocumentClassifier AWS API Documentation
     #
@@ -932,6 +1125,42 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Gets the properties associated with a specific endpoint. Use this
+    # operation to get the status of an endpoint.
+    #
+    # @option params [required, String] :endpoint_arn
+    #   The Amazon Resource Number (ARN) of the endpoint being described.
+    #
+    # @return [Types::DescribeEndpointResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeEndpointResponse#endpoint_properties #endpoint_properties} => Types::EndpointProperties
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_endpoint({
+    #     endpoint_arn: "ComprehendEndpointArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.endpoint_properties.endpoint_arn #=> String
+    #   resp.endpoint_properties.status #=> String, one of "CREATING", "DELETING", "FAILED", "IN_SERVICE", "UPDATING"
+    #   resp.endpoint_properties.message #=> String
+    #   resp.endpoint_properties.model_arn #=> String
+    #   resp.endpoint_properties.desired_inference_units #=> Integer
+    #   resp.endpoint_properties.current_inference_units #=> Integer
+    #   resp.endpoint_properties.creation_time #=> Time
+    #   resp.endpoint_properties.last_modified_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DescribeEndpoint AWS API Documentation
+    #
+    # @overload describe_endpoint(params = {})
+    # @param [Hash] params ({})
+    def describe_endpoint(params = {}, options = {})
+      req = build_request(:describe_endpoint, params)
+      req.send_request(options)
+    end
+
     # Gets the properties associated with an entities detection job. Use
     # this operation to get the status of a detection job.
     #
@@ -1221,9 +1450,8 @@ module Aws::Comprehend
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
-    #   primary languages supported by Amazon Comprehend: German ("de"),
-    #   English ("en"), Spanish ("es"), French ("fr"), Italian ("it"),
-    #   or Portuguese ("pt"). All documents must be in the same language.
+    #   primary languages supported by Amazon Comprehend. All documents must
+    #   be in the same language.
     #
     # @return [Types::DetectEntitiesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1262,9 +1490,8 @@ module Aws::Comprehend
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
-    #   primary languages supported by Amazon Comprehend: German ("de"),
-    #   English ("en"), Spanish ("es"), French ("fr"), Italian ("it"),
-    #   or Portuguese ("pt"). All documents must be in the same language.
+    #   primary languages supported by Amazon Comprehend. All documents must
+    #   be in the same language.
     #
     # @return [Types::DetectKeyPhrasesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1303,9 +1530,8 @@ module Aws::Comprehend
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
-    #   primary languages supported by Amazon Comprehend: German ("de"),
-    #   English ("en"), Spanish ("es"), French ("fr"), Italian ("it"),
-    #   or Portuguese ("pt"). All documents must be in the same language.
+    #   primary languages supported by Amazon Comprehend. All documents must
+    #   be in the same language.
     #
     # @return [Types::DetectSentimentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1345,7 +1571,7 @@ module Aws::Comprehend
     #
     # @option params [required, String] :language_code
     #   The language code of the input documents. You can specify any of the
-    #   primary languages supported by Amazon Comprehend: German ("de"),
+    #   following languages supported by Amazon Comprehend: German ("de"),
     #   English ("en"), Spanish ("es"), French ("fr"), Italian ("it"),
     #   or Portuguese ("pt").
     #
@@ -1399,6 +1625,8 @@ module Aws::Comprehend
     #   * {Types::ListDocumentClassificationJobsResponse#document_classification_job_properties_list #document_classification_job_properties_list} => Array&lt;Types::DocumentClassificationJobProperties&gt;
     #   * {Types::ListDocumentClassificationJobsResponse#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_document_classification_jobs({
@@ -1462,6 +1690,8 @@ module Aws::Comprehend
     #   * {Types::ListDocumentClassifiersResponse#document_classifier_properties_list #document_classifier_properties_list} => Array&lt;Types::DocumentClassifierProperties&gt;
     #   * {Types::ListDocumentClassifiersResponse#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_document_classifiers({
@@ -1486,6 +1716,7 @@ module Aws::Comprehend
     #   resp.document_classifier_properties_list[0].training_start_time #=> Time
     #   resp.document_classifier_properties_list[0].training_end_time #=> Time
     #   resp.document_classifier_properties_list[0].input_data_config.s3_uri #=> String
+    #   resp.document_classifier_properties_list[0].input_data_config.label_delimiter #=> String
     #   resp.document_classifier_properties_list[0].output_data_config.s3_uri #=> String
     #   resp.document_classifier_properties_list[0].output_data_config.kms_key_id #=> String
     #   resp.document_classifier_properties_list[0].classifier_metadata.number_of_labels #=> Integer
@@ -1495,12 +1726,17 @@ module Aws::Comprehend
     #   resp.document_classifier_properties_list[0].classifier_metadata.evaluation_metrics.precision #=> Float
     #   resp.document_classifier_properties_list[0].classifier_metadata.evaluation_metrics.recall #=> Float
     #   resp.document_classifier_properties_list[0].classifier_metadata.evaluation_metrics.f1_score #=> Float
+    #   resp.document_classifier_properties_list[0].classifier_metadata.evaluation_metrics.micro_precision #=> Float
+    #   resp.document_classifier_properties_list[0].classifier_metadata.evaluation_metrics.micro_recall #=> Float
+    #   resp.document_classifier_properties_list[0].classifier_metadata.evaluation_metrics.micro_f1_score #=> Float
+    #   resp.document_classifier_properties_list[0].classifier_metadata.evaluation_metrics.hamming_loss #=> Float
     #   resp.document_classifier_properties_list[0].data_access_role_arn #=> String
     #   resp.document_classifier_properties_list[0].volume_kms_key_id #=> String
     #   resp.document_classifier_properties_list[0].vpc_config.security_group_ids #=> Array
     #   resp.document_classifier_properties_list[0].vpc_config.security_group_ids[0] #=> String
     #   resp.document_classifier_properties_list[0].vpc_config.subnets #=> Array
     #   resp.document_classifier_properties_list[0].vpc_config.subnets[0] #=> String
+    #   resp.document_classifier_properties_list[0].mode #=> String, one of "MULTI_CLASS", "MULTI_LABEL"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/ListDocumentClassifiers AWS API Documentation
@@ -1532,6 +1768,8 @@ module Aws::Comprehend
     #   * {Types::ListDominantLanguageDetectionJobsResponse#dominant_language_detection_job_properties_list #dominant_language_detection_job_properties_list} => Array&lt;Types::DominantLanguageDetectionJobProperties&gt;
     #   * {Types::ListDominantLanguageDetectionJobsResponse#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_dominant_language_detection_jobs({
@@ -1575,6 +1813,60 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Gets a list of all existing endpoints that you've created.
+    #
+    # @option params [Types::EndpointFilter] :filter
+    #   Filters the endpoints that are returned. You can filter endpoints on
+    #   their name, model, status, or the date and time that they were
+    #   created. You can only set one filter at a time.
+    #
+    # @option params [String] :next_token
+    #   Identifies the next page of results to return.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return in each page. The default is
+    #   100.
+    #
+    # @return [Types::ListEndpointsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListEndpointsResponse#endpoint_properties_list #endpoint_properties_list} => Array&lt;Types::EndpointProperties&gt;
+    #   * {Types::ListEndpointsResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_endpoints({
+    #     filter: {
+    #       model_arn: "ComprehendModelArn",
+    #       status: "CREATING", # accepts CREATING, DELETING, FAILED, IN_SERVICE, UPDATING
+    #       creation_time_before: Time.now,
+    #       creation_time_after: Time.now,
+    #     },
+    #     next_token: "String",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.endpoint_properties_list #=> Array
+    #   resp.endpoint_properties_list[0].endpoint_arn #=> String
+    #   resp.endpoint_properties_list[0].status #=> String, one of "CREATING", "DELETING", "FAILED", "IN_SERVICE", "UPDATING"
+    #   resp.endpoint_properties_list[0].message #=> String
+    #   resp.endpoint_properties_list[0].model_arn #=> String
+    #   resp.endpoint_properties_list[0].desired_inference_units #=> Integer
+    #   resp.endpoint_properties_list[0].current_inference_units #=> Integer
+    #   resp.endpoint_properties_list[0].creation_time #=> Time
+    #   resp.endpoint_properties_list[0].last_modified_time #=> Time
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/ListEndpoints AWS API Documentation
+    #
+    # @overload list_endpoints(params = {})
+    # @param [Hash] params ({})
+    def list_endpoints(params = {}, options = {})
+      req = build_request(:list_endpoints, params)
+      req.send_request(options)
+    end
+
     # Gets a list of the entity detection jobs that you have submitted.
     #
     # @option params [Types::EntitiesDetectionJobFilter] :filter
@@ -1594,6 +1886,8 @@ module Aws::Comprehend
     #   * {Types::ListEntitiesDetectionJobsResponse#entities_detection_job_properties_list #entities_detection_job_properties_list} => Array&lt;Types::EntitiesDetectionJobProperties&gt;
     #   * {Types::ListEntitiesDetectionJobsResponse#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_entities_detection_jobs({
@@ -1665,6 +1959,8 @@ module Aws::Comprehend
     #   * {Types::ListEntityRecognizersResponse#entity_recognizer_properties_list #entity_recognizer_properties_list} => Array&lt;Types::EntityRecognizerProperties&gt;
     #   * {Types::ListEntityRecognizersResponse#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_entity_recognizers({
@@ -1740,6 +2036,8 @@ module Aws::Comprehend
     #   * {Types::ListKeyPhrasesDetectionJobsResponse#key_phrases_detection_job_properties_list #key_phrases_detection_job_properties_list} => Array&lt;Types::KeyPhrasesDetectionJobProperties&gt;
     #   * {Types::ListKeyPhrasesDetectionJobsResponse#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_key_phrases_detection_jobs({
@@ -1803,6 +2101,8 @@ module Aws::Comprehend
     #   * {Types::ListSentimentDetectionJobsResponse#sentiment_detection_job_properties_list #sentiment_detection_job_properties_list} => Array&lt;Types::SentimentDetectionJobProperties&gt;
     #   * {Types::ListSentimentDetectionJobsResponse#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_sentiment_detection_jobs({
@@ -1899,6 +2199,8 @@ module Aws::Comprehend
     #   * {Types::ListTopicsDetectionJobsResponse#topics_detection_job_properties_list #topics_detection_job_properties_list} => Array&lt;Types::TopicsDetectionJobProperties&gt;
     #   * {Types::ListTopicsDetectionJobsResponse#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_topics_detection_jobs({
@@ -2157,10 +2459,8 @@ module Aws::Comprehend
     # @option params [required, String] :language_code
     #   The language of the input documents. All documents must be in the same
     #   language. You can specify any of the languages supported by Amazon
-    #   Comprehend: English ("en"), Spanish ("es"), French ("fr"),
-    #   German ("de"), Italian ("it"), or Portuguese ("pt"). If custom
-    #   entities recognition is used, this parameter is ignored and the
-    #   language used for training the model is used instead.
+    #   Comprehend. If custom entities recognition is used, this parameter is
+    #   ignored and the language used for training the model is used instead.
     #
     # @option params [String] :client_request_token
     #   A unique identifier for the request. If you don't set the client
@@ -2255,9 +2555,8 @@ module Aws::Comprehend
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
-    #   primary languages supported by Amazon Comprehend: German ("de"),
-    #   English ("en"), Spanish ("es"), French ("fr"), Italian ("it"),
-    #   or Portuguese ("pt"). All documents must be in the same language.
+    #   primary languages supported by Amazon Comprehend. All documents must
+    #   be in the same language.
     #
     # @option params [String] :client_request_token
     #   A unique identifier for the request. If you don't set the client
@@ -2351,9 +2650,8 @@ module Aws::Comprehend
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
-    #   primary languages supported by Amazon Comprehend: German ("de"),
-    #   English ("en"), Spanish ("es"), French ("fr"), Italian ("it"),
-    #   or Portuguese ("pt"). All documents must be in the same language.
+    #   primary languages supported by Amazon Comprehend. All documents must
+    #   be in the same language.
     #
     # @option params [String] :client_request_token
     #   A unique identifier for the request. If you don't set the client
@@ -2815,6 +3113,34 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Updates information about the specified endpoint.
+    #
+    # @option params [required, String] :endpoint_arn
+    #   The Amazon Resource Number (ARN) of the endpoint being updated.
+    #
+    # @option params [required, Integer] :desired_inference_units
+    #   The desired number of inference units to be used by the model using
+    #   this endpoint. Each inference unit represents of a throughput of 100
+    #   characters per second.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_endpoint({
+    #     endpoint_arn: "ComprehendEndpointArn", # required
+    #     desired_inference_units: 1, # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/UpdateEndpoint AWS API Documentation
+    #
+    # @overload update_endpoint(params = {})
+    # @param [Hash] params ({})
+    def update_endpoint(params = {}, options = {})
+      req = build_request(:update_endpoint, params)
+      req.send_request(options)
+    end
+
     # @!endgroup
 
     # @param params ({})
@@ -2828,7 +3154,7 @@ module Aws::Comprehend
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-comprehend'
-      context[:gem_version] = '1.27.0'
+      context[:gem_version] = '1.32.0'
       Seahorse::Client::Request.new(handlers, context)
     end