aws-sdk-comprehend 1.34.0 → 1.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11748948d475c0bf4d3a5411da47e7a422c3ef4cfc54d1fa1818bf8e1f6fa286
-  data.tar.gz: f050489b0d80a847633811f2c1de56861364c545caabb2bdd58b8d011360deea
+  metadata.gz: fb841e7f98bf2b40de5e3f385e3585ec64e29b61e921778971208d527886a5c9
+  data.tar.gz: 4e8687f7495e31d6c9a844ba6a29b1867cf91ecfba0b3bdd64be8e3fda8dfa88
 SHA512:
-  metadata.gz: 0af4bdffd5ce15ed08cef833efcb3e92db0533c36b3350676a82223b20fe284cbf3a6eb42fb8450384b45692b0d3d1784ad86779d2e986e4bf6edc7b19b04d89
-  data.tar.gz: a4ea81392c59ae740f7ed0ff858ebb4d18d4f466799755dd5e3af6c16a413089bbe124c53aabe7ff8d889ba033c5044101c0db157092d8669d4383f2f8d6cfcf
+  metadata.gz: 24ee5c1f0fa7e826845c22538e65a110fc59a26b171a2fb47ca05ac5ddc050c09adae81ace2c086dca498f1a47cd6910cfd2630d221e8a8bd61ccaf57812060b
+  data.tar.gz: 0eccd1f090108d68ff3f208b0499112eea405e401966f6dff53174e29c71e1892cd530ce3bf9b0bcac977101a626e1f8dca1de1d0f04d909f67cc89640b50e19

data/lib/aws-sdk-comprehend.rb

@@ -7,6 +7,7 @@
 #
 # WARNING ABOUT GENERATED CODE
 
+
 require 'aws-sdk-core'
 require 'aws-sigv4'
 
@@ -44,9 +45,9 @@ require_relative 'aws-sdk-comprehend/customizations'
 #
 # See {Errors} for more information.
 #
-# @service
+# @!group service
 module Aws::Comprehend
 
-  GEM_VERSION = '1.34.0'
+  GEM_VERSION = '1.39.0'
 
 end

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

@@ -85,13 +85,28 @@ module Aws::Comprehend
     #     * `Aws::Credentials` - Used for configuring static, non-refreshing
     #       credentials.
     #
+    #     * `Aws::SharedCredentials` - Used for loading static credentials from a
+    #       shared file, such as `~/.aws/config`.
+    #
+    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #
+    #     * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
+    #       assume a role after providing credentials via the web.
+    #
+    #     * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
+    #       access token generated from `aws login`.
+    #
+    #     * `Aws::ProcessCredentials` - Used for loading credentials from a
+    #       process that outputs to stdout.
+    #
     #     * `Aws::InstanceProfileCredentials` - Used for loading credentials
     #       from an EC2 IMDS on an EC2 instance.
     #
-    #     * `Aws::SharedCredentials` - Used for loading credentials from a
-    #       shared file, such as `~/.aws/config`.
+    #     * `Aws::ECSCredentials` - Used for loading credentials from
+    #       instances running in ECS.
     #
-    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #     * `Aws::CognitoIdentityCredentials` - Used for loading credentials
+    #       from the Cognito Identity service.
     #
     #     When `:credentials` are not configured directly, the following
     #     locations will be searched for credentials:
@@ -101,10 +116,10 @@ module Aws::Comprehend
     #     * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
     #     * `~/.aws/credentials`
     #     * `~/.aws/config`
-    #     * EC2 IMDS instance profile - When used by default, the timeouts are
-    #       very aggressive. Construct and pass an instance of
-    #       `Aws::InstanceProfileCredentails` to enable retries and extended
-    #       timeouts.
+    #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
+    #       are very aggressive. Construct and pass an instance of
+    #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
+    #       enable retries and extended timeouts.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -344,7 +359,7 @@ module Aws::Comprehend
     # @example Request syntax with placeholder values
     #
     #   resp = client.batch_detect_dominant_language({
-    #     text_list: ["String"], # required
+    #     text_list: ["CustomerInputString"], # required
     #   })
     #
     # @example Response structure
@@ -390,7 +405,7 @@ module Aws::Comprehend
     # @example Request syntax with placeholder values
     #
     #   resp = client.batch_detect_entities({
-    #     text_list: ["String"], # required
+    #     text_list: ["CustomerInputString"], # required
     #     language_code: "en", # required, accepts en, es, fr, de, it, pt, ar, hi, ja, ko, zh, zh-TW
     #   })
     #
@@ -438,7 +453,7 @@ module Aws::Comprehend
     # @example Request syntax with placeholder values
     #
     #   resp = client.batch_detect_key_phrases({
-    #     text_list: ["String"], # required
+    #     text_list: ["CustomerInputString"], # required
     #     language_code: "en", # required, accepts en, es, fr, de, it, pt, ar, hi, ja, ko, zh, zh-TW
     #   })
     #
@@ -487,7 +502,7 @@ module Aws::Comprehend
     # @example Request syntax with placeholder values
     #
     #   resp = client.batch_detect_sentiment({
