# 批量查询runtime访问方式 - ListCoreRuntimeEndpoints #### 功能介绍 该接口用于根据运行时ID查询某一个具体的Agent运行时下的访问方式列表。支持分页查询。 **适用场景：** 根据Agent运行时ID查询该运行时的访问方式列表。 #### 调用方法 请参见[如何调用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:listCoreRuntimeEndpoints | List | runtime \* | - | - | - | | agentarts:runtimeEndpoint:listCoreRuntimeEndpoints | List | runtimeEndpoint \* | - | - | - | #### URI GET /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}$。 **默认取值**: 不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | offset | 否 | Integer | **参数解释**： 分页起始页码。 **约束限制**: 不涉及。 **取值范围**： 1 - 1000 **默认取值**: 1 | | limit | 否 | Integer | **参数解释**： 每页记录数。 **约束限制**: 不涉及。 **取值范围**： 10 - 100 **默认取值**: 10 | | 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个标签。 **取值范围**： 最小数量 1，最大数量 10 **默认取值**: 不涉及。 | | tag_value_matches | 否 | Array of strings | **参数解释**： 需要匹配的包含该标签的资源，需要和tag_key_matches条件配合使用，tag_key_matches和tag_value_matches的元素个数需要一致，且标签顺序需要完全匹配，不支持空字符串。 **约束限制**: 支持批量查询多个标签，最多支持10个标签。 **取值范围**： 最小数量 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 **默认取值**: ALL | #### 请求参数 无 #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | **参数解释**: 总记录数。 **取值范围**: 0 - 1000000 | | items | Array of [CoreRunRuntimeEndpoint] objects | **参数解释**: 运行时访问方式对象列表。 **取值范围**: 元素个数0 -100。 | 表4CoreRunRuntimeEndpoint | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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标签服务，用于资源分类。 **取值范围**: 不涉及。 | 表5CoreRunRoutingConfigurationResp | 参数 | 参数类型 | 描述 | |:---|:---|:---| | version_weights | Array of [CoreRunVersionWeightResp] objects | **参数解释**: 运行时访问方式两个版本的权重配置。 **取值范围**: 不涉及 | 表6CoreRunVersionWeightResp | 参数 | 参数类型 | 描述 | |:---|:---|:---| | version_name | String | **参数解释**: 版本名称。 **取值范围**: 以小写字母或数字开头，以小写字母或数字结尾，可以包含小写字母、数字和中划线，长度为2-24个字符。 | | weight | Number | **参数解释**: 流量权重比例 (0 - 100)。 **取值范围**: \[0, 100\] | 表7CoreRunTagItemResp | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | **参数解释**: 标签键。 **取值范围**: 长度为 1 - 128 个字符。 | | value | String | **参数解释**: 标签值。 **取值范围**: 长度为 0 - 255 个字符。 | **状态码：400** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。枚举值说明：AgentArts.03000400表示客户端请求参数错误。 **取值范围**： 固定值：AgentArts.03000400。 | | error_msg | String | **参数解释**： 错误详细信息。 **取值范围**： 长度为1-512个字符。 | **状态码：401** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 错误码。枚举值说明：AgentArts.03000401表示未授权（认证令牌缺失、无效或已过期）。 **取值范围**: 不涉及。 | | error_msg | String | **参数解释**： 错误详细信息。 **取值范围**： 长度为 1 - 512 个字符。 | **状态码：403** 表10响应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。 | 表11CoreRunErrorDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。 **取值范围**： 长度为 18 个字符。 | | error_msg | String | **参数解释**： 错误信息。 **取值范围**： 长度为 1 - 1024 个字符。 | **状态码：429** 表12响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。枚举值说明：AgentArts.03000429表示请求过于频繁（触发限流）。 **取值范围**： 固定值：AgentArts.03000429。 | | error_msg | String | **参数解释**： 错误详细信息。 **取值范围**： 长度为 1 - 512 个字符。 | **状态码：500** 表13响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。枚举值说明：AgentArts.03000500表示服务器内部错误。 **取值范围**： 固定值：AgentArts.03000500。 | | error_msg | String | **参数解释**： 错误详细信息。 **取值范围**： 长度为 1 - 512 个字符。 | #### 请求示例 ``` GET https://{Endpoint}/v1/core/runtimes/{runtime_id}/endpoints ``` #### 响应示例 **状态码：200** 查询成功，返回指定runtime的访问方式列表。 ``` { "total" : 2, "items" : [ { "runtime_id" : "f47ac10b-58cc-4372-a567-0e02b2c3d479", "id" : "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "name" : "public-endpoint", "description" : "公开访问的运行时访问方式", "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 } ] }, "tags" : [ { "key" : "access", "value" : "public" } ] }, { "runtime_id" : "f47ac10b-58cc-4372-a567-0e02b2c3d479", "id" : "b2c3d4e5-f6a7-8901-bcde-f12345678901", "name" : "canary-endpoint", "description" : "金丝雀发布的运行时访问方式", "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" : "access", "value" : "internal" }, { "key" : "strategy", "value" : "canary" } ] } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询成功，返回指定runtime的访问方式列表。 | | 400 | 请求参数错误（如runtime_id格式错误等）。 | | 401 | 未授权（认证令牌缺失、无效或已过期）。 | | 403 | 禁止访问（认证后权限不足）。 | | 429 | 请求过于频繁（触发限流）。 | | 500 | 服务器内部错误。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。