批量查询版本 - ListCoreRuntimeVersions

runtime_id

是

String

参数解释：

运行时ID，用于唯一标识一个Agent运行时实例。可以通过AgentArts智能体运行时控制台或者运行时查询接口获取。

约束限制:

不涉及。

取值范围：

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），符合正则条件^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$。

默认取值:

无

offset

否

Integer

参数解释：

分页起始页码，默认值为1。

约束限制:

不涉及。

取值范围：

1 - 1000

默认取值:

1

limit

否

Integer

参数解释：

每页记录数，默认值为10。

约束限制:

不涉及。

取值范围：

10 - 100

默认取值:

10

total

Integer

参数解释:

总记录数。

取值范围:

0 - 1000000

items

Array of CoreRunRuntimeVersion objects

参数解释:

RuntimeVersion对象列表。

取值范围:

元素个数为0 - 100。

version

String

参数解释:

版本名称，默认为v1、v2自增长，用户也可自定义。

取值范围:

如果用户自定义版本名称，长度为 1 - 24 个字符，必须以字母开头和结尾。

description

String

参数解释:

版本描述（创建/更新版本时可选）。

取值范围:

长度为 0 - 4096 个字符。

created_at

String

参数解释:

创建时间（系统自动生成，UTC时区）。

取值范围:

不涉及。

updated_at

String

参数解释:

最近更新时间（系统自动生成，版本更新/标签修改时刷新）。

取值范围:

不涉及。

artifact_source

CoreRunArtifactSource object

参数解释:

Agent来源数据结构。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

network_config

CoreRunNetworkConfig object

参数解释:

出站网络配置，不配置默认是PUBLIC。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

environment_variables

Array of CoreRunEnvironmentVariable objects

参数解释:

环境变量配置列表，用于配置运行时环境变量。

约束限制:

总大小约束2MB。

取值范围:

支持0 - 1024个元素。

默认取值:

不涉及。

invoke_config

CoreRunInvokeConfigResp object

参数解释:

智能体调用相关配置。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

observability

CoreRunObservability object

参数解释:

可观测性配置（日志+指标）。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

url

String

参数解释:

Agent镜像地址，用于运行时拉取镜像启动Agent服务，可以通过SWR控制台以及SWR的镜像查询接口获取对应的镜像地址。

约束限制:

必须是一个有效的SWR镜像地址。

取值范围:

长度为 1 - 2048 个字符。

默认取值:

不涉及。

commands

Array of strings

参数解释:

启动镜像的命令，示例：python main.py --port=8080。

约束限制:

不涉及。

取值范围:

最多 10 个元素，每个元素长度为 1 - 256 个字符。

默认取值:

不涉及。

network_mode

String

参数解释:

出站网络类型，当前支持如下2种：

• PUBLIC: 表示公网出口。

• VPC: 表示虚拟私有云出口。

约束限制:

不涉及。

取值范围:

• PUBLIC

• VPC

默认取值:

PUBLIC。

vpc_config

CoreRunVpcConfig object

参数解释:

vpc网络配置。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

vpc_id

String

参数解释:

VPC ID，可以通过VPC的控制台页面或者VPC查询接口获取。

约束限制:

不涉及。

取值范围:

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），符合正则条件^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$。

默认取值:

不涉及。

subnet_id

String

参数解释:

子网ID，可以通过VPC的控制台页面或者VPC查询接口获取。

约束限制:

不涉及。

取值范围:

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），符合正则条件^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$。

默认取值:

不涉及。

security_group_ids

Array of strings

参数解释:

VPC关联的安全组ID列表。

约束限制:

不涉及。

取值范围:

元素个数0-10个。

默认取值:

不涉及。

key

String

参数解释:

环境变量键。

约束限制:

不涉及。

取值范围:

必须以字母开头，由英文字母、数字、下划线和点号组成。

默认取值:

不涉及。

value

String

参数解释:

环境变量值。

约束限制:

不涉及。

取值范围:

长度为 1 - 1048576 个字符。

默认取值:

不涉及。

port

Integer

参数解释:

智能体运行时监听的端口号，用于接收外部请求。

