调用UpgradeCloudAssistants接口，为云服务器实例升级已安装的批量作业客户端至最新版本。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | UpgradeCloudAssistants | 要执行的操作，取值：UpgradeCloudAssistants。 |
Version | String | 是 | 2020-04-01 | API的版本，取值：2020-04-01。 |
InstanceIds.N | Array of String | 是 | InstanceIds.1=i-ervasv*****&InstanceIds.2=i-uihrdgh***** | 实例ID，最多支持50个ID。您可以调用DescribeInstances接口查询获取实例ID。
|
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
UpgradingInstanceIds | Array of String | ["i-ycm4ru8****" ] | 成功提交升级请求的实例ID列表。 |
FailedInstances | Array of Object | -- | 符合条件的升级失败实例信息。 |
GET /?Action=UpgradeCloudAssistants&Version=2020-04-01&IntanceIds.1=i-ervasv***** HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing Service: ecs
{ "ResponseMetadata": { "RequestId": "202308301A86D*******", "Action": "UpgradingCloudAssistants", "Version": "2020-04-01", "Service": "ecs", "Region": "cn-beijing" }, "Result": { "UpgradingInstanceIds": [ "i-ervasv*****" ], "FailedInstances": [] } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
400 | LimitExceeded.MaximumInstanceIds | The specified InstanceIds exceeds the limit. | 实例数量超出限制。 |
400 | MissingParameter.InstanceIds | The required parameter InstanceIds is not supplied. | 实例 ID 不能为空。 |
400 | MissingParameter.AccountId | The required parameter AccountId is not supplied. | 用户ID不能为空。 |
500 | InternalError | An internal error has occurred. | 内部错误，请重试。如果多次尝试失败，请提交工单。 |