Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Cancelación de trabajo del programa de carga de Neptune
<a name="load-api-reference-cancel"></a>

Cancela un trabajo de carga.

Para cancelar un trabajo, debe enviar una solicitud HTTP `DELETE` al punto de enlace `https://your-neptune-endpoint:port/loader`. El valor `loadId` se puede añadir a la ruta de la dirección URL `/loader` o bien incluirse como variable en la URL.

## Sintaxis de solicitud de cancelación de trabajo
<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 de solicitud de cancelación de tarea
<a name="load-api-reference-cancel-parameters"></a>

**loadId**  
El ID de la tarea de carga.

## Sintaxis de respuesta de cancelación de trabajo
<a name="load-api-reference-cancel-parameters-response"></a>

```
no response body
```

**200 OK**  
Una tarea de carga eliminada correctamente devuelve el código `200`.

## Errores de cancelación de tarea
<a name="load-api-reference-cancel-parameters-errors"></a>

Si se produce un error, se devuelve un objeto JSON en el elemento `BODY` de la respuesta. El objeto `message` contiene una descripción del error.

**Categorías de errores**
+ **`Error 400`**: un `loadId` no válido devuelve un error de solicitud incorrecta HTTP `400`. El mensaje describe el error.
+ **`Error 500`**: una solicitud válida que no se puede procesar devuelve un error interno del servidor HTTP `500`. El mensaje describe el error.

## Mensajes de error de cancelación de tarea
<a name="load-api-reference-cancel-parameters-errors-messages"></a>

A continuación se muestran los posibles mensajes de error de la API de cancelación con la descripción correspondiente.
+ `The load with id = load_id does not exist or not active` (HTTP 404): no se ha encontrado la carga. Compruebe el valor del parámetro `id`.
+ `Load cancellation is not permitted on a read replica instance.` (HTTP 405): la carga es una operación de escritura. Vuelva a intentar cargar en el punto final del read/write clúster. 

## Ejemplos de cancelación de tarea
<a name="load-api-reference-cancel-examples"></a>

**Example Solicitud**  
A continuación, se muestra una solicitud enviada mediante HTTP `DELETE` con el comando `curl`.  

```
aws neptunedata cancel-loader-job \
  --endpoint-url https://your-neptune-endpoint:port \
  --load-id 0a237328-afd5-4574-a0bc-c29ce5f54802
```
Para obtener más información, consulte [cancel-loader-job](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/cancel-loader-job.html)la Referencia 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
```
En este ejemplo se supone que sus AWS credenciales están configuradas en su entorno. *us-east-1*Sustitúyala por la región de tu cúmulo de Neptuno.

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