查询单个runtime访问方式 - ShowCoreRuntimeEndpoint

功能介绍

该接口用于根据Agent运行时ID和访问方式ID查询对应的Agent运行时访问方式详细信息。

适用场景：

查询某一个具体的Agent运行时访问方式的详细信息。

调用方法

请参见如何调用API。

授权信息

账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
agentarts:runtimeEndpoint:showCoreRuntimeEndpoint	Read	runtimeEndpoint *	g:ResourceTag/<tag-key>	-	-

URI

GET /v1/core/runtimes/{runtime_id}/endpoints/{endpoint_id}

表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}$。默认取值: 不涉及。
endpoint_id	是	String	参数解释：访问方式ID，用于唯一标识一个Agent运行时访问方式实例。约束限制: 不涉及。取值范围：匹配标准的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}$。默认取值: 不涉及。

请求参数

无

响应参数

状态码：200

表2 响应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标签服务，用于资源分类。取值范围: 不涉及。

表3 CoreRunRoutingConfigurationResp
参数	参数类型	描述
version_weights	Array of CoreRunVersionWeightResp objects	参数解释: 运行时访问方式多版本权重配置。取值范围: 元素个数0 - 3。

表4 CoreRunVersionWeightResp
参数	参数类型	描述
version_name	String	参数解释: 版本名称。取值范围: 以小写字母或数字开头，以小写字母或数字结尾，可以包含小写字母、数字和中划线，长度为2-24个字符。
weight	Float	参数解释: 流量权重比例 (0.0 - 1.0)。取值范围: [0, 1.0]

表5 CoreRunTagItemResp
参数	参数类型	描述
key	String	参数解释: 标签键。取值范围: 长度为 1 - 128 个字符。
value	String	参数解释: 标签值。取值范围: 长度为 0 - 255 个字符。

状态码：401

表6 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 错误码。枚举值说明：AgentArts.03000401表示未授权（认证令牌缺失、无效或已过期）。取值范围: 不涉及。
error_msg	String	参数解释：错误详细信息。取值范围：长度为 1 - 512 个字符。

状态码：403

表7 响应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。

表8 CoreRunErrorDetail
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为 18 个字符。
error_msg	String	参数解释：错误信息。取值范围：长度为 1 - 1024 个字符。

状态码：404

表9 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。枚举值说明：AgentArts.03000404表示资源不存在。取值范围：固定值：AgentArts.03000404。
error_msg	String	参数解释：错误详细信息。取值范围：长度为 1 - 512 个字符。

状态码：429

**表10** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。枚举值说明：AgentArts.03000429表示请求过于频繁（触发限流）。取值范围：固定值：AgentArts.03000429。
error_msg	String	参数解释：错误详细信息。取值范围：长度为 1 - 512 个字符。

状态码：500

**表11** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。枚举值说明：AgentArts.03000500表示服务器内部错误。取值范围：固定值：AgentArts.03000500。
error_msg	String	参数解释：错误详细信息。取值范围：长度为 1 - 512 个字符。

请求示例

GET https://{Endpoint}/v1/core/runtimes/{runtime_id}/endpoints/{endpoint_id}

响应示例

状态码：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.0.0",
      "weight" : 1.0
    } ]
  },
  "tags" : [ {
    "key" : "access",
    "value" : "public"
  } ]
}

状态码

状态码	描述
200	查询成功，返回指定访问方式的详细信息。
401	未授权（认证令牌缺失、无效或已过期）。
403	禁止访问（认证后权限不足）。
404	资源不存在（指定的endpoint_id未找到）。
429	请求过于频繁（触发限流）。
500	服务器内部错误。