aws-sdk-comprehend 1.60.0 → 1.62.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a75cc38649333387d5418a7c80d9113999b17f57661027b78e042e55f92fecdd
-  data.tar.gz: 9a65e161a5123e8aace032e4e26a3521e8ff56b7edd20acd3b1a6e590c6f4624
+  metadata.gz: b2b0ff29417aa35c35084fa9357970b72b02f674261ec69b68401baffccedd3d
+  data.tar.gz: 284edfaefd2215cd9783ab96c6535b0e50c1b6f763067f51a32ef2ac501e9952
 SHA512:
-  metadata.gz: bb3cae0fcd400466508d2508812b3e0105a358f4ace7a580bf96e5aaf88160a561e236534e3a4f9233c11348292826c09b73e41f525c46561db5801e6b2a5fa0
-  data.tar.gz: 066a5b860baa16c7d901cc0a680c40e502db95d339322db37d25083a8205aa319af384e39ea4db69d68a52014d2ae917a5536efa1bce8048b06be3ddc32d103b
+  metadata.gz: 1433313b3641640353668d8e0f6f9f007ca8d7b7ef645bb210b9c05ebdf7f8172d4a545bf27179c8bd5ab7b3a33eefacfff093b57f10113b5bc0a06e1ec70ddb
+  data.tar.gz: 48864026f184295c7e9c9945286ea283dee6eb418dee073595c9a40113fc90201324089751874f8b1a72bca52a8e6c9dcb31b07ac29a39698c9f9911e26f07d7

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.62.0 (2022-09-21)
+------------------
+
+* Feature - Amazon Comprehend now supports synchronous mode for targeted sentiment API operations.
+
+1.61.0 (2022-05-20)
+------------------
+
+* Feature - Comprehend releases 14 new entity types for DetectPiiEntities and ContainsPiiEntities APIs.
+
 1.60.0 (2022-03-09)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.60.0
+1.62.0

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

@@ -370,10 +370,10 @@ module Aws::Comprehend
     # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-languages.html
     #
     # @option params [required, Array<String>] :text_list
-    #   A list containing the text of the input documents. The list can
-    #   contain a maximum of 25 documents. Each document should contain at
-    #   least 20 characters and must contain fewer than 5,000 bytes of UTF-8
-    #   encoded characters.
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. Each document should
+    #   contain at least 20 characters. The maximum size of each document is 5
+    #   KB.
     #
     # @return [Types::BatchDetectDominantLanguageResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -409,12 +409,16 @@ module Aws::Comprehend
 
     # Inspects the text of a batch of documents for named entities and
     # returns information about them. For more information about named
-    # entities, see how-entities
+    # entities, see [Entities][1] in the Comprehend Developer Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-entities.html
     #
     # @option params [required, Array<String>] :text_list
-    #   A list containing the text of the input documents. The list can
-    #   contain a maximum of 25 documents. Each document must contain fewer
-    #   than 5,000 bytes of UTF-8 encoded characters.
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. The maximum size of each
+    #   document is 5 KB.
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
@@ -460,9 +464,9 @@ module Aws::Comprehend
     # Detects the key noun phrases found in a batch of documents.
     #
     # @option params [required, Array<String>] :text_list
-    #   A list containing the text of the input documents. The list can
-    #   contain a maximum of 25 documents. Each document must contain fewer
-    #   that 5,000 bytes of UTF-8 encoded characters.
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. The maximum size of each
+    #   document is 5 KB.
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
@@ -509,9 +513,15 @@ module Aws::Comprehend
     # in each one.
     #
     # @option params [required, Array<String>] :text_list
-    #   A list containing the text of the input documents. The list can
-    #   contain a maximum of 25 documents. Each document must contain fewer
-    #   that 5,000 bytes of UTF-8 encoded characters.
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. The maximum size of each
+    #   document is 5 KB.
+    #
+    #   <note markdown="1"> Amazon Comprehend performs real-time sentiment analysis on the first
+    #   500 characters of the input text and ignores any additional text in
+    #   the input.
+    #
+    #    </note>
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
@@ -555,12 +565,17 @@ module Aws::Comprehend
 
     # Inspects the text of a batch of documents for the syntax and part of
     # speech of the words in the document and returns information about
