更新时间:2026-07-17 gmt 08:00

创建target-j9九游会登录

创建网关时,可以创建并绑定target。创建target用于定义和配置一个目标端点或服务,网关将接收到的请求转发到该服务进行处理。

前提条件

  • 完成
  • 创建target时,选择open api类型的目标服务类型,且从obs中获取文件时,用户除了需要具备网关的fullaccesspolicy权限外,还需包含以下身份策略权限:
    表1 授权项

    授权项

    功能介绍

    obs:bucket:listbucket

    授予获取桶内对象列表的权限。

    obs:bucket:listbucketversions

    授予获取桶内多版本对象列表的权限。

    obs:bucket:listallmybuckets

    授予查询创建的桶列表的权限。

    obs:object:getobject

    授予下载非指定版本对象的权限。

    obs:object:getobjectversion

    授予下载指定版本对象的权限。

    在iam控制台为用户授权的操作指导可参考:给iam用户授权

约束与限制

一个网关最多可关联10个target。

创建target

  1. 登录。
  1. 在左侧导航栏选择“开发中心 > 组件库 ”,单击左上角“网关”页签,进入网关界面。
  2. 选择已创建的网关,单击网关名称,在“关联target”区域,单击“创建target”。
  3. 输入target的配置信息,参数说明请参考表2,然后单击“确定”。
    表2 参数说明

    参数

    说明

    基本信息

    名称

    target的名称,同一网关下target名称不可重复。

    命名规则:

    • 以字母或数字开头和结尾。
    • 支持大小写字母、数字和连字符。
    • 长度为 1-50 个字符。

    系统会默认生成target的名称,可根据需求自定义修改。

    描述

    用于对target内容和用途的简要说明。

    规则:长度不大于200个字符。

    配置信息

    类型

    选择target的类型,关于target类型的介绍请参见。

    • rest api:使用open api schema文件调用。
      • 使用“obs”进行oas文件导入。

        使用openapi specification (oas) 文件来定义和配置目标端点或服务,并且这些文件存储在对象存储服务(object storage service, obs)中,并在创建target时从obs中导入这些文件。

        单击“从obs中选择”,选择在obs中创建的桶列表,直至选择到桶中的.json文件后单击“确定”。

      • 使用“自定义”进行oas文件导入。

        从本地文件系统中选择并上传oas文件,用于定义和配置目标端点或服务。

        • 单击“从本地导入”,浏览本地文件系统,选择oas文件并上传。上传后json文件或yaml即可展示在“内联编辑器”中。
        • 单击“从obs中导入”,选择在obs中创建的桶列表,直至选择到桶中的.json文件后单击“确定”,将obs中的文件下载下来展示到内联编辑器中。
    • mcp:使用已有的mcp服务器调用。
      • 传输方式
        • sse:基于http的协议,用于从服务器向客户端推送实时更新,适用于需要实时更新的应用。
        • streamable http:基于http的流式传输方式,允许服务器向客户端发送连续的数据流,适用于需要实时数据流的应用。
      • mcp地址:输入mcp地址。

    出站身份认证

    出站身份认证

    配置出站身份认证方式,用于在网关将请求转发到后端服务(target)时,对请求进行身份验证和授权。

    支持以下认证方式:

    • api key
      • 选择出站身份,如下拉框无选项请单击“创建出站身份”,创建“api key”类型的出站身份。
      • 选择位置。
        • 标头:在http请求的头部字段中传递api key。
        • 查询参数:在http请求的url中传递api key。
      • 参数名称(可选):输入参数名称,在请求中传递api的密钥时使用的具体名称。
      • 前缀(可选):在请求头中传递api key时,api密钥值之前的前缀部分,如在授权标头中使用的“bearer”。
    • oauth
      • 选择出站身份,如下拉框无选项请单击“创建出站身份”,创建“oauth 客户端”类型的出站身份。
      • 选择授权类型。

        客户端授权:适用于用户授权应用程序(客户端)访问其资源。

      • 作用域:用于定义可以访问的资源和操作的范围,确保只能访问其被授权的资源。输入范围名称,最大可添加100个范围。
      • 自定义参数:在请求中传递的额外参数,可以用于传递特定的信息或满足特定的认证需求。请输入自定义参数信息的键和值,最大可添加255个参数。
    • 无认证:在网关将请求转发到target时,不对请求进行身份验证和授权。
  4. 创建完成后,即可在列表展示已创建的target。

    target的状态说明如下:

    网关创建完成后,在网关列表中单击网关名称,进入基本信息页面,在“关联target”区域即可查看target状态。

    • 就绪可用状态:target创建成功后,状态初始化为“就绪可用”。
    • 在线状态:启动沙箱并探测target连通性成功后,状态更新为“在线”,此时 target 可正常调用。当关联该target的沙箱被释放后,状态将回退至“就绪可用”。
    • 离线状态:启动沙箱并探测target连通性失败后,状态更新为“离线”,离线状态下target无法正常调用。

      离线状态的两种情况以及j9九游会登录的解决方案:

      • 连接超时:target的连接请求超时,无法在规定时间内建立连接,请检查网关和target的网络连接性或检查target服务是否正常运行。
      • 解析不到ip:target的ip地址无法解析,导致连接失败。

        请检查target配置的域名dns解析是否正常,使用命令行工具(如nslookup或dig)测试target的域名解析是否正常。

    当启用语义检索并同步mcp类型的target时,触发同步操作(单击操作列的“同步”,或勾选多个target后单击“同步target信息”)后,target状态将呈现以下两种情况:

    • 同步中:系统正在同步target信息。
    • 等待同步中:当前target排队等待同步中,状态提示为“等待同步中”。

更多操作

您还可以对已创建的target执行如下操作。

表3 更多操作

操作

说明

同步target信息

手动同步target信息仅支持mcp类型的target,rest api类型的target系统会自动同步。

在创建网关时开启语义检索功能后系统会自动同步mcp类型及rest api类型的target信息,如果mcp类型的target外部工具发生变化,需要手动同步mcp信息,以确保语义检索工具能够获取最新的数据。

手动同步target操作如下:

  1. 在网关列表单击网关名称,进入网关详情页面。
  2. 在网关详情页面的“关联target”区域。
  3. 同步target信息。
    • 同步单击target信息:单击target列表操作列的“同步”,系统提示“同步 target 任务已创建!”。
    • 同步多个target信息:在target列表勾选多个target,单击“同步target信息”,系统提示“同步 target 任务已创建!”。

同步后target状态将呈现以下两种情况:

  • 同步中:系统正在同步target信息。
  • 等待同步中:当前target排队等待同步中,状态提示为“等待同步中”。

查看target

  1. 在网关详情页面的“关联target”区域。
  2. 单击target名称,查看target详情。

修改target

  1. 在网关详情页面的“关联target”区域。
  2. 单击target列表操作列的“编辑”。
  3. 修改target信息,其中置灰项不可修改。

删除target

target删除后不可恢复,请谨慎操作。

  1. 在网关详情页面的“关联target”区域。
  2. 单击target列表操作列的“删除”。
  3. 在弹框中单击“确定”。

相关文档

网站地图