# 查询代码解释器列表 - ListCoreCodeInterpreters #### 功能介绍 该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:listCoreCodeInterpreters | List | - | - | - | - | #### URI GET /v1/core/code-interpreters 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 否 | String | **参数解释：** 按代码解释器名称过滤。 **约束范围：** 不涉及 **取值范围：** 长度在2到40之间 **默认取值：** 空 | | offset | 否 | Integer | **参数解释：** 偏移。 **约束限制：** 不涉及。 **取值范围：** 正整数 **默认取值：** 0。 | | limit | 否 | Integer | **参数解释：** 限制数量。 **约束限制：** 不涉及。 **取值范围：** 正整数，最大值1000。 **默认取值：** 1000。 | | sort_key | 否 | String | **参数解释：** 排序字段 **约束范围：** 不涉及 **取值范围：** 必须是created_at或updated_at **默认取值：** 缺省值为created_at | | sort_dir | 否 | String | **参数解释：** 排序方向 **约束范围：** 不涉及 **取值范围：** 必须是asc或desc **默认取值：** 缺省值为desc | | tag_key_exists | 否 | Array of strings | **参数解释**： 需要匹配的包含该标签名称的资源。 **约束限制**: 支持批量查询多个标签名，最多支持10个标签。 **取值范围**： 最小数量 1，最大数量 10 **默认取值**: 不涉及。 | | tag_key_matches | 否 | Array of strings | **参数解释**： 需要匹配的包含该标签的资源，需要和tag_value_matches条件配合使用，tag_key_matches和tag_value_matches的元素个数需要一致，且标签顺序需要完全匹配，不支持空字符串。 **约束限制**: 支持批量查询多个标签，最多支持10个标签。tag_key_matches和tag_value_matches键值对不可重复. **取值范围**： 最小数量 1，最大数量 10 **默认取值**: 不涉及。 | | tag_value_matches | 否 | Array of strings | **参数解释**： 需要匹配的包含该标签的资源，需要和tag_key_matches条件配合使用，tag_key_matches和tag_value_matches的元素个数需要一致，且标签顺序需要完全匹配，支持空字符串。 **约束限制**: 支持批量查询多个标签，最多支持10个标签。tag_key_matches和tag_value_matches键值对不可重复. **取值范围**： 最小数量 1，最大数量 10 **默认取值**: 不涉及。 | | tag_match_policy | 否 | String | **参数解释**: 标签匹配模式，仅针对tag_key_exists，tag_key_matches，tag_value_matches参数生效。 - ALL: 若请求中包含tag_key_exists参数，查询规则为资源标签需要包含tag_key_exists中的所有元素，若请求中tag_key_matches以及tag_value_matches参数存在，查询规则为资源标签需要包含所有tag_key_matches以及tag_value_matches参数中指定的key-value对应的标签。 - ANY: 若请求中包含tag_key_exists参数，查询规则为资源标签需要包含tag_key_exists中的任意一个元素，若请求中tag_key_matches以及tag_value_matches参数存在，查询规则为资源标签需要包含tag_key_matches以及tag_value_matches参数中任意一个key-value对应的标签。 - ALL - ANY 三个参数都存在时，取tag_key_exists和tag_key_matches，tag_value_matches的交集 三个参数都存在时，取tag_key_exists和tag_key_matches，tag_value_matches的并集 **约束限制**: 不涉及。 **取值范围**： 长度为1-3个字符。允许的值为： **默认取值**: ALL | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total_count | Integer | **参数解释：** 总记录数。 **取值范围：** 正整数。 | | items | Array of [CoreToolBasic] objects | **参数解释：** 查询列表数组 **取值范围：** 不涉及 | 表3CoreToolBasic | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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：删除失败。 | 表4CoreToolsWorkloadIdentity | 参数 | 参数类型 | 描述 | |:---|:---|:---| | urn | String | **参数解释：** 工作负载身份的URN。 **取值范围：** 不涉及。 | 表5CoreToolsObservability | 参数 | 参数类型 | 描述 | |:---|:---|:---| | logs | [CoreToolsLogsConfig] object | **参数解释：** 工具的日志配置。 **取值范围：** 不涉及。 | | metrics | [CoreToolsMetricsObservabilityConfig] object | **参数解释：** 工具的自定义指标采集详细配置。 **取值范围：** 不涉及。 | | tracing | [CoreToolsTracingObservabilityConfig] object | **参数解释：** 工具的调用链采集配置。 **取值范围：** 不涉及。 | 表6CoreToolsLogsConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | enabled | Boolean | **参数解释：** 是否开启日志采集。 - 未开启，工具运行过程产生的日志无法上报至云日志服务(LTS)。 - 开启后，工具运行过程产生的日志会上报至云日志服务(LTS)。 **取值范围：** - true打开。 - false关闭。 | | group_id | String | **参数解释：** 工具的日志组ID。 **取值范围：** 长度不能超过64个字符。 | | stream_id | String | **参数解释：** 工具的日志流ID。 **取值范围：** 长度不能超过64个字符。 | 表7CoreToolsMetricsObservabilityConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | enabled | Boolean | **参数解释：** 是否开启自定义指标采集。 **取值范围：** - true 开启。 - false 关闭。 | | instance_id | String | **参数解释：** 自定义指标实例ID。 **取值范围：** 长度不能超过64个字符。 | 表8CoreToolsTracingObservabilityConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | enabled | Boolean | **参数解释：** 是否开启调用链采集。 **取值范围：** - true 开启。 - false 关闭。 | | service_group | String | **参数解释：** 调用链服务组名。 **取值范围：** 长度不能超过64个字符。 | 表9CoreToolsTag | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | **参数解释：** 标签键。 **取值范围：** 符合规则\^((?!\\s)(?!*sys* )\[\\p{L}\\p{Z}\\p{N}*.:/=+-@\]\*)(?\