aws-sdk-comprehend 1.37.0 → 1.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4fb3f7488cd480d7681c044f6040c13d0c88ba65b427f90c0a149c6efcd6103
-  data.tar.gz: 16771694de681d932a0a3f03385c32e01a093a80d1927d2fcfdb30c023ddba58
+  metadata.gz: b742f41b8729d157dc0220a9066fd13e7ef35f8cd74ed4dffda2a404d30f74cc
+  data.tar.gz: ed3245b0270f71abdc8a92725dd8f725e4e3bafbbd8490a4a8ed80cfd8d150c0
 SHA512:
-  metadata.gz: 7daea9d2a96bb4df5b9ac44190a60d592ef37383af2693b2a7d6d35362acd2040e6fa8d2d1d804e066d1959e9a4e54997f74037a7f224b403c70fe599ce72859
-  data.tar.gz: 7c2677947ff9a6d0f2c64141e044b0ff85fc20c3151451933ee9a15ca65a298c334f78cd5a7c8367318c696542c821c4044cfc443a819d74445c006b8a80c893
+  metadata.gz: 0204deb04b9404e7ff743e3aafac4504920c9279a026fe6ab9c17767817589fb6bcc0198b5ffe6716ba0800d5fcb5e1734b0420428626ab4ff5e6b852cae46a6
+  data.tar.gz: 49cafb1cf8bfd2d6bdd7b09aac3ac188269b0cbbb1bb406f76d4f44febfe211c5e0d2494ecc3ac7ecc458e6a569d2f10a1bced03614784e0140e818e37453010

data/lib/aws-sdk-comprehend.rb

@@ -7,6 +7,7 @@
 #
 # WARNING ABOUT GENERATED CODE
 
+
 require 'aws-sdk-core'
 require 'aws-sigv4'
 
@@ -47,6 +48,6 @@ require_relative 'aws-sdk-comprehend/customizations'
 # @!group service
 module Aws::Comprehend
 
-  GEM_VERSION = '1.37.0'
+  GEM_VERSION = '1.42.0'
 
 end

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

@@ -706,8 +706,15 @@ module Aws::Comprehend
     #       },
     #     ],
     #     input_data_config: { # required
-    #       s3_uri: "S3Uri", # required
+    #       data_format: "COMPREHEND_CSV", # accepts COMPREHEND_CSV, AUGMENTED_MANIFEST
+    #       s3_uri: "S3Uri",
     #       label_delimiter: "LabelDelimiter",
+    #       augmented_manifests: [
+    #         {
+    #           s3_uri: "S3Uri", # required
+    #           attribute_names: ["AttributeNamesListItem"], # required
+    #         },
+    #       ],
     #     },
     #     output_data_config: {
     #       s3_uri: "S3Uri",
@@ -873,12 +880,13 @@ module Aws::Comprehend
     #       },
     #     ],
     #     input_data_config: { # required
+    #       data_format: "COMPREHEND_CSV", # accepts COMPREHEND_CSV, AUGMENTED_MANIFEST
     #       entity_types: [ # required
     #         {
     #           type: "EntityTypeName", # required
     #         },
     #       ],
-    #       documents: { # required
+    #       documents: {
     #         s3_uri: "S3Uri", # required
     #       },
     #       annotations: {
@@ -887,6 +895,12 @@ module Aws::Comprehend
     #       entity_list: {
     #         s3_uri: "S3Uri", # required
     #       },
+    #       augmented_manifests: [
+    #         {
+    #           s3_uri: "S3Uri", # required
+    #           attribute_names: ["AttributeNamesListItem"], # required
+    #         },
+    #       ],
     #     },
     #     client_request_token: "ClientRequestTokenString",
     #     language_code: "en", # required, accepts en, es, fr, de, it, pt, ar, hi, ja, ko, zh, zh-TW
@@ -1069,8 +1083,13 @@ module Aws::Comprehend
     #   resp.document_classifier_properties.end_time #=> Time
     #   resp.document_classifier_properties.training_start_time #=> Time
     #   resp.document_classifier_properties.training_end_time #=> Time
+    #   resp.document_classifier_properties.input_data_config.data_format #=> String, one of "COMPREHEND_CSV", "AUGMENTED_MANIFEST"
     #   resp.document_classifier_properties.input_data_config.s3_uri #=> String
     #   resp.document_classifier_properties.input_data_config.label_delimiter #=> String
