更新时间:2026-08-14 GMT+08:00
分享

查询异步任务详情 - ShowCoreSpaceJob

功能介绍

查询服务异步任务详情。

调用方法

请参见如何调用API

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

space_id

String

参数解释:

Space ID,唯一标识一个Space,可以通过AgentArts智能体记忆库控制台或者记忆库查询接口获取。

约束限制:

不涉及。

取值范围:

匹配标准的UUID格式(8-4-4-4-12的十六进制数字串,由连字符分隔),符合正则条件^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$。

默认取值:

不涉及。

job_id

String

参数解释:

异步任务 ID,唯一标识一个异步任务,可通过列出异步任务的接口返回获取。

约束限制:

不涉及。

取值范围:

UUID格式,长度36字符,仅支持小写十六进制数字0-9a-f和连字符-。

默认取值:

不涉及。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

id

String

参数解释:

异步任务 ID,唯一标识一个异步任务,可通过创建异步任务的接口返回获取。

取值范围:

不涉及。

job_name

String

参数解释:

异步任务名称,标识任务的类型。

取值范围:

  • create_space: 创建记忆空间

  • update_network: 更新网络配置

status

String

参数解释:

异步任务的当前执行状态。

取值范围:

  • running: 执行中

  • success: 成功

  • failed: 失败

space_id

String

参数解释:

所属 Space ID,标识该记录所属的记忆空间。

取值范围:

不涉及。

error_code

String

参数解释:

错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息。

取值范围:

不涉及。

created_at

String

参数解释:

记录的创建时间,由系统自动生成,格式为 ISO 8601(YYYY-MM-DDTHH:mm:ssZ)。

取值范围:

不涉及。

updated_at

String

参数解释:

记录的最近更新时间,由系统自动更新,格式为 ISO 8601(YYYY-MM-DDTHH:mm:ssZ)。

取值范围:

不涉及。

状态码:401

表3 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.01XXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

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

取值范围:

不涉及。

状态码:403

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

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

取值范围:

不涉及。

error_msg

String

参数解释:

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

取值范围:

不涉及。

encoded_authorization_message

String

参数解释:

编码后的授权失败信息。

取值范围:

不涉及。

details

Array of CoreSpaceCommonError objects

参数解释:

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

取值范围:

不涉及。

表5 CoreSpaceCommonError

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.01XXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

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

取值范围:

不涉及。

状态码:404

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.01XXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

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

取值范围:

不涉及。

状态码:429

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.01XXXXXX。

取值范围:

不涉及。

error_msg

String

参数解释:

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

取值范围:

不涉及。

状态码:500

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,标识错误类型,格式为 AgentArts.01XXXXXX。

取值范围:

不涉及。

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",
  "space_id" : "f726675e-a694-498d-bc84-68a2b74a0aeb",
  "created_at" : "2025-01-18T10:00:00.000Z",
  "updated_at" : "2025-01-18T10:00:00.000Z",
  "error_code" : "AgentArts.01010401",
  "error_msg" : "缺少vpcep权限"
}

状态码

状态码

描述

200

成功获取任务状态

401

认证失败。

403

权限不足。

404

记忆库未找到

429

请求频率超限。

500

内部服务器错误

错误码

请参见错误码

相关文档