# 更新代码解释器 - UpdateCoreCodeInterpreter
#### 功能介绍
该API用于更新代码解释器配置。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。
#### 授权信息
账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-agentarts/Permission.html)。
| 授权项                                                 | 访问级别  | 资源类型（\*为必须）        | 条件键                                                                                                                                                                                                                                                                                                                                                                                                        | 别名 | 依赖的授权项 |
|:---|:---|:---|:---|:---|:---|
| agentarts:codeInterpreter:updateCoreCodeInterpreter | Write | codeInterpreter \* | g:ResourceTag/\<tag-key\>                                                                                                                                                                                                                                                                                                                                                                                  | -  | -      |
| agentarts:codeInterpreter:updateCoreCodeInterpreter | Write | -                  | - g:RequestTag/\<tag-key\>   - g:TagKeys    | -  | -      |
   
#### URI
PUT /v1/core/code-interpreters/{code_interpreter_id}
表1路径参数 
| 参数                  | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| code_interpreter_id | 是    | String | **参数解释：** 代码解释器ID，可通过[查询代码解释器列表](https://support.huaweicloud.com/api-agentarts/ListCoreCodeInterpreters.html)接口获取。 **约束限制：** 不涉及。 **取值范围：** 符合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位字符串。 **默认取值：** 不涉及。 |
   
#### 请求参数
表2请求Body参数 
| 参数            | 是否必选 | 参数类型                                                                                        | 描述                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| observability | 否    | [CoreToolsObservability] object | **参数解释：** 可观测配置，包含日志采集、自定义指标采集、调用链采集等配置。 **约束范围：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| tags          | 否    | Array of [CoreToolsTag] objects           | **参数解释：** 资源标签。 **约束范围：** 不涉及。 **取值范围：** 最多20个，且键值不能重复。 **默认取值：** 不涉及。                |
   
 表3CoreToolsObservability 
| 参数      | 是否必选 | 参数类型                                                                                                                  | 描述                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| logs    | 否    | [CoreToolsLogsConfig] object                                 | **参数解释：** 工具的日志配置。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。        |
| metrics | 否    | [CoreToolsMetricsObservabilityConfig] object | **参数解释：** 工具的自定义指标采集详细配置。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| tracing | 否    | [CoreToolsTracingObservabilityConfig] object | **参数解释：** 工具的调用链采集配置。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。     |
   
 表4CoreToolsLogsConfig 
| 参数        | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|:---|
| enabled   | 否    | Boolean | **参数解释：** 是否开启日志采集。 - 未开启，工具运行过程产生的日志无法上报至云日志服务(LTS)。   - 开启后，工具运行过程产生的日志会上报至云日志服务(LTS)。    **约束限制：** 不涉及。 **取值范围：** - true打开。   - false关闭。    **默认取值：** false。 |
| group_id  | 否    | String  | **参数解释：** 工具的日志组ID。 **约束限制：** 当前不支持更新、指定。 **取值范围：** 长度不能超过64个字符。 **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| stream_id | 否    | String  | **参数解释：** 工具的日志流ID。 **约束限制：** 当前不支持更新、指定。 **取值范围：** 长度不能超过64个字符。 **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
   
 表5CoreToolsMetricsObservabilityConfig 
| 参数          | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| enabled     | 否    | Boolean | **参数解释：** 是否开启自定义指标采集。 **约束限制：** 不涉及。 **取值范围：** - true 开启。   - false 关闭。    **默认取值：** false。 |
| instance_id | 否    | String  | **参数解释：** 自定义指标实例ID。 **约束限制：** 不涉及。 **取值范围：** 长度不能超过64个字符。 **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                                                                      |
   
 表6CoreToolsTracingObservabilityConfig 
| 参数            | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| enabled       | 否    | Boolean | **参数解释：** 是否开启调用链采集。 **约束限制：** 不涉及。 **取值范围：** - true 开启。   - false 关闭。    **默认取值：** false。 |
| service_group | 否    | String  | **参数解释：** 调用链服务组名。 **约束限制：** 不涉及。 **取值范围：** 长度不能超过64个字符。 **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                                                                      |
   
 表7CoreToolsTag 
| 参数    | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| key   | 是    | String | **参数解释：** 标签键。 **约束限制：** 不能为空，且单个资源标签键不能重复。 **取值范围：** 符合规则\^((?!\\s)(?!*sys* )\[\\p{L}\\p{Z}\\p{N}*.:/=+-@\]\*)(?\<!\\s)$，即可以包含任意语种的字母、数字和空格，以及*.:=+-@字符，但首尾不能包含空格，且不能以_sys_开头，且长度在1到128之间。 **默认取值：** 不涉及。 |
| value | 否    | String | **参数解释：** 标签值。 **约束限制：** 不涉及。 **取值范围：** 符合规则\^(\[\\p{L}\\p{Z}\\p{N}*.:/=+-@\]\*)$，即可以包含任意语种的字母、数字和空格，以及*.:/=+-@字符，且长度不能超过255个字符。 **默认取值：** 不涉及                                                             |
   
#### 响应参数
**状态码：200**
表8响应Body参数 
| 参数                    | 参数类型                                                                                               | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|
| 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,38}\[a-z0-9\]$，即必须以小写字母开头，小写字母或数字结尾，中间可包含数字、小写字母、中划线，字符长度必须在2-40个字符之间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| description           | String                                                                                             | **参数解释：** 工具的描述。 **取值范围：** 任意字符，长度不能超过4096个字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| created_at            | String                                                                                             | **参数解释：** 创建时间。 **取值范围：** ISO 8601格式的时间字符串，例如：2026-04-09T08:29:59.922+00:00。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| updated_at            | String                                                                                             | **参数解释：** 更新时间。 **取值范围：** ISO 8601格式的时间字符串，例如：2026-04-09T08:29:59.922+00:00。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 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                                                                                             | **参数解释：** 工具状态。 **取值范围：** - RUNNING：运行中。   - DELETING：删除中。   - DELETE_FAILED：删除失败。    |
| updated_by            | String                                                                                             | **参数解释：** 更新用户。 **取值范围：** 更新用户的IAM用户ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   
 表9CoreToolsWorkloadIdentity 