-    # them. For more information, see how-syntax.
+    # them. For more information, see [Syntax][1] in the Comprehend
+    # Developer Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-syntax.html
     #
     # @option params [required, Array<String>] :text_list
-    #   A list containing the text of the input documents. The list can
-    #   contain a maximum of 25 documents. Each document must contain fewer
-    #   that 5,000 bytes of UTF-8 encoded characters.
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. The maximum size for each
+    #   document is 5 KB.
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
@@ -605,6 +620,70 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Inspects a batch of documents and returns a sentiment analysis for
+    # each entity identified in the documents.
+    #
+    # For more information about targeted sentiment, see [Targeted
+    # sentiment][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-targeted-sentiment.html
+    #
+    # @option params [required, Array<String>] :text_list
+    #   A list containing the UTF-8 encoded text of the input documents. The
+    #   list can contain a maximum of 25 documents. The maximum size of each
+    #   document is 5 KB.
+    #
+    # @option params [required, String] :language_code
+    #   The language of the input documents. Currently, English is the only
+    #   supported language.
+    #
+    # @return [Types::BatchDetectTargetedSentimentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::BatchDetectTargetedSentimentResponse#result_list #result_list} => Array&lt;Types::BatchDetectTargetedSentimentItemResult&gt;
+    #   * {Types::BatchDetectTargetedSentimentResponse#error_list #error_list} => Array&lt;Types::BatchItemError&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.batch_detect_targeted_sentiment({
+    #     text_list: ["CustomerInputString"], # required
+    #     language_code: "en", # required, accepts en, es, fr, de, it, pt, ar, hi, ja, ko, zh, zh-TW
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.result_list #=> Array
+    #   resp.result_list[0].index #=> Integer
+    #   resp.result_list[0].entities #=> Array
+    #   resp.result_list[0].entities[0].descriptive_mention_index #=> Array
+    #   resp.result_list[0].entities[0].descriptive_mention_index[0] #=> Integer
+    #   resp.result_list[0].entities[0].mentions #=> Array
+    #   resp.result_list[0].entities[0].mentions[0].score #=> Float
+    #   resp.result_list[0].entities[0].mentions[0].group_score #=> Float
+    #   resp.result_list[0].entities[0].mentions[0].text #=> String
+    #   resp.result_list[0].entities[0].mentions[0].type #=> String, one of "PERSON", "LOCATION", "ORGANIZATION", "FACILITY", "BRAND", "COMMERCIAL_ITEM", "MOVIE", "MUSIC", "BOOK", "SOFTWARE", "GAME", "PERSONAL_TITLE", "EVENT", "DATE", "QUANTITY", "ATTRIBUTE", "OTHER"
+    #   resp.result_list[0].entities[0].mentions[0].mention_sentiment.sentiment #=> String, one of "POSITIVE", "NEGATIVE", "NEUTRAL", "MIXED"
+    #   resp.result_list[0].entities[0].mentions[0].mention_sentiment.sentiment_score.positive #=> Float
+    #   resp.result_list[0].entities[0].mentions[0].mention_sentiment.sentiment_score.negative #=> Float
+    #   resp.result_list[0].entities[0].mentions[0].mention_sentiment.sentiment_score.neutral #=> Float
+    #   resp.result_list[0].entities[0].mentions[0].mention_sentiment.sentiment_score.mixed #=> Float
+    #   resp.result_list[0].entities[0].mentions[0].begin_offset #=> Integer
+    #   resp.result_list[0].entities[0].mentions[0].end_offset #=> Integer
+    #   resp.error_list #=> Array
+    #   resp.error_list[0].index #=> Integer
+    #   resp.error_list[0].error_code #=> String
+    #   resp.error_list[0].error_message #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/BatchDetectTargetedSentiment AWS API Documentation
+    #
+    # @overload batch_detect_targeted_sentiment(params = {})
+    # @param [Hash] params ({})
+    def batch_detect_targeted_sentiment(params = {}, options = {})
+      req = build_request(:batch_detect_targeted_sentiment, params)
+      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.
@@ -613,7 +692,12 @@ module Aws::Comprehend
     #   The document text to be analyzed.
     #
     # @option params [required, String] :endpoint_arn
