获取异步应用运行的状态 - ShowRunStatus
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| DataArtsPlatform:application:showRunStatus | Read | - | - | - | - |
URI
GET /v1/{project_id}/applications/{application_id}/runs/{run_id}/status
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Workspace-Id | 是 | String | 参数解释: 工作空间ID。 获取方法请参见获取项目ID,例如:6280b8733aea43a2a0799c55aeeb0e68。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 参数解释: 是否是调试模式。 取值范围: |
| 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 | 参数解释: 应用运行状态。 取值范围: |
| 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 | 获取应用运行状态成功响应。 |
错误码
请参见错误码。