| 参数  | 参数类型   | 描述                                                                                                                                                                          |
|:---|:---|:---|
| urn | String | **参数解释：** 工作负载身份的URN。 **取值范围：** 不涉及。 |
   
 表10CoreToolsObservability 
| 参数      | 参数类型                                                                                                                   | 描述                                                                                                                                                                              |
|:---|:---|:---|
| logs    | [CoreToolsLogsConfig] object                                 | **参数解释：** 工具的日志配置。 **取值范围：** 不涉及。        |
| metrics | [CoreToolsMetricsObservabilityConfig] object | **参数解释：** 工具的自定义指标采集详细配置。 **取值范围：** 不涉及。 |
| tracing | [CoreToolsTracingObservabilityConfig] object | **参数解释：** 工具的调用链采集配置。 **取值范围：** 不涉及。     |
   
 表11CoreToolsLogsConfig 
| 参数        | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|
| enabled   | Boolean | **参数解释：** 是否开启日志采集。 - 未开启，工具运行过程产生的日志无法上报至云日志服务(LTS)。   - 开启后，工具运行过程产生的日志会上报至云日志服务(LTS)。    **取值范围：** - true打开。   - false关闭。    |
| group_id  | String  | **参数解释：** 工具的日志组ID。 **取值范围：** 长度不能超过64个字符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| stream_id | String  | **参数解释：** 工具的日志流ID。 **取值范围：** 长度不能超过64个字符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   
 表12CoreToolsMetricsObservabilityConfig 
| 参数          | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|
| enabled     | Boolean | **参数解释：** 是否开启自定义指标采集。 **取值范围：** - true 开启。   - false 关闭。    |
| instance_id | String  | **参数解释：** 自定义指标实例ID。 **取值范围：** 长度不能超过64个字符。                                                                                                                                                                                                                                                                                                                                                                                 |
   
 表13CoreToolsTracingObservabilityConfig 
