{ "$schema": "https://json-structure.org/meta/core/v0/#", "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-comprehend/refs/heads/main/json-structure/openapi.yml-start-pii-entities-detection-job-request-structure.json", "name": "StartPiiEntitiesDetectionJobRequest", "description": "StartPiiEntitiesDetectionJobRequest schema", "type": "object", "properties": { "InputDataConfig": { "allOf": [ { "$ref": "#/components/schemas/InputDataConfig" }, { "description": "The input properties for a PII entities detection job." } ] }, "OutputDataConfig": { "allOf": [ { "$ref": "#/components/schemas/OutputDataConfig" }, { "description": "Provides con\ufb01guration parameters for the output of PII entity detection jobs." } ] }, "Mode": { "allOf": [ { "$ref": "#/components/schemas/PiiEntitiesDetectionMode" }, { "description": "Specifies whether the output provides the locations (offsets) of PII entities or a file in which PII entities are redacted." } ] }, "RedactionConfig": { "allOf": [ { "$ref": "#/components/schemas/RedactionConfig" }, { "description": "

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.

" } ] }, "DataAccessRoleArn": { "allOf": [ { "$ref": "#/components/schemas/IamRoleArn" }, { "description": "The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend read access to your input data." } ] }, "JobName": { "allOf": [ { "$ref": "#/components/schemas/JobName" }, { "description": "The identifier of the job." } ] }, "LanguageCode": { "allOf": [ { "$ref": "#/components/schemas/LanguageCode" }, { "description": "The language of the input documents. Currently, English is the only valid language." } ] }, "ClientRequestToken": { "allOf": [ { "$ref": "#/components/schemas/ClientRequestTokenString" }, { "description": "A unique identifier for the request. If you don't set the client request token, Amazon Comprehend generates one." } ] }, "Tags": { "allOf": [ { "$ref": "#/components/schemas/TagList" }, { "description": "Tags to associate 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." } ] } }, "required": [ "InputDataConfig", "OutputDataConfig", "Mode", "DataAccessRoleArn", "LanguageCode" ] }