+    #   resp.document_classifier_properties.input_data_config.augmented_manifests #=> Array
+    #   resp.document_classifier_properties.input_data_config.augmented_manifests[0].s3_uri #=> String
+    #   resp.document_classifier_properties.input_data_config.augmented_manifests[0].attribute_names #=> Array
+    #   resp.document_classifier_properties.input_data_config.augmented_manifests[0].attribute_names[0] #=> String
     #   resp.document_classifier_properties.output_data_config.s3_uri #=> String
     #   resp.document_classifier_properties.output_data_config.kms_key_id #=> String
     #   resp.document_classifier_properties.classifier_metadata.number_of_labels #=> Integer
@@ -1256,11 +1275,16 @@ module Aws::Comprehend
     #   resp.entity_recognizer_properties.end_time #=> Time
     #   resp.entity_recognizer_properties.training_start_time #=> Time
     #   resp.entity_recognizer_properties.training_end_time #=> Time
+    #   resp.entity_recognizer_properties.input_data_config.data_format #=> String, one of "COMPREHEND_CSV", "AUGMENTED_MANIFEST"
     #   resp.entity_recognizer_properties.input_data_config.entity_types #=> Array
     #   resp.entity_recognizer_properties.input_data_config.entity_types[0].type #=> String
     #   resp.entity_recognizer_properties.input_data_config.documents.s3_uri #=> String
     #   resp.entity_recognizer_properties.input_data_config.annotations.s3_uri #=> String
     #   resp.entity_recognizer_properties.input_data_config.entity_list.s3_uri #=> String
+    #   resp.entity_recognizer_properties.input_data_config.augmented_manifests #=> Array
+    #   resp.entity_recognizer_properties.input_data_config.augmented_manifests[0].s3_uri #=> String
+    #   resp.entity_recognizer_properties.input_data_config.augmented_manifests[0].attribute_names #=> Array
+    #   resp.entity_recognizer_properties.input_data_config.augmented_manifests[0].attribute_names[0] #=> String
     #   resp.entity_recognizer_properties.recognizer_metadata.number_of_trained_documents #=> Integer
     #   resp.entity_recognizer_properties.recognizer_metadata.number_of_test_documents #=> Integer
     #   resp.entity_recognizer_properties.recognizer_metadata.evaluation_metrics.precision #=> Float
