aws-sdk-textract 1.11.0 → 1.16.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 1bf20998fc774ea09529b86887c30c705053ae44
-  data.tar.gz: 522589b5ec0f6a46466ee1079bd928e375a43b12
+SHA256:
+  metadata.gz: cdfa2b5cc2d97eafde10b5415facb69d41216071f301544f7f4f012862aaf20e
+  data.tar.gz: a29f892ed90962cdebb8d67789173d94db952a782a6ea78174328a02ca86f789
 SHA512:
-  metadata.gz: 07bc5768da20330e5a6631d20e9b3946b74d6602e948a1147624c56b36a41f68f9d8c15d8fea9cf5d85ef3c764fb562c51be5fabe2e4c291e2ddd171671b4355
-  data.tar.gz: 5c293d2c8633f731e1ea863bcab6b11bcb358a81e64472d470802f0ee22a8199fbfd9351a4486cc9e24c554433a5d6adbcda769aace7c07b278e5554d291bade
+  metadata.gz: 79e17d70bdfed96a06e0367209bce4ce86cc4f5babf56c73644c510714949668d8fa0390cf23d0e52defca0f648ce3a259fb714fba24aa7a5d31530e979790e7
+  data.tar.gz: 9f5a3e1ee13b53acf38a57f278f69dc0d6206f97e0544e2568938c8a3541062bf6b6c4862fbdebaf088ddfb668eadcf78d2ecfcc825cc13f6f9dfc9dbe0dd7eb

data/lib/aws-sdk-textract.rb

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

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

@@ -24,12 +24,25 @@ 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'
 
 Aws::Plugins::GlobalConfiguration.add_identifier(:textract)
 
 module Aws::Textract
+  # An API client for Textract.  To construct a client, you need to configure a `:region` and `:credentials`.
+  #
+  #     client = Aws::Textract::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
@@ -57,6 +70,7 @@ module Aws::Textract
     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)
 
@@ -93,7 +107,7 @@ module Aws::Textract
     #   @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 +122,12 @@ module Aws::Textract
     #     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 +152,10 @@ module Aws::Textract
     #     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 +163,7 @@ module Aws::Textract
     #   @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 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
@@ -154,7 +178,7 @@ module Aws::Textract
     #     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 +190,29 @@ module Aws::Textract
     #     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 +220,30 @@ module Aws::Textract
     #     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 +276,15 @@ module Aws::Textract
     #     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 +293,7 @@ module Aws::Textract
     #     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`.
@@ -268,27 +324,30 @@ module Aws::Textract
     #
     # The types of information returned are as follows:
     #
-    # * Words and lines that are related to nearby lines and words. The
-    #   related information is returned in two Block objects each of type
-    #   `KEY_VALUE_SET`\: a KEY Block object and a VALUE Block object. For
-    #   example, *Name: Ana Silva Carolina* contains a key and value.
-    #   *Name:* is the key. *Ana Silva Carolina* is the value.
+    # * Form data (key-value pairs). The related information is returned in
+    #   two Block objects, each of type `KEY_VALUE_SET`\: a KEY `Block`
+    #   object and a VALUE `Block` object. For example, *Name: Ana Silva
+    #   Carolina* contains a key and value. *Name:* is the key. *Ana Silva
+    #   Carolina* is the value.
     #
-    # * Table and table cell data. A TABLE Block object contains information
-    #   about a detected table. A CELL Block object is returned for each
-    #   cell in a table.
+    # * Table and table cell data. A TABLE `Block` object contains
+    #   information about a detected table. A CELL `Block` object is
+    #   returned for each cell in a table.
     #
-    # * Selectable elements such as checkboxes and radio buttons. A
-    #   SELECTION\_ELEMENT Block object contains information about a
-    #   selectable element.
+    # * Lines and words of text. A LINE `Block` object contains one or more
+    #   WORD `Block` objects. All lines and words that are detected in the
+    #   document are returned (including text that doesn't have a
+    #   relationship with the value of `FeatureTypes`).
     #
