StartLoaderJobInput

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/amazon-neptune/json-schema/amazon-neptune-start-loader-job-input-schema.json",
  "title": "StartLoaderJobInput",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amazon-neptune-loader-api-openapi.yml#/components/schemas/StartLoaderJobInput",
  "type": "object",
  "properties": {
    "source": {
      "type": "string",
      "description": "The source parameter accepts an S3 URI that identifies a single file, multiple files, a folder, or multiple folders. Neptune loads every data file in any folder that is specified. The URI can be in any of the following formats. s3://(bucket_name)/(object-key-name) https://s3.amazonaws.com/(bucket_name)/(object-key-name) https://s3.us-east-1.amazonaws.com/(bucket_name)/(object-key-name) The object-key-name element of the URI is equivalent to the prefix parameter in an S3 ListObjects API call. It identifies all the objects in the specified S3 bucket whose names begin with that prefix. That can b"
    },
    "format": {
      "type": "string",
      "enum": [
        "csv",
        "opencypher",
        "ntriples",
        "nquads",
        "rdfxml",
        "turtle"
      ],
      "description": "The format of the data. For more information about data formats for the Neptune Loader command, see Load Data Formats. Allowed values csv for the Gremlin CSV data format. opencypher for the openCypher CSV data format. ntriples for the N-Triples RDF data format. nquads for the N-Quads RDF data format. rdfxml for the RDF\\XML RDF data format. turtle for the Turtle RDF data format."
    },
    "s3BucketRegion": {
      "type": "string",
      "enum": [
        "us-east-1",
        "us-east-2",
        "us-west-1",
        "us-west-2",
        "ca-central-1",
        "sa-east-1",
        "eu-north-1",
        "eu-west-1",
        "eu-west-2",
        "eu-west-3",
        "eu-central-1",
        "me-south-1",
        "af-south-1",
        "ap-east-1",
        "ap-northeast-1",
        "ap-northeast-2",
        "ap-southeast-1",
        "ap-southeast-2",
        "ap-south-1",
        "cn-north-1",
        "cn-northwest-1",
        "us-gov-west-1",
        "us-gov-east-1",
        "ca-west-1",
        "eu-south-2",
        "il-central-1",
        "me-central-1",
        "ap-northeast-3",
        "ap-southeast-3",
        "ap-southeast-4",
        "ap-southeast-5",
        "ap-southeast-7",
        "mx-central-1",
        "ap-east-2",
        "ap-south-2",
        "eu-central-2"
      ],
      "description": "The Amazon region of the S3 bucket. This must match the Amazon Region of the DB cluster."
    },
    "iamRoleArn": {
      "type": "string",
      "description": "The Amazon Resource Name (ARN) for an IAM role to be assumed by the Neptune DB instance for access to the S3 bucket. The IAM role ARN provided here should be attached to the DB cluster (see Adding the IAM Role to an Amazon Neptune Cluster."
    },
    "mode": {
      "type": "string",
      "enum": [
        "RESUME",
        "NEW",
        "AUTO"
      ],
      "description": "The load job mode. Allowed values: RESUME, NEW, AUTO. Default value: AUTO. RESUME - In RESUME mode, the loader looks for a previous load from this source, and if it finds one, resumes that load job. If no previous load job is found, the loader stops. The loader avoids reloading files that were successfully loaded in a previous job. It only tries to process failed files. If you dropped previously loaded data from your Neptune cluster, that data is not reloaded in this mode. If a previous load job loaded all files from the same source successfully, nothing is reloaded, and the loader returns suc"
    },
    "failOnError": {
      "type": "boolean",
      "description": "failOnError - A flag to toggle a complete stop on an error. Allowed values: \"TRUE\", \"FALSE\". Default value: \"TRUE\". When this parameter is set to \"FALSE\", the loader tries to load all the data in the location specified, skipping any entries with errors. When this parameter is set to \"TRUE\", the loader stops as soon as it encounters an error. Data loaded up to that point persists."
    },
    "parallelism": {
      "type": "string",
      "enum": [
        "LOW",
        "MEDIUM",
        "HIGH",
        "OVERSUBSCRIBE"
      ],
      "description": "The optional parallelism parameter can be set to reduce the number of threads used by the bulk load process. Allowed values: LOW – The number of threads used is the number of available vCPUs divided by 8. MEDIUM – The number of threads used is the number of available vCPUs divided by 2. HIGH – The number of threads used is the same as the number of available vCPUs. OVERSUBSCRIBE – The number of threads used is the number of available vCPUs multiplied by 2. If this value is used, the bulk loader takes up all available resources. This does not mean, however, that the OVERSUBSCRIBE setting result"
    },
    "parserConfiguration": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "parserConfiguration – An optional object with additional parser configuration values. Each of the child parameters is also optional: namedGraphUri - The default graph for all RDF formats when no graph is specified (for non-quads formats and NQUAD entries with no graph). The default is https://aws.amazon.com/neptune/vocab/v01/DefaultNamedGraph. baseUri - The base URI for RDF/XML and Turtle formats. The default is https://aws.amazon.com/neptune/default. allowEmptyStrings - Gremlin users need to be able to pass empty string values(\"\") as node and edge properties when loading CSV data. If allowEmp"
    },
    "updateSingleCardinalityProperties": {
      "type": "boolean",
      "description": "updateSingleCardinalityProperties is an optional parameter that controls how the bulk loader treats a new value for single-cardinality vertex or edge properties. This is not supported for loading openCypher data. Allowed values: \"TRUE\", \"FALSE\". Default value: \"FALSE\". By default, or when updateSingleCardinalityProperties is explicitly set to \"FALSE\", the loader treats a new value as an error, because it violates single cardinality. When updateSingleCardinalityProperties is set to \"TRUE\", on the other hand, the bulk loader replaces the existing value with the new one. If multiple edge or singl"
    },
    "queueRequest": {
      "type": "boolean",
      "description": "This is an optional flag parameter that indicates whether the load request can be queued up or not. You don't have to wait for one load job to complete before issuing the next one, because Neptune can queue up as many as 64 jobs at a time, provided that their queueRequest parameters are all set to \"TRUE\". The queue order of the jobs will be first-in-first-out (FIFO). If the queueRequest parameter is omitted or set to \"FALSE\", the load request will fail if another load job is already running. Allowed values: \"TRUE\", \"FALSE\". Default value: \"FALSE\"."
    },
    "dependencies": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "This is an optional parameter that can make a queued load request contingent on the successful completion of one or more previous jobs in the queue. Neptune can queue up as many as 64 load requests at a time, if their queueRequest parameters are set to \"TRUE\". The dependencies parameter lets you make execution of such a queued request dependent on the successful completion of one or more specified previous requests in the queue. For example, if load Job-A and Job-B are independent of each other, but load Job-C needs Job-A and Job-B to be finished before it begins, proceed as follows: Submit lo"
    },
    "userProvidedEdgeIds": {
      "type": "boolean",
      "description": "This parameter is required only when loading openCypher data that contains relationship IDs. It must be included and set to True when openCypher relationship IDs are explicitly provided in the load data (recommended). When userProvidedEdgeIds is absent or set to True, an :ID column must be present in every relationship file in the load. When userProvidedEdgeIds is present and set to False, relationship files in the load must not contain an :ID column. Instead, the Neptune loader automatically generates an ID for each relationship. It's useful to provide relationship IDs explicitly so that the "
    },
    "edgeOnlyLoad": {
      "type": "boolean",
      "description": "edgeOnlyLoad - A flag that controls file processing order during bulk loading. Allowed values: \"TRUE\", \"FALSE\". Default value: \"FALSE\". When this parameter is set to \"FALSE\", the loader automatically loads vertex files first, then edge files afterwards. It does this by first scanning all files to determine their contents (vertices or edges). When this parameter is set to \"TRUE\", the loader skips the initial scanning phase and immediately loads all files in the order they appear."
    }
  },
  "required": [
    "source",
    "format",
    "s3BucketRegion",
    "iamRoleArn"
  ]
}