文档中心

AgentKit

请输入

Runtime

ListRuntimeInstances - 查询运行时实例信息

查询运行时的实例信息。

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：ListRuntimeInstances

要执行的操作，取值：ListRuntimeInstances。

Version string 必选示例值：2025-10-30

API的版本，取值：2025-10-30。

RuntimeId string 必选示例值：r-ye7agye1a8cr38iu****

运行时ID。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

InstanceItems object[] 示例值：--

实例详情。

AliasName string 示例值：name1

实例别名。

RuntimeId string 示例值：r-ye7agye1a8cr38iu****

运行时ID。

CreateTime string 示例值：2024-06-25 11:17:11.492301904 +0800 CST

实例创建时间。

InstanceName string 示例值：1jsq6bcn-630g8l8****

实例名称。

InstanceStatus string 示例值：Ready

实例状态。取值：

Starting：启动中。

Ready：就绪。

Failed：失败。

Terminating：终止中。

Unknown：未知状态。

RevisionNumber integer 示例值：1

实例版本号。

RunningInstance integer 示例值：10

运行中的实例个数。

请求示例

POST https://agentkit.cn-beijing.volcengineapi.com?Action=ListRuntimeInstances&Version=2025-10-30 HTTP/1.1​
Content-Type: application/json​
{​
    "RuntimeId": "r-ye7agye1a8cr38iu****"​
}​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "202601131535214BBED****",​
    "Action": "ListRuntimeInstances",​
    "Version": "2025-10-30",​
    "Service": "agentkit",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "InstanceItems": [​
      {​
        "RuntimeId": "r-ye7agye1a8cr38iu****",​
        "InstanceName": "xxxxx",​
        "RevisionNumber": 1,​
        "InstanceStatus": "Ready",​
        "CreateTime": "2026-01-13 02:26:51.5812395 +0000 UTC"​
      }​
    ],​
    "RunningInstance": 1,​
  }​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	MissingParameter.RuntimeId	The required parameter RuntimeId is not supplied.	runtime id不能为空。

最近更新时间：2026.01.16 10:30:23

这个页面对您有帮助吗？

有用

无用