As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Trabalho de cancelamento do carregador do Neptune
<a name="load-api-reference-cancel"></a>

Cancela um trabalho de carga.

Para cancelar um trabalho, você deve enviar uma solicitação HTTP `DELETE` ao endpoint `https://your-neptune-endpoint:port/loader`. O `loadId` pode ser acrescentado ao caminho da URL `/loader` ou incluído como uma variável na URL.

## Sintaxe da solicitação de trabalho de cancelamento
<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
```

## Parâmetros da solicitação de trabalho de cancelamento
<a name="load-api-reference-cancel-parameters"></a>

**loadId**  
O ID do trabalho de carga.

## Sintaxe da resposta de trabalho de cancelamento
<a name="load-api-reference-cancel-parameters-response"></a>

```
no response body
```

**200 OK**  
O trabalho de carga excluído com êxito retorna um código `200`.

## Erros do trabalho de cancelamento
<a name="load-api-reference-cancel-parameters-errors"></a>

Quando ocorre um erro, um objeto JSON é retornado no `BODY` da resposta. O objeto `message` contém uma descrição do erro.

**Categorias de erros**
+ **`Error 400`**: um `loadId` inválido gera um erro de solicitação HTTP `400` inadequada. A mensagem descreve o erro.
+ **`Error 500`**: uma solicitação válida que não pode ser processada gera um erro interno do servidor HTTP `500`. A mensagem descreve o erro.

## Mensagens de erro do trabalho de cancelamento
<a name="load-api-reference-cancel-parameters-errors-messages"></a>

As seguintes são as mensagens de erro possíveis da API de cancelamento com uma descrição do erro.
+ `The load with id = load_id does not exist or not active` (HTTP 404): a carga não foi encontrada. Verifique o valor do parâmetro `id`.
+ `Load cancellation is not permitted on a read replica instance.` (HTTP 405): o carregamento é uma operação de gravação. Tente carregar novamente no endpoint do read/write cluster. 

## Exemplos do trabalho de cancelamento
<a name="load-api-reference-cancel-examples"></a>

**Example Solicitação**  
O seguinte é uma solicitação enviada por HTTP `DELETE` usando o comando `curl`.  

```
aws neptunedata cancel-loader-job \
  --endpoint-url https://your-neptune-endpoint:port \
  --load-id 0a237328-afd5-4574-a0bc-c29ce5f54802
```
Para obter mais informações, consulte [cancel-loader-job](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/cancel-loader-job.html)na Referência de AWS CLI Comandos.

```
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
```
Este exemplo pressupõe que suas AWS credenciais estejam configuradas em seu ambiente. *us-east-1*Substitua pela região do seu cluster Neptune.

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