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à.

# Annullamento di un processo dello strumento di caricamento Neptune
<a name="load-api-reference-cancel"></a>

Annulla un processo di caricamento.

Per annullare un lavoro, è necessario inviare una richiesta HTTP `DELETE` all'endpoint `https://your-neptune-endpoint:port/loader`. Il valore `loadId` può essere aggiunto al percorso URL `/loader` o incluso nell'URL come variabile.

## Sintassi della richiesta di annullamento di un processo
<a name="load-api-reference-cancel-syntax"></a>

```
DELETE https://your-neptune-endpoint:port/loader?loadId=loadId
```

```
DELETE https://your-neptune-endpoint:port/loader/loadId
```

## Parametri della richiesta del processo di annullamento
<a name="load-api-reference-cancel-parameters"></a>

**loadId**  
L'ID del processo di caricamento.

## Sintassi della risposta del processo di annullamento
<a name="load-api-reference-cancel-parameters-response"></a>

```
no response body
```

**200 OK**  
Il processo di caricamento eliminato correttamente restituisce il codice `200`.

## Errori del processo di annullamento
<a name="load-api-reference-cancel-parameters-errors"></a>

Se si verifica un errore, viene restituito un oggetto JSON nel `BODY` della risposta. L'oggetto `message` contiene una descrizione dell'errore.

**Categorie di errore**
+ **`Error 400`**: un oggetto `loadId` non valido restituisce un errore di richiesta non valida HTTP `400`. Il messaggio descrive l'errore.
+ **`Error 500`**: una richiesta valida che non può essere elaborata restituisce un errore interno del server HTTP `500`. Il messaggio descrive l'errore.

## Messaggi di errore del processo di annullamento
<a name="load-api-reference-cancel-parameters-errors-messages"></a>

Di seguito sono riportati i possibili messaggi di errore dell'API di annullamento con la relativa descrizione.
+ `The load with id = load_id does not exist or not active` (HTTP 404): il caricamento non è stato trovato. Verifica il valore del parametro `id`.
+ `Load cancellation is not permitted on a read replica instance.` (HTTP 405): il caricamento è un'operazione di scrittura. Riprova a caricare l'endpoint del cluster. read/write 

## Esempi del processo di annullamento
<a name="load-api-reference-cancel-examples"></a>

**Example Richiesta**  
Di seguito viene riportata una richiesta inviata tramite HTTP `DELETE` mediante il comando `curl`.  

```
aws neptunedata cancel-loader-job \
  --endpoint-url https://your-neptune-endpoint:port \
  --load-id 0a237328-afd5-4574-a0bc-c29ce5f54802
```
Per ulteriori informazioni, vedere [cancel-loader-job](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/cancel-loader-job.html)nel AWS CLI Command Reference.

```
import boto3
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://your-neptune-endpoint:port',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.cancel_loader_job(
    loadId='0a237328-afd5-4574-a0bc-c29ce5f54802'
)

print(response)
```

```
awscurl 'https://your-neptune-endpoint:port/loader/0a237328-afd5-4574-a0bc-c29ce5f54802' \
  --region us-east-1 \
  --service neptune-db \
  -X DELETE
```
Questo esempio presuppone che le AWS credenziali siano configurate nell'ambiente in uso. Sostituisci *us-east-1* con la regione del tuo cluster Neptune.

```
curl -X DELETE 'https://your-neptune-endpoint:port/loader/0a237328-afd5-4574-a0bc-c29ce5f54802'
```