aws-sdk-comprehend 1.58.0 → 1.61.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2ec5735718fc3eaf23440ab18f4ade3d29391eaf7fde2972ef70ec75a1049e27
-  data.tar.gz: b7ac60515580b749a00794be7fb5826c147f96f49cdd6a7812cf5d32fab3b7ec
+  metadata.gz: e9506b07c0fd74a91d95eb651618788bde3605dbe23762423c4e241644bcc3c8
+  data.tar.gz: '0094e85d2ff29db0389c55662ac90e94ccdd3b08076b56d09a7e94ee8a2efdba'
 SHA512:
-  metadata.gz: 9125de7a4c2674e9d2aa9ff34b4852b87d11ad1cade537946c86e68391af0a3cbf41571b6311fcded62165ed749c54273813deeac31e62ce04ac30a73fd5bb23
-  data.tar.gz: 189807a266da35c12358f209cc8732bbf2a6ba37de73fa01c1e0fdb2bcd6959797e1eef1a8aa7997fb1be17467cf63265122e6aafa74a4692656727ac4d949fa
+  metadata.gz: 61ed9fc9bbe5d1c330e70d64564ba6beb6eccbd6a8e25cd8be9e1e896536a44d930138c626a2054f90302d33fb2894115a777abd6e1ad12cb0bcbe787f980efe
+  data.tar.gz: faa8ad043980f18673d0f31f286713e60dba7b5af54e6a69befac5fd9894be4f1cd73c45b3507772c88a04189b5764523ce964938db5976f4aef0300aaae5738

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.61.0 (2022-05-20)
+------------------
+
+* Feature - Comprehend releases 14 new entity types for DetectPiiEntities and ContainsPiiEntities APIs.
+
+1.60.0 (2022-03-09)
+------------------
+
+* Feature - Amazon Comprehend now supports extracting the sentiment associated with entities such as brands, products and services from text documents.
+
+1.59.0 (2022-02-24)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.58.0 (2022-02-03)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.58.0
+1.61.0

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

@@ -27,6 +27,7 @@ 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/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
@@ -75,6 +76,7 @@ module Aws::Comprehend
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::ChecksumAlgorithm)
     add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::SignatureV4)
@@ -460,7 +462,7 @@ module Aws::Comprehend
     # @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.
+    #   than 5,000 bytes of UTF-8 encoded characters.
     #
     # @option params [required, String] :language_code
     #   The language of the input documents. You can specify any of the
@@ -611,7 +613,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:
     #
@@ -653,7 +660,8 @@ module Aws::Comprehend
     #   (PII) entity labels.
     #
     # @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:
     #