-    #   The Amazon Resource Number (ARN) of the endpoint.
+    #   The Amazon Resource Number (ARN) of the endpoint. For information
+    #   about endpoints, see [Managing endpoints][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/comprehend/latest/dg/manage-endpoints.html
     #
     # @return [Types::ClassifyDocumentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -650,12 +734,11 @@ module Aws::Comprehend
     # types such as name, address, bank account number, or phone number.
     #
     # @option params [required, String] :text
-    #   Creates a new document classification request to analyze a single
-    #   document in real-time, returning personally identifiable information
-    #   (PII) entity labels.
+    #   A UTF-8 text string. The maximum string size is 100 KB.
     #
     # @option params [required, String] :language_code
-    #   The language of the input documents.
+    #   The language of the input documents. Currently, English is the only
+    #   valid language.
     #
     # @return [Types::ContainsPiiEntitiesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -671,7 +754,7 @@ module Aws::Comprehend
     # @example Response structure
     #
     #   resp.labels #=> Array
-    #   resp.labels[0].name #=> String, one of "BANK_ACCOUNT_NUMBER", "BANK_ROUTING", "CREDIT_DEBIT_NUMBER", "CREDIT_DEBIT_CVV", "CREDIT_DEBIT_EXPIRY", "PIN", "EMAIL", "ADDRESS", "NAME", "PHONE", "SSN", "DATE_TIME", "PASSPORT_NUMBER", "DRIVER_ID", "URL", "AGE", "USERNAME", "PASSWORD", "AWS_ACCESS_KEY", "AWS_SECRET_KEY", "IP_ADDRESS", "MAC_ADDRESS", "ALL"
+    #   resp.labels[0].name #=> String, one of "BANK_ACCOUNT_NUMBER", "BANK_ROUTING", "CREDIT_DEBIT_NUMBER", "CREDIT_DEBIT_CVV", "CREDIT_DEBIT_EXPIRY", "PIN", "EMAIL", "ADDRESS", "NAME", "PHONE", "SSN", "DATE_TIME", "PASSPORT_NUMBER", "DRIVER_ID", "URL", "AGE", "USERNAME", "PASSWORD", "AWS_ACCESS_KEY", "AWS_SECRET_KEY", "IP_ADDRESS", "MAC_ADDRESS", "ALL", "LICENSE_PLATE", "VEHICLE_IDENTIFICATION_NUMBER", "UK_NATIONAL_INSURANCE_NUMBER", "CA_SOCIAL_INSURANCE_NUMBER", "US_INDIVIDUAL_TAX_IDENTIFICATION_NUMBER", "UK_UNIQUE_TAXPAYER_REFERENCE_NUMBER", "IN_PERMANENT_ACCOUNT_NUMBER", "IN_NREGA", "INTERNATIONAL_BANK_ACCOUNT_NUMBER", "SWIFT_CODE", "UK_NATIONAL_HEALTH_SERVICE_NUMBER", "CA_HEALTH_NUMBER", "IN_AADHAAR", "IN_VOTER_NUMBER"
     #   resp.labels[0].score #=> Float
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/ContainsPiiEntities AWS API Documentation
@@ -688,7 +771,11 @@ module Aws::Comprehend
     # documents that labeled with the categories that you want to use. After
     # the classifier is trained you can use it to categorize a set of
     # labeled documents into the categories. For more information, see
-    # how-document-classification.
+    # [Document Classification][1] in the Comprehend Developer Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-document-classification.html
     #
     # @option params [required, String] :document_classifier_name
     #   The name of the document classifier.
@@ -849,7 +936,12 @@ module Aws::Comprehend
     end
 
     # Creates a model-specific endpoint for synchronous inference for a
-    # previously trained custom model
+    # previously trained custom model For information about endpoints, see
+    # [Managing endpoints][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/manage-endpoints.html
     #
     # @option params [required, String] :endpoint_name
     #   This is the descriptive suffix that becomes part of the `EndpointArn`
@@ -1115,7 +1207,11 @@ module Aws::Comprehend
 
     # Deletes a model-specific endpoint for a previously-trained custom
     # model. All endpoints must be deleted in order for the model to be
