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

升级受管代理

将完整签名的 `Agent` 软件包升级到已认证的目标版本。需要已保存 `Agent` 作用域内的 `agent.upgrade` 权限、在线 `Agent`、无冲突任务及有效的升级预检查。重复请求会恢复原任务；应查询该任务确认完成或回滚，不能仅检查软件包是否交付。

POST/api/v1/lifecycle/managed-agent/agents/{id}/upgrade

操作 ID

UpgradeManagedAgent

起始版本

1.3.0

执行模式

同步

认证信息

需要认证

认证信息

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

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

application/json

路径参数

  • id
    String必填

    资源ID。

请求体字段

  • requestId
    String

    资源。

    示例： value

  • precheckId
    String

    资源。

    示例： value

  • targetVersion
    String

    资源。

    示例： value

响应状态

200 OK
200 OK

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

  • taskId
    String

    任务ID。

    示例： value

  • state
    String

    当前状态。

    示例： value

  • desiredAgentVersion
    String

    资源。

    示例： value

  • desiredAgentRelease
    String

    该资源期望的 `Agent` 发布版本。

    示例： 10

变更历史

查看全部变更历史

  • 变更时间

    新增响应字段 desiredAgentRelease
    查看 API