-    # * Lines and words of text. A LINE Block object contains one or more
-    #   WORD Block objects.
+    # Selection elements such as check boxes and option buttons (radio
+    # buttons) can be detected in form data and in tables. A
+    # SELECTION\_ELEMENT `Block` object contains information about a
+    # selection element, including the selection status.
     #
     # You can choose which type of analysis to perform by specifying the
     # `FeatureTypes` list.
     #
-    # The output is returned in a list of `BLOCK` objects.
+    # The output is returned in a list of `Block` objects.
     #
     # `AnalyzeDocument` is a synchronous operation. To analyze documents
     # asynchronously, use StartDocumentAnalysis.
@@ -302,22 +361,30 @@ module Aws::Textract
     # @option params [required, Types::Document] :document
     #   The input document as base64-encoded bytes or an Amazon S3 object. If
     #   you use the AWS CLI to call Amazon Textract operations, you can't
-    #   pass image bytes. The document must be an image in JPG or PNG format.
+    #   pass image bytes. The document must be an image in JPEG or PNG format.
     #
-    #   If you are using an AWS SDK to call Amazon Textract, you might not
-    #   need to base64-encode image bytes passed using the `Bytes` field.
+    #   If you're using an AWS SDK to call Amazon Textract, you might not
+    #   need to base64-encode image bytes that are passed using the `Bytes`
+    #   field.
     #
     # @option params [required, Array<String>] :feature_types
     #   A list of the types of analysis to perform. Add TABLES to the list to
-    #   return information about the tables detected in the input document.
-    #   Add FORMS to return detected fields and the associated text. To
-    #   perform both types of analysis, add TABLES and FORMS to
-    #   `FeatureTypes`.
+    #   return information about the tables that are detected in the input
+    #   document. Add FORMS to return detected form data. To perform both
+    #   types of analysis, add TABLES and FORMS to `FeatureTypes`. All lines
+    #   and words detected in the document are included in the response
+    #   (including text that isn't related to the value of `FeatureTypes`).
+    #
+    # @option params [Types::HumanLoopConfig] :human_loop_config
+    #   Sets the configuration for the human in the loop workflow for
+    #   analyzing documents.
     #
     # @return [Types::AnalyzeDocumentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::AnalyzeDocumentResponse#document_metadata #document_metadata} => Types::DocumentMetadata
     #   * {Types::AnalyzeDocumentResponse#blocks #blocks} => Array&lt;Types::Block&gt;
+    #   * {Types::AnalyzeDocumentResponse#human_loop_activation_output #human_loop_activation_output} => Types::HumanLoopActivationOutput
+    #   * {Types::AnalyzeDocumentResponse#analyze_document_model_version #analyze_document_model_version} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -331,6 +398,13 @@ module Aws::Textract
     #       },
     #     },
     #     feature_types: ["TABLES"], # required, accepts TABLES, FORMS
+    #     human_loop_config: {
+    #       human_loop_name: "HumanLoopName", # required
+    #       flow_definition_arn: "FlowDefinitionArn", # required
+    #       data_attributes: {
+    #         content_classifiers: ["FreeOfPersonallyIdentifiableInformation"], # accepts FreeOfPersonallyIdentifiableInformation, FreeOfAdultContent
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -360,6 +434,11 @@ module Aws::Textract
     #   resp.blocks[0].entity_types[0] #=> String, one of "KEY", "VALUE"
     #   resp.blocks[0].selection_status #=> String, one of "SELECTED", "NOT_SELECTED"
     #   resp.blocks[0].page #=> Integer
+    #   resp.human_loop_activation_output.human_loop_arn #=> String
+    #   resp.human_loop_activation_output.human_loop_activation_reasons #=> Array
+    #   resp.human_loop_activation_output.human_loop_activation_reasons[0] #=> String
+    #   resp.human_loop_activation_output.human_loop_activation_conditions_evaluation_results #=> String
+    #   resp.analyze_document_model_version #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/AnalyzeDocument AWS API Documentation
     #
