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

更新受管代理

更新 `updateMask` 选中的 `displayName` 和/或 `agentLifecycleAlertDestination`。需要已保存 `Agent` 作用域内的 `agent.config.write` 权限和有效的平台访问权限;允许更新离线 `Agent`。以最后提交的值为准。`requestId` 用于跟踪,不用于响应重放。不创建任务或远程配置。

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

操作 ID

UpdateManagedAgent

起始版本

1.3.0

执行模式

同步

认证信息

需要认证

认证信息

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

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

application/json

路径参数

  • id
    String必填

    资源ID。

请求体字段

  • requestId
    String

    资源。

    示例: value

  • updateMask
    List

    更新脱敏。

    示例: item1,item2

  • displayName
    String

    显示名称。用于界面展示。

    示例: value

  • agentLifecycleAlertDestination
    String

    `zmetis` 或 `none`。仅在 `update_mask` 选中时应用。

    示例: value

响应状态

200 OK
200 OK

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

  • agentId
    String

    代理ID。

    示例: value

  • displayName
    String

    显示名称。用于界面展示。

    示例: value

  • agentLifecycleAlertDestination
    String

    资源。

    示例: value

  • rowVersion
    String

    资源。

    示例: 10