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

# 列出批量评估
<a name="batch-evaluations-list"></a>

列出您账户中的所有批量评估任务。结果是分页的。

## 代码示例
<a name="list-batch-eval-examples"></a>

**Example**  

```
import boto3

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

# List all batch evaluations
paginator_token = None
all_evaluations = []

while True:
    params = {"maxResults": 50}
    if paginator_token:
        params["nextToken"] = paginator_token

    response = client.list_batch_evaluations(**params)
    all_evaluations.extend(response["batchEvaluations"])

    paginator_token = response.get("nextToken")
    if not paginator_token:
        break

for evaluation in all_evaluations:
    print(
        f"{evaluation['batchEvaluationId']}  "
        f"{evaluation['batchEvaluationName']}  "
        f"{evaluation['status']}  "
        f"{evaluation['createdAt']}"
    )
```
列出所有批量评估作业（正在运行的作业从服务中刷新）。`--json`用于机器可读的输出：  

```
agentcore batch-evaluations history --json
```
要查看单批评估作业及其结果，请传递作业 ID：  

```
agentcore view batch-evaluation <batch-evaluation-id> --json
```

## 请求参数
<a name="list-batch-eval-params"></a>


| 参数 | Type | 必需 | 说明 | 
| --- | --- | --- | --- | 
|  `maxResults`  | 整数 | 否 | 每页的最大结果数。范围：1—100。默认：服务定义。 | 
|  `nextToken`  | 字符串 | 否 | 来自先前回复的分页标记。 | 

## 响应
<a name="list-batch-eval-response"></a>


| 字段 | Type | 说明 | 
| --- | --- | --- | 
|  `batchEvaluations`  | 列表 | 批量评估摘要列表。 | 
|  `nextToken`  | 字符串 | 下一页的分页标记。没有更多结果时不存在。 | 

### 批量评估汇总字段
<a name="list-batch-eval-summary-fields"></a>


| 字段 | Type | 说明 | 
| --- | --- | --- | 
|  `batchEvaluationId`  | 字符串 | 唯一标识符。 | 
|  `batchEvaluationArn`  | 字符串 | 批量评估的 ARN。 | 
|  `batchEvaluationName`  | 字符串 | 作业名称。 | 
|  `status`  | 字符串 | 当前状态：`PENDING`、`IN_PROGRESS`、`COMPLETED`、`COMPLETED_WITH_ERRORS`、`FAILED`、`STOPPING`、`STOPPED`、`DELETING`。 | 
|  `createdAt`  | Timestamp | 创建任务的时间。 | 
|  `evaluators`  | 列表 | 使用的评估人员。 | 
|  `evaluationResults`  | 对象 | 汇总结果摘要。任务完成时出现。 | 
|  `errorDetails`  | 字符串列表 | 任务失败时的错误消息。 | 

## 错误
<a name="list-batch-eval-errors"></a>


| 错误 | HTTP 状态 | 说明 | 
| --- | --- | --- | 
|  `ValidationException`  | 400 | 分页参数无效。 | 
|  `AccessDeniedException`  | 403 | 权限不足。 | 
|  `ThrottlingException`  | 429 | 超出请求速率。 | 
|  `InternalServerException`  | 500 | Service-side 错误。 |