跳转到主要内容
API Explorer|API Explorer
基础设施相关接口/Agent 管理
POSTAgent起始版本 1.0同步需要认证

触发探测

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

调试可用性

在线调试

使用当前认证信息和示例参数提交 Mock 请求。

路径参数

请求参数

路径参数

  • uuidString必填

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

响应状态

200 OK

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

  • agentIdString

    代理ID。

    示例： agent-abc123-def456

  • timestampString

    时间戳。

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

  • detectedServicesList

    已检测服务。

    示例： (nested array)

    • serviceString

      名称已检测服务。

      示例： nginx

    • confidenceLong

      置信度。

      示例： 0.95

    • evidenceList

      资源。

      示例： item1,item2

    • recommendedConfigObject

      推荐配置信息。

      • typeString

        类型。

        示例： prometheus

      • sourceString

        来源信息。

        示例： /var/log/app.log

      • parserString

        解析器类型。

        示例： json

      • pluginString

        标识符处理采集器。

        示例： filebeat

      • endpointString

        接收端地址。

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

      • varsLinkedHashMap

        变量定义模板渲染。

        示例： (nested object)

  • probeTimeMsString

    探测时间毫秒。

    示例： 1200

请求地址

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

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

操作 ID

TriggerProbe

永久链接

请求示例

curl -X POST '{host}/api/v1/agents/{uuid}/probe' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{}'

响应示例

200
{
  "agentId": "agent-abc123-def456",
  "timestamp": "example",
  "detectedServices": [
    {}
  ],
  "probeTimeMs": 1200
}

变更历史

此 API 暂无变更历史记录。

查看全部变更历史