更新runtime - UpdateCoreRuntime

agentarts:runtime:updateCoreRuntime

Write

runtime *

g:ResourceTag/<tag-key>

-

• iam:agencies:pass
• vpc:nativePorts:create
• vpc:routeTables:update
• eip:publicIps:associateInstance

-

• g:RequestTag/<tag-key>

• g:TagKeys

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}$。

默认取值:

不涉及。

version

否

String

参数解释:

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

约束限制:

不涉及。

取值范围:

以小写字母或数字开头，以小写字母或数字结尾，可以包含小写字母、数字和中划线，长度为2-24个字符。

默认取值:

不涉及。

description

否

String

参数解释:

版本描述信息。

约束限制:

不涉及。

取值范围:

长度为0-255个字符，不能包含小于号或大于号

默认取值:

不涉及。

artifact_source

否

CoreRunArtifactSource object

参数解释:

Agent来源数据结构。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

environment_variables

否

Array of CoreRunEnvironmentVariable objects

参数解释:

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

约束限制:

总大小约束2MB。

取值范围:

支持0 - 1024个元素。

默认取值:

不涉及。

invoke_config

否

UpdateCoreRunInvokeConfig object

参数解释:

更新智能体运行时调用相关配置。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

observability

否

CoreRunObservability object

参数解释:

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

storage_config

否

CoreRunStorageConfig object

参数解释:

运行时存储配置，支持挂载SFS Turbo存储类型。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

tags

否

Array of CoreRunTagItem objects

参数解释:

标签配置列表，对接TMS标签服务，用于资源分类。

约束限制:

元素个数0 - 20。

取值范围:

不涉及。

默认取值:

不涉及。

execution_agency_name

否

String

参数解释：

运行时委托名称。

约束限制:

必须是一个存在的信任委托名称，且该委托授权对象为安全沙箱元数据。

取值范围：

长度为 1 - 64 个字符。

默认取值:

不涉及。

url

是

String

参数解释:

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

约束限制:

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

取值范围:

长度为 1 - 2048 个字符。

默认取值:

不涉及。

commands

否

Array of strings

参数解释:

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

约束限制:

不涉及。

取值范围:

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

默认取值:

不涉及。

key

是

String

参数解释:

环境变量键。

约束限制:

不涉及。

取值范围:

必须以字母开头，由英文字母、数字、下划线和点号组成，长度为 1 - 512 个字符。

默认取值:

不涉及。

value

是

String

参数解释:

环境变量值。

约束限制:

不涉及。

取值范围:

长度为 0 - 1048576 个字符。

默认取值:

不涉及。

port

否

Integer

参数解释:

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

约束限制:

不涉及。

取值范围:

1 - 65535

默认值:

8080

protocol

否

String

参数解释:

智能体运行时支持的协议类型，默认值HTTP。

• HTTP: HTTP协议

• MCP: MCP协议

• HTTP

• MCP

约束限制:

不涉及。

取值范围:

长度为 1 - 4 个字符。允许的值为：

默认值:

HTTP

logs

否

CoreRunLogsConfig object

参数解释:

日志采集配置。

约束限制:

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

取值范围:

不涉及。

默认取值:

不涉及。

metrics

否

CoreRunMetricsObservabilityConfig object

参数解释:

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

tracing

否

CoreRunTracingObservabilityConfig object

参数解释:

调用链采集配置。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

enabled

否

Boolean

参数解释:

是否开启日志采集，默认为false。

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

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

• true

• false

约束限制:

不涉及。

取值范围:

默认值:

false

group_id

否

String

参数解释:

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

约束限制:

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

取值范围:

长度为 1 - 64 个字符。

默认值:

无。

stream_id

否

String

参数解释:

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

约束限制:

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

取值范围:

长度为 1 - 64 个字符。

默认值:

无。

project_id

否

String

参数解释:

日志流所在项目ID，可以访问我的凭据控制台页面获取对应的项目ID或者通过IAM的项目查询接口获取。

约束限制:

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

取值范围:

长度为 1 - 64 个字符。

默认值:

不涉及。

enabled

否

Boolean

参数解释:

是否开启自定义指标采集，默认为false。

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

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

• true

• false

约束限制:

不涉及。

取值范围:

默认值:

false

instance_id

否

String

参数解释:

自定义指标实例ID。可以通过AOM的Prometheus监控 > 实例列表页面获取实例ID，或者通过AOM的实例查询接口获取。

约束限制:

不涉及。

取值范围:

长度为 1 - 64 个字符。

默认取值:

不涉及。

enabled

否

Boolean

参数解释:

是否开启调用链采集，默认为false。

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

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

• true

• false

约束限制:

不涉及。

取值范围:

默认值:

false

service_group

否

String

参数解释:

