发现 API 端点

Last published : Oct 06, 2026
您可以使用 API 安全功能查看组织中已发现的 API 端点。NetScaler Console 根据 NetScaler 实例和 API 部署上接收到的 API 流量发现 API 端点。
在 NetScaler Console 中，安全 > API 安全 > API 发现页面显示已发现的 API 端点。
  • 虚拟服务器 - VServer 选项卡显示来自 NetScaler 实例的虚拟服务器。当虚拟服务器在指定期间收到 API 请求时，它们会显示在此选项卡中。
  • API 部署 - 此选项卡显示使用 API 定义从 NetScaler Console 部署的 API 部署。当 API 部署在指定期间收到 API 请求时，此选项卡会发现 API 端点。要添加和部署 API 定义，请参阅添加 API 定义 和部署 API 定义。
注意：
  • 确保配置分析并在虚拟服务器上启用 Web Insights。请参阅在 API 实例上启用 Web Insight。
  • 您只能将策略添加到在API 部署选项卡下发现的 API 端点。
Related information
API 安全

查看 API 端点

在API 发现中，当您选择虚拟服务器或 API 部署时，NetScaler Console GUI 会显示 API 端点及其详细信息，例如：
  • 方法 - 它显示 API 端点中使用的方法。例如，GET 和 POST 方法。
  • 总请求数 - 它显示 API 端点上的 API 请求计数。
  • 响应状态 - 它显示每个响应状态的计数。例如，2xx、3xx、4xx 和 5xx。
  • 在规范中找到 - 此列仅适用于 API 部署。有时，不属于 API 定义的内部 API 可能会接收来自外部的流量。此列可帮助您识别 API 端点和观察到的方法是否属于 API 定义。
虚拟服务器中的 API 端点可用情况如下：
虚拟服务器中的 API 端点(/en-us/netscaler-console-service/media/vserver-api-endpoints.png)
API 部署中的 API 端点如下所示：
虚拟服务器中的 API 端点(/en-us/netscaler-console-service/media/api-deployment-endpoints.png)
您还可以选择所需的 API 端点以查看其详细分析报告。
详细的 API 端点报告(/en-us/netscaler-console-service/media/detailed-api-endpoint-report.png)
有关每个部分的更多信息，请参阅查看 API 分析。

从发现的 API 端点创建 API 定义

要从发现的 API 端点（API 资源和方法）创建 API 定义，请执行以下操作：
  1. 导航到 Security > API Security > API Discovery 以查看虚拟服务器和 API 部署列表。
  2. 在 VServers 选项卡中单击任何虚拟服务器。
  3. 虚拟服务器页面显示发现的端点列表。选择任何端点，然后单击 Create API Definition。
更新 API 定义(/en-us/netscaler-console-service/media/api-gateway-create-api-definition.png)
注意：
如果您未选择任何端点并单击 Create API Definition，将弹出一个窗口，要求您确认是否要为所有端点创建 API 定义。单击 Yes 以创建包含所有端点的 API 定义，否则单击 No。
所有端点的弹出消息(/en-us/netscaler-console-service/media/api-definition-all-endpoints-msg.png)
  1. 在 创建 API 定义 中，指定以下内容：
    • 名称 - API 定义的名称。
    • API 定义 - 定义必须包含标题、版本、基本路径和主机。您可以在“主机”字段中指定域名或 IP 地址。
    • API 资源 - 将多个 API 资源添加到您的定义中。每个资源都有一个路径和支持的方法。
  2. 单击“创建定义”以创建 API 定义。
注意：
如果要在将 API 资源路径添加到 API 定义之前对其进行编辑，请使用 API 定义屏幕上 API 资源的排序或搜索功能。
例如，考虑一个名为“/api/products/123-3243-2344334/reviews”的 API 资源，其中路径段“123-3243-2344334”是可变产品 ID。您现在可以对 API 资源进行排序，将资源路径添加为“/api/products/{id}/reviews”，并删除所有具有诸如“/api/products/123-3243-2344334/reviews”之类的 ID 的 API 端点。
创建 API 定义

使用发现的 API 端点更新现有 API 定义

要使用 API 端点（API 资源和方法）更新现有 API 定义，请执行以下操作：
  1. 导航到“安全 > API 安全 > API 发现”以查看虚拟服务器和 API 部署列表。
  2. 单击“虚拟服务器”选项卡中的任何虚拟服务器。
  3. 虚拟服务器页面显示发现的端点列表。选择要添加到现有 API 定义的端点。单击“更新现有 API 定义”。
    更新 API 定义
  4. 从“选择现有 API 定义”下拉列表中，选择要更新的 API 定义。单击“更新定义”。
  5. 出现“更新现有 API 定义”页面。“API 资源”部分显示以下表格：
    • “已添加资源” - 您选择的 API 端点
    • “现有资源” - API 定义中已有的 API 端点
    “注意：”:
    如果在“已添加资源”和“现有资源”中都存在相同的 API 端点，则该端点只会添加到 API 定义一次。
  6. 单击“更新定义”。