GetIndexJobStatus分页
查询指定的知识库创建任务或知识库追加任务的当前状态
服务地址:
华东2 金融云
输入参数
只看必填
WorkspaceId知识库所属的业务空间 ID
JobId知识库作业任务 ID
IndexId知识库 ID
pageSize指定分页查询时每页展示的文档导入任务数量
分页参数
PageNumber SubmitIndexJob 接口和...
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • RAM 用户(子账号)需要首先获取百炼的数据权限(AliyunBailianDataFullAccessAliyunBailianDataReadOnlyAccess均可,已包括 sfm:GetIndexJobStatus 权限点),然后才能调用本接口,详见为 RAM 用户授予数据权限。阿里云账号(主账号)可直接调用无须授权。建议您通过最新版百炼 SDK来调用本接口。
  • 您需要有一个正在执行中的知识库作业任务(创建知识库任务可以调用 SubmitIndexJob 接口,创建知识库追加任务可以调用 SubmitIndexAddDocumentsJob 接口),并且获得相应的JobId
  • 本接口调用间隔建议在 5 秒以上。
  • 本接口具有幂等性。

请求语法

GET /{WorkspaceId}/index/job/status HTTP/1.1

路径参数

字段名称字段详情
WorkspaceIdstring

知识库所属的业务空间 ID。在百炼的控制台首页,单击页面左上角业务空间详情图标获取。

示例值:llm-3z7uw7fwz0vexxxx

请求参数

字段名称字段详情
JobIdstring

知识库作业任务 ID,即 SubmitIndexJob 接口或 SubmitIndexAddDocumentsJob 接口返回的Data.Id

示例值:20230718xxxx-146c93bf
IndexIdstring

知识库 ID,即 CreateIndex 接口返回的Data.Id

示例值:79c0alxxxx参考取值来源:
    SubmitIndexJob
PageNumberinteger<int32>

SubmitIndexJob 接口和 SubmitIndexAddDocumentsJob 接口均支持批量导入文档。本接口返回的字段包括知识库作业任务的总状态Status及各文档导入的状态Document.Status。若文档较多,可通过PageNumber参数进行分页查询。起始值为 1,默认值为 1。

示例值:1
pageSizeinteger<int32>

指定分页查询时每页展示的文档导入任务数量。最大值不限。默认值为 10。

示例值:10

返回参数

字段名称字段详情
Codestring

错误状态码。

示例值:Index.Forbidden
Dataobject

接口业务数据字段。

Messagestring

错误信息。

示例值:User not authorized to operate on the specified resource.
RequestIdstring

请求 ID。

示例值:17204B98-xxxx-4F9A-8464-2446A84821CA
Statusstring

接口返回的状态码。

示例值:200
Successboolean

接口调用是否成功,可能值为:展开详情

示例值:true
变更历史
变更时间变更内容概要操作
2025-03-25
变更返回参数
2024-09-05
新增请求参数PageNumber
新增请求参数pageSize