@@ -372,7 +451,7 @@ module Aws::Textract
 
     # Detects text in the input document. Amazon Textract can detect lines
     # of text and the words that make up a line of text. The input document
-    # must be an image in JPG or PNG format. `DetectDocumentText` returns
+    # must be an image in JPEG or PNG format. `DetectDocumentText` returns
     # the detected text in an array of Block objects.
     #
     # Each document page has as an associated `Block` of type PAGE. Each
@@ -393,15 +472,17 @@ module Aws::Textract
     # @option params [required, Types::Document] :document
     #   The input document as base64-encoded bytes or an Amazon S3 object. If
     #   you use the AWS CLI to call Amazon Textract operations, you can't
-    #   pass image bytes. The document must be an image in JPG or PNG format.
+    #   pass image bytes. The document must be an image in JPEG or PNG format.
     #
-    #   If you are using an AWS SDK to call Amazon Textract, you might not
-    #   need to base64-encode image bytes passed using the `Bytes` field.
+    #   If you're using an AWS SDK to call Amazon Textract, you might not
+    #   need to base64-encode image bytes that are passed using the `Bytes`
+    #   field.
     #
     # @return [Types::DetectDocumentTextResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DetectDocumentTextResponse#document_metadata #document_metadata} => Types::DocumentMetadata
     #   * {Types::DetectDocumentTextResponse#blocks #blocks} => Array&lt;Types::Block&gt;
+    #   * {Types::DetectDocumentTextResponse#detect_document_text_model_version #detect_document_text_model_version} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -443,6 +524,7 @@ module Aws::Textract
     #   resp.blocks[0].entity_types[0] #=> String, one of "KEY", "VALUE"
     #   resp.blocks[0].selection_status #=> String, one of "SELECTED", "NOT_SELECTED"
     #   resp.blocks[0].page #=> Integer
+    #   resp.detect_document_text_model_version #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/DetectDocumentText AWS API Documentation
     #
@@ -469,30 +551,34 @@ module Aws::Textract
     # `GetDocumentAnalysis` returns an array of Block objects. The following
     # types of information are returned:
     #
-    # * Words and lines that are related to nearby lines and words. The
-    #   related information is returned in two Block objects each of type
-    #   `KEY_VALUE_SET`\: a KEY Block object and a VALUE Block object. For
-    #   example, *Name: Ana Silva Carolina* contains a key and value.
-    #   *Name:* is the key. *Ana Silva Carolina* is the value.
+    # * Form data (key-value pairs). The related information is returned in
+    #   two Block objects, each of type `KEY_VALUE_SET`\: a KEY `Block`
+    #   object and a VALUE `Block` object. For example, *Name: Ana Silva
+    #   Carolina* contains a key and value. *Name:* is the key. *Ana Silva
+    #   Carolina* is the value.
     #
-    # * Table and table cell data. A TABLE Block object contains information
-    #   about a detected table. A CELL Block object is returned for each
-    #   cell in a table.
+    # * Table and table cell data. A TABLE `Block` object contains
+    #   information about a detected table. A CELL `Block` object is
+    #   returned for each cell in a table.
     #
-    # * Selectable elements such as checkboxes and radio buttons. A
-    #   SELECTION\_ELEMENT Block object contains information about a
-    #   selectable element.
+    # * Lines and words of text. A LINE `Block` object contains one or more
+    #   WORD `Block` objects. All lines and words that are detected in the
+    #   document are returned (including text that doesn't have a
+    #   relationship with the value of the `StartDocumentAnalysis`
+    #   `FeatureTypes` input parameter).
     #
-    # * Lines and words of text. A LINE Block object contains one or more
-    #   WORD Block objects.
+    # Selection elements such as check boxes and option buttons (radio
+    # buttons) can be detected in form data and in tables. A
+    # SELECTION\_ELEMENT `Block` object contains information about a
+    # selection element, including the selection status.
     #
