

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Caricatore di massa Neptune Data Plane APIs
<a name="data-api-dp-loader"></a>

**Azioni di caricamento in blocco:**
+ [StartLoaderJob (azione)](#StartLoaderJob)
+ [GetLoaderJobStatus (azione)](#GetLoaderJobStatus)
+ [ListLoaderJobs (azione)](#ListLoaderJobs)
+ [CancelLoaderJob (azione)](#CancelLoaderJob)

**Struttura del caricamento in blocco:**
+ [LoaderIdResult (struttura)](#LoaderIdResult)

## StartLoaderJob (azione)
<a name="StartLoaderJob"></a>

         Il nome AWS CLI per questa API è:. `start-loader-job`

Avvia un processo dello strumento di caricamento in blocco Neptune per caricare i dati da un bucket Amazon S3 in un'istanza database Neptune. Vedi [Uso dello strumento di caricamento in blocco Amazon Neptune per importare i dati](https://docs.aws.amazon.com/neptune/latest/userguide/bulk-load.html).

Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione [StartLoaderJobneptune-db](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#startloaderjob): IAM in quel cluster.

**Richiesta**
+ **dependencies** (nella CLI: `--dependencies`): una stringa di tipo `string` (una stringa con codifica UTF-8).

  Si tratta di un parametro facoltativo che può rendere subordinata una richiesta di caricamento in coda al completamento di una o più attività precedenti nella coda.

  Neptune può accodare fino a 64 richieste di caricamento alla volta, se i relativi parametri `queueRequest` sono impostati su `"TRUE"`. Il parametro `dependencies` consente di rendere l'esecuzione di tale richiesta in coda dipendente dal completamento corretto di una o più richieste precedenti specificate nella coda.

  Ad esempio, se `Job-A` e `Job-B` del caricamento sono indipendenti l'una dall'altra, ma `Job-C` richiede che `Job-A` e `Job-B` siano completate prima del suo avvio, procedere come segue:

  1. Inviare `load-job-A` e `load-job-B` una dopo l'altra in qualsiasi ordine e salvare i loro id di caricamento.

  1. Inviare `load-job-C` con gli id di caricamento delle due attività nel campo `dependencies`:  
**Example**  

  ```
    "dependencies" : ["(job_A_load_id)", "(job_B_load_id)"]
  ```

  A causa del parametro `dependencies`, il bulk loader non avvia `Job-C` fino a quando `Job-A` e `Job-B` non sono state completate correttamente. Se una di queste attività non riesce, l'attività non verrà eseguita e il suo stato sarà impostato su `LOAD_FAILED_BECAUSE_DEPENDENCY_NOT_SATISFIED`.

  È possibile impostare più livelli di dipendenza in questo modo, in modo che l'errore di un'attività causi l'annullamento di tutte le richieste direttamente o indirettamente dipendenti da essa.
+ **failOnError** (nella CLI: `--fail-on-error`): un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  **`failOnError`**: un flag per attivare un arresto completo in caso di errore.

  *Valori consentiti:* `"TRUE"`, `"FALSE"`.

  *Valore predefinito*: `"TRUE"`.

  Quando questo parametro è impostato su `"FALSE"`, il loader tenta di caricare tutti i dati nella posizione specificata, saltando eventuali voci con errori.

  Quando questo parametro è impostato su `"TRUE"`, il loader si arresta non appena rileva un errore. I dati caricati fino a quel punto persistono.
+ **format** (nella CLI: `--format`): *Obbligatorio:* un formato di tipo `string` (una stringa con codifica UTF-8).

  Il formato dei dati. Per ulteriori informazioni sui formati di dati per il comando `Loader` di Neptune, consulta [Formati dei dati da caricare](https://docs.aws.amazon.com/neptune/latest/userguide/bulk-load-tutorial-format.html).

**Valori consentiti**
  + **`csv`** per il [formato dei dati CSV Gremlin](https://docs.aws.amazon.com/neptune/latest/userguide/bulk-load-tutorial-format-gremlin.html).
  + **`opencypher`** per il [formato dei dati CSV openCypher](https://docs.aws.amazon.com/neptune/latest/userguide/bulk-load-tutorial-format-opencypher.html).
  + **`ntriples`** per il [formato dei dati N-Triples RDF](https://www.w3.org/TR/n-triples/).
  + **`nquads`** per il [formato dei dati N-Quads RDF](https://www.w3.org/TR/n-quads/).
  + **`rdfxml`** per il [formato dei dati RDF\$1XML RDF](https://www.w3.org/TR/rdf-syntax-grammar/).
  + **`turtle`** per il [formato dei dati Turtle RDF](https://www.w3.org/TR/turtle/).
+ **iamRoleArn** (nella CLI: `--iam-role-arn`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il nome della risorsa Amazon (ARN) per un ruolo IAM che deve essere assunto dall'istanza database Neptune per l'accesso al bucket S3. L'ARN del ruolo IAM fornito qui deve essere collegato al cluster database (vedi [Aggiunta del ruolo IAM a un cluster Amazon Neptune](https://docs.aws.amazon.com/neptune/latest/userguide/bulk-load-tutorial-IAM-add-role-cluster.html)).
+ **mode** (nella CLI: `--mode`): una modalità di tipo `string` (una stringa con codifica UTF-8).

  Modalità del processo di caricamento

  *Valori consentiti*: `RESUME`, `NEW`, `AUTO`.

  *Valore predefinito*: `AUTO`.

****
  + `RESUME`: in modalità RESUME, lo strumento di caricamento cerca un caricamento precedente da questa origine e, se ne trova uno, riprende l'attività di caricamento. Se non viene trovata alcuna attività di caricamento precedente, il loader si arresta.

    Il loader evita di ricaricare i file caricati correttamente in un'attività precedente. Tenta di elaborare solo i file non caricati. Se sono stati eliminati i dati caricati in precedenza dal cluster Neptune, tali dati non vengono ricaricati in questa modalità. Se un processo di caricamento precedente ha caricato correttamente tutti i file dalla stessa origine, nulla viene ricaricato e lo strumento di caricamento restituisce un risultato positivo.
  + `NEW`: in modalità NEW viene creata una nuova richiesta di caricamento, indipendentemente da eventuali caricamenti precedenti. Questa modalità può essere utilizzata per ricaricare tutti i dati provenienti da un'origine dopo che sono stati eliminati dati caricati precedentemente dal cluster Neptune o per caricare nuovi dati disponibili nella stessa origine.
  + `AUTO`: in modalità AUTO, lo strumento di caricamento cerca un'attività di caricamento precedente dalla stessa origine e, se ne trova una, riprende tale attività, proprio come in modalità `RESUME`.

    Se il loader non trova un'attività di caricamento precedente dalla stessa origine, carica tutti i dati dall'origine, proprio come in modalità `NEW`.
+ **parallelism** (nella CLI: `--parallelism`): un parallelismo di tipo `string` (una stringa con codifica UTF-8).

  Il parametro facoltativo `parallelism` può essere impostato per ridurre il numero di thread utilizzati dall'attività di caricamento in blocco.

  *Valori consentiti*:
  + `LOW`— Il numero di thread utilizzati è il numero di v disponibili diviso per 8. CPUs 
  + `MEDIUM`— Il numero di thread utilizzati è il numero di v disponibili CPUs diviso per 2.
  + `HIGH`— Il numero di thread utilizzati è uguale al numero di v disponibili. CPUs
  + `OVERSUBSCRIBE`— Il numero di thread utilizzati è il numero di v disponibili CPUs moltiplicato per 2. Se viene utilizzato questo valore, il bulk loader occupa tutte le risorse disponibili.

    Ciò non significa, tuttavia, che l'impostazione `OVERSUBSCRIBE` comporti un utilizzo della CPU al 100%. Poiché l'operazione di caricamento è I/O limitata, l'utilizzo massimo della CPU previsto è compreso tra il 60% e il 70%.

  *Valore predefinito*: `HIGH`

  L'impostazione `parallelism` a volte può causare un deadlock tra i thread durante il caricamento dei dati openCypher. Quando ciò accade, Neptune restituisce l'errore `LOAD_DATA_DEADLOCK`. Di solito è possibile risolvere il problema impostando `parallelism` su un valore inferiore e riprovando il comando di caricamento.
+ **parserConfiguration**  (nella CLI: `--parser-configuration`): un array di mappa con coppie chiave-valore in cui:

      Ogni chiave è una stringa di tipo `string` (una stringa con codifica UTF-8).

      Ogni valore è una stringa di tipo `string` (una stringa con codifica UTF-8).

  **`parserConfiguration`**: un oggetto opzionale con valori di configurazione del parser aggiuntivi. Ciascuno dei parametri figlio è anche facoltativo:

****
  + **`namedGraphUri`**: il grafo predefinito per tutti i formati RDF quando non viene specificato alcun grafo (per formati non quads e voci NQUAD senza grafo).

    Il valore predefinito è `https://aws.amazon.com/neptune/vocab/v01/DefaultNamedGraph`.
  + **`baseUri`**— L'URI di base per i formati Turtle RDF/XML e Turtle.

    Il valore predefinito è `https://aws.amazon.com/neptune/default`.
  + **`allowEmptyStrings`**: gli utenti di Gremlin devono essere in grado di passare valori di stringa vuoti ("") come proprietà dei nodi e degli archi durante il caricamento di dati CSV. Se `allowEmptyStrings` è impostato su `false` (valore predefinito), le stringhe vuote vengono trattate come valori null e non vengono caricate.

    Se `allowEmptyStrings` è impostato su `true`, lo strumento di caricamento considera le stringhe vuote come valori di proprietà validi e le carica di conseguenza.
+ **queueRequest** (nella CLI: `--queue-request`): un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  Si tratta di un parametro flag opzionale che indica se la richiesta di caricamento può essere accodata o meno. 

  Non è necessario attendere il completamento di un processo di caricamento prima di emettere quello successivo, perché Neptune può accodare fino a 64 processi alla volta, a condizione che i relativi parametri `queueRequest` siano tutti impostati su `"TRUE"`. L'ordine di coda dei lavori sarà first-in-first-out (FIFO).

  Se il parametro `queueRequest` viene omesso o impostato su `"FALSE"`, la richiesta di caricamento avrà esito negativo se un'altra attività di caricamento è già in esecuzione.

  *Valori consentiti:* `"TRUE"`, `"FALSE"`.

  *Valore predefinito*: `"FALSE"`.
+ **s3BucketRegion**(nella CLI:`--s-3-bucket-region`) — *Obbligatorio:* un S3BucketRegion, di tipo: `string` (una stringa con codifica UTF-8).

  La regione Amazon del bucket S3. Deve corrispondere alla regione Amazon del cluster database.
+ **source** (nella CLI: `--source`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il parametro `source` accetta un URI S3 che identifica un singolo file, più file, una cartella o più cartelle. Neptune carica ogni file di dati in qualsiasi cartella specificata.

  l'URI può essere in uno dei seguenti formati.
  + `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)`

  L'`object-key-name`elemento dell'URI è equivalente al parametro [prefix](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html#API_ListObjects_RequestParameters) in una chiamata API S3. [ListObjects](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html) Identifica tutti gli oggetti nel bucket S3 specificato i cui nomi iniziano con il prefisso specificato. Può trattarsi di un singolo file o una singola cartella oppure di più file e/o cartelle.

  La cartella o le cartelle specificate possono contenere più file di vertici e più file di archi.
+ **updateSingleCardinalityProperties** (nella CLI: `--update-single-cardinality-properties`): un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  `updateSingleCardinalityProperties` è un parametro facoltativo che controlla il modo in cui lo strumento di caricamento in blocco tratta un nuovo valore per le proprietà di vertici o archi a cardinalità singola. Non è supportato per il caricamento di dati openCypher.

  *Valori consentiti:* `"TRUE"`, `"FALSE"`.

  *Valore predefinito*: `"FALSE"`.

  Come impostazione predefinita o quando `updateSingleCardinalityProperties` è impostato esplicitamente su `"FALSE"`, il loader considera un nuovo valore come un errore, perché viola la cardinalità singola.

  Quando `updateSingleCardinalityProperties` è impostato invece su `"TRUE"`, il bulk loader sostituisce il valore esistente con quello nuovo. Se valori di proprietà multipli edge o vertice a cardinalità singola vengono forniti nei file di origine caricati, il valore finale alla fine del caricamento in blocco potrebbe essere uno qualsiasi di questi nuovi valori. Il loader garantisce solo che il valore esistente è stato sostituito da uno di quelli nuovi.
+ **userProvidedEdgeIds** (nella CLI: `--user-provided-edge-ids`): un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  Questo parametro è richiesto solo quando si caricano dati OpenCypher che contengono una relazione. IDs Deve essere incluso e impostato su `True` quando la relazione IDs OpenCypher viene fornita esplicitamente nei dati di caricamento (consigliato).

  Se `userProvidedEdgeIds` è assente o è impostato su `True`, in ogni file delle relazioni all'interno del caricamento deve esistere una colonna `:ID`.

  Se `userProvidedEdgeIds` è presente ed è impostato su `False`, i file delle relazioni all'interno del caricamento **non devono** contenere una colonna `:ID`. Lo strumento di caricamento Neptune genera automaticamente un ID per ogni relazione.

  È utile fornire una relazione in modo IDs esplicito in modo che il caricatore possa riprendere il caricamento dopo la correzione dell'errore nei dati CSV, senza dover ricaricare le relazioni che sono già state caricate. Se la relazione IDs non è stata assegnata in modo esplicito, il loader non può riprendere un caricamento non riuscito se è stato necessario correggere un file di relazione e deve invece ricaricare tutte le relazioni.

**Risposta**
+ **payload**: *Obbligatorio:* un array di mappa con coppie chiave-valore in cui:

      Ogni chiave è una stringa di tipo `string` (una stringa con codifica UTF-8).

      Ogni valore è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Contiene una coppia nome-valore `loadId` che fornisce un identificatore per l'operazione di caricamento.
+ **status**: *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il codice HTTP restituito che indica lo stato del processo di caricamento.

**Errori**
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [BulkLoadIdNotFoundException](data-api-dp-errors.md#BulkLoadIdNotFoundException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [LoadUrlAccessDeniedException](data-api-dp-errors.md#LoadUrlAccessDeniedException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [InternalFailureException](data-api-dp-errors.md#InternalFailureException)
+ [S3Exception](data-api-dp-errors.md#S3Exception)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)

## GetLoaderJobStatus (azione)
<a name="GetLoaderJobStatus"></a>

         Il nome AWS CLI per questa API è:. `get-loader-job-status`

Ottiene informazioni su un determinato processo di caricamento. Neptune tiene traccia dei 1.024 lavori di caricamento in blocco più recenti e archivia solo gli ultimi 10.000 dettagli di errore per processo.

Per ulteriori informazioni, consulta l'[API Neptune Get-Status Loader](https://docs.aws.amazon.com/neptune/latest/userguide/load-api-reference-status.htm).

Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione [GetLoaderJobStatusneptune-db](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#getloaderjobstatus): IAM in quel cluster.

**Richiesta**
+ **details** (nella CLI: `--details`): un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  Flag che indica se includere o meno i dettagli oltre allo stato generale (`TRUE` o `FALSE`, l'impostazione predefinita è `FALSE`).
+ **errors** (nella CLI: `--errors`): un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  Flag che indica se includere o meno un elenco di errori riscontrati (`TRUE` o `FALSE`, l'impostazione predefinita è `FALSE`).

  L'elenco degli errori è paginato. I parametri `page` ed `errorsPerPage` consentono di esaminare tutti gli errori.
+ **errorsPerPage**(nella CLI:`--errors-per-page`) — a PositiveInteger, di tipo: `integer` (un intero con segno a 32 bit), almeno 1? st?.

  Il numero di errori restituiti in ogni pagina (un numero intero positivo; l'impostazione predefinita è `10`). È valido solo se il parametro `errors` è impostato su `TRUE`.
+ **loadId** (nella CLI: `--load-id`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  L'ID del processo di caricamento di cui ottenere lo stato.
+ **page**(nella CLI:`--page`) — a PositiveInteger, di tipo: `integer` (un intero con segno a 32 bit), almeno 1? st?.

  Il numero della pagina di errore (un numero intero positivo; l'impostazione predefinita è `1`). È valido solo se il parametro `errors` è impostato su `TRUE`.

**Risposta**
+ **payload**: *Obbligatorio:* un documento di tipo `document` (un contenuto aperto indipendente dal protocollo rappresentato da un modello di dati simile a JSON).

  Informazioni sullo stato del processo di caricamento, con un layout simile al seguente:  
**Example**  

  ```
  {
            "status" : "200 OK",
            "payload" : {
              "feedCount" : [
                {
                  "LOAD_FAILED" : (number)
                }
              ],
              "overallStatus" : {
                "fullUri" : "s3://(bucket)/(key)",
                "runNumber" : (number),
                "retryNumber" : (number),
                "status" : "(string)",
                "totalTimeSpent" : (number),
                "startTime" : (number),
                "totalRecords" : (number),
                "totalDuplicates" : (number),
                "parsingErrors" : (number),
                "datatypeMismatchErrors" : (number),
                "insertErrors" : (number),
              },
              "failedFeeds" : [
                {
                  "fullUri" : "s3://(bucket)/(key)",
                  "runNumber" : (number),
                  "retryNumber" : (number),
                  "status" : "(string)",
                  "totalTimeSpent" : (number),
                  "startTime" : (number),
                  "totalRecords" : (number),
                  "totalDuplicates" : (number),
                  "parsingErrors" : (number),
                  "datatypeMismatchErrors" : (number),
                  "insertErrors" : (number),
                }
              ],
              "errors" : {
                "startIndex" : (number),
                "endIndex" : (number),
                "loadId" : "(string),
                "errorLogs" : [ ]
              }
            }
          }
  ```
+ **status**: *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  Il codice di risposta HTTP per la richiesta.

**Errori**
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [BulkLoadIdNotFoundException](data-api-dp-errors.md#BulkLoadIdNotFoundException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [LoadUrlAccessDeniedException](data-api-dp-errors.md#LoadUrlAccessDeniedException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [InternalFailureException](data-api-dp-errors.md#InternalFailureException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)

## ListLoaderJobs (azione)
<a name="ListLoaderJobs"></a>

         Il nome AWS CLI per questa API è:. `list-loader-jobs`

Recupera un elenco di `loadIds` per tutti i processi dello strumento di caricamento attivi.

Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione [ListLoaderJobsneptune-db](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#listloaderjobs): IAM in quel cluster.

**Richiesta**
+ **includeQueuedLoads** (nella CLI: `--include-queued-loads`): un valore booleano di tipo `boolean` [un valore booleano (vero o falso)].

  Un parametro opzionale che può essere utilizzato per escludere il caricamento IDs delle richieste di carico in coda quando si richiede un elenco di carichi impostando il parametro su. IDs `FALSE` Il valore predefinito è `TRUE`.
+ **limit**(nella CLI:`--limit`) — a ListLoaderJobsInputLimitInteger, di tipo: `integer` (un intero con segno a 32 bit), non meno di 1 o più di 100? 1? s.

  Il numero di carichi IDs da elencare. Deve essere un numero intero positivo maggiore di zero e non superiore a `100` (valore predefinito).

**Risposta**
+ **payload**: *obbligatorio:* un oggetto [LoaderIdResult](#LoaderIdResult).

  L'elenco dei lavori richiesti IDs.
+ **status**: *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  Restituisce lo stato della richiesta di elenco dei processi.

**Errori**
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [BulkLoadIdNotFoundException](data-api-dp-errors.md#BulkLoadIdNotFoundException)
+ [InternalFailureException](data-api-dp-errors.md#InternalFailureException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [LoadUrlAccessDeniedException](data-api-dp-errors.md#LoadUrlAccessDeniedException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)

## CancelLoaderJob (azione)
<a name="CancelLoaderJob"></a>

         Il nome AWS CLI per questa API è:. `cancel-loader-job`

Annulla un processo di caricamento specificato. Questa è una richiesta HTTP `DELETE`. Per ulteriori informazioni, consulta l'[API Neptune Get-Status Loader](https://docs.aws.amazon.com/neptune/latest/userguide/load-api-reference-status.htm).

Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione [CancelLoaderJobneptune-db](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#cancelloaderjob): IAM in quel cluster.

**Richiesta**
+ **loadId** (nella CLI: `--load-id`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8).

  L'ID del processo di caricamento da eliminare.

**Risposta**
+ **status**: una stringa di tipo `string` (una stringa con codifica UTF-8).

  Lo stato di annullamento.

**Errori**
+ [BadRequestException](data-api-dp-errors.md#BadRequestException)
+ [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException)
+ [BulkLoadIdNotFoundException](data-api-dp-errors.md#BulkLoadIdNotFoundException)
+ [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException)
+ [LoadUrlAccessDeniedException](data-api-dp-errors.md#LoadUrlAccessDeniedException)
+ [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException)
+ [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException)
+ [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException)
+ [InternalFailureException](data-api-dp-errors.md#InternalFailureException)
+ [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException)
+ [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException)
+ [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException)
+ [MissingParameterException](data-api-dp-errors.md#MissingParameterException)

## *Struttura del caricamento in blocco:*
<a name="data-api-dp-loader-bulk-load-structure-spacer"></a>

## LoaderIdResult (struttura)
<a name="LoaderIdResult"></a>

Contiene un elenco di carichi IDs.

**Campi**
+ **loadIds**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8).

  Un elenco di carichi IDs.