@@ -1288,6 +1312,47 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Gets the status and details of an events detection job.
+    #
+    # @option params [required, String] :job_id
+    #   The identifier of the events detection job.
+    #
+    # @return [Types::DescribeEventsDetectionJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeEventsDetectionJobResponse#events_detection_job_properties #events_detection_job_properties} => Types::EventsDetectionJobProperties
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_events_detection_job({
+    #     job_id: "JobId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.events_detection_job_properties.job_id #=> String
+    #   resp.events_detection_job_properties.job_name #=> String
+    #   resp.events_detection_job_properties.job_status #=> String, one of "SUBMITTED", "IN_PROGRESS", "COMPLETED", "FAILED", "STOP_REQUESTED", "STOPPED"
+    #   resp.events_detection_job_properties.message #=> String
+    #   resp.events_detection_job_properties.submit_time #=> Time
+    #   resp.events_detection_job_properties.end_time #=> Time
+    #   resp.events_detection_job_properties.input_data_config.s3_uri #=> String
+    #   resp.events_detection_job_properties.input_data_config.input_format #=> String, one of "ONE_DOC_PER_FILE", "ONE_DOC_PER_LINE"
+    #   resp.events_detection_job_properties.output_data_config.s3_uri #=> String
+    #   resp.events_detection_job_properties.output_data_config.kms_key_id #=> String
+    #   resp.events_detection_job_properties.language_code #=> String, one of "en", "es", "fr", "de", "it", "pt", "ar", "hi", "ja", "ko", "zh", "zh-TW"
+    #   resp.events_detection_job_properties.data_access_role_arn #=> String
+    #   resp.events_detection_job_properties.target_event_types #=> Array
+    #   resp.events_detection_job_properties.target_event_types[0] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DescribeEventsDetectionJob AWS API Documentation
+    #
+    # @overload describe_events_detection_job(params = {})
+    # @param [Hash] params ({})
+    def describe_events_detection_job(params = {}, options = {})
+      req = build_request(:describe_events_detection_job, params)
+      req.send_request(options)
+    end
+
     # Gets the properties associated with a key phrases detection job. Use
     # this operation to get the status of a detection job.
     #
@@ -1334,6 +1399,52 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Gets the properties associated with a PII entities detection job. For
+    # example, you can use this operation to get the job status.
+    #
+    # @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::DescribePiiEntitiesDetectionJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribePiiEntitiesDetectionJobResponse#pii_entities_detection_job_properties #pii_entities_detection_job_properties} => Types::PiiEntitiesDetectionJobProperties
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_pii_entities_detection_job({
+    #     job_id: "JobId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.pii_entities_detection_job_properties.job_id #=> String
+    #   resp.pii_entities_detection_job_properties.job_name #=> String
+    #   resp.pii_entities_detection_job_properties.job_status #=> String, one of "SUBMITTED", "IN_PROGRESS", "COMPLETED", "FAILED", "STOP_REQUESTED", "STOPPED"
+    #   resp.pii_entities_detection_job_properties.message #=> String
+    #   resp.pii_entities_detection_job_properties.submit_time #=> Time
+    #   resp.pii_entities_detection_job_properties.end_time #=> Time
+    #   resp.pii_entities_detection_job_properties.input_data_config.s3_uri #=> String
+    #   resp.pii_entities_detection_job_properties.input_data_config.input_format #=> String, one of "ONE_DOC_PER_FILE", "ONE_DOC_PER_LINE"
+    #   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.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"
+    #   resp.pii_entities_detection_job_properties.data_access_role_arn #=> String
+    #   resp.pii_entities_detection_job_properties.mode #=> String, one of "ONLY_REDACTION", "ONLY_OFFSETS"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DescribePiiEntitiesDetectionJob AWS API Documentation
+    #
+    # @overload describe_pii_entities_detection_job(params = {})
+    # @param [Hash] params ({})
+    def describe_pii_entities_detection_job(params = {}, options = {})
+      req = build_request(:describe_pii_entities_detection_job, params)
+      req.send_request(options)
+    end
+
     # Gets the properties associated with a sentiment detection job. Use
     # this operation to get the status of a detection job.
     #
@@ -1557,6 +1668,44 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Inspects the input text for entities that contain personally
+    # 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.
+    #
+    # @option params [required, String] :language_code
+    #   The language of the input documents.
+    #
+    # @return [Types::DetectPiiEntitiesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DetectPiiEntitiesResponse#entities #entities} => Array<Types::PiiEntity>
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.detect_pii_entities({
+    #     text: "String", # 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].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].begin_offset #=> Integer
+    #   resp.entities[0].end_offset #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/DetectPiiEntities AWS API Documentation
+    #
+    # @overload detect_pii_entities(params = {})
+    # @param [Hash] params ({})
+    def detect_pii_entities(params = {}, options = {})
+      req = build_request(:detect_pii_entities, params)
+      req.send_request(options)
+    end
+
     # Inspects text and returns an inference of the prevailing sentiment
     # (`POSITIVE`, `NEUTRAL`, `MIXED`, or `NEGATIVE`).
     #
@@ -1751,8 +1900,13 @@ module Aws::Comprehend
     #   resp.document_classifier_properties_list[0].end_time #=> Time
     #   resp.document_classifier_properties_list[0].training_start_time #=> Time
     #   resp.document_classifier_properties_list[0].training_end_time #=> Time
+    #   resp.document_classifier_properties_list[0].input_data_config.data_format #=> String, one of "COMPREHEND_CSV", "AUGMENTED_MANIFEST"
     #   resp.document_classifier_properties_list[0].input_data_config.s3_uri #=> String
     #   resp.document_classifier_properties_list[0].input_data_config.label_delimiter #=> String
+    #   resp.document_classifier_properties_list[0].input_data_config.augmented_manifests #=> Array
+    #   resp.document_classifier_properties_list[0].input_data_config.augmented_manifests[0].s3_uri #=> String
+    #   resp.document_classifier_properties_list[0].input_data_config.augmented_manifests[0].attribute_names #=> Array
+    #   resp.document_classifier_properties_list[0].input_data_config.augmented_manifests[0].attribute_names[0] #=> String
     #   resp.document_classifier_properties_list[0].output_data_config.s3_uri #=> String
     #   resp.document_classifier_properties_list[0].output_data_config.kms_key_id #=> String
     #   resp.document_classifier_properties_list[0].classifier_metadata.number_of_labels #=> Integer
@@ -2020,11 +2174,16 @@ module Aws::Comprehend
     #   resp.entity_recognizer_properties_list[0].end_time #=> Time
     #   resp.entity_recognizer_properties_list[0].training_start_time #=> Time
     #   resp.entity_recognizer_properties_list[0].training_end_time #=> Time
+    #   resp.entity_recognizer_properties_list[0].input_data_config.data_format #=> String, one of "COMPREHEND_CSV", "AUGMENTED_MANIFEST"
     #   resp.entity_recognizer_properties_list[0].input_data_config.entity_types #=> Array
     #   resp.entity_recognizer_properties_list[0].input_data_config.entity_types[0].type #=> String
     #   resp.entity_recognizer_properties_list[0].input_data_config.documents.s3_uri #=> String
     #   resp.entity_recognizer_properties_list[0].input_data_config.annotations.s3_uri #=> String
     #   resp.entity_recognizer_properties_list[0].input_data_config.entity_list.s3_uri #=> String
+    #   resp.entity_recognizer_properties_list[0].input_data_config.augmented_manifests #=> Array
+    #   resp.entity_recognizer_properties_list[0].input_data_config.augmented_manifests[0].s3_uri #=> String
+    #   resp.entity_recognizer_properties_list[0].input_data_config.augmented_manifests[0].attribute_names #=> Array
+    #   resp.entity_recognizer_properties_list[0].input_data_config.augmented_manifests[0].attribute_names[0] #=> String
     #   resp.entity_recognizer_properties_list[0].recognizer_metadata.number_of_trained_documents #=> Integer
     #   resp.entity_recognizer_properties_list[0].recognizer_metadata.number_of_test_documents #=> Integer
     #   resp.entity_recognizer_properties_list[0].recognizer_metadata.evaluation_metrics.precision #=> Float
@@ -2053,6 +2212,67 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Gets a list of the events detection jobs that you have submitted.
+    #
+    # @option params [Types::EventsDetectionJobFilter] :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.
+    #
+    # @return [Types::ListEventsDetectionJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListEventsDetectionJobsResponse#events_detection_job_properties_list #events_detection_job_properties_list} => Array<Types::EventsDetectionJobProperties>
+    #   * {Types::ListEventsDetectionJobsResponse#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_events_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.events_detection_job_properties_list #=> Array
+    #   resp.events_detection_job_properties_list[0].job_id #=> String
+    #   resp.events_detection_job_properties_list[0].job_name #=> String
+    #   resp.events_detection_job_properties_list[0].job_status #=> String, one of "SUBMITTED", "IN_PROGRESS", "COMPLETED", "FAILED", "STOP_REQUESTED", "STOPPED"
+    #   resp.events_detection_job_properties_list[0].message #=> String
+    #   resp.events_detection_job_properties_list[0].submit_time #=> Time
+    #   resp.events_detection_job_properties_list[0].end_time #=> Time
+    #   resp.events_detection_job_properties_list[0].input_data_config.s3_uri #=> String
+    #   resp.events_detection_job_properties_list[0].input_data_config.input_format #=> String, one of "ONE_DOC_PER_FILE", "ONE_DOC_PER_LINE"
+    #   resp.events_detection_job_properties_list[0].output_data_config.s3_uri #=> String
+    #   resp.events_detection_job_properties_list[0].output_data_config.kms_key_id #=> String
+    #   resp.events_detection_job_properties_list[0].language_code #=> String, one of "en", "es", "fr", "de", "it", "pt", "ar", "hi", "ja", "ko", "zh", "zh-TW"
+    #   resp.events_detection_job_properties_list[0].data_access_role_arn #=> String
+    #   resp.events_detection_job_properties_list[0].target_event_types #=> Array
+    #   resp.events_detection_job_properties_list[0].target_event_types[0] #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/ListEventsDetectionJobs AWS API Documentation
+    #
+    # @overload list_events_detection_jobs(params = {})
+    # @param [Hash] params ({})
+    def list_events_detection_jobs(params = {}, options = {})
+      req = build_request(:list_events_detection_jobs, params)
+      req.send_request(options)
+    end
+
     # Get a list of key phrase detection jobs that you have submitted.
     #
     # @option params [Types::KeyPhrasesDetectionJobFilter] :filter
@@ -2118,6 +2338,68 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Gets a list of the PII entity detection jobs that you have submitted.
+    #
+    # @option params [Types::PiiEntitiesDetectionJobFilter] :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.
+    #
+    # @return [Types::ListPiiEntitiesDetectionJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListPiiEntitiesDetectionJobsResponse#pii_entities_detection_job_properties_list #pii_entities_detection_job_properties_list} => Array<Types::PiiEntitiesDetectionJobProperties>
+    #   * {Types::ListPiiEntitiesDetectionJobsResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_pii_entities_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.pii_entities_detection_job_properties_list #=> Array
+    #   resp.pii_entities_detection_job_properties_list[0].job_id #=> String
+    #   resp.pii_entities_detection_job_properties_list[0].job_name #=> String
+    #   resp.pii_entities_detection_job_properties_list[0].job_status #=> String, one of "SUBMITTED", "IN_PROGRESS", "COMPLETED", "FAILED", "STOP_REQUESTED", "STOPPED"
+    #   resp.pii_entities_detection_job_properties_list[0].message #=> String
+    #   resp.pii_entities_detection_job_properties_list[0].submit_time #=> Time
+    #   resp.pii_entities_detection_job_properties_list[0].end_time #=> Time
+    #   resp.pii_entities_detection_job_properties_list[0].input_data_config.s3_uri #=> String
+    #   resp.pii_entities_detection_job_properties_list[0].input_data_config.input_format #=> String, one of "ONE_DOC_PER_FILE", "ONE_DOC_PER_LINE"
+    #   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.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"
+    #   resp.pii_entities_detection_job_properties_list[0].data_access_role_arn #=> String
+    #   resp.pii_entities_detection_job_properties_list[0].mode #=> String, one of "ONLY_REDACTION", "ONLY_OFFSETS"
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/comprehend-2017-11-27/ListPiiEntitiesDetectionJobs AWS API Documentation
+    #
+    # @overload list_pii_entities_detection_jobs(params = {})
+    # @param [Hash] params ({})
+    def list_pii_entities_detection_jobs(params = {}, options = {})
+      req = build_request(:list_pii_entities_detection_jobs, params)
+      req.send_request(options)
+    end
+
     # Gets a list of sentiment detection jobs that you have submitted.
     #
     # @option params [Types::SentimentDetectionJobFilter] :filter
@@ -2567,6 +2849,73 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Starts an asynchronous event detection job for a collection of
+    # documents.
+    #
+    # @option params [required, Types::InputDataConfig] :input_data_config
+    #   Specifies the format and location of the input data for the 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.
+    #
+    # @option params [String] :job_name
+    #   The identifier of the events detection job.
+    #
+    # @option params [required, String] :language_code
+    #   The language code of the input documents.
+    #
+    # @option params [String] :client_request_token
+    #   An 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 [required, Array<String>] :target_event_types
+    #   The types of events to detect in the input documents.
+    #
+    # @return [Types::StartEventsDetectionJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartEventsDetectionJobResponse#job_id #job_id} => String
+    #   * {Types::StartEventsDetectionJobResponse#job_status #job_status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_events_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
+    #     },
+    #     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",
+    #     target_event_types: ["EventTypeString"], # 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/StartEventsDetectionJob AWS API Documentation
+    #
+    # @overload start_events_detection_job(params = {})
+    # @param [Hash] params ({})
+    def start_events_detection_job(params = {}, options = {})
+      req = build_request(:start_events_detection_job, params)
+      req.send_request(options)
+    end
+
     # Starts an asynchronous key phrase detection job for a collection of
     # documents. Use the operation to track the status of a job.
     #
@@ -2662,6 +3011,87 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Starts an asynchronous PII entity detection job for a collection of
+    # documents.
+    #
+    # @option params [required, Types::InputDataConfig] :input_data_config
+    #   The input properties for a PII entities detection job.
+    #
+    # @option params [required, Types::OutputDataConfig] :output_data_config
+    #   Provides configuration parameters for the output of PII entity
+    #   detection jobs.
+    #
+    # @option params [required, String] :mode
+    #   Specifies whether the output provides the locations (offsets) of PII
+    #   entities or a file in which PII entities are redacted.
+    #
+    # @option params [Types::RedactionConfig] :redaction_config
+    #   Provides configuration parameters for PII entity redaction.
+    #
+    #   This parameter is required if you set the `Mode` parameter to
+    #   `ONLY_REDACTION`. In that case, you must provide a `RedactionConfig`
+    #   definition that includes the `PiiEntityTypes` parameter.
+    #
+    # @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.
+    #
+    # @option params [String] :job_name
+    #   The identifier of the job.
+    #
+    # @option params [required, String] :language_code
+    #   The language of the input documents.
+    #
+    # @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.**
+    #
+    # @return [Types::StartPiiEntitiesDetectionJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartPiiEntitiesDetectionJobResponse#job_id #job_id} => String
+    #   * {Types::StartPiiEntitiesDetectionJobResponse#job_status #job_status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_pii_entities_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
+    #     },
+    #     output_data_config: { # required
+    #       s3_uri: "S3Uri", # required
+    #       kms_key_id: "KmsKeyId",
+    #     },
+    #     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
+    #       mask_mode: "MASK", # accepts MASK, REPLACE_WITH_PII_ENTITY_TYPE
+    #       mask_character: "MaskCharacter",
+    #     },
+    #     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",
+    #   })
+    #
+    # @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/StartPiiEntitiesDetectionJob AWS API Documentation
+    #
+    # @overload start_pii_entities_detection_job(params = {})
+    # @param [Hash] params ({})
+    def start_pii_entities_detection_job(params = {}, options = {})
+      req = build_request(:start_pii_entities_detection_job, params)
+      req.send_request(options)
+    end
+
     # Starts an asynchronous sentiment detection job for a collection of
     # documents. use the operation to track the status of a job.
     #
@@ -2937,6 +3367,36 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Stops an events detection job in progress.
+    #
+    # @option params [required, String] :job_id
+    #   The identifier of the events detection job to stop.
+    #
+    # @return [Types::StopEventsDetectionJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StopEventsDetectionJobResponse#job_id #job_id} => String
+    #   * {Types::StopEventsDetectionJobResponse#job_status #job_status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.stop_events_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/StopEventsDetectionJob AWS API Documentation
+    #
+    # @overload stop_events_detection_job(params = {})
+    # @param [Hash] params ({})
+    def stop_events_detection_job(params = {}, options = {})
+      req = build_request(:stop_events_detection_job, params)
+      req.send_request(options)
+    end
+
     # Stops a key phrases detection job in progress.
     #
     # If the job state is `IN_PROGRESS` the job is marked for termination
@@ -2979,6 +3439,36 @@ module Aws::Comprehend
       req.send_request(options)
     end
 
+    # Stops a PII entities detection job in progress.
+    #
+    # @option params [required, String] :job_id
+    #   The identifier of the PII entities detection job to stop.
+    #
+    # @return [Types::StopPiiEntitiesDetectionJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StopPiiEntitiesDetectionJobResponse#job_id #job_id} => String
+    #   * {Types::StopPiiEntitiesDetectionJobResponse#job_status #job_status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.stop_pii_entities_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/StopPiiEntitiesDetectionJob AWS API Documentation
+    #
+    # @overload stop_pii_entities_detection_job(params = {})
+    # @param [Hash] params ({})
+    def stop_pii_entities_detection_job(params = {}, options = {})
+      req = build_request(:stop_pii_entities_detection_job, params)
+      req.send_request(options)
+    end
+
     # Stops a sentiment detection job in progress.
     #
     # If the job state is `IN_PROGRESS` the job is marked for termination
@@ -3190,7 +3680,7 @@ module Aws::Comprehend
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-comprehend'
-      context[:gem_version] = '1.37.0'
+      context[:gem_version] = '1.42.0'
       Seahorse::Client::Request.new(handlers, context)
     end