文档首页/云数据库 GaussDB/API参考/API（推荐）/实例管理/查询实例主备平衡状态 - CheckingWhetherHostLoadIsUnbalancedDuetoaPrimary/StandbySwitchover
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

查询实例主备平衡状态 - CheckingWhetherHostLoadIsUnbalancedDuetoaPrimary/StandbySwitchover

功能介绍

查询实例是否发生过主备切换而导致主机负载不均衡。

调试

您可以在API Explorer中调试该接口。

URI

GET /v3/{project_id}/instances/{instance_id}/balance

表1 参数说明

名称

是否必选

说明

project_id

是

参数解释：

租户在某一Region下的项目ID。

获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

instance_id

是

参数解释：

实例ID，此参数是用户创建实例的唯一标识。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为36个字符。

默认取值：

不涉及。

请求参数

无。

响应参数

表2 参数说明

名称

参数类型

说明

balanced

Boolean

参数解释：

平衡状态。显示是否有集群实例发生过主备切换而导致主机负载不均衡。

取值范围：

  • true，均衡。
  • false，不均衡。

请求示例

查询实例主备平衡状态。

GET https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/opengauss/v3/0483b6b16e954cb88930a360d2c4e663/instance/dsfae23fsfdsae3435in14/balance

响应示例

查询实例主备平衡状态成功。

{
	"balanced": true
}

状态码

错误码

请参见错误码。

父主题：实例管理