查询运行时某个版本的详情。

请求参数

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

Action string 必选示例值：GetRuntimeVersion

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

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

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

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

运行时ID。

VersionNumber integer 可选示例值：1

运行时版本号。不填默认为0，表示最新版本。

返回参数

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

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

运行时描述。

Endpoint string 示例值：http://sd3qupshmeps3v7l9****.apigateway-cn-beijing.volceapi.com

运行时访问域名。

Envs object[] 示例值：--

运行时环境变量。

Key string 示例值：test-key

环境变量的Key。

Value string 示例值：test-value

环境变量的Value。

LinkedResources object[] 示例值：--

关联组件资源列表。

Id string 示例值：mem-yefiu7g5q8c1kdto****

资源ID。

Name string 示例值：viking_g6q3nnk

资源名称。

Type string 示例值：Memory

资源类型。包括：

Knowledge：知识库。

Memory：记忆库。

MCPToolset：MCP工具集。

BuiltInTool：工具。

SessionStore：会话资源。

LlmshieldAppId string 示例值：app-d65v55avi7p8hpl3****

关联的大模型安全围栏资产ID。

LlmshieldStatus integer 示例值：1

大模型安全围栏状态。

1：启用。

0：未启用。

MaxConcurrency integer 示例值：5

实例最大并发请求数量。

MemoryMb integer 示例值：2048

单实例最大内存，单位 MB。

ModelAgentName string 示例值：doubao-seed-1.6

推理模型接入点。

Name string 示例值：my-agent

运行时名称。

ProjectName string 示例值：default

运行时所属项目名称。

RoleName string 示例值：MyTestRole

运行时绑定的IAM角色名称。

RuntimeId string 示例值：r-22ddsc***

运行时ID。

Status string 示例值：Ready

运行时状态。取值：

Creating：创建中。

Error：错误。

Releasing：发布中。

Ready：运行中。

Deleting：删除中。

Deleted：已删除。

Updating：更新中。

UnReleased：未发布。

Tags object[] 示例值：--

运行时标签列表。

Key string 示例值：k1

标签键。

Type string 示例值：system

标签类型。

system：系统标签。

custom：用户标签。

Value string 示例值：v1

标签值。

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：读写权限。

UpdatedAt string 示例值：2025-10-20T16:02:15+08:00

版本更新时间。

VersionNumber integer 示例值：1

运行时版本号。

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	MissingParameter.RuntimeId	The required parameter RuntimeId is not supplied.	runtime id不能为空。
404	InvalidResource.NotFound	The specified resource does not exist.	资源不存在

AgentKit