跳转到主要内容
API Explorer|API Explorer
基础设施相关接口/Agent 管理
POSTAgent起始版本 1.0同步需要认证

批量升级生命周期

发起批次升级多个代理可配置并发。

调试可用性

在线调试

使用当前认证信息和示例参数提交 Mock 请求。

请求参数

请求体字段

  • agentIdsList必填

    代理ID列表。

    示例： item1,item2

  • toVersionString必填

    目标版本号。

    示例： 1.5.0

  • artifactUrlString必填

    制品地址。

    示例： https://artifacts.example.com/agent-1.5.0.tar.gz

  • checksumString必填

    校验值。

    示例： sha256:abc123def456

  • concurrencyInteger必填

    并发数。

    示例： 5

响应状态

200 OK

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

  • batchIdString

    批次ID。

    示例： batch-upg-001

请求地址

POST/api/v1/agents/lifecycle/batch-upgrade

/api/v1/agents/lifecycle/batch-upgrade

操作 ID

LifecycleBatchUpgrade

永久链接

请求示例

curl -X POST '{host}/api/v1/agents/lifecycle/batch-upgrade' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"agentIds":"item1,item2","toVersion":"1.5.0","artifactUrl":"https://artifacts.example.com/agent-1.5.0.tar.gz","checksum":"sha256:abc123def456","concurrency":5}'

响应示例

200
{
  "batchId": "batch-upg-001"
}

变更历史

此 API 暂无变更历史记录。

查看全部变更历史