获取受管代理可用性

根据当前兼容性修订版本，读取安装、`host_metrics` 和操作的准入状态。需要 `agent.read` 权限，以及所选可选平台/`Region` 作用域的权限（包括未关联的 `Agent`）；作用域访问被拒绝时返回 `PermissionDenied`。不授予写权限，也不替代各 `Agent` 的操作预检查。运行时不可用不妨碍服务端撤销访问。

GET/api/v1/lifecycle/managed-agent/availability

操作 ID

GetManagedAgentAvailability

起始版本

1.3.0

执行模式

同步

认证信息

需要认证

认证信息

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

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

查询参数

platformUuid
String
平台UUID。
regionUuid
String
过滤可用性区域UUID。

响应状态

200 OK

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

scope
Object
作用范围。
- platformUuid
  String
  平台UUID。
  示例： value
- regionUuid
  String
  资源。
  示例： value
compatibilityRevision
String
资源。
示例： value
install
Object
资源。
- available
  Boolean
  资源。
  示例： true
- blockedBy
  List
  资源。
  示例： item1,item2
- targetAgentVersion
  String
  资源。
  示例： value
- targetAgentRelease
  String
  该资源的目标 `Agent` 发布版本。
  示例： 10
capabilities
List
资源。
示例： (nested array)
- capabilityId
  String
  资源。
  示例： value
- available
  Boolean
  资源。
  示例： true
- blockedBy
  List
  已阻塞人。
  示例： item1,item2
operations
Object
资源。
- restart
  Object
  资源。
  available
  Boolean
  资源。
  示例： true
  blockedBy
  List
  资源。
  示例： item1,item2
  targetAgentVersion
  String
  资源。
  示例： value
  targetAgentRelease
  String
  该资源的目标 `Agent` 发布版本。
  示例： 10
- upgrade
  Object
  资源。
  available
  Boolean
  资源。
  示例： true
  blockedBy
  List
  资源。
  示例： item1,item2
  targetAgentVersion
  String
  资源。
  示例： value
  targetAgentRelease
  String
  该资源的目标 `Agent` 发布版本。
  示例： 10
- revokeAccess
  Object
  资源。
  available
  Boolean
  资源。
  示例： true
  blockedBy
  List
  资源。
  示例： item1,item2
  targetAgentVersion
  String
  资源。
  示例： value
  targetAgentRelease
  String
  该资源的目标 `Agent` 发布版本。
  示例： 10

请求示例

curl -X GET '{host}/api/v1/lifecycle/managed-agent/availability?platformUuid={platformUuid}&regionUuid={regionUuid}' \
  -H 'Authorization: Bearer {token}'

响应示例

{
  "scope": {
    "platformUuid": "value",
    "regionUuid": "value"
  },
  "compatibilityRevision": "value",
  "install": {
    "available": true,
    "blockedBy": [
      "value"
    ],
    "targetAgentVersion": "value",
    "targetAgentRelease": "10"
  },
  "capabilities": [
    {
      "capabilityId": "value",
      "available": true,
      "blockedBy": [
        "value"
      ]
    }
  ],
  "operations": {
    "restart": {
      "available": true,
      "blockedBy": [
        "value"
      ],
      "targetAgentVersion": "value",
      "targetAgentRelease": "10"
    },
    "upgrade": {
      "available": true,
      "blockedBy": [
        "value"
      ],
      "targetAgentVersion": "value",
      "targetAgentRelease": "10"
    },
    "revokeAccess": {
      "available": true,
      "blockedBy": [
        "value"
      ],
      "targetAgentVersion": "value",
      "targetAgentRelease": "10"
    }
  }
}

变更历史

查看全部变更历史

变更时间变更内容概要操作

变更时间
2026-09-17
新增响应字段 targetAgentRelease
查看 API

资产

采集任务

基础设施综合

安装器

生命周期

OTA 升级计划

OTA 版本与策略

联邦与 SSO

变更管理

生命周期升级

告警规则

告警模板

告警通道与集成

告警事件

告警路由与策略

安全

ZMetis 审计

平台管理

平台联邦

平台健康

平台综合

ZMetis 任务

获取受管代理可用性

认证信息

请求参数

查询参数

响应状态

变更历史