-    # deleted.
+    # deleted. For information about endpoints, see [Managing endpoints][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/manage-endpoints.html
     #
     # @option params [required, String] :endpoint_arn
     #   The Amazon Resource Number (ARN) of the endpoint being deleted.
@@ -1368,7 +1464,12 @@ module Aws::Comprehend
     end
 
     # Gets the properties associated with a specific endpoint. Use this
-    # operation to get the status of an endpoint.
+    # operation to get the status of an endpoint. For information about
+    # endpoints, see [Managing endpoints][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/manage-endpoints.html
     #
     # @option params [required, String] :endpoint_arn
     #   The Amazon Resource Number (ARN) of the endpoint being described.
@@ -1664,7 +1765,7 @@ module Aws::Comprehend
     #   resp.pii_entities_detection_job_properties.output_data_config.s3_uri #=> String
     #   resp.pii_entities_detection_job_properties.output_data_config.kms_key_id #=> String
     #   resp.pii_entities_detection_job_properties.redaction_config.pii_entity_types #=> Array
-    #   resp.pii_entities_detection_job_properties.redaction_config.pii_entity_types[0] #=> String, one of "BANK_ACCOUNT_NUMBER", "BANK_ROUTING", "CREDIT_DEBIT_NUMBER", "CREDIT_DEBIT_CVV", "CREDIT_DEBIT_EXPIRY", "PIN", "EMAIL", "ADDRESS", "NAME", "PHONE", "SSN", "DATE_TIME", "PASSPORT_NUMBER", "DRIVER_ID", "URL", "AGE", "USERNAME", "PASSWORD", "AWS_ACCESS_KEY", "AWS_SECRET_KEY", "IP_ADDRESS", "MAC_ADDRESS", "ALL"
+    #   resp.pii_entities_detection_job_properties.redaction_config.pii_entity_types[0] #=> String, one of "BANK_ACCOUNT_NUMBER", "BANK_ROUTING", "CREDIT_DEBIT_NUMBER", "CREDIT_DEBIT_CVV", "CREDIT_DEBIT_EXPIRY", "PIN", "EMAIL", "ADDRESS", "NAME", "PHONE", "SSN", "DATE_TIME", "PASSPORT_NUMBER", "DRIVER_ID", "URL", "AGE", "USERNAME", "PASSWORD", "AWS_ACCESS_KEY", "AWS_SECRET_KEY", "IP_ADDRESS", "MAC_ADDRESS", "ALL", "LICENSE_PLATE", "VEHICLE_IDENTIFICATION_NUMBER", "UK_NATIONAL_INSURANCE_NUMBER", "CA_SOCIAL_INSURANCE_NUMBER", "US_INDIVIDUAL_TAX_IDENTIFICATION_NUMBER", "UK_UNIQUE_TAXPAYER_REFERENCE_NUMBER", "IN_PERMANENT_ACCOUNT_NUMBER", "IN_NREGA", "INTERNATIONAL_BANK_ACCOUNT_NUMBER", "SWIFT_CODE", "UK_NATIONAL_HEALTH_SERVICE_NUMBER", "CA_HEALTH_NUMBER", "IN_AADHAAR", "IN_VOTER_NUMBER"
     #   resp.pii_entities_detection_job_properties.redaction_config.mask_mode #=> String, one of "MASK", "REPLACE_WITH_PII_ENTITY_TYPE"
     #   resp.pii_entities_detection_job_properties.redaction_config.mask_character #=> String
     #   resp.pii_entities_detection_job_properties.language_code #=> String, one of "en", "es", "fr", "de", "it", "pt", "ar", "hi", "ja", "ko", "zh", "zh-TW"
@@ -1876,8 +1977,8 @@ module Aws::Comprehend
     # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-languages.html
     #
     # @option params [required, String] :text
-    #   A UTF-8 text string. Each string should contain at least 20 characters
-    #   and must contain fewer that 5,000 bytes of UTF-8 encoded characters.
+    #   A UTF-8 text string. The string must contain at least 20 characters.
+    #   The maximum string size is 100 KB.
     #
     # @return [Types::DetectDominantLanguageResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1905,11 +2006,15 @@ module Aws::Comprehend
     end
 
     # Inspects text for named entities, and returns information about them.
