# 刪除批次評估
<a name="batch-evaluations-delete"></a>

刪除批次評估任務及其相關聯的中繼資料。任務必須處於終端狀態 (`COMPLETED`、 `FAILED`或 `STOPPED`)，才能將其刪除。

刪除批次評估會從 移除任務記錄`ListBatchEvaluations`。它不會刪除寫入 CloudWatch Logs 的每個工作階段評估結果。

## 程式碼範例
<a name="delete-batch-eval-examples"></a>

**Example**  

```
import boto3

client = boto3.client("bedrock-agentcore", region_name="us-west-2")

response = client.delete_batch_evaluation(batchEvaluationId=batch_eval_id)
print(f"Deleted: {response['batchEvaluationId']}")
print(f"Status: {response['status']}")
```
若要從服務中刪除批次評估任務記錄並清除本機歷史記錄，請使用 `agentcore archive batch-evaluation`。  

```
# Archive (delete) a batch evaluation job record on the service and clear local history
agentcore archive batch-evaluation -i <batch-evaluation-id>
```
對於仍在執行的任務，您必須先將其停止，才能封存：  

```
agentcore stop batch-evaluation -i <batch-evaluation-id>
```
兩個子命令都接受 `-i, --id <id>`、加上 `--region`和 `--json`。

## 請求參數
<a name="delete-batch-eval-params"></a>


| 參數 | Type | 必要 | 描述 | 
| --- | --- | --- | --- | 
|  `batchEvaluationId`  | String | 是 | 要刪除的批次評估 ID。以路徑參數傳遞。 | 

## 回應
<a name="delete-batch-eval-response"></a>


| 欄位 | Type | Description | 
| --- | --- | --- | 
|  `batchEvaluationId`  | String | 批次評估 ID。 | 
|  `batchEvaluationArn`  | String | 批次評估的 ARN。 | 
|  `status`  | String | 已刪除任務的最終狀態。 | 

## 錯誤
<a name="delete-batch-eval-errors"></a>


| 錯誤 | HTTP 狀態 | 說明 | 
| --- | --- | --- | 
|  `ResourceNotFoundException`  | 404 | 找不到具有指定 ID 的批次評估。 | 
|  `ConflictException`  | 409 | 批次評估仍在執行中。先將其停止，然後刪除。使用 AgentCore CLI，在封存之前使用 `agentcore stop batch-evaluation -i <batch-evaluation-id>`（標記為 `-i, --id`；選用 `--region`和 `--json`) 停止執行中的任務。 | 
|  `ValidationException`  | 400 | 無效的批次評估 ID 格式。 | 
|  `AccessDeniedException`  | 403 | 許可不足。 | 
|  `ThrottlingException`  | 429 | 超過請求率。 | 
|  `InternalServerException`  | 500 | 服務端錯誤。 |