修改运行时配置。

请求参数

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

Action string 必选示例值：UpdateRuntime

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

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

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

AgentSpaceId string 可选示例值：as-yeh6q4a48****

关联A2A智能体空间ID。

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。

格式为host/namespace/repo:tag的镜像地址。

当镜像类型选择公共镜像时，镜像地址请输入agentkit-prod-public-cn-beijing.cr.volces.com/template/financial:v1117_1。

CpuMilli integer 可选示例值：2000

实例vCPU规格, 单位为milli cpu。

取值范围 250~16000。

Description string 可选示例值：Agent-001

运行时描述。

长度限制为 1000 以内的 Unicode 字符。

Envs.N.Key string[] 必选示例值：DATABASE_MEM0_BASE_URL

运行时环境变量的键。

只能包含字母、数字、下划线，且只能以下划线字母开头，长度限制为1 ~ 63个字符。

同一运行时下 Key 唯一。

Envs.N.Value string[] 可选示例值：mem0-cnlfjzigaku8gc****.mem0.volces.com:8000

运行时环境变量的值。

KnowledgeId string 可选示例值：kb-xxxx

关联的知识库ID。

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

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

LlmshieldStatus integer 可选示例值：1

大模型安全围栏启用状态。

1：启用。

0：未启用。

MCPToolsetId string 可选示例值：mt-3tigy72q3u3vj0x2****

关联的MCP工具集ID。

MaxConcurrency integer 可选示例值：100

实例最大并发请求数量。取值范围：10~1000。

MaxInstance integer 可选示例值：10

最大实例数量。取值范围：1～10。

说明

如需提升最大实例数上限，请前往配额中心申请提升Runtime/Instances配额上限。

MemoryId string 可选示例值：mem-xxxx

关联的记忆库ID。

MemoryMb integer 可选示例值：4096

实例Memory规格。单位：MiB。取值范围：512~131072。

说明

取值需要以 512 为梯度，即512、1024、1536、2048等。

MinInstance integer 可选示例值：1

最小实例数量。取值范围：0~MaxInstance。

ModelAgentName string 可选示例值：doubao-seed-1.6

推理模型接入点。

ReleaseEnable boolean 可选示例值：true

更新完是否立即发布。取值：

true：立即发布。

false：不立即发布。

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

运行时ID。

RequestModifierConfig.FunctionId string 可选示例值：wrwsk****

veFaaS函数ID。您可以调用GetFunction获取函数ID。

SessionStoreId string 可选示例值：ss-yefjbwgpa8c1kdto****

关联会话资源ID。

RequestModifierConfig.Path string 可选示例值：/hello

自行定义访问 HTTP 服务器的路径。用于指定请求修改器作用的请求路径。

Tags.N.Key string[] 必选示例值：Tags.1.Value=v1

为资源添加的用户标签的标签键。

参数 - N：表示标签键的序号，取值范围：1～20。

多个标签键之间用&分隔。

命名规则如下：

不能以任何大小写形式的volc:或sys:开头。

volc:或sys:开头为系统预留标签键禁止创建。

只能包含语言字符、数字、空格和英文符号“_”、“.”、“:”、“/”、“=”、“+”、“-”、“@”。

长度限制在1～128个字符之间。

Tags.N.Type string[] 可选示例值：custom

标签类型。

system：系统标签。

custom：用户标签。

Tags.N.Value string[] 可选示例值：Tags.1.Value=v1

为资源添加的用户标签的标签值。

参数 - N：表示标签值的序号，取值范围：1～20。

多个标签值之间用&分隔。

命名规则如下：

只能包含语言字符、数字、空格和英文符号“_”、“.”、“:”、“/”、“=”、“+”、“-”、“@”。

允许为空，长度限制在0～256个字符之间。

ToolId string 可选示例值：t-dascxxxxx

关联的工具ID。

TosMountConfig.Credentials.AccessKeyId string 可选示例值：GY2OGJiOTdl****

输入火山引擎平台的Access Key ID。

说明

当TosMountConfig.EnableTos配置为true时必填。

TosMountConfig.Credentials.SecretAccessKey string 可选示例值：emRoTnpVNU5HU****

输入火山引擎平台的Secret Access Key ID。

说明

当TosMountConfig.EnableTos配置为true时必填。

TosMountConfig.EnableTos boolean 可选示例值：false

是否启用TOS挂载。挂载后，运行时实例对应目录产生的数据将存储至TOS服务。取值：

true：开启。

false：不开启。

TosMountConfig.MountPoints.N.BucketName string[] 可选示例值：bucket01

TOS存储桶名称。

说明

当TosMountConfig.EnableTos配置为true时必填。

TosMountConfig.MountPoints.N.BucketPath string[] 可选示例值：http://tos-cn-beijing.ivolces.com

TOS存储桶路径。

说明

当TosMountConfig.EnableTos配置为true时必填。

TosMountConfig.MountPoints.N.Endpoint string[] 可选示例值：tmp/abc

TOS存储桶子目录。

说明

当TosMountConfig.EnableTos配置为true时必填。

TosMountConfig.MountPoints.N.LocalMountPath string[] 可选示例值：/home/app

待挂载的运行时实例本地目录。

说明

当TosMountConfig.EnableTos配置为true时必填。

TosMountConfig.MountPoints.N.ReadOnly boolean[] 可选示例值：false

指定待挂载的运行时实例本地目录的访问权限。取值：

true：只读权限。

false：读写权限。

说明

当TosMountConfig.EnableTos配置为true时必填。

返回参数

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

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

运行时ID。

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	InvalidDescription.Malformed	The specified Description is malformed.	指定的描述格式错误。
400	InvalidKey.Malformed	The specified Key is malformed.	指定的Key不合法。
400	InvalidParams.MaxInstance	MaxInstance should be in range [MinInstance, runtime.quota]	无效的最大实例个数配置。
400	InvalidParams.MinInstance	MinInstance should be in range [0, MaxInstance]	无效的最小实例个数配置。
400	InvalidResourceStatus	The status of the specified resource does not support this request.	当前资源的状态不支持此操作。
400	MissingParameter.DiscoveryUrl	The required parameter DiscoveryUrl is not supplied.	参数DiscoveryUrl不能为空。
400	MissingParameter.Key	The required parameter Key is not supplied.	参数Key不能为空。
400	MissingParameter.RuntimeId	The required parameter RuntimeId is not supplied.	runtime id不能为空。
400	InvalidParameter.MemoryId	The specified parameter MemoryId is invalid.	MemoryId参数不合法。
400	InvalidEnvKey.Malformed	The environment variable key must start with an underscore or a letter, contain only letters, digits, or underscores, and be at most 63 characters long.	环境变量Key不合法。
400	InvalidParameter.ArtifactUrl	The specified parameter ArtifactUrl is invalid.	参数ArtifactUrl不合法。
400	InvalidParameter.KnowledgeIds	The specified parameter KnowledgeIds is invalid.	参数KnowledgeIds不合法。
400	InvalidParams.CpuMilli	CpuMilli should be in range [1000, 1250, 1500, 2000, 4000, 8000, 16000]	参数CpuMilli需要在[1000, 1250, 1500, 2000, 4000, 8000, 16000]范围内。
404	InvalidAgentKitRuntime.NotFound	The specified AgentKitRuntime does not exist.	资源不存在。

AgentKit