-    # For more information, about named entities, see how-entities.
+    # For more information, about named entities, see [Entities][1] in the
+    # Comprehend Developer Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-entities.html
     #
     # @option params [required, String] :text
-    #   A UTF-8 text string. Each string must contain fewer that 5,000 bytes
-    #   of UTF-8 encoded characters.
+    #   A UTF-8 text string. The maximum string size is 100 KB.
     #
     # @option params [String] :language_code
     #   The language of the input documents. You can specify any of the
@@ -1930,6 +2035,12 @@ module Aws::Comprehend
     #   your custom model, and it ignores any language code that you provide
     #   in your request.
     #
+    #   For information about endpoints, see [Managing endpoints][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/comprehend/latest/dg/manage-endpoints.html
+    #
     # @return [Types::DetectEntitiesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DetectEntitiesResponse#entities #entities} => Array&lt;Types::Entity&gt;
@@ -1963,8 +2074,8 @@ module Aws::Comprehend
     # Detects the key noun phrases found in the text.
     #
     # @option params [required, String] :text
-    #   A UTF-8 text string. Each string must contain fewer that 5,000 bytes
-    #   of UTF-8 encoded characters.
+    #   A UTF-8 text string. The string must contain less than 100 KB of UTF-8
+    #   encoded characters.
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
@@ -2003,11 +2114,11 @@ module Aws::Comprehend
     # identifiable information (PII) and returns information about them.
     #
     # @option params [required, String] :text
-    #   A UTF-8 text string. Each string must contain fewer that 5,000 bytes
-    #   of UTF-8 encoded characters.
+    #   A UTF-8 text string. The maximum string size is 100 KB.
     #
     # @option params [required, String] :language_code
-    #   The language of the input documents.
+    #   The language of the input documents. Currently, English is the only
+    #   valid language.
     #
     # @return [Types::DetectPiiEntitiesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2024,7 +2135,7 @@ module Aws::Comprehend
     #
     #   resp.entities #=> Array
     #   resp.entities[0].score #=> Float
-    #   resp.entities[0].type #=> String, one of "BANK_ACCOUNT_NUMBER", "BANK_ROUTING", "CREDIT_DEBIT_NUMBER", "CREDIT_DEBIT_CVV", "CREDIT_DEBIT_EXPIRY", "PIN", "EMAIL", "ADDRESS", "NAME", "PHONE", "SSN", "DATE_TIME", "PASSPORT_NUMBER", "DRIVER_ID", "URL", "AGE", "USERNAME", "PASSWORD", "AWS_ACCESS_KEY", "AWS_SECRET_KEY", "IP_ADDRESS", "MAC_ADDRESS", "ALL"
+    #   resp.entities[0].type #=> String, one of "BANK_ACCOUNT_NUMBER", "BANK_ROUTING", "CREDIT_DEBIT_NUMBER", "CREDIT_DEBIT_CVV", "CREDIT_DEBIT_EXPIRY", "PIN", "EMAIL", "ADDRESS", "NAME", "PHONE", "SSN", "DATE_TIME", "PASSPORT_NUMBER", "DRIVER_ID", "URL", "AGE", "USERNAME", "PASSWORD", "AWS_ACCESS_KEY", "AWS_SECRET_KEY", "IP_ADDRESS", "MAC_ADDRESS", "ALL", "LICENSE_PLATE", "VEHICLE_IDENTIFICATION_NUMBER", "UK_NATIONAL_INSURANCE_NUMBER", "CA_SOCIAL_INSURANCE_NUMBER", "US_INDIVIDUAL_TAX_IDENTIFICATION_NUMBER", "UK_UNIQUE_TAXPAYER_REFERENCE_NUMBER", "IN_PERMANENT_ACCOUNT_NUMBER", "IN_NREGA", "INTERNATIONAL_BANK_ACCOUNT_NUMBER", "SWIFT_CODE", "UK_NATIONAL_HEALTH_SERVICE_NUMBER", "CA_HEALTH_NUMBER", "IN_AADHAAR", "IN_VOTER_NUMBER"
     #   resp.entities[0].begin_offset #=> Integer
     #   resp.entities[0].end_offset #=> Integer
     #
