文档首页/ 数据智能平台 DataArts Platform/ API参考/ API/ 应用运行/ 获取异步应用运行的状态 - ShowRunStatus
更新时间:2026-10-29 GMT+08:00
分享

获取异步应用运行的状态 - ShowRunStatus

功能介绍

该接口用于获取应用异步运行的状态。当通过异步运行应用接口异步运行应用后,就可以通过该接口获取应用运行的状态信息。

接口路径参数里的run_id就是异步运行应用接口返回的run_id。

调用方法

请参见如何调用API。

授权信息

账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

DataArtsPlatform:application:showRunStatus

Read

-

-

-

-

URI

GET /v1/{project_id}/applications/{application_id}/runs/{run_id}/status

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID。

获取方法请参见获取项目ID。

约束限制:

不涉及。

取值范围:

小写字母和数字组成的32位十六进制字符,例如:ff8080817d30ff7b017d3213ba600001。

默认取值:

不涉及。

application_id

是

String

参数解释:

应用ID,应用的唯一标识,可以通过应用开发控制台或应用查询接口获取。

约束限制:

不涉及。

取值范围:

标准的 UUID 格式,即由连字符(-)分隔的 32 位十六进制字符,格式为 8-4-4-4-12,例如:13f2a6d8-17c9-431b-9a43-95231545c25b。

默认取值:

不涉及。

run_id

是

String

参数解释:

运行ID,用于唯一标识一次运行,通过运行应用相关接口生成并返回。

约束限制:

不涉及。

取值范围:

标准的 UUID 格式,即由连字符(-)分隔的 32 位十六进制字符,格式为 8-4-4-4-12,例如:552b5251-8558-4271-9aec-46e5879ab9e5。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Workspace-Id

是

String

参数解释:

工作空间ID。

获取方法请参见获取项目ID,例如:6280b8733aea43a2a0799c55aeeb0e68。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

workspace_id

String

参数解释:

工作空间ID,工作空间的唯一标识。

取值范围:

小写字母和数字组成的32位十六进制字符,例如:ff8080817d30ff7b017d3213ba600001。

application_id

String

参数解释:

应用ID,应用的唯一标识。

取值范围:

标准的 UUID 格式,即由连字符(-)分隔的 32 位十六进制字符,格式为 8-4-4-4-12,例如:2c1f93a2-cfc3-4799-abae-bda8edf36d7。

create_date

String

参数解释:

应用运行的开始时间,系统自动生成。

取值范围:

UTC时区的时间戳格式(yyyy-MM-ddTHH:mm:ssZ)。

debug

Boolean

参数解释:

是否是调试模式。

取值范围:

  • true:调试模式。

  • false:运行模式。

error

String

参数解释:

错误消息,当应用运行失败时,该属性有效,且值为失败原因。

取值范围:

不涉及。

finish_date

String

参数解释:

应用运行的结束时间,系统自动生成。

取值范围:

UTC时区的时间戳格式(yyyy-MM-ddTHH:mm:ssZ)。

inputs

Object

参数解释:

在调用应用运行接口时,inputs对象中的字段(Key)并非API预留的固定字段,而是取决于您在应用开发时“开始节点”中定义的参数名。例如在开始节点定义了一个string类型参数,名称为name,值为名字,就需在请求体构建{inputs:{"name":"zhangsan"}}的形式传参。

取值范围:

不涉及。

message_id

String

参数解释:

运行消息ID,由系统生成。应用的一次运行会生成一个消息ID。因应用可能涉及交互问答,同一次运行可能涉及多次交互,因此会产生不同的消息ID。

取值范围:

标准的 UUID 格式,即由连字符(-)分隔的 32 位十六进制字符,格式为 8-4-4-4-12,例如:550e8400-e29b-41d4-a716-446655440000。

outputs

Object

参数解释:

outputs对象中的字段(Key)并非API预留的固定字段,而是取决于您在应用开发时“结束节点”中定义的参数名。例如在结束节点定义了一个string类型参数,名称为name,则outputs的内容就是{"name":"张三"}。

说明:对于智能体应用,outputs只包含output字段,为智能体的输出参数。

取值范围:

不涉及。

parent_run_id

String

参数解释:

父运行ID,用于唯一标识当前运行的父运行ID,常在子应用里出现。

取值范围:

标准的 UUID 格式,即由连字符(-)分隔的 32 位十六进制字符,格式为 8-4-4-4-12,例如:430e8400-e29b-41d4-a716-44665544defe。

run_id

String

参数解释:

运行ID,用于唯一标识一次运行。

取值范围:

标准的 UUID 格式,即由连字符(-)分隔的 32 位十六进制字符,格式为 8-4-4-4-12,例如:550e8400-e29b-41d4-a716-446655440000。

session_id

String

参数解释:

会话ID,会话的唯一标识。

取值范围:

标准的 UUID 格式,即由连字符(-)分隔的 32 位十六进制字符,格式为 8-4-4-4-12,例如:2350bb6e-7f05-40d6-b65f-2cf0d3fde0a2。

status

String

参数解释:

应用运行状态。

取值范围:

  • init:初始化。

  • init_failed:初始化失败。

  • succeeded:成功。

  • failed:失败。

  • running:运行中。

  • interacting:交互。

  • stopped:已停止。

  • canceled:已取消。

  • stopping:停止中。

user

String

参数解释:

应用运行的用户。

取值范围:

IAM用户。

version

String

参数解释:

应用版本号。标识当前运行的应用版本。

取值范围:

不涉及。

请求示例

获取应用异步运行状态

GET https://{Endpoint}/v1/{project_id}/applications/{application_id}/runs/{run_id}/status

响应示例

状态码:200

获取应用运行状态

{
  "workspace_id" : "ff8080817d30ff7b017d3213ba600001",
  "application_id" : "06824050-8a2b-4b89-a6c6-d859a4204d8f",
  "run_id" : "8ac0dfc9-5535-4a87-9c20-43e41cc871d3",
  "message_id" : "8ac0dfc9-5535-4a87-9c20-43e41cc871d3",
  "session_id" : "7917dbae-3cd6-455d-a6cd-b19c9b8099ad",
  "version" : "1.0",
  "status" : "succeeded",
  "debug" : false,
  "user" : "test_user1",
  "inputs" : {
    "name" : "John",
    "age" : 100
  },
  "outputs" : {
    "output_var" : "hello John, how are you?"
  },
  "create_date" : "2026-10-08T10:46:25Z",
  "finish_date" : "2026-10-08T10:46:26Z"
}

状态码

状态码

描述

200

获取应用运行状态成功响应。

错误码

请参见错误码。

相关文档