# 创建代码解释器 - CreateCoreCodeInterpreter #### 功能介绍 该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:createCoreCodeInterpreter | Write | codeInterpreter \* | - | - | - iam:agencies:pass - vpc:nativePorts:create - vpc:routeTables:update - eip:publicIps:associateInstance | | agentarts:codeInterpreter:createCoreCodeInterpreter | Write | - | - g:RequestTag/\ - g:TagKeys | - | - iam:agencies:pass - vpc:nativePorts:create - vpc:routeTables:update - eip:publicIps:associateInstance | #### URI POST /v1/core/code-interpreters #### 请求参数 表1请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | **参数解释：** 代码解释器的名称。 **约束限制：** 该名称在您的账户中必须是唯一的。 **取值范围：** 符合正则条件\^\[a-z\]\[a-z0-9-\]{0,38}\[a-z0-9\]$，即必须以小写字母开头，小写字母或数字结尾，中间可包含数字、小写字母、中划线，字符长度必须在2-40个字符之间。 **默认取值：** 不涉及。 | | description | 否 | String | **参数解释：** 代码解释器的描述。 **约束限制：** 不涉及。 **取值范围：** 任意字符（包括中文、英文字母、数字、特殊字符等），长度不能超过4096个字符。 **默认取值：** 不涉及。 | | auth_type | 否 | String | **参数解释：** 工具认证方式。 **约束限制：** 不涉及。 **取值范围：** *API_KEY*: 使用 API 密钥认证。 *IAM*: 使用 IAM认证。 **默认取值：** IAM。 | | api_key_name | 否 | String | **参数解释：** API Key名称。 **约束限制：** 不涉及。 **取值范围：** 满足正则\^\[a-zA-Z0-9_-\]{1,64}$，即只能包含数字、字母、下划线、中划线，且长度必须在1-64个字符之间。 **默认取值：** 不涉及。 | | execution_agency_name | 否 | String | **参数解释：** 为代码解释器提供访问云服务的权限的IAM委托名，获取方式请参见[创建委托](https://support.huaweicloud.com/usermanual-iam/iam_06_0001.html)。 **约束限制：** 必须是IAM已创建委托。 **取值范围：** IAM委托名长度必须在1-64个字符之间，字符规则以IAM服务校验规则为准。 **默认取值：** 不涉及。 | | observability | 否 | [CoreToolsObservability] object | **参数解释：** 可观测性配置。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | network_config | 否 | [CoreToolsOutboundNetwork] object | **参数解释：** 出方向网络配置。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 为空时，默认公网访问方式 | | agent_gateway_id | 否 | String | **参数解释：** 代码解释器入口的AgentGateway的ID。 **约束限制：** 必须为已存在AgentGateway的ID，或者缺省为空，使用租户默认AgentGateway接入。 **取值范围：** 从AgentGateway实例获取，或默认不填。 **默认取值：** 不涉及。 | | tags | 否 | Array of [CoreToolsTag] objects | **参数解释：** 资源标签。 **约束限制：** 同一个资源的标签key不能重复、标签列表最多支持20个。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | 表2CoreToolsObservability | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | logs | 否 | [CoreToolsLogsConfig] object | **参数解释：** 工具的日志配置。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | metrics | 否 | [CoreToolsMetricsObservabilityConfig] object | **参数解释：** 工具的自定义指标采集详细配置。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | tracing | 否 | [CoreToolsTracingObservabilityConfig] object | **参数解释：** 工具的调用链采集配置。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | 表3CoreToolsLogsConfig | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | enabled | 否 | Boolean | **参数解释：** 是否开启日志采集。 - 未开启，工具运行过程产生的日志无法上报至云日志服务(LTS)。 - 开启后，工具运行过程产生的日志会上报至云日志服务(LTS)。 **约束限制：** 不涉及。 **取值范围：** - true打开。 - false关闭。 **默认取值：** false。 | | group_id | 否 | String | **参数解释：** 工具的日志组ID。 **约束限制：** 当前不支持更新、指定。 **取值范围：** 长度不能超过64个字符。 **默认取值：** 不涉及。 | | stream_id | 否 | String | **参数解释：** 工具的日志流ID。 **约束限制：** 当前不支持更新、指定。 **取值范围：** 长度不能超过64个字符。 **默认取值：** 不涉及。 | 表4CoreToolsMetricsObservabilityConfig | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | enabled | 否 | Boolean | **参数解释：** 是否开启自定义指标采集。 **约束限制：** 不涉及。 **取值范围：** - true 开启。 - false 关闭。 **默认取值：** false。 | | instance_id | 否 | String | **参数解释：** 自定义指标实例ID。 **约束限制：** 不涉及。 **取值范围：** 长度不能超过64个字符。 **默认取值：** 不涉及。 | 表5CoreToolsTracingObservabilityConfig | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | enabled | 否 | Boolean | **参数解释：** 是否开启调用链采集。 **约束限制：** 不涉及。 **取值范围：** - true 开启。 - false 关闭。 **默认取值：** false。 | | service_group | 否 | String | **参数解释：** 调用链服务组名。 **约束限制：** 不涉及。 **取值范围：** 长度不能超过64个字符。 **默认取值：** 不涉及。 | 表6CoreToolsOutboundNetwork | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | network_mode | 是 | String | **参数解释：** 工具可以访问的网络类型。 **约束限制：** 2选1。 **取值范围：** - PUBLIC表示公网。 - VPC表示私有网络。 **默认取值：** 不涉及。 | | vpc_config | 否 | [CoreToolsVpcConfig] object | **参数解释：** 工具使用的VPC子网配置。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | 表7CoreToolsVpcConfig | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | vpc_id | 是 | String | **参数解释：** 工具使用的VPC的ID，获取方式请参见[创建VPC](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0013935842.html)。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字及"-"组成，且长度为36个字符。 **默认取值：** 不涉及。 | | subnet_id | 是 | String | **参数解释：** 工具使用的VPC子网的ID，获取方式请参见[创建VPC子网](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0013748726.html)。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字及"-"组成，且长度为36个字符。 **默认取值：** 不涉及。 | | security_group_ids | 否 | Array of strings | **参数解释：** 工具使用的安全组id列表，获取方式请参见[创建安全组](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0013748715.html)。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字及"-"组成，且长度为36个字符。 **默认取值：** 不涉及。 | 表8CoreToolsTag | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | key | 是 | String | **参数解释：** 标签键。 **约束限制：** 不能为空，且单个资源标签键不能重复。 **取值范围：** 符合规则\^((?!\\s)(?!*sys* )\[\\p{L}\\p{Z}\\p{N}*.:/=+-@\]\*)(?\