@@ -2041,8 +2152,13 @@ module Aws::Comprehend
     # (`POSITIVE`, `NEUTRAL`, `MIXED`, or `NEGATIVE`).
     #
     # @option params [required, String] :text
-    #   A UTF-8 text string. Each string must contain fewer that 5,000 bytes
-    #   of UTF-8 encoded characters.
+    #   A UTF-8 text string. The maximum string size is 5 KB.
+    #
+    #   <note markdown="1"> Amazon Comprehend performs real-time sentiment analysis on the first
+    #   500 characters of the input text and ignores any additional text in
+    #   the input.
+    #
+    #    </note>
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
@@ -2079,11 +2195,15 @@ module Aws::Comprehend
     end
 
     # Inspects text for syntax and the part of speech of words in the
-    # document. For more information, how-syntax.
+    # document. For more information, see [Syntax][1] in the Comprehend
+    # Developer Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-syntax.html
     #
     # @option params [required, String] :text
-    #   A UTF-8 string. Each string must contain fewer that 5,000 bytes of UTF
-    #   encoded characters.
+    #   A UTF-8 string. The maximum string size is 5 KB.
     #
     # @option params [required, String] :language_code
     #   The language code of the input documents. You can specify any of the
@@ -2121,6 +2241,61 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Inspects the input text and returns a sentiment analysis for each
+    # entity identified in the text.
+    #
+    # For more information about targeted sentiment, see [Targeted
+    # sentiment][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/how-targeted-sentiment.html
+    #
+    # @option params [required, String] :text
+    #   A UTF-8 text string. The maximum string length is 5 KB.
+    #
+    # @option params [required, String] :language_code
+    #   The language of the input documents. Currently, English is the only
+    #   supported language.
+    #
+    # @return [Types::DetectTargetedSentimentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DetectTargetedSentimentResponse#entities #entities} => Array&lt;Types::TargetedSentimentEntity&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.detect_targeted_sentiment({
+    #     text: "CustomerInputString", # required
+    #     language_code: "en", # required, accepts en, es, fr, de, it, pt, ar, hi, ja, ko, zh, zh-TW
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.entities #=> Array
+    #   resp.entities[0].descriptive_mention_index #=> Array
+    #   resp.entities[0].descriptive_mention_index[0] #=> Integer
+    #   resp.entities[0].mentions #=> Array
+    #   resp.entities[0].mentions[0].score #=> Float
+    #   resp.entities[0].mentions[0].group_score #=> Float
+    #   resp.entities[0].mentions[0].text #=> String
+    #   resp.entities[0].mentions[0].type #=> String, one of "PERSON", "LOCATION", "ORGANIZATION", "FACILITY", "BRAND", "COMMERCIAL_ITEM", "MOVIE", "MUSIC", "BOOK", "SOFTWARE", "GAME", "PERSONAL_TITLE", "EVENT", "DATE", "QUANTITY", "ATTRIBUTE", "OTHER"
+    #   resp.entities[0].mentions[0].mention_sentiment.sentiment #=> String, one of "POSITIVE", "NEGATIVE", "NEUTRAL", "MIXED"
+    #   resp.entities[0].mentions[0].mention_sentiment.sentiment_score.positive #=> Float
+    #   resp.entities[0].mentions[0].mention_sentiment.sentiment_score.negative #=> Float
+    #   resp.entities[0].mentions[0].mention_sentiment.sentiment_score.neutral #=> Float
+    #   resp.entities[0].mentions[0].mention_sentiment.sentiment_score.mixed #=> Float
+    #   resp.entities[0].mentions[0].begin_offset #=> Integer
+    #   resp.entities[0].mentions[0].end_offset #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DetectTargetedSentiment AWS API Documentation
+    #
+    # @overload detect_targeted_sentiment(params = {})
+    # @param [Hash] params ({})
+    def detect_targeted_sentiment(params = {}, options = {})
+      req = build_request(:detect_targeted_sentiment, params)
+      req.send_request(options)
+    end
+
     # Creates a new custom model that replicates a source custom model that
     # you import. The source model can be in your AWS account or another
     # one.
