# 创建runtime访问方式 - CreateCoreRuntimeEndpoint #### 功能介绍 该接口用于为某一个具体的Agent运行时创建访问方式，支持为该访问方式绑定版本以及对应的灰度策略。 **适用场景：** 某一个具体的Agent运行时存在多个版本，通过配置访问方式来指定调用某一个具体版本。 某一个具体的Agent运行时修改后需要进行灰度发布，通过配置访问方式，为老版本和新版本配置流量权重。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-agentarts/Permission.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | agentarts:runtimeEndpoint:createCoreRuntimeEndpoint | Write | runtimeEndpoint \* | - | - | - | | agentarts:runtimeEndpoint:createCoreRuntimeEndpoint | Write | - | - g:RequestTag/\ - g:TagKeys | - | - | #### URI POST /v1/core/runtimes/{runtime_id}/endpoints 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | runtime_id | 是 | String | **参数解释**： 运行时ID，用于唯一标识一个Agent运行时实例。可以通过AgentArts智能体运行时控制台或者运行时查询接口获取。 **约束限制**: 不涉及。 **取值范围**： 匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），符合正则条件\^\[0-9a-f\]{8}-\[0-9a-f\]{4}-\[0-9a-f\]{4}-\[0-9a-f\]{4}-\[0-9a-f\]{12}$。 **默认取值**: 不涉及。 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | **参数解释**: 访问方式名称。 **约束限制**: 同一个运行时下名称不可重复 **取值范围**: 以字母开头，以字母或数字结尾，可以包含字母、数字和中划线，长度为2-48个字符。 **默认取值**: 不涉及。 | | target_version_name | 否 | String | **参数解释**: 目标版本名称，如果配置了访问方式路由则以访问方式路由为准。 **约束限制**: 不涉及。 **取值范围**: 以小写字母或数字开头，以小写字母或数字结尾，可以包含小写字母、数字和中划线，长度为2-24个字符。 **默认取值**: 不涉及。 | | description | 否 | String | **参数解释**: 描述信息。 **约束限制**: 不涉及。 **取值范围**: 长度为0-255个字符，不能包含小于号或大于号 **默认取值**: 不涉及。 | | routing_config | 否 | [CoreRunRoutingConfiguration] object | **参数解释**: 智能体运行时访问方式的路由配置，支持多版本权重分配。 **约束限制**: 不涉及。 **取值范围**: 不涉及。 **默认取值**: 不涉及。 | | tags | 否 | Array of [CoreRunTagItem] objects | **参数解释**: 标签配置列表，对接TMS标签服务，用于资源分类。 **约束限制**: 元素个数0 - 20。 **取值范围**: 不涉及。 **默认取值**: 不涉及。 | 表3CoreRunRoutingConfiguration | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | version_weights | 否 | Array of [CoreRunVersionWeight] objects | **参数解释**: 运行时访问方式两个版本的权重配置。 **约束限制**: 目前限制只支持两个版本的权重控制。 **取值范围**: 不涉及 **默认取值**: 不涉及。 | 表4CoreRunVersionWeight | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | version_name | 否 | String | **参数解释**: 版本名称。 **约束限制**: 不涉及。 **取值范围**: 以小写字母或数字开头，以小写字母或数字结尾，可以包含小写字母、数字和中划线，长度为2-24个字符。 **默认取值**: 不涉及。 | | weight | 否 | Number | **参数解释**: 流量权重比例 (0 - 100)。 **约束限制**: 两个version_name对应weight参数之和固定为100 **取值范围**: \[0, 100\] **默认取值**: 不涉及。 | 表5CoreRunTagItem | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | key | 是 | String | **参数解释**: 标签键。 **约束限制**: 不涉及。 **取值范围**: 长度为 1 - 128 个字符。 **默认取值**: 不涉及。 | | value | 是 | String | **参数解释**: 标签值。 **约束限制**: 不涉及。 **取值范围**: 长度为 0 - 255 个字符。 **默认取值**: 不涉及。 | #### 响应参数 **状态码：200** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | runtime_id | String | **参数解释**: 运行时ID。 **取值范围**: 匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），符合正则条件\^\[0-9a-f\]{8}-\[0-9a-f\]{4}-\[0-9a-f\]{4}-\[0-9a-f\]{4}-\[0-9a-f\]{12}$。 | | id | String | **参数解释**: 运行时访问方式ID。 **取值范围**: 匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），符合正则条件\^\[0-9a-f\]{8}-\[0-9a-f\]{4}-\[0-9a-f\]{4}-\[0-9a-f\]{4}-\[0-9a-f\]{12}$。 | | name | String | **参数解释**: 运行时访问方式名称。 **取值范围**: 以字母开头，以字母或数字结尾，可以包含字母、数字和中划线，长度为2-48个字符。 | | description | String | **参数解释**: 运行时访问方式描述。 **取值范围**: 长度为0-255个字符，不能包含小于号或大于号 | | created_at | String | **参数解释**: 创建时间。 **取值范围**: 不涉及。 | | updated_at | String | **参数解释**: 最后更新时间。 **取值范围**: 不涉及。 | | target_version_name | String | **参数解释**: 目标版本名称。 **取值范围**: 以小写字母或数字开头，以小写字母或数字结尾，可以包含小写字母、数字和中划线，长度为2-24个字符。 | | routing_config | [CoreRunRoutingConfigurationResp] object | **参数解释**: 智能体运行时访问方式的路由配置，支持多版本权重分配。 **取值范围**: 不涉及。 | | tags | Array of [CoreRunTagItemResp] objects | **参数解释**: 标签配置列表，对接TMS标签服务，用于资源分类。 **取值范围**: 不涉及。 | 表7CoreRunRoutingConfigurationResp | 参数 | 参数类型 | 描述 | |:---|:---|:---| | version_weights | Array of [CoreRunVersionWeightResp] objects | **参数解释**: 运行时访问方式两个版本的权重配置。 **取值范围**: 不涉及 | 表8CoreRunVersionWeightResp | 参数 | 参数类型 | 描述 | |:---|:---|:---| | version_name | String | **参数解释**: 版本名称。 **取值范围**: 以小写字母或数字开头，以小写字母或数字结尾，可以包含小写字母、数字和中划线，长度为2-24个字符。 | | weight | Number | **参数解释**: 流量权重比例 (0 - 100)。 **取值范围**: \[0, 100\] | 表9CoreRunTagItemResp | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | **参数解释**: 标签键。 **取值范围**: 长度为 1 - 128 个字符。 | | value | String | **参数解释**: 标签值。 **取值范围**: 长度为 0 - 255 个字符。 | **状态码：400** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。枚举值说明：AgentArts.03000400表示客户端请求参数错误。 **取值范围**： 固定值：AgentArts.03000400。 | | error_msg | String | **参数解释**： 错误详细信息。 **取值范围**： 长度为1-512个字符。 | **状态码：401** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 错误码。枚举值说明：AgentArts.03000401表示未授权（认证令牌缺失、无效或已过期）。 **取值范围**: 不涉及。 | | error_msg | String | **参数解释**： 错误详细信息。 **取值范围**： 长度为 1 - 512 个字符。 | **状态码：403** 表12响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。枚举值说明：AgentArts.03000403表示禁止访问（认证后权限不足）。 **取值范围**： 固定值：AgentArts.03000403。 | | error_msg | String | **参数解释**： 错误详细信息。 **取值范围**： 长度为 1 - 512 个字符。 | | coded_authorization_message | String | **参数解释**： IAM5 当OpenAPI无权限时报错信息。 **取值范围**： 长度为 1 - 1024 个字符。 | | details | Array of [CoreRunErrorDetail] objects | **参数解释**： 依赖的下游服务错误信息列表。 **取值范围**： 最小数量 0，最大数量 10。 | 表13CoreRunErrorDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。 **取值范围**： 长度为 18 个字符。 | | error_msg | String | **参数解释**： 错误信息。 **取值范围**： 长度为 1 - 1024 个字符。 | **状态码：404** 表14响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。枚举值说明：AgentArts.03000404表示资源不存在。 **取值范围**： 固定值：AgentArts.03000404。 | | error_msg | String | **参数解释**： 错误详细信息。 **取值范围**： 长度为 1 - 512 个字符。 | **状态码：409** 表15响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。枚举值说明：AgentArts.03000409表示资源冲突。 **取值范围**： 固定值：AgentArts.03000409。 | | error_msg | String | **参数解释**： 错误详细信息。 **取值范围**： 长度为 1 - 512 个字符。 | **状态码：429** 表16响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。枚举值说明：AgentArts.03000429表示请求过于频繁（触发限流）。 **取值范围**： 固定值：AgentArts.03000429。 | | error_msg | String | **参数解释**： 错误详细信息。 **取值范围**： 长度为 1 - 512 个字符。 | **状态码：500** 表17响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。枚举值说明：AgentArts.03000500表示服务器内部错误。 **取值范围**： 固定值：AgentArts.03000500。 | | error_msg | String | **参数解释**： 错误详细信息。 **取值范围**： 长度为 1 - 512 个字符。 | #### 请求示例 无 #### 响应示例 **状态码：200** 创建成功，返回创建的访问方式信息。 - ``` { "runtime_id" : "f47ac10b-58cc-4372-a567-0e02b2c3d479", "id" : "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "name" : "public-api", "description" : "公开访问的 API 访问方式", "target_version_name" : "v1", "created_at" : "2024-05-20T14:30:00Z", "updated_at" : "2024-05-20T14:30:00Z", "routing_config" : { "version_weights" : [ { "version_name" : "v1", "weight" : 100 }, { "version_name" : "v2", "weight" : 0 } ] } } ``` - ``` { "runtime_id" : "f47ac10b-58cc-4372-a567-0e02b2c3d479", "id" : "b2c3d4e5-f6a7-8901-bcde-f12345678901", "name" : "canary-api", "description" : "金丝雀发布访问方式，90%流量到v1，10%流量到v2", "target_version_name" : "v2", "created_at" : "2024-05-21T10:00:00Z", "updated_at" : "2024-05-21T10:00:00Z", "routing_config" : { "version_weights" : [ { "version_name" : "v1", "weight" : 90 }, { "version_name" : "v2", "weight" : 10 } ] }, "tags" : [ { "key" : "strategy", "value" : "canary" }, { "key" : "team", "value" : "platform" } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 创建成功，返回创建的访问方式信息。 | | 400 | 请求参数错误（如name格式错误等）。 | | 401 | 未授权（认证令牌缺失、无效或已过期）。 | | 403 | 禁止访问（认证后权限不足）。 | | 404 | 资源不存在（指定的runtime_id未找到）。 | | 409 | 资源冲突（如访问方式名称已存在）。 | | 429 | 请求过于频繁（触发限流）。 | | 500 | 服务器内部错误。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。