更新代码解释器 - UpdateCoreCodeInterpreter
功能介绍
该API用于更新代码解释器配置。
URI
PUT /v1/core/code-interpreters/{code_interpreter_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| code_interpreter_id | 是 | String | 参数解释: 代码解释器ID。 约束限制: 不涉及。 取值范围: 符合UUID正则^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$的36位字符串。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| observability | 否 | CoreToolsObservability object | 参数解释: 可观测配置,包含日志采集、自定义指标采集、调用链采集等配置。 约束范围: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| tags | 否 | Array of CoreToolsTag objects | 参数解释: 资源标签。 约束范围: 不涉及。 取值范围: 最多20个,且键值不能重复。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| logs | 否 | CoreToolsLogsConfig object | 参数解释: 工具的日志配置。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| metrics | 否 | 参数解释: 工具的自定义指标采集详细配置。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 | |
| tracing | 否 | 参数解释: 工具的调用链采集配置。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| enabled | 否 | Boolean | 参数解释: 是否开启日志采集。 约束限制: 不涉及。 取值范围: 默认取值: false。 |
| group_id | 否 | String | 参数解释: 工具的日志组ID。 约束限制: 当前不支持更新、指定。 取值范围: 长度不能超过64个字符。 默认取值: 不涉及。 |
| stream_id | 否 | String | 参数解释: 工具的日志流ID。 约束限制: 当前不支持更新、指定。 取值范围: 长度不能超过64个字符。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| enabled | 否 | Boolean | 参数解释: 是否开启自定义指标采集。 约束限制: 不涉及。 取值范围: 默认取值: false。 |
| instance_id | 否 | String | 参数解释: 自定义指标实例ID。 约束限制: 不涉及。 取值范围: 长度不能超过64个字符。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| enabled | 否 | Boolean | 参数解释: 是否开启调用链采集。 约束限制: 不涉及。 取值范围: 默认取值: false。 |
| service_group | 否 | String | 参数解释: 调用链服务组名。 约束限制: 不涉及。 取值范围: 长度不能超过64个字符。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| key | 是 | String | 参数解释: 标签键。 约束限制: 不能为空,且单个资源标签键不能重复。 取值范围: 符合规则^((?!\s)(?!sys)[\p{L}\p{Z}\p{N}.:/=+-@]*)(?<!\s)$,即可以包含任意语种的字母、数字和空格,以及.:=+-@字符,但首尾不能包含空格,且不能以_sys_开头,且长度在1到128之间。 默认取值: 不涉及。 |
| value | 是 | String | 参数解释: 标签值。 约束限制: 不涉及。 取值范围: 符合规则^([\p{L}\p{Z}\p{N}.:/=+-@]*)$,即可以包含任意语种的字母、数字和空格,以及.:/=+-@字符,且长度不能超过255个字符。 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 代码解释器ID。 取值范围: 符合UUID规则^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$的36位字符串。 |
| name | String | 参数解释: 代码解释器的名称。 取值范围: 符合正则^[a-z][a-z0-9-]{0,46}[a-z0-9]$,即必须以小写字母开头,小写字母或数字结尾,中间可包含数字、小写字母、中划线,字符长度必须在2-48个字符之间。 |
| description | String | 参数解释: 代码解释器的描述。 取值范围: 任意字符,长度不能超过4096个字符 |
| created_at | String | 参数解释: 创建时间。 取值范围: 不涉及。 |
| updated_at | String | 参数解释: 更新时间。 取值范围: 不涉及。 |
| execution_agency_name | String | 参数解释: 为代码解释器提供访问云服务的权限的IAM委托名。 取值范围: IAM委托名长度必须在1-64个字符之间,字符规则以IAM服务校验规则为准。 |
| agent_gateway_id | String | 参数解释: 代码解析器入口的AgentGateway的ID。 取值范围: 符合UUID规则 ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$的36位字符串。 |
| workload_identity | CoreToolsWorkloadIdentity object | 参数解释: 认证信息。 取值范围: 不涉及。 |
| access_endpoint | String | 参数解释: 访问域名。 取值范围: 不涉及。 |
| observability | CoreToolsObservability object | 参数解释: 可观测性信息。 取值范围: 不涉及。 |
| tags | Array of CoreToolsTag objects | 参数解释: 资源标签。 取值范围: 不涉及。 |
| status | String | 参数解释: 工具状态。 取值范围: |
| updated_by | String | 参数解释: 更新用户。 取值范围: 更新用户的IAM用户ID。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| logs | CoreToolsLogsConfig object | 参数解释: 工具的日志配置。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| metrics | 参数解释: 工具的自定义指标采集详细配置。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 | |
| tracing | 参数解释: 工具的调用链采集配置。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| enabled | Boolean | 参数解释: 是否开启日志采集。 约束限制: 不涉及。 取值范围: 默认取值: false。 |
| group_id | String | 参数解释: 工具的日志组ID。 约束限制: 当前不支持更新、指定。 取值范围: 长度不能超过64个字符。 默认取值: 不涉及。 |
| stream_id | String | 参数解释: 工具的日志流ID。 约束限制: 当前不支持更新、指定。 取值范围: 长度不能超过64个字符。 默认取值: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| enabled | Boolean | 参数解释: 是否开启自定义指标采集。 约束限制: 不涉及。 取值范围: 默认取值: false。 |
| instance_id | String | 参数解释: 自定义指标实例ID。 约束限制: 不涉及。 取值范围: 长度不能超过64个字符。 默认取值: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| enabled | Boolean | 参数解释: 是否开启调用链采集。 约束限制: 不涉及。 取值范围: 默认取值: false。 |
| service_group | String | 参数解释: 调用链服务组名。 约束限制: 不涉及。 取值范围: 长度不能超过64个字符。 默认取值: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| key | String | 参数解释: 标签键。 约束限制: 不能为空,且单个资源标签键不能重复。 取值范围: 符合规则^((?!\s)(?!sys)[\p{L}\p{Z}\p{N}.:/=+-@]*)(?<!\s)$,即可以包含任意语种的字母、数字和空格,以及.:=+-@字符,但首尾不能包含空格,且不能以_sys_开头,且长度在1到128之间。 默认取值: 不涉及。 |
| value | String | 参数解释: 标签值。 约束限制: 不涉及。 取值范围: 符合规则^([\p{L}\p{Z}\p{N}.:/=+-@]*)$,即可以包含任意语种的字母、数字和空格,以及.:/=+-@字符,且长度不能超过255个字符。 默认取值: 不涉及 |
状态码:401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。 |
| error_msg | String | 参数解释: 错误信息。 取值范围: 不涉及。 |
状态码:403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。 |
| error_msg | String | 参数解释: 错误信息。 取值范围: 不涉及。 |
| encoded_authorization_message | String | 参数解释: 编码后的授权失败信息,可找IAM服务oncall提供解码方式获取详细授权失败原因。 取值范围: 不涉及。 |
| details | Array of CoreToolsCommonError objects | 参数解释: 依赖的下游服务错误信息列表。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。 |
| error_msg | String | 参数解释: 错误信息。 取值范围: 不涉及。 |
状态码:404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。 |
| error_msg | String | 参数解释: 错误信息。 取值范围: 不涉及。 |
状态码:429
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。 |
| error_msg | String | 参数解释: 错误信息。 取值范围: 不涉及。 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码。 取值范围: 满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。 |
| error_msg | String | 参数解释: 错误信息。 取值范围: 不涉及。 |
请求示例
/v1/core/code-interpreters/9ca9f2a6-18e4-xxxx-xxxx-8c21e978a1ad
{
"observability" : {
"logs" : {
"enabled" : false
}
},
"tags" : [ {
"key" : "a",
"value" : "b"
} ]
} 响应示例
状态码:200
OK。
{
"id" : "9ca9f2a6-18e4-xxxx-xxxx-8c21e978a1ad",
"name" : "vvvv",
"description" : "cccx",
"execution_agency_name" : "agent-evol-swr",
"observability" : {
"logs" : {
"enabled" : false
}
},
"workload_identity" : {
"urn" : "urn_demo"
},
"access_endpoint" : "accessEndpoint_demo",
"tags" : [ {
"key" : "a",
"value" : "b"
} ],
"created_at" : "2026-03-21T08:14:23.252+00:00",
"updated_at" : "2026-04-09T11:21:07.765+00:00",
"updated_by" : "6f80301edacc43728bf47b6a6484d512"
} 状态码:401
认证失败。
{
"error_code" : "AgentArts.04000401",
"error_msg" : "Authentication failed: invalid token."
} 状态码:403
权限不足。
{
"error_code" : "AgentArts.04000403",
"error_msg" : "Authentication failed: you have no permission of XXX",
"encoded_authorization_message" : "eyJlcnJvciI6ICJVbmF1dGhvcml6ZWQifQ==",
"details" : {
"error_code" : "XXX",
"error_msg" : "XXXX"
}
} 状态码:404
资源不存在。
{
"error_code" : "AgentArts.04000404",
"error_msg" : "resource xxx not exist"
} 状态码:429
请求频率超限。
{
"error_code" : "AgentArts.04000429",
"error_msg" : "The interface has been limited."
} 状态码:500
内部系统错误。
{
"error_code" : "AgentArts.04000500",
"error_msg" : "Internal error"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK。 |
| 401 | 认证失败。 |
| 403 | 权限不足。 |
| 404 | 资源不存在。 |
| 429 | 请求频率超限。 |
| 500 | 内部系统错误。 |
错误码
请参见错误码。