AgentKit
AgentKit
文档指南
请输入
- 文档首页
AgentKitAgentKit开发者指南API参考RuntimeListRuntimeVersions - 查询运行时所有版本详情
复制全文
下载 pdfListRuntimeVersions - 查询运行时所有版本详情
文档反馈
问问助手查询运行时所有版本的详情。
请求参数
Action string 必选 示例值：ListRuntimeVersions
要执行的操作，取值：ListRuntimeVersions。
Version string 必选 示例值：2025-10-30
API的版本，取值：2025-10-30。
MaxResults integer 可选 示例值：10
分页查询时设置的每页行数。
- 最小值：1。
- 最大值：100。
- 默认值：10。
NextToken string 可选 示例值：3da3332e**
分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的NextToken参数值。
RuntimeId string 必选 示例值：r-ye7agye1a8cr38iu****
运行时ID。
返回参数
AgentKitRuntimeVersions object[] 示例值：--
运行时所有版本的详情。
TosMountConfig object 示例值：--
TOS挂载配置。
Credentials object 示例值：--
TOS凭证。
AccessKeyId string 示例值：GY2OGJiOTdl****
火山引擎平台的Access Key ID。
SecretAccessKey string 示例值：emRoTnpVNU5HU****
火山引擎平台的Secret Access Key ID。
EnableTos boolean 示例值：true
是否启用TOS挂载。挂载后，运行时实例对应目录产生的数据将存储至TOS服务。取值：
- true：开启。
- false：不开启。
MountPoints object[] 示例值：--
TOS 挂载点列表。
BucketName string 示例值：bucket01
TOS存储桶名称。
BucketPath string 示例值：http://tos-cn-beijing.ivolces.com
TOS存储桶路径。
Endpoint string 示例值：tmp/abc
TOS存储桶子目录。
LocalMountPath string 示例值：/home/app
待挂载的运行时实例本地目录。
ReadOnly boolean 示例值：false
指定待挂载的运行时实例的访问权限。取值：
- true：只读权限。
- false：读写权限。
ApmplusEnable boolean 示例值：true
是否开启APMPlus和日志服务，以提供对Runtime的观测并写入日志。包括：
- true：开启。
- false：不开启。
ArtifactType string 示例值：image
运行时镜像类型。取值：
- image: 自定义镜像。
- public_image: 公共镜像。
ArtifactUrl string 示例值：cp-enterprise-cn-beijing.cr.volces.com/demo/agent:latest
运行时镜像的URL。
AuthorizerConfiguration object 示例值：--
入站身份认证信息。目前支持API Key和OAuth JWT认证配置。
CustomJwtAuthorizer object 示例值：--
OAuth JWT认证方式。
AllowedClients string[] 示例值：["client1"]
允许访问的客户端列表，允许所有客户端访问时，置为空列表。
DiscoveryUrl string 示例值：https://example.com/.well-known/openid-configuration
令牌签名密钥 URL。此 URL 用于获取 OpenID Connect 配置或授权服务器元数据，以验证传入的令牌。目前仅支持火山引擎identity服务的签名秘钥URL。
KeyAuth object 示例值：--
API Key认证配置。
ApiKey string 示例值：22243eefff**
API Key的值。
ApiKeyLocation string 示例值：Header
API Key传递的位置。取值：
- Header：当前仅支持Header。
ApiKeyName string 示例值：test-key
API Key的名字。
Command string 示例值：./run.sh
运行时启动命令。
CpuMilli integer 示例值：1000
单实例最大CPU。单位：milli cpu。
CreatedAt string 示例值：2025-10-20T16:02:15+08:00
运行时版本创建时间。
Description string 示例值：runtime01
运行时描述。
Envs object[] 示例值：--
运行时环境变量。
Key string 示例值：test-key
环境变量的Key。
Value string 示例值：test-value
环境变量的Value。
MemoryMb integer 示例值：2048
单实例最大内存，单位 MB。
RoleName string 示例值：MyTestRole
运行时绑定的IAM角色名称。
RuntimeId string 示例值：r-22ddsc***
运行时ID。
Status string 示例值：Ready
运行时状态。取值：
- Creating：创建中。
- Error： 错误。
- Releasing： 发布中。
- Ready： 运行中。
- Deleting： 删除中。
- Deleted： 已删除。
- Updating： 更新中。
- UnReleased： 未发布。
UpdatedAt string 示例值：2025-10-20T16:02:15+08:00
运行时版本更新时间。
VersionNumber integer 示例值：1
版本号。
NextToken string 示例值：bHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq****
本次调用返回的查询凭证值，返回为空表示该页为末页。
请求示例
POST https://agentkit.cn-beijing.volcengineapi.com?Action=ListRuntimeVersions&Version=2025-10-30 HTTP/1.1
Content-Type: application/json
{
"RuntimeId": "r-ye6xzwchkwoaroxxxxxx",
"MaxResults": "10",
}
返回示例
{
"ResponseMetadata": {
"RequestId": "202510272157150B50CD9A1448B0289A80",
"Action": "ListRuntimeVersions",
"Version": "2025-10-30",
"Service": "agentkit",
"Region": "cn-beijing"
},
"Result": {
"AgentKitRuntimeVersions": [
{
"RuntimeId": "rv-ye7******",
"Description": "AgentKit project",
"VersionNumber": 1,
"CreatedAt": "2025-10-27T17:04:53+08:00",
"UpdatedAt": "2025-10-27T17:05:20+08:00",
"ArtifactType": "image",
"ArtifactUrl": "agentkit-cli-******",
"AuthorizerConfiguration": {
"KeyAuth": {
"ApiKey": "dsdsds******",
"ApiKeyLocation": "Header",
"ApiKeyName": "API-KEY-******"
},
},
"Envs": [
{
"Key": "MODEL_AGENT_API_KEY",
"Value": "38484******"
}
],
"Command": "",
"RoleName": "AgentKit-Runtime******",
"Status": "Ready",
"CpuMilli": 1000,
"MemoryMb": 2048,
"ApmplusEnable": true
},
{
"RuntimeId": "rv-ye7s******",
"Description": "AgentKit project",
"VersionNumber": 0,
"CreatedAt": "2025-10-27T17:04:04+08:00",
"UpdatedAt": "2025-10-27T17:04:04+08:00",
"ArtifactType": "image",
"ArtifactUrl": "agentkit-******",
"AuthorizerConfiguration": {
"KeyAuth": {
"ApiKey": "dsdd******",
"ApiKeyLocation": "Header",
"ApiKeyName": "API-KEY-******"
},
},
"Envs": [
{
"Key": "MODEL_AGENT_API_KEY",
"Value": "38484******"
}
],
"Command": "",
"RoleName": "AgentKit******",
"Status": "Creating",
"CpuMilli": 0,
"MemoryMb": 0,
"ApmplusEnable": true,
}
],
"NextToken": "dC15ZTdjZ2xlM3VvYzFrZHRvcn****",
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
400 | MissingParameter.RuntimeId | The required parameter RuntimeId is not supplied. | runtime id不能为空。 |
404 | InvalidAgentKitRuntime.NotFound | The specified AgentKitRuntime does not exist. | 指定运行时不存在 |
最近更新时间：2026.07.21 20:57:35
这个页面对您有帮助吗？
有用
有用
无用
无用