约束限制:

不涉及。

取值范围:

1 - 65535

默认值:

8080

protocol

String

参数解释:

智能体运行时支持的协议类型

• HTTP: HTTP协议

• MCP: MCP协议

约束限制:

不涉及。

取值范围:

• HTTP

• MCP

默认值:

HTTP

logs

CoreRunLogsConfig object

参数解释:

日志采集配置。

约束限制:

日志组ID与日志流ID必须配套使用，要么同时缺省，要么同时填写。

取值范围:

不涉及。

默认取值:

不涉及。

metrics

CoreRunMetricsObservabilityConfig object

参数解释:

自定义指标采集详细配置。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

tracing

CoreRunTracingObservabilityConfig object

参数解释:

调用链采集配置。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

enabled

Boolean

参数解释:

是否开启日志采集。

• 未开启，托管运行时过程产生的日志无法上报至云日志服务(LTS)。

• 开启后，托管运行时过程产生的日志会上报云日志服务(LTS)。

约束限制:

不涉及。

取值范围:

• true

• false

默认值:

false

group_id

String

参数解释:

日志组ID。

约束限制:

与日志流ID配套使用，需同时填写或同时缺省。

取值范围:

长度为 1 - 64 个字符。

默认值:

无。

stream_id

String

参数解释:

日志流ID。

约束限制:

与日志组ID配套使用，需同时填写或同时缺省。

取值范围:

长度为 1 - 64 个字符。

默认值:

无。

project_id

String

参数解释:

日志流所在项目ID。

约束限制:

与日志组ID配套使用，需同时填写或同时缺省。

取值范围:

长度为 1 - 64 个字符。

默认值:

无。

enabled

Boolean

参数解释:

是否开启自定义指标采集。

• 未开启，托管运行时过程产生的自定义指标无法上报至应用运维管理服务(AOM)。

• 开启后，托管运行时过程产生的自定义指标会上报应用运维管理服务(AOM)。

约束限制:

不涉及。

取值范围:

• true

• false

默认值:

false

instance_id

String

参数解释:

自定义指标实例ID。

约束限制:

不涉及。

取值范围:

长度为 1 - 64 个字符。

默认取值:

不涉及。

enabled

Boolean

参数解释:

是否开启调用链采集。

• 未开启，托管运行时过程产生的调用链数据无法上报至应用性能管理服务(APM)。

• 开启后，托管运行时过程产生的调用链数据会上报应用性能管理服务(APM)。

约束限制:

不涉及。

取值范围:

• true

• false

默认值:

false

service_group

String

参数解释:

调用链服务应用名。

约束限制:

不涉及。

取值范围:

长度为 1 - 64 个字符。

默认取值:

不涉及。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000400表示客户端请求参数错误。

取值范围：

固定值：AgentArts.03000400。

error_msg

String

错误详细信息。

error_code

String

参数解释:

错误码。枚举值说明：AgentArts.03000401表示未授权（认证令牌缺失、无效或已过期）。

取值范围:

不涉及。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000403表示禁止访问（认证后权限不足）。

取值范围：

固定值：AgentArts.03000403。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

coded_authorization_message

String

参数解释：

IAM5 当OpenAPI无权限时报错信息。

取值范围：

长度为 1 - 1024 个字符。

details

Array of CoreRunErrorDetail objects

参数解释：

依赖的下游服务错误信息列表。

取值范围：

最小数量 0，最大数量 10。

error_code

String

参数解释：

错误码。

取值范围：

长度为 18 个字符。

error_msg

String

参数解释：

错误信息。

取值范围：

长度为 1 - 1024 个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000404表示资源不存在。

取值范围：

固定值：AgentArts.03000404。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000429表示请求过于频繁（触发限流）。

取值范围：

固定值：AgentArts.03000429。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000500表示服务器内部错误。

取值范围：

固定值：AgentArts.03000500。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

200

查询成功。

400

请求参数错误。

401

未授权（认证令牌缺失、无效或已过期）。

403

禁止访问（认证后权限不足）。

404

资源不存在。

429

请求过于频繁（触发限流）。

500

服务器内部错误。