@@ -2476,7 +2651,12 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
-    # Gets a list of all existing endpoints that you've created.
+    # Gets a list of all existing endpoints that you've created. For
+    # information about endpoints, see [Managing endpoints][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/manage-endpoints.html
     #
     # @option params [Types::EndpointFilter] :filter
     #   Filters the endpoints that are returned. You can filter endpoints on
@@ -2933,7 +3113,7 @@ module Aws::Comprehend
     #   resp.pii_entities_detection_job_properties_list[0].output_data_config.s3_uri #=> String
     #   resp.pii_entities_detection_job_properties_list[0].output_data_config.kms_key_id #=> String
     #   resp.pii_entities_detection_job_properties_list[0].redaction_config.pii_entity_types #=> Array
-    #   resp.pii_entities_detection_job_properties_list[0].redaction_config.pii_entity_types[0] #=> String, one of "BANK_ACCOUNT_NUMBER", "BANK_ROUTING", "CREDIT_DEBIT_NUMBER", "CREDIT_DEBIT_CVV", "CREDIT_DEBIT_EXPIRY", "PIN", "EMAIL", "ADDRESS", "NAME", "PHONE", "SSN", "DATE_TIME", "PASSPORT_NUMBER", "DRIVER_ID", "URL", "AGE", "USERNAME", "PASSWORD", "AWS_ACCESS_KEY", "AWS_SECRET_KEY", "IP_ADDRESS", "MAC_ADDRESS", "ALL"
+    #   resp.pii_entities_detection_job_properties_list[0].redaction_config.pii_entity_types[0] #=> String, one of "BANK_ACCOUNT_NUMBER", "BANK_ROUTING", "CREDIT_DEBIT_NUMBER", "CREDIT_DEBIT_CVV", "CREDIT_DEBIT_EXPIRY", "PIN", "EMAIL", "ADDRESS", "NAME", "PHONE", "SSN", "DATE_TIME", "PASSPORT_NUMBER", "DRIVER_ID", "URL", "AGE", "USERNAME", "PASSWORD", "AWS_ACCESS_KEY", "AWS_SECRET_KEY", "IP_ADDRESS", "MAC_ADDRESS", "ALL", "LICENSE_PLATE", "VEHICLE_IDENTIFICATION_NUMBER", "UK_NATIONAL_INSURANCE_NUMBER", "CA_SOCIAL_INSURANCE_NUMBER", "US_INDIVIDUAL_TAX_IDENTIFICATION_NUMBER", "UK_UNIQUE_TAXPAYER_REFERENCE_NUMBER", "IN_PERMANENT_ACCOUNT_NUMBER", "IN_NREGA", "INTERNATIONAL_BANK_ACCOUNT_NUMBER", "SWIFT_CODE", "UK_NATIONAL_HEALTH_SERVICE_NUMBER", "CA_HEALTH_NUMBER", "IN_AADHAAR", "IN_VOTER_NUMBER"
     #   resp.pii_entities_detection_job_properties_list[0].redaction_config.mask_mode #=> String, one of "MASK", "REPLACE_WITH_PII_ENTITY_TYPE"
     #   resp.pii_entities_detection_job_properties_list[0].redaction_config.mask_character #=> String
     #   resp.pii_entities_detection_job_properties_list[0].language_code #=> String, one of "en", "es", "fr", "de", "it", "pt", "ar", "hi", "ja", "ko", "zh", "zh-TW"
@@ -3821,7 +4001,8 @@ module Aws::Comprehend
     #   The identifier of the job.
     #
     # @option params [required, String] :language_code
-    #   The language of the input documents.
+    #   The language of the input documents. Currently, English is the only
+    #   valid language.
     #
     # @option params [String] :client_request_token
     #   A unique identifier for the request. If you don't set the client
@@ -3860,7 +4041,7 @@ module Aws::Comprehend
     #     },
     #     mode: "ONLY_REDACTION", # required, accepts ONLY_REDACTION, ONLY_OFFSETS
     #     redaction_config: {
