跳转到主要内容
近期删除/近期删除

更新受管代理能力

使用 `agent.config.write` 权限和有效的五分钟预检查,提交单次 `host_metrics` 启用、配置更新或禁用。配置更新使用 `configurationRevision`;禁用时使用 `drainMode` `wait` 或 `discard`。返回已持久化的任务;重复请求会恢复该任务,不重复执行 `Agent` 操作。配置未变化时,更新返回 `noOp` 和当前状态,不创建任务。期望状态不表示已经激活。

PATCH/api/v1/lifecycle/managed-agent/agents/{id}/capabilities

操作 ID

UpdateManagedAgentCapabilities

起始版本

1.3.0

执行模式

同步

认证信息

需要认证

认证信息

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

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

application/json

路径参数

  • id
    String必填

    资源ID。

请求体字段

  • requestId
    String

    资源。

    示例: value

  • precheckId
    String

    资源。

    示例: value

  • changes
    List

    变更。

    示例: (nested array)

    • capabilityId
      String

      资源。

      示例: value

    • desiredState
      String

      资源。

      示例: value

    • configurationRevision
      String

      配置修订版本。

      示例: value

    • drainMode
      String

      排空模式。

      示例: value

响应状态

200 OK
200 OK

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

  • taskId
    String

    任务ID。

    示例: value

  • state
    String

    当前状态。

    示例: value

  • desiredState
    String

    单个变更请求状态空多个变更。

    示例: value

  • noOp
    Boolean

    请求的配置未变化且未创建任务时为 True。

    示例: true

  • effectiveState
    String

    生效状态。

    示例: value