获取批量预测任务列表
更新时间：2024-12-24
接口描述
用于获取批量预测任务列表。
权限说明
调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。需具有以下任一权限：
- 完全控制千帆大模型平台的权限：QianfanFullControlAccessPolicy
- 运维操作千帆大模型平台预测服务的权限：QianfanServiceOperateAccessPolicy
- 只读访问千帆大模型平台预测服务的权限：QianfanServiceReadAccessPolicy
鉴权说明
调用本文API，使用“安全认证/Access Key ”中的Access Key ID 和 Secret Access Key等进行鉴权，无法使用获取Access Token的方式鉴权，具体鉴权认证机制参考鉴权认证机制。
请求结构
POST /v2/batchinference?Action=DescribeBatchInferenceTasks HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"marker":"infer-n509xxxhqq3"
}请求头域
除公共头域外，无其它特殊头域。
请求参数
- Query参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Action | string | 是 | 方法名称，固定值DescribeBatchInferenceTasks |
- Body参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| runStatus | List<string> | 否 | 运行状态过滤条件，可选值如下 · Queuing：排队中 · Running：运行中 · Done：运行完成 · Stopping：运行终止中 · Stopped：运行终止 · Failed：运行失败 · Expired：运行超时 |
| marker | string | 否 | 本次查询的起始位置，默认从第一条数据开始 |
| maxKeys | int | 否 | 返回的列表长度最大为100，默认值是10，如果指定的值大于100，按100操作 |
| pageReverse | bool | 否 | 是否倒序，默认为false |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| requestId | string | 请求ID |
| result | object | 请求结果 |
result说明
| 名称 | 类型 | 描述 |
|---|---|---|
| taskList | List<taskItem> | 任务列表 |
| pageInfo | object | 分页信息 |
taskItem说明
| 名称 | 类型 | 描述 |
|---|---|---|
| taskId | string | 任务ID |
| name | string | 任务名称 |
| description | string | 任务描述 |
| endpoint | string | 推理服务endpoint |
| modelId | string | 模型版本ID |
| inferenceParams | object | 推理服务参数配置 |
| runStatus | string | 任务运行状态 · Queuing：排队中 · Running：运行中 · Done：运行完成 · Stopping：运行终止中 · Stopped: 运行终止 · Failed：运行失败 · Expired：运行超时 |
| errorCode | int | 任务运行失败时返回的错误码，即当runStatus=Failed，返回该字段 |
| errorReason | string | 任务运行失败时返回的错误原因，即当runStatus=Failed，返回该字段 |
| inputBosUri | string | 数据输入bos目录 |
| outputBosUri | string | 数据输出bos目录，固定输出格式为jsonl |
| outputDir | string | 数据输出任务目录 |
| inputTokenUsage | int | 成功处理的输入总token数，当任务运行状态为Done时返回该字段 |
| outputTokenUsage | int | 成功处理的输出总token数，当任务运行状态为Done时返回该字段 |
| progress | int | 已处理的数据条数 |
| totalDataCount | int | 总数据条数 |
| taskSource | string | 任务来源，说明： · batchInference：批量推理 · modelEval：模型评估 · inferenceDataset：推理数据集 |
| dataFormat | string | 数据格式，说明： · default · src_tgt · role |
| creator | string | 任务创建人 |
| createTime | string | 任务创建时间 |
| finishTime | string | 任务结束时间 |
pageInfo说明
| 名称 | 类型 | 描述 |
|---|---|---|
| marker | string | 本次查询的起始位置 |
| maxKeys | int | 请求返回的最大数目 |
| isTruncated | bool | 是否只返回了部分数据，说明： · false：表示本次已经返回所有结果 · true · 表示本次还没有返回所有结果 |
| nextMarker | string | 说明：当isTruncated为true时，才返回此项，作为下次查询marker的值 |
请求示例
curl --location 'https://qianfan.baidubce.com/v2/batchinference?Action=DescribeBatchInferenceTasks' \
--header 'Authorization: bce-auth-v1/f0ee7a166bxxxx02c13/2023-09-19T13:42:13Z/180000/host;x-bce-date/9a8cfb8ee58xxxx4525543' \
--header 'x-bce-date: 2023-09-19T13:37:10Z' \
--header 'Content-Type: application/json' \
--data '{
"marker":"infer-n509xxxhqq3"
}'响应示例
{
"requestId":"1bef3f87-c5b2-4419-936b-50f9884f10d4",
"result":{
"taskList":[
{
"taskId":"infer-9ia3kc1wt9mp",
"name":"name",
"description":"description",
"endpoint":"http://xxx",
"inferenceParams":{
"temperature":0.9,
"top_p":0.3
},
"runStatus":"Running",
"inputBosUri":"bos:/user_a/bucket",
"outputBosUri":"bos:/user_b/output",
"outputDir":"662f7bfb8055376bcd516942",
"inputTokenUsage":10000,
"outputTokenUsage":10000,
"progress":100,
"totalDataCount":400,
"taskSource":"batchInference",
"dataFormat":"default",
"creator":"accountName",
"createTime":"2024-01-16T09:48:35Z",
"finishTime":"2024-01-16T10:48:35Z"
}
],
"pageInfo":{
"marker":"infer-n50985crhqq3",
"maxKeys":1,
"isTruncated":false
}
}
}错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
| 名称 | 描述 |
|---|---|
| requestId | 请求ID |
| code | 错误码，帮助理解和解决发生的错误 |
| message | 错误描述信息，帮助理解和解决发生的错误 |
例如返回：
{
"requestId":"1bef3f87-xxx0f9884f10d4",
"code":"AccessDenied",
"message":"Access denied."
}更多其他错误码，也可以查看错误码说明。