Amazon Comprehend · JSON Structure

Openapi.Yml Start Pii Entities Detection Job Request Structure

StartPiiEntitiesDetectionJobRequest schema

Type: object Properties: 9 Required: 5
Machine LearningNatural Language ProcessingNLPText Analysis

StartPiiEntitiesDetectionJobRequest is a JSON Structure definition published by Amazon Comprehend, describing 9 properties, of which 5 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

InputDataConfig OutputDataConfig Mode RedactionConfig DataAccessRoleArn JobName LanguageCode ClientRequestToken Tags

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$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": "<p>Provides configuration parameters for PII entity redaction.</p> <p>This parameter is required if you set the <code>Mode</code> parameter to <code>ONLY_REDACTION</code>. In that case, you must provide a <code>RedactionConfig</code> definition that includes the <code>PiiEntityTypes</code> parameter.</p>"
        }
      ]
    },
    "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"
  ]
}