-    # Use the `MaxResults` parameter to limit the number of blocks returned.
-    # If there are more results than specified in `MaxResults`, the value of
-    # `NextToken` in the operation response contains a pagination token for
-    # getting the next set of results. To get the next page of results, call
-    # `GetDocumentAnalysis`, and populate the `NextToken` request parameter
-    # with the token value that's returned from the previous call to
-    # `GetDocumentAnalysis`.
+    # Use the `MaxResults` parameter to limit the number of blocks that are
+    # returned. If there are more results than specified in `MaxResults`,
+    # the value of `NextToken` in the operation response contains a
+    # pagination token for getting the next set of results. To get the next
+    # page of results, call `GetDocumentAnalysis`, and populate the
+    # `NextToken` request parameter with the token value that's returned
+    # from the previous call to `GetDocumentAnalysis`.
     #
     # For more information, see [Document Text Analysis][1].
     #
@@ -502,7 +588,8 @@ module Aws::Textract
     #
     # @option params [required, String] :job_id
     #   A unique identifier for the text-detection job. The `JobId` is
-    #   returned from `StartDocumentAnalysis`.
+    #   returned from `StartDocumentAnalysis`. A `JobId` value is only valid
+    #   for 7 days.
     #
     # @option params [Integer] :max_results
     #   The maximum number of results to return per paginated call. The
@@ -524,6 +611,7 @@ module Aws::Textract
     #   * {Types::GetDocumentAnalysisResponse#blocks #blocks} => Array&lt;Types::Block&gt;
     #   * {Types::GetDocumentAnalysisResponse#warnings #warnings} => Array&lt;Types::Warning&gt;
     #   * {Types::GetDocumentAnalysisResponse#status_message #status_message} => String
+    #   * {Types::GetDocumentAnalysisResponse#analyze_document_model_version #analyze_document_model_version} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -567,6 +655,7 @@ module Aws::Textract
     #   resp.warnings[0].pages #=> Array
     #   resp.warnings[0].pages[0] #=> Integer
     #   resp.status_message #=> String
+    #   resp.analyze_document_model_version #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/GetDocumentAnalysis AWS API Documentation
     #
@@ -616,7 +705,8 @@ module Aws::Textract
     #
     # @option params [required, String] :job_id
     #   A unique identifier for the text detection job. The `JobId` is
-    #   returned from `StartDocumentTextDetection`.
+    #   returned from `StartDocumentTextDetection`. A `JobId` value is only
+    #   valid for 7 days.
     #
     # @option params [Integer] :max_results
     #   The maximum number of results to return per paginated call. The
@@ -638,6 +728,7 @@ module Aws::Textract
     #   * {Types::GetDocumentTextDetectionResponse#blocks #blocks} => Array&lt;Types::Block&gt;
     #   * {Types::GetDocumentTextDetectionResponse#warnings #warnings} => Array&lt;Types::Warning&gt;
     #   * {Types::GetDocumentTextDetectionResponse#status_message #status_message} => String
+    #   * {Types::GetDocumentTextDetectionResponse#detect_document_text_model_version #detect_document_text_model_version} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -681,6 +772,7 @@ module Aws::Textract
     #   resp.warnings[0].pages #=> Array
     #   resp.warnings[0].pages[0] #=> Integer
     #   resp.status_message #=> String
+    #   resp.detect_document_text_model_version #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/textract-2018-06-27/GetDocumentTextDetection AWS API Documentation
     #
@@ -691,14 +783,14 @@ module Aws::Textract
       req.send_request(options)
     end
 
-    # Starts asynchronous analysis of an input document for relationships
-    # between detected items such as key and value pairs, tables, and
-    # selection elements.
+    # Starts the asynchronous analysis of an input document for
+    # relationships between detected items such as key-value pairs, tables,
+    # and selection elements.
     #