-    #     text_list: ["String"], # required
+    #     text_list: ["CustomerInputString"], # required
     #     language_code: "en", # required, accepts en, es, fr, de, it, pt, ar, hi, ja, ko, zh, zh-TW
     #   })
     #
@@ -537,7 +552,7 @@ module Aws::Comprehend
     # @example Request syntax with placeholder values
     #
     #   resp = client.batch_detect_syntax({
-    #     text_list: ["String"], # required
+    #     text_list: ["CustomerInputString"], # required
     #     language_code: "en", # required, accepts en, es, fr, de, it, pt
     #   })
     #
@@ -584,7 +599,7 @@ module Aws::Comprehend
     # @example Request syntax with placeholder values
     #
     #   resp = client.classify_document({
-    #     text: "String", # required
+    #     text: "CustomerInputString", # required
     #     endpoint_arn: "DocumentClassifierEndpointArn", # required
     #   })
     #
@@ -607,7 +622,7 @@ module Aws::Comprehend
     end
 
     # Creates a new document classifier that you can use to categorize
-    # documents. To create a classifier you provide a set of training
+    # documents. To create a classifier, you provide a set of training
     # 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
@@ -817,8 +832,10 @@ module Aws::Comprehend
     #   not need to pass this option.**
     #
     # @option params [required, String] :language_code
-    #   The language of the input documents. All documents must be in the same
-    #   language. Only English ("en") is currently supported.
+    #   You can specify any of the following languages supported by Amazon
+    #   Comprehend: English ("en"), Spanish ("es"), French ("fr"),
+    #   Italian ("it"), German ("de"), or Portuguese ("pt"). All
+    #   documents must be in the same language.
     #
     # @option params [String] :volume_kms_key_id
     #   ID for the AWS Key Management Service (KMS) key that Amazon Comprehend
@@ -1317,6 +1334,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.
     #
@@ -1427,7 +1490,7 @@ module Aws::Comprehend
     # @example Request syntax with placeholder values
     #
     #   resp = client.detect_dominant_language({
-    #     text: "String", # required
+    #     text: "CustomerInputString", # required
     #   })
     #
     # @example Response structure
@@ -1452,11 +1515,25 @@ module Aws::Comprehend
     #   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
+    # @option params [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.
     #
+    #   If your request includes the endpoint for a custom entity recognition
+    #   model, Amazon Comprehend uses the language of your custom model, and
+    #   it ignores any language code that you specify here.
+    #
+    # @option params [String] :endpoint_arn
+    #   The Amazon Resource Name of an endpoint that is associated with a
+    #   custom entity recognition model. Provide an endpoint if you want to
+    #   detect entities by using your own custom model instead of the default
+    #   model that is used by Amazon Comprehend.
+    #
+    #   If you specify an endpoint, Amazon Comprehend uses the language of
+    #   your custom model, and it ignores any language code that you provide
+    #   in your request.
+    #
     # @return [Types::DetectEntitiesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DetectEntitiesResponse#entities #entities} => Array<Types::Entity>
@@ -1464,8 +1541,9 @@ module Aws::Comprehend
     # @example Request syntax with placeholder values
     #
     #   resp = client.detect_entities({
-    #     text: "String", # required
-    #     language_code: "en", # required, accepts en, es, fr, de, it, pt, ar, hi, ja, ko, zh, zh-TW
+    #     text: "CustomerInputString", # required
+    #     language_code: "en", # accepts en, es, fr, de, it, pt, ar, hi, ja, ko, zh, zh-TW
+    #     endpoint_arn: "EntityRecognizerEndpointArn",
     #   })
     #
     # @example Response structure
@@ -1504,7 +1582,7 @@ module Aws::Comprehend
     # @example Request syntax with placeholder values
     #
     #   resp = client.detect_key_phrases({
-    #     text: "String", # required
+    #     text: "CustomerInputString", # required
     #     language_code: "en", # required, accepts en, es, fr, de, it, pt, ar, hi, ja, ko, zh, zh-TW
     #   })
     #
@@ -1525,6 +1603,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`).
     #
@@ -1545,7 +1661,7 @@ module Aws::Comprehend
     # @example Request syntax with placeholder values
     #
     #   resp = client.detect_sentiment({
-    #     text: "String", # required
+    #     text: "CustomerInputString", # required
     #     language_code: "en", # required, accepts en, es, fr, de, it, pt, ar, hi, ja, ko, zh, zh-TW
     #   })
     #
@@ -1586,7 +1702,7 @@ module Aws::Comprehend
     # @example Request syntax with placeholder values
     #
     #   resp = client.detect_syntax({
-    #     text: "String", # required
+    #     text: "CustomerInputString", # required
     #     language_code: "en", # required, accepts en, es, fr, de, it, pt
     #   })
     #
@@ -2086,6 +2202,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
@@ -2630,6 +2808,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.
     #
@@ -2947,6 +3206,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
@@ -3158,7 +3447,7 @@ module Aws::Comprehend
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-comprehend'
-      context[:gem_version] = '1.34.0'
+      context[:gem_version] = '1.39.0'
       Seahorse::Client::Request.new(handlers, context)
     end