跳转到主要内容
ZStack
基础设施相关接口/Agent 管理

触发探测

触发自动发现探测目标代理探测运行中的服务。

POST/api/v1/agents/{uuid}/probe

操作 ID

TriggerProbe

起始版本

1.0.0

执行模式

同步

认证信息

需要认证

认证信息

调用该 API 时需要在请求头中携带以下认证信息。

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

路径参数

  • uuid
    String必填

    资源的UUID，唯一标识该资源。

响应状态

200 OK
200 OK

该 API 成功时返回以下响应结构。

  • agentId
    String

    代理ID。

    示例： agent-abc123-def456

  • timestamp
    String

    时间戳。

    示例： 2026-01-15T08:00:00Z

  • detectedServices
    List

    已检测服务。

    示例： (nested array)

    • service
      String

      名称已检测服务。

      示例： nginx

    • confidence
      Long

      置信度。

      示例： 0.95

    • evidence
      List

      资源。

      示例： item1,item2

    • recommendedConfig
      Object

      推荐配置信息。

      • type
        String

        类型。

        示例： prometheus

      • source
        String

        来源信息。

        示例： /var/log/app.log

      • parser
        String

        解析器类型。

        示例： json

      • plugin
        String

        标识符处理收集器。

        示例： filebeat

      • endpoint
        String

        接收端地址。

        示例： http://loki:3100/loki/api/v1/push

      • vars
        LinkedHashMap

        变量定义模板渲染。

        示例： (nested object)

  • probeTimeMs
    String

    探测时间毫秒。

    示例： 1200