租户端 存储 日志服务（CLS） 采集相关接口 UpgradeAgentNormal

UpgradeAgentNormal

最近更新时间: 2025-10-20 17:05:57

1. 接口描述

接口请求域名： cls.api3.fincloud.tencent.cn。

基于Agent粒度的单次升级任务启动

默认接口请求频率限制：20次/秒。

接口更新时间：2022-10-31 11:10:35。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：UpgradeAgentNormal
Version 是 否 String 公共参数，本接口取值：2020-10-16
Region 是 否 String 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
AgentIps 是 否 Array of String 需要升级的机器IP列表
UpdateMode 是 否 Int64 升级类型:0-disable,1-manual,2-auto
UpdateStart 否 否 String 升级开始时间，如：22:00:00，晚上10点开始
UpdateStop 否 否 String 升级结束时间，如：23:00:00，晚上11点结束
TargetVersion 否 否 String 升级目标版本

3. 输出参数

参数名称 类型 描述
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码 描述
AuthFailure CAM签名/鉴权错误。
FailedOperation 操作失败。
InternalError 内部错误。
InvalidParameter 参数错误。
MissingParameter 缺少参数错误。
OperationDenied 操作被拒绝。
OperationDenied.AccountDestroy 账户已销毁。
OperationDenied.AccountIsolate 账户欠费。
OperationDenied.AccountNotExists 账户不存在。
ResourceNotFound 资源不存在。
ResourceNotFound.AgentVersionNotExist agent version不存在。