-    # `StartDocumentAnalysis` can analyze text in documents that are in JPG,
-    # PNG, and PDF format. The documents are stored in an Amazon S3 bucket.
-    # Use DocumentLocation to specify the bucket name and file name of the
-    # document.
+    # `StartDocumentAnalysis` can analyze text in documents that are in
+    # JPEG, PNG, and PDF format. The documents are stored in an Amazon S3
+    # bucket. Use DocumentLocation to specify the bucket name and file name
+    # of the document.
     #
     # `StartDocumentAnalysis` returns a job identifier (`JobId`) that you
     # use to get the results of the operation. When text analysis is
@@ -722,22 +814,27 @@ module Aws::Textract
     # @option params [required, Array<String>] :feature_types
     #   A list of the types of analysis to perform. Add TABLES to the list to
     #   return information about the tables that are detected in the input
-    #   document. Add FORMS to return detected fields and the associated text.
-    #   To perform both types of analysis, add TABLES and FORMS to
-    #   `FeatureTypes`. All selectable elements (`SELECTION_ELEMENT`) that are
-    #   detected are returned, whatever the value of `FeatureTypes`.
+    #   document. Add FORMS to return detected form data. To perform both
+    #   types of analysis, add TABLES and FORMS to `FeatureTypes`. All lines
+    #   and words detected in the document are included in the response
+    #   (including text that isn't related to the value of `FeatureTypes`).
     #
     # @option params [String] :client_request_token
     #   The idempotent token that you use to identify the start request. If
     #   you use the same token with multiple `StartDocumentAnalysis` requests,
     #   the same `JobId` is returned. Use `ClientRequestToken` to prevent the
-    #   same job from being accidentally started more than once.
+    #   same job from being accidentally started more than once. For more
+    #   information, see [Calling Amazon Textract Asynchronous Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/textract/latest/dg/api-async.html
     #
     # @option params [String] :job_tag
-    #   An identifier you specify that's included in the completion
-    #   notification that's published to the Amazon SNS topic. For example,
-    #   you can use `JobTag` to identify the type of document, such as a tax
-    #   form or a receipt, that the completion notification corresponds to.
+    #   An identifier that you specify that's included in the completion
+    #   notification published to the Amazon SNS topic. For example, you can
+    #   use `JobTag` to identify the type of document that the completion
+    #   notification corresponds to (such as a tax form or a receipt).
     #
     # @option params [Types::NotificationChannel] :notification_channel
     #   The Amazon SNS topic ARN that you want Amazon Textract to publish the
@@ -784,7 +881,7 @@ module Aws::Textract
     # text.
     #
     # `StartDocumentTextDetection` can analyze text in documents that are in
-    # JPG, PNG, and PDF format. The documents are stored in an Amazon S3
+    # JPEG, PNG, and PDF format. The documents are stored in an Amazon S3
     # bucket. Use DocumentLocation to specify the bucket name and file name
     # of the document.
     #
@@ -812,12 +909,18 @@ module Aws::Textract
     #   you use the same token with multiple `StartDocumentTextDetection`
     #   requests, the same `JobId` is returned. Use `ClientRequestToken` to
     #   prevent the same job from being accidentally started more than once.
+    #   For more information, see [Calling Amazon Textract Asynchronous
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/textract/latest/dg/api-async.html
     #
     # @option params [String] :job_tag
-    #   An identifier you specify that's included in the completion
-    #   notification that's published to the Amazon SNS topic. For example,
-    #   you can use `JobTag` to identify the type of document, such as a tax
-    #   form or a receipt, that the completion notification corresponds to.
+    #   An identifier that you specify that's included in the completion
+    #   notification published to the Amazon SNS topic. For example, you can
+    #   use `JobTag` to identify the type of document that the completion
+    #   notification corresponds to (such as a tax form or a receipt).
     #
     # @option params [Types::NotificationChannel] :notification_channel
     #   The Amazon SNS topic ARN that you want Amazon Textract to publish the
@@ -871,7 +974,7 @@ module Aws::Textract
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-textract'
-      context[:gem_version] = '1.11.0'
+      context[:gem_version] = '1.16.1'
       Seahorse::Client::Request.new(handlers, context)
     end