调用链服务应用名。

约束限制:

不涉及。

取值范围:

长度为 1 - 64 个字符。

默认取值:

不涉及。

sfs_turbo

否

Array of CoreRunSfsTurboStorageConfig objects

参数解释:

SFS Turbo存储挂载配置列表。

约束限制:

最多支持5个SFS Turbo挂载点。

取值范围:

不涉及。

默认取值:

不涉及。

sfs_turbo_id

是

String

参数解释:

SFS Turbo实例ID。

约束限制:

必选参数。

取值范围:

匹配标准的UUID格式。

默认取值:

不涉及。

sfs_path

否

String

参数解释:

SFS Turbo存储的目录路径。

约束限制:

可选参数，若有值则必须以'/'开头，不能包含'..'。

取值范围:

0-4096

默认取值:

/

mount_path

是

String

参数解释:

挂载到运行时的目录路径。

约束限制:

必选参数，必须为/home, /mnt, /data, /tmp，或上述目录的子目录，不能包含'..'。不同挂载目录之间，禁止相同或存在包含关系。

取值范围:

不涉及。

默认取值:

不涉及。

read_only

否

Boolean

参数解释:

是否以只读方式挂载。

约束限制:

可选参数。

取值范围:

不涉及。

默认取值:

false

key

是

String

参数解释:

标签键。

约束限制:

不涉及。

取值范围:

长度为 1 - 128 个字符。

默认取值:

不涉及。

value

是

String

参数解释:

标签值。

约束限制:

不涉及。

取值范围:

长度为 0 - 255 个字符。

默认取值:

不涉及。

id

String

参数解释:

AgentRuntime唯一标识（用户操作唯一键，UUID随机生成）。

取值范围:

匹配标准的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}$。

description

String

参数解释:

描述信息。

取值范围:

长度为 0 - 4096 个字符。

name

String

参数解释:

Agent名称。

取值范围:

以小写字母开头，以小写字母或数字结尾，可以包含小写字母、数字和中划线，长度为2-48个字符。

latest_version

String

参数解释:

最新版本名称。

取值范围:

长度为 2 - 24 个字符，必须以字母开头和结尾，支持中划线。

created_at

String

参数解释:

创建时间。

取值范围:

不涉及。

agent_gateway_id

String

参数解释:

Agent Gateway ID。

取值范围:

匹配标准的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}$。

updated_at

String

参数解释:

最后更新时间。

取值范围:

不涉及。

workload_identity_urn

String

参数解释:

Identity URN。

取值范围:

长度为 1 - 1500 个字符。

tags

Array of CoreRunTagItemResp objects

参数解释:

标签配置列表，对接TMS标签服务，用于资源分类。

取值范围:

不涉及。

arch

String

参数解释:

运行时架构。

取值范围:

arm64、x86_64

version_detail

CoreRunRuntimeVersion object

参数解释:

关联版本信息（查询接口返回，非存储字段，关联指定版本配置）。

取值范围:

不涉及。

key

String

参数解释:

标签键。

取值范围:

长度为 1 - 128 个字符。

value

String

参数解释:

标签值。

取值范围:

长度为 0 - 255 个字符。

version

String

参数解释:

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

取值范围:

以小写字母或数字开头，以小写字母或数字结尾，可以包含小写字母、数字和中划线，长度为2-24个字符。

description

String

参数解释:

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

取值范围:

长度为 0 - 4096 个字符。

created_at

String

参数解释:

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

取值范围:

不涉及。

updated_at

String

参数解释:

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

取值范围:

不涉及。

artifact_source

CoreRunArtifactSourceResp object

参数解释:

Agent来源数据结构。

取值范围:

不涉及。

network_config

CoreRunNetworkConfigResp object

参数解释:

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

取值范围:

不涉及。

environment_variables

Array of CoreRunEnvironmentVariableResp objects

参数解释:

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

取值范围:

支持0 - 1024个元素。

invoke_config

CoreRunInvokeConfigResp object

参数解释:

智能体调用相关配置。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

observability

CoreRunObservabilityResp object

参数解释:

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

取值范围:

不涉及。

storage_config

CoreRunStorageConfig object

参数解释:

运行时存储配置，支持挂载SFS Turbo存储类型。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

url

String

参数解释:

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

取值范围:

长度为 1 - 2048 个字符。

commands

Array of strings

参数解释:

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

取值范围:

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

network_mode

String

参数解释:

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

• PUBLIC: 表示公网出口。

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

• PUBLIC

• VPC

取值范围:

长度为 1 - 6 个字符。允许的值为：

vpc_config

CoreRunVpcConfigResp 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列表。可以通过VPC的控制台页面或者VPC查询接口获取。

取值范围:

元素个数0-10个，每个安全组值的长度为 1 - 36 个字符。