-    #       pii_entity_types: ["BANK_ACCOUNT_NUMBER"], # accepts BANK_ACCOUNT_NUMBER, BANK_ROUTING, CREDIT_DEBIT_NUMBER, CREDIT_DEBIT_CVV, CREDIT_DEBIT_EXPIRY, PIN, EMAIL, ADDRESS, NAME, PHONE, SSN, DATE_TIME, PASSPORT_NUMBER, DRIVER_ID, URL, AGE, USERNAME, PASSWORD, AWS_ACCESS_KEY, AWS_SECRET_KEY, IP_ADDRESS, MAC_ADDRESS, ALL
+    #       pii_entity_types: ["BANK_ACCOUNT_NUMBER"], # accepts BANK_ACCOUNT_NUMBER, BANK_ROUTING, CREDIT_DEBIT_NUMBER, CREDIT_DEBIT_CVV, CREDIT_DEBIT_EXPIRY, PIN, EMAIL, ADDRESS, NAME, PHONE, SSN, DATE_TIME, PASSPORT_NUMBER, DRIVER_ID, URL, AGE, USERNAME, PASSWORD, AWS_ACCESS_KEY, AWS_SECRET_KEY, IP_ADDRESS, MAC_ADDRESS, ALL, LICENSE_PLATE, VEHICLE_IDENTIFICATION_NUMBER, UK_NATIONAL_INSURANCE_NUMBER, CA_SOCIAL_INSURANCE_NUMBER, US_INDIVIDUAL_TAX_IDENTIFICATION_NUMBER, UK_UNIQUE_TAXPAYER_REFERENCE_NUMBER, IN_PERMANENT_ACCOUNT_NUMBER, IN_NREGA, INTERNATIONAL_BANK_ACCOUNT_NUMBER, SWIFT_CODE, UK_NATIONAL_HEALTH_SERVICE_NUMBER, CA_HEALTH_NUMBER, IN_AADHAAR, IN_VOTER_NUMBER
     #       mask_mode: "MASK", # accepts MASK, REPLACE_WITH_PII_ENTITY_TYPE
     #       mask_character: "MaskCharacter",
     #     },
@@ -4029,9 +4210,8 @@ module Aws::Comprehend
     #   The identifier of the job.
     #
     # @option params [required, String] :language_code
-    #   The language of the input documents. You can specify any of the
-    #   primary languages supported by Amazon Comprehend. All documents must
-    #   be in the same language.
+    #   The language of the input documents. Currently, English is the only
+    #   supported language.
     #
     # @option params [String] :client_request_token
     #   A unique identifier for the request. If you don't set the client
@@ -4423,7 +4603,7 @@ module Aws::Comprehend
 
     # Stops a sentiment detection job in progress.
     #
-    # If the job state is `IN_PROGRESS` the job is marked for termination
+    # If the job state is `IN_PROGRESS`, the job is marked for termination
     # and put into the `STOP_REQUESTED` state. If the job completes before
     # it can be stopped, it is put into the `COMPLETED` state; otherwise the
     # job is be stopped and put into the `STOPPED` state.
@@ -4465,7 +4645,7 @@ module Aws::Comprehend
 
     # Stops a targeted sentiment detection job in progress.
     #
-    # If the job state is `IN_PROGRESS` the job is marked for termination
+    # If the job state is `IN_PROGRESS`, the job is marked for termination
     # and put into the `STOP_REQUESTED` state. If the job completes before
     # it can be stopped, it is put into the `COMPLETED` state; otherwise the
     # job is be stopped and put into the `STOPPED` state.
@@ -4633,7 +4813,12 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
-    # Updates information about the specified endpoint.
+    # Updates information about the specified endpoint. For information
+    # about endpoints, see [Managing endpoints][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/comprehend/latest/dg/manage-endpoints.html
     #
     # @option params [required, String] :endpoint_arn
     #   The Amazon Resource Number (ARN) of the endpoint being updated.
@@ -4683,7 +4868,7 @@ module Aws::Comprehend
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-comprehend'
-      context[:gem_version] = '1.60.0'
+      context[:gem_version] = '1.62.0'
       Seahorse::Client::Request.new(handlers, context)
     end