| 参数            | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|
| enabled       | Boolean | **参数解释：** 是否开启调用链采集。 **取值范围：** - true 开启。   - false 关闭。    |
| service_group | String  | **参数解释：** 调用链服务组名。 **取值范围：** 长度不能超过64个字符。                                                                                                                                                                                                                                                                                                                                                                                 |
   
 表14CoreToolsTag 
| 参数    | 参数类型   | 描述                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|
| key   | String | **参数解释：** 标签键。 **取值范围：** 符合规则\^((?!\\s)(?!*sys* )\[\\p{L}\\p{Z}\\p{N}*.:/=+-@\]\*)(?\<!\\s)$，即可以包含任意语种的字母、数字和空格，以及*.:=+-@字符，但首尾不能包含空格，且不能以_sys_开头，且长度在1到128之间。 |
| value | String | **参数解释：** 标签值。 **取值范围：** 符合规则\^(\[\\p{L}\\p{Z}\\p{N}*.:/=+-@\]\*)$，即可以包含任意语种的字母、数字和空格，以及*.:/=+-@字符，且长度不能超过255个字符。                                              |
   
**状态码：401**
 表15响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。 **取值范围：** 满足正则\^AgentArts.0400\\d{4}$，例如AgentArts.04000404。 |
| error_msg  | String | **参数解释：** 错误信息。 **取值范围：** 不涉及。                                             |
   
**状态码：403**
表16响应Body参数 
| 参数                            | 参数类型                                                                                               | 描述                                                                                                                                                                                                                |
|:---|:---|:---|
| error_code                    | String                                                                                             | **参数解释：** 错误码。 **取值范围：** 满足正则\^AgentArts.0400\\d{4}$，例如AgentArts.04000404。 |
| error_msg                     | String                                                                                             | **参数解释：** 错误信息。 **取值范围：** 不涉及。                                             |
| encoded_authorization_message | String                                                                                             | **参数解释：** 编码后的授权失败信息。 **取值范围：** 不涉及。                                       |
| details                       | Array of [CoreToolsCommonError] objects | **参数解释：** 依赖的下游服务错误信息列表。 **取值范围：** 不涉及。                                    |
   
表17CoreToolsCommonError 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。 **取值范围：** 满足正则\^AgentArts.0400\\d{4}$，例如AgentArts.04000404。 |
| error_msg  | String | **参数解释：** 错误信息。 **取值范围：** 不涉及。                                             |
   
**状态码：404**
表18响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。 **取值范围：** 满足正则\^AgentArts.0400\\d{4}$，例如AgentArts.04000404。 |
| error_msg  | String | **参数解释：** 错误信息。 **取值范围：** 不涉及。                                             |
   
**状态码：429**
表19响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。 **取值范围：** 满足正则\^AgentArts.0400\\d{4}$，例如AgentArts.04000404。 |
| error_msg  | String | **参数解释：** 错误信息。 **取值范围：** 不涉及。                                             |
   
**状态码：500**
表20响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。 **取值范围：** 满足正则\^AgentArts.0400\\d{4}$，例如AgentArts.04000404。 |
| error_msg  | String | **参数解释：** 错误信息。 **取值范围：** 不涉及。                                             |
   
#### 请求示例
```
PUT /v1/core/code-interpreters/9ca9f2a6-18e4-4777-b23b-8c21e978a1ad
{
  "observability" : {
    "logs" : {
      "enabled" : false
    }
  },
  "tags" : [ {
    "key" : "a",
    "value" : "b"
  } ]
}
```
#### 响应示例
**状态码：200**
OK。
```
{
  "id" : "9ca9f2a6-18e4-4777-b23b-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"
  } ],
  "status" : "RUNNING",
  "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" : "AgentArts.04000403",
    "error_msg" : "Authentication failed."
  } ]
}
```
**状态码：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 | 内部系统错误。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。