更新时间:2025-08-07 GMT+08:00

查询主机安装的ICAgent信息

功能介绍

该接口用于查询集群主机或用户自定义主机安装的ICAgent信息。

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/{cluster_id}/{namespace}/agents

表1 路径参数

参数

是否必选

参数类型

描述

cluster_id

String

  • 查询集群主机时,填写集群id。

  • 查询用户自定义主机时,填写“APM”。

namespace

String

  • 查询集群主机时,填写命名空间。

  • 查询用户自定义主机时,填写“APM”。

project_id

String

租户从IAM申请到的projectid,一般为32位字符串。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

从IAM服务获取的用户Token。

Content-Type

String

指定类型为application/json。

响应参数

状态码:200

OK 请求响应成功。

请求示例

查询集群主机安装的ICAgent信息。

https://{Endpoint}/v1/{project_id}/{cluster_id}/{namespace}/agents

响应示例

状态码:200

OK 请求响应成功。

[ {
  "ip" : "10.**.**.13",
  "agentId" : "7b****93-7**1-4**e-8**b-3d****35**84",
  "devCloudId" : "",
  "nodeName" : "aom-docker-75079-iul66",
  "status" : "running",
  "lastModified" : "1700577655170",
  "updateTime" : "1701141177267",
  "version" : "5.13.110.52",
  "osType" : "linux",
  "pinpointVersion" : "1.0.29",
  "pinpointStatus" : "",
  "phpProbeVersion" : "",
  "dotnetProbeVersion" : "",
  "extendInfo" : null,
  "customHostTag" : null,
  "enterprise_project_id" : "d64fbcc8-c296-4a6f-8988-6850dfb08b47",
  "reserved" : "{\"cpu_used\":\"1.5\",\"goroutine_used\":9507,\"mem_used\":\"181556\",\"net_used\":0.1923828125}"
} ]

状态码

状态码

描述

200

OK 请求响应成功。

错误码

请参见错误码