key

String

参数解释:

环境变量键。

取值范围:

必须以字母开头，由英文字母、数字、下划线和点号组成，长度为 1 - 512 个字符。

value

String

参数解释:

环境变量值。

取值范围:

长度为 0 - 1048576 个字符。

port

Integer

参数解释:

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

约束限制:

不涉及。

取值范围:

1 - 65535

默认值:

8080

protocol

String

参数解释:

智能体运行时支持的协议类型，默认值HTTP。

• HTTP: HTTP协议

• MCP: MCP协议

• HTTP

• MCP

约束限制:

不涉及。

取值范围:

长度为 1 - 4 个字符。允许的值为：

默认值:

HTTP

file_transfer_config

CoreRunFileTransferConfig object

参数解释:

智能体运行时文件操作配置。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

url_match_type

String

参数解释:

智能体运行时调用URL的匹配模式

• ACCURATE_MATCH: 运行时调用URL为精确匹配，只支持/runtimes/{runtime_name}/invocations的调用路径。

• PREFIX_MATCH: 运行时调用URL为前缀匹配，支持/runtimes/{runtime_name}/invocations以及/runtimes/{runtime_name}/invocations/{custom_path}的调用路径。

• ACCURATE_MATCH

• PREFIX_MATCH

取值范围:

enabled

Boolean

参数解释:

是否开启文件上传/下载功能，默认为false。

• 未开启，智能体运行时将不对外提供文件上传/下载的API接口。

• 开启后，智能体运行时将提供文件上传/下载的API接口。

• true

• false

约束限制:

不涉及。

取值范围:

默认值:

false

logs

CoreRunLogsConfigResp object

参数解释:

日志采集配置。

取值范围:

不涉及。

metrics

CoreRunMetricsObservabilityConfigResp object

参数解释:

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

取值范围:

不涉及。

tracing

CoreRunTracingObservabilityConfigResp object

参数解释:

调用链采集配置。

取值范围:

不涉及。

enabled

Boolean

参数解释:

是否开启日志采集，默认为false。

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

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

• true

• false

取值范围:

group_id

String

参数解释:

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

取值范围:

长度为 1 - 64 个字符。

stream_id

String

参数解释:

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

取值范围:

长度为 1 - 64 个字符。

project_id

String

参数解释:

日志流所在项目ID，可以访问我的凭据控制台页面获取对应的项目ID或者通过IAM的项目查询接口获取。

取值范围:

长度为 1 - 64 个字符。

enabled

Boolean

参数解释:

是否开启自定义指标采集，默认为false。

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

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

• true

• false

取值范围:

instance_id

String

参数解释:

自定义指标实例ID。可以通过AOM的Prometheus监控 > 实例列表页面获取实例ID，或者通过AOM的实例查询接口获取。

取值范围:

长度为 1 - 64 个字符。

enabled

Boolean

参数解释:

是否开启调用链采集，默认为false。

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

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

• true

• false

取值范围:

service_group

String

参数解释:

调用链服务应用名。

取值范围:

长度为 1 - 64 个字符。

sfs_turbo

Array of CoreRunSfsTurboStorageConfig objects

参数解释:

SFS Turbo存储挂载配置列表。

约束限制:

最多支持5个SFS Turbo挂载点。

取值范围:

不涉及。

默认取值:

不涉及。

sfs_turbo_id

String

参数解释:

SFS Turbo实例ID。

约束限制:

必选参数。

取值范围:

匹配标准的UUID格式。

默认取值:

不涉及。

sfs_path

String

参数解释:

SFS Turbo存储的目录路径。

约束限制:

可选参数，若有值则必须以'/'开头，不能包含'..'。

取值范围:

0-4096

默认取值:

/

mount_path

String

参数解释:

挂载到运行时的目录路径。

约束限制:

必选参数，必须为/home, /mnt, /data, /tmp，或上述目录的子目录，不能包含'..'。不同挂载目录之间，禁止相同或存在包含关系。

取值范围:

不涉及。

默认取值:

不涉及。

read_only

Boolean

参数解释:

是否以只读方式挂载。

约束限制:

可选参数。

取值范围:

不涉及。

默认取值:

false

error_code

String

参数解释：

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

取值范围：

固定值：AgentArts.03000400。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为1-512个字符。

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.03000409表示资源冲突。

取值范围：

固定值：AgentArts.03000409。

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

更新成功，返回更新后的AgentRun完整信息（含最新版本详情）。

400

参数错误（如必填字段格式不正确、版本配置冲突等）。

401

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

403

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

404

资源不存在（指定的runtimeId未找到）。

409

资源冲突（如同时更新导致版本号冲突）。

429

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

500

服务器错误（如数据库更新失败、版本号生成异常等）。