查询批量实例可升级的版本和升级类型
调试
您可以在API Explorer中调试该接口。
URI
POST https://{Endpoint}/v3/{project_id}/instances/db-upgrade/candidate-versions
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
参数解释: 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为32个字符。 默认取值: 不涉及。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
instance_ids |
否 |
Array of strings |
批量实例ID。 |
响应参数
参数 |
参数类型 |
描述 |
---|---|---|
upgrade_type_list |
Array of 表4 objects |
升级类型信息列表。 数组长度:0 - 1000 |
target_version |
String |
若实例处于升级待观察中,返回升级的目标版本,否则返回为空。 最小长度:0 最大长度:1000 |
upgrade_candidate_versions |
Array of strings |
可以升级的版本,包括大小版本。 最小长度:0 最大长度:1000 数组长度:0 - 1000 |
hotfix_upgrade_infos |
Array of 表6 objects |
可以升级的热补丁信息。 数组长度:0 - 1000 |
hotfix_rollback_infos |
Array of 表6 objects |
可以回滚的热补丁信息。 |
参数 |
参数类型 |
描述 |
---|---|---|
upgrade_type |
String |
升级类型。 取值范围:
|
enable |
Boolean |
升级类型是否可用。
|
upgrade_action_list |
Array of 表5 objects |
升级操作列表。 数组长度:0 - 1000 |
is_parallel_upgrade |
Boolean |
是否正在进行AZ内并行升级。
|
请求示例
查询批量实例可升级的版本和升级类型。
POST https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/db-upgrade/candidate-versions { "instance_ids" : [ "cc0ae5c47bf94834bf9e44138f7f995ain14", "aa0ae5c47bf94834bf9e44138f7f995ain14" ] }
响应示例
查询批量实例可升级的版本和升级类型。
{ "upgrade_type_list": [ { "upgrade_type": "grey", "upgrade_action_list": [ { "upgrade_action": "commit", "enable": false }, { "upgrade_action": "rollback", "enable": false }, { "upgrade_action": "upgrade", "enable": true }, { "upgrade_action": "upgradeAutoCommit", "enable": true } ], "enable": true, "is_parallel_upgrade": null }, { "upgrade_type": "inplace", "upgrade_action_list": [ { "upgrade_action": "upgradeAutoCommit", "enable": true } ], "enable": true, "is_parallel_upgrade": null }, { "upgrade_type": "hotfix", "upgrade_action_list": [ { "upgrade_action": "upgradeAutoCommit", "enable": false }, { "upgrade_action": "rollback", "enable": false } ], "enable": false, "is_parallel_upgrade": null } ], "upgrade_candidate_versions": [ "8.302.90" ], "target_version": null, "hotfix_upgrade_infos": [], "hotfix_rollback_infos": [] }
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。