本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Neptune 加载程序取消任务
<a name="load-api-reference-cancel"></a>

取消加载任务。

要取消任务，必须将 HTTP `DELETE` 请求发送到 `https://your-neptune-endpoint:port/loader` 终端节点。`loadId` 可以追加到 `/loader` URL 路径，或作为变量包含在 URL 中。

## 取消任务请求语法
<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
```

## 取消任务请求参数
<a name="load-api-reference-cancel-parameters"></a>

**loadId**  
加载任务的 ID。

## 取消任务响应语法
<a name="load-api-reference-cancel-parameters-response"></a>

```
no response body
```

**200 OK (200 确定)**  
成功删除的加载任务将返回 `200` 代码。

## 取消任务错误
<a name="load-api-reference-cancel-parameters-errors"></a>

当错误出现后，响应的 `BODY` 中将返回 JSON 对象。`message` 对象包含对错误的描述。

**错误类别**
+ **`Error 400`** - 无效的 `loadId` 返回 HTTP `400` 错误请求错误。此消息描述错误。
+ **`Error 500`** – 无法处理的有效请求返回 HTTP `500` 内部服务器错误。此消息描述错误。

## 取消任务错误消息
<a name="load-api-reference-cancel-parameters-errors-messages"></a>

以下是来自取消 API 的可能的错误消息，其中包含对错误的描述。
+ `The load with id = load_id does not exist or not active` (HTTP 404) – 找不到加载。检查 `id` 参数的值。
+ `Load cancellation is not permitted on a read replica instance.` (HTTP 405) – 加载是写入操作。在 read/write 集群终端节点上重试加载。

## 取消任务示例
<a name="load-api-reference-cancel-examples"></a>

**Example 请求**  
下面是使用 `curl` 命令经由 HTTP `DELETE` 发送的请求。  

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