# 获取异步应用运行的状态 - ShowRunStatus #### 功能介绍 该接口用于获取应用异步运行的状态。当通过[异步运行应用](https://support.huaweicloud.com/api-dataartsplatform/RunApplicationAsync.html)接口异步运行应用后，就可以通过该接口获取应用运行的状态信息。 接口路径参数里的run_id就是[异步运行应用](https://support.huaweicloud.com/api-dataartsplatform/RunApplicationAsync.html)接口返回的run_id。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-dataartsplatform/dataartsplatform_07_0002.html)。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-dataartsplatform/dataartsplatform_07_0013.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | DataArtsPlatform:application:showRunStatus | Read | - | - | - | - | #### URI GET /v1/{project_id}/applications/{application_id}/runs/{run_id}/status 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-dataartsplatform/dataartsplatform_07_0021.html)。 **约束限制：** 不涉及。 **取值范围：** 小写字母和数字组成的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](https://support.huaweicloud.com/api-dataartsplatform/dataartsplatform_07_0021.html)，例如：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 | 获取应用运行状态成功响应。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-dataartsplatform/ErrorCode.html)。