@@ -669,7 +677,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
@@ -847,7 +855,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`
@@ -1113,7 +1126,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.
@@ -1366,7 +1383,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.
@@ -1662,7 +1684,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"
@@ -1764,6 +1786,57 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Gets the properties associated with a targeted sentiment detection
+    # job. Use this operation to get the status of the job.
+    #
+    # @option params [required, String] :job_id
+    #   The identifier that Amazon Comprehend generated for the job. The
+    #   operation returns this identifier in its response.
+    #
+    # @return [Types::DescribeTargetedSentimentDetectionJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeTargetedSentimentDetectionJobResponse#targeted_sentiment_detection_job_properties #targeted_sentiment_detection_job_properties} => Types::TargetedSentimentDetectionJobProperties
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_targeted_sentiment_detection_job({
+    #     job_id: "JobId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.targeted_sentiment_detection_job_properties.job_id #=> String
+    #   resp.targeted_sentiment_detection_job_properties.job_arn #=> String
+    #   resp.targeted_sentiment_detection_job_properties.job_name #=> String
+    #   resp.targeted_sentiment_detection_job_properties.job_status #=> String, one of "SUBMITTED", "IN_PROGRESS", "COMPLETED", "FAILED", "STOP_REQUESTED", "STOPPED"
+    #   resp.targeted_sentiment_detection_job_properties.message #=> String
+    #   resp.targeted_sentiment_detection_job_properties.submit_time #=> Time
+    #   resp.targeted_sentiment_detection_job_properties.end_time #=> Time
+    #   resp.targeted_sentiment_detection_job_properties.input_data_config.s3_uri #=> String
+    #   resp.targeted_sentiment_detection_job_properties.input_data_config.input_format #=> String, one of "ONE_DOC_PER_FILE", "ONE_DOC_PER_LINE"
+    #   resp.targeted_sentiment_detection_job_properties.input_data_config.document_reader_config.document_read_action #=> String, one of "TEXTRACT_DETECT_DOCUMENT_TEXT", "TEXTRACT_ANALYZE_DOCUMENT"
+    #   resp.targeted_sentiment_detection_job_properties.input_data_config.document_reader_config.document_read_mode #=> String, one of "SERVICE_DEFAULT", "FORCE_DOCUMENT_READ_ACTION"
+    #   resp.targeted_sentiment_detection_job_properties.input_data_config.document_reader_config.feature_types #=> Array
+    #   resp.targeted_sentiment_detection_job_properties.input_data_config.document_reader_config.feature_types[0] #=> String, one of "TABLES", "FORMS"
+    #   resp.targeted_sentiment_detection_job_properties.output_data_config.s3_uri #=> String
+    #   resp.targeted_sentiment_detection_job_properties.output_data_config.kms_key_id #=> String
+    #   resp.targeted_sentiment_detection_job_properties.language_code #=> String, one of "en", "es", "fr", "de", "it", "pt", "ar", "hi", "ja", "ko", "zh", "zh-TW"
+    #   resp.targeted_sentiment_detection_job_properties.data_access_role_arn #=> String
+    #   resp.targeted_sentiment_detection_job_properties.volume_kms_key_id #=> String
+    #   resp.targeted_sentiment_detection_job_properties.vpc_config.security_group_ids #=> Array
+    #   resp.targeted_sentiment_detection_job_properties.vpc_config.security_group_ids[0] #=> String
+    #   resp.targeted_sentiment_detection_job_properties.vpc_config.subnets #=> Array
+    #   resp.targeted_sentiment_detection_job_properties.vpc_config.subnets[0] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DescribeTargetedSentimentDetectionJob AWS API Documentation
+    #
+    # @overload describe_targeted_sentiment_detection_job(params = {})
+    # @param [Hash] params ({})
+    def describe_targeted_sentiment_detection_job(params = {}, options = {})
+      req = build_request(:describe_targeted_sentiment_detection_job, params)
+      req.send_request(options)
+    end
+
     # Gets the properties associated with a topic detection job. Use this
     # operation to get the status of a detection job.
     #
@@ -1877,6 +1950,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;
@@ -1954,7 +2033,8 @@ module Aws::Comprehend
     #   of UTF-8 encoded characters.
     #
     # @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:
     #
@@ -1971,7 +2051,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
     #
@@ -2423,7 +2503,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
@@ -2880,7 +2965,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"
@@ -3000,6 +3085,77 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Gets a list of targeted sentiment detection jobs that you have
+    # submitted.
+    #
+    # @option params [Types::TargetedSentimentDetectionJobFilter] :filter
+    #   Filters the jobs that are returned. You can filter jobs on their name,
+    #   status, or the date and time that they were submitted. 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::ListTargetedSentimentDetectionJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListTargetedSentimentDetectionJobsResponse#targeted_sentiment_detection_job_properties_list #targeted_sentiment_detection_job_properties_list} => Array&lt;Types::TargetedSentimentDetectionJobProperties&gt;
+    #   * {Types::ListTargetedSentimentDetectionJobsResponse#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_targeted_sentiment_detection_jobs({
+    #     filter: {
+    #       job_name: "JobName",
+    #       job_status: "SUBMITTED", # accepts SUBMITTED, IN_PROGRESS, COMPLETED, FAILED, STOP_REQUESTED, STOPPED
+    #       submit_time_before: Time.now,
+    #       submit_time_after: Time.now,
+    #     },
+    #     next_token: "String",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.targeted_sentiment_detection_job_properties_list #=> Array
+    #   resp.targeted_sentiment_detection_job_properties_list[0].job_id #=> String
+    #   resp.targeted_sentiment_detection_job_properties_list[0].job_arn #=> String
+    #   resp.targeted_sentiment_detection_job_properties_list[0].job_name #=> String
+    #   resp.targeted_sentiment_detection_job_properties_list[0].job_status #=> String, one of "SUBMITTED", "IN_PROGRESS", "COMPLETED", "FAILED", "STOP_REQUESTED", "STOPPED"
+    #   resp.targeted_sentiment_detection_job_properties_list[0].message #=> String
+    #   resp.targeted_sentiment_detection_job_properties_list[0].submit_time #=> Time
+    #   resp.targeted_sentiment_detection_job_properties_list[0].end_time #=> Time
+    #   resp.targeted_sentiment_detection_job_properties_list[0].input_data_config.s3_uri #=> String
+    #   resp.targeted_sentiment_detection_job_properties_list[0].input_data_config.input_format #=> String, one of "ONE_DOC_PER_FILE", "ONE_DOC_PER_LINE"
+    #   resp.targeted_sentiment_detection_job_properties_list[0].input_data_config.document_reader_config.document_read_action #=> String, one of "TEXTRACT_DETECT_DOCUMENT_TEXT", "TEXTRACT_ANALYZE_DOCUMENT"
+    #   resp.targeted_sentiment_detection_job_properties_list[0].input_data_config.document_reader_config.document_read_mode #=> String, one of "SERVICE_DEFAULT", "FORCE_DOCUMENT_READ_ACTION"
+    #   resp.targeted_sentiment_detection_job_properties_list[0].input_data_config.document_reader_config.feature_types #=> Array
+    #   resp.targeted_sentiment_detection_job_properties_list[0].input_data_config.document_reader_config.feature_types[0] #=> String, one of "TABLES", "FORMS"
+    #   resp.targeted_sentiment_detection_job_properties_list[0].output_data_config.s3_uri #=> String
+    #   resp.targeted_sentiment_detection_job_properties_list[0].output_data_config.kms_key_id #=> String
+    #   resp.targeted_sentiment_detection_job_properties_list[0].language_code #=> String, one of "en", "es", "fr", "de", "it", "pt", "ar", "hi", "ja", "ko", "zh", "zh-TW"
+    #   resp.targeted_sentiment_detection_job_properties_list[0].data_access_role_arn #=> String
+    #   resp.targeted_sentiment_detection_job_properties_list[0].volume_kms_key_id #=> String
+    #   resp.targeted_sentiment_detection_job_properties_list[0].vpc_config.security_group_ids #=> Array
+    #   resp.targeted_sentiment_detection_job_properties_list[0].vpc_config.security_group_ids[0] #=> String
+    #   resp.targeted_sentiment_detection_job_properties_list[0].vpc_config.subnets #=> Array
+    #   resp.targeted_sentiment_detection_job_properties_list[0].vpc_config.subnets[0] #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/ListTargetedSentimentDetectionJobs AWS API Documentation
+    #
+    # @overload list_targeted_sentiment_detection_jobs(params = {})
+    # @param [Hash] params ({})
+    def list_targeted_sentiment_detection_jobs(params = {}, options = {})
+      req = build_request(:list_targeted_sentiment_detection_jobs, params)
+      req.send_request(options)
+    end
+
     # Gets a list of the topic detection jobs that you have submitted.
     #
     # @option params [Types::TopicsDetectionJobFilter] :filter
@@ -3697,7 +3853,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
@@ -3736,7 +3893,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",
     #     },
@@ -3768,7 +3925,7 @@ module Aws::Comprehend
     end
 
     # Starts an asynchronous sentiment detection job for a collection of
-    # documents. use the operation to track the status of a job.
+    # documents. Use the operation to track the status of a job.
     #
     # @option params [required, Types::InputDataConfig] :input_data_config
     #   Specifies the format and location of the input data for the job.
@@ -3881,6 +4038,120 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Starts an asynchronous targeted sentiment detection job for a
+    # collection of documents. Use the operation to track the status of a
+    # job.
+    #
+    # @option params [required, Types::InputDataConfig] :input_data_config
+    #   The input properties for an inference job.
+    #
+    # @option params [required, Types::OutputDataConfig] :output_data_config
+    #   Specifies where to send the output files.
+    #
+    # @option params [required, String] :data_access_role_arn
+    #   The Amazon Resource Name (ARN) of the AWS Identity and Access
+    #   Management (IAM) role that grants Amazon Comprehend read access to
+    #   your input data. For more information, see [Role-based
+    #   permissions][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions
+    #
+    # @option params [String] :job_name
+    #   The identifier of the job.
+    #
+    # @option params [required, String] :language_code
+    #   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
+    #   request token, Amazon Comprehend generates one.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    # @option params [String] :volume_kms_key_id
+    #   ID for the KMS key that Amazon Comprehend uses to encrypt data on the
+    #   storage volume attached to the ML compute instance(s) that process the
+    #   analysis job. The VolumeKmsKeyId can be either of the following
+    #   formats:
+    #
+    #   * KMS Key ID: `"1234abcd-12ab-34cd-56ef-1234567890ab"`
+    #
+    #   * Amazon Resource Name (ARN) of a KMS Key:
+    #     `"arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"`
+    #
+    # @option params [Types::VpcConfig] :vpc_config
+    #   Configuration parameters for an optional private Virtual Private Cloud
+    #   (VPC) containing the resources you are using for the job. For more
+    #   information, see [Amazon VPC][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/vpc/latest/userguide/what-is-amazon-vpc.html
+    #
+    # @option params [Array<Types::Tag>] :tags
+    #   Tags to be associated with the targeted sentiment detection job. A tag
+    #   is a key-value pair that adds metadata to a resource used by Amazon
+    #   Comprehend. For example, a tag with "Sales" as the key might be
+    #   added to a resource to indicate its use by the sales department.
+    #
+    # @return [Types::StartTargetedSentimentDetectionJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartTargetedSentimentDetectionJobResponse#job_id #job_id} => String
+    #   * {Types::StartTargetedSentimentDetectionJobResponse#job_arn #job_arn} => String
+    #   * {Types::StartTargetedSentimentDetectionJobResponse#job_status #job_status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_targeted_sentiment_detection_job({
+    #     input_data_config: { # required
+    #       s3_uri: "S3Uri", # required
+    #       input_format: "ONE_DOC_PER_FILE", # accepts ONE_DOC_PER_FILE, ONE_DOC_PER_LINE
+    #       document_reader_config: {
+    #         document_read_action: "TEXTRACT_DETECT_DOCUMENT_TEXT", # required, accepts TEXTRACT_DETECT_DOCUMENT_TEXT, TEXTRACT_ANALYZE_DOCUMENT
+    #         document_read_mode: "SERVICE_DEFAULT", # accepts SERVICE_DEFAULT, FORCE_DOCUMENT_READ_ACTION
+    #         feature_types: ["TABLES"], # accepts TABLES, FORMS
+    #       },
+    #     },
+    #     output_data_config: { # required
+    #       s3_uri: "S3Uri", # required
+    #       kms_key_id: "KmsKeyId",
+    #     },
+    #     data_access_role_arn: "IamRoleArn", # required
+    #     job_name: "JobName",
+    #     language_code: "en", # required, accepts en, es, fr, de, it, pt, ar, hi, ja, ko, zh, zh-TW
+    #     client_request_token: "ClientRequestTokenString",
+    #     volume_kms_key_id: "KmsKeyId",
+    #     vpc_config: {
+    #       security_group_ids: ["SecurityGroupId"], # required
+    #       subnets: ["SubnetId"], # required
+    #     },
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue",
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.job_id #=> String
+    #   resp.job_arn #=> String
+    #   resp.job_status #=> String, one of "SUBMITTED", "IN_PROGRESS", "COMPLETED", "FAILED", "STOP_REQUESTED", "STOPPED"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/StartTargetedSentimentDetectionJob AWS API Documentation
+    #
+    # @overload start_targeted_sentiment_detection_job(params = {})
+    # @param [Hash] params ({})
+    def start_targeted_sentiment_detection_job(params = {}, options = {})
+      req = build_request(:start_targeted_sentiment_detection_job, params)
+      req.send_request(options)
+    end
+
     # Starts an asynchronous topic detection job. Use the
     # `DescribeTopicDetectionJob` operation to track the status of a job.
     #
@@ -4184,7 +4455,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.
@@ -4224,6 +4495,48 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Stops a targeted sentiment detection job in progress.
+    #
+    # 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.
+    #
+    # If the job is in the `COMPLETED` or `FAILED` state when you call the
+    # `StopDominantLanguageDetectionJob` operation, the operation returns a
+    # 400 Internal Request Exception.
+    #
+    # When a job is stopped, any documents already processed are written to
+    # the output location.
+    #
+    # @option params [required, String] :job_id
+    #   The identifier of the targeted sentiment detection job to stop.
+    #
+    # @return [Types::StopTargetedSentimentDetectionJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StopTargetedSentimentDetectionJobResponse#job_id #job_id} => String
+    #   * {Types::StopTargetedSentimentDetectionJobResponse#job_status #job_status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.stop_targeted_sentiment_detection_job({
+    #     job_id: "JobId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.job_id #=> String
+    #   resp.job_status #=> String, one of "SUBMITTED", "IN_PROGRESS", "COMPLETED", "FAILED", "STOP_REQUESTED", "STOPPED"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/StopTargetedSentimentDetectionJob AWS API Documentation
+    #
+    # @overload stop_targeted_sentiment_detection_job(params = {})
+    # @param [Hash] params ({})
+    def stop_targeted_sentiment_detection_job(params = {}, options = {})
+      req = build_request(:stop_targeted_sentiment_detection_job, params)
+      req.send_request(options)
+    end
+
     # Stops a document classifier training job while in progress.
     #
     # If the training job state is `TRAINING`, the job is marked for
@@ -4352,7 +4665,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.
@@ -4402,7 +4720,7 @@ module Aws::Comprehend
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-comprehend'
-      context[:gem_version] = '1.58.0'
+      context[:gem_version] = '1.61.0'
       Seahorse::Client::Request.new(handlers, context)
     end