Class: Aws::Comprehend::Types::StartPiiEntitiesDetectionJobRequest

Inherits:
Struct
  • Object
show all
Defined in:
gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb

Overview

Note:

When making an API call, you may pass StartPiiEntitiesDetectionJobRequest data as a hash:

{
  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",
  },
  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",
  tags: [
    {
      key: "TagKey", # required
      value: "TagValue",
    },
  ],
}

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#client_request_tokenString

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.

Returns:

  • (String)


6100
6101
6102
6103
6104
6105
6106
6107
6108
6109
6110
6111
6112
# File 'gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb', line 6100

class StartPiiEntitiesDetectionJobRequest < Struct.new(
  :input_data_config,
  :output_data_config,
  :mode,
  :redaction_config,
  :data_access_role_arn,
  :job_name,
  :language_code,
  :client_request_token,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#data_access_role_arnString

The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that grants Amazon Comprehend read access to your input data.

Returns:

  • (String)


6100
6101
6102
6103
6104
6105
6106
6107
6108
6109
6110
6111
6112
# File 'gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb', line 6100

class StartPiiEntitiesDetectionJobRequest < Struct.new(
  :input_data_config,
  :output_data_config,
  :mode,
  :redaction_config,
  :data_access_role_arn,
  :job_name,
  :language_code,
  :client_request_token,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#input_data_configTypes::InputDataConfig

The input properties for a PII entities detection job.



6100
6101
6102
6103
6104
6105
6106
6107
6108
6109
6110
6111
6112
# File 'gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb', line 6100

class StartPiiEntitiesDetectionJobRequest < Struct.new(
  :input_data_config,
  :output_data_config,
  :mode,
  :redaction_config,
  :data_access_role_arn,
  :job_name,
  :language_code,
  :client_request_token,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#job_nameString

The identifier of the job.

Returns:

  • (String)


6100
6101
6102
6103
6104
6105
6106
6107
6108
6109
6110
6111
6112
# File 'gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb', line 6100

class StartPiiEntitiesDetectionJobRequest < Struct.new(
  :input_data_config,
  :output_data_config,
  :mode,
  :redaction_config,
  :data_access_role_arn,
  :job_name,
  :language_code,
  :client_request_token,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#language_codeString

The language of the input documents.

Returns:

  • (String)


6100
6101
6102
6103
6104
6105
6106
6107
6108
6109
6110
6111
6112
# File 'gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb', line 6100

class StartPiiEntitiesDetectionJobRequest < Struct.new(
  :input_data_config,
  :output_data_config,
  :mode,
  :redaction_config,
  :data_access_role_arn,
  :job_name,
  :language_code,
  :client_request_token,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#modeString

Specifies whether the output provides the locations (offsets) of PII entities or a file in which PII entities are redacted.

Returns:

  • (String)


6100
6101
6102
6103
6104
6105
6106
6107
6108
6109
6110
6111
6112
# File 'gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb', line 6100

class StartPiiEntitiesDetectionJobRequest < Struct.new(
  :input_data_config,
  :output_data_config,
  :mode,
  :redaction_config,
  :data_access_role_arn,
  :job_name,
  :language_code,
  :client_request_token,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#output_data_configTypes::OutputDataConfig

Provides configuration parameters for the output of PII entity detection jobs.



6100
6101
6102
6103
6104
6105
6106
6107
6108
6109
6110
6111
6112
# File 'gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb', line 6100

class StartPiiEntitiesDetectionJobRequest < Struct.new(
  :input_data_config,
  :output_data_config,
  :mode,
  :redaction_config,
  :data_access_role_arn,
  :job_name,
  :language_code,
  :client_request_token,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#redaction_configTypes::RedactionConfig

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.



6100
6101
6102
6103
6104
6105
6106
6107
6108
6109
6110
6111
6112
# File 'gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb', line 6100

class StartPiiEntitiesDetectionJobRequest < Struct.new(
  :input_data_config,
  :output_data_config,
  :mode,
  :redaction_config,
  :data_access_role_arn,
  :job_name,
  :language_code,
  :client_request_token,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#tagsArray<Types::Tag>

Tags to be associated with the PII entities 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.

Returns:



6100
6101
6102
6103
6104
6105
6106
6107
6108
6109
6110
6111
6112
# File 'gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb', line 6100

class StartPiiEntitiesDetectionJobRequest < Struct.new(
  :input_data_config,
  :output_data_config,
  :mode,
  :redaction_config,
  :data_access_role_arn,
  :job_name,
  :language_code,
  :client_request_token,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end