文档首页/ 智果（AgentArts）智能体平台/ API参考/ API/ 记忆库/ 异步任务管理/ 查询异步任务状态 - ShowCoreSpaceJob
更新时间：2026-06-10 GMT+08:00
查看PDF
分享

查询异步任务状态 - ShowCoreSpaceJob

功能介绍

查询服务异步任务的执行状态。

调用方法

请参见如何调用API。

URI

GET /v1/core/spaces/{space_id}/job/{job_id}

表1 路径参数

参数

是否必选

参数类型

描述

space_id

是

String

参数解释：

记忆空间 ID，唯一标识一个记忆空间，可通过"创建Space"接口获取。

约束限制：

仅支持字母、数字和中划线。

取值范围：

长度1-48字符。

默认取值：

不涉及。

job_id

是

String

参数解释：

异步任务 ID，唯一标识一个异步任务。

约束限制：

仅支持字母、数字和中划线。

取值范围：

长度1-48字符。

默认取值：

不涉及。

请求参数

无

响应参数

状态码：200

成功获取任务状态

状态码：401

表2 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息，描述错误详情，供问题排查使用。

取值范围：

不涉及。

状态码：403

表3 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息，描述错误详情，供问题排查使用。

取值范围：

不涉及。

encoded_authorization_message

String

参数解释：

编码后的授权失败信息。

取值范围：

不涉及。

details

Array of CoreSpaceCommonError objects

参数解释：

依赖的下游服务错误信息列表，包含导致当前请求失败的下游服务错误详情。

取值范围：

不涉及。
表4 CoreSpaceCommonError

参数

参数类型

描述

error_code

String

参数解释：

错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息，描述错误详情，供问题排查使用。

取值范围：

不涉及。

状态码：404

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息，描述错误详情，供问题排查使用。

取值范围：

不涉及。

状态码：429

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息，描述错误详情，供问题排查使用。

取值范围：

不涉及。

状态码：500

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息，描述错误详情，供问题排查使用。

取值范围：

不涉及。

请求示例

/v1/core/spaces/123e4567-e89b-12d3-a456-426614174000/job/123e4567-e89b-12d3-a456-426614174000

响应示例

状态码：200

成功获取任务状态

{
  "id" : "123e4567-e89b-12d3-a456-426614174000",
  "job_name" : "update_network",
  "status" : "running"
}

状态码：401

认证失败

{
  "error_code" : "AgentArts.01020002",
  "error_msg" : "Authentication failed"
}

状态码：403

权限不足

{
  "error_code" : "AgentArts.01010002",
  "error_msg" : "Insufficient permissions"
}

状态码：404

任务不存在

{
  "error_code" : "AgentArts.01010007",
  "error_msg" : "Specified task does not exist"
}

状态码：429

请求过于频繁

{
  "error_code" : "AgentArts.01020008",
  "error_msg" : "Too many requests"
}

状态码：500

内部服务错误

{
  "error_code" : "AgentArts.01010008",
  "error_msg" : "Internal service error"
}

状态码

状态码

描述

200

成功获取任务状态

401

认证失败

403

权限不足

404

任务不存在

429

请求过于频繁

500

内部服务错误

错误码

请参见错误码。

父主题： 异步任务管理

相关文档