文档中心

云数据库 PostgreSQL 版

连接管理

ModifyDBEndpointReadWeight

调用 ModifyDBEndpointReadWeight 接口修改终端读权重分配模式，以及自定义权重配比。

请求类型

同步请求。

注意事项

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	postgres-0af11cd4****	实例 ID。
EndpointId	String	是	postgres-0af11cd4****-cluster	实例连接终端 ID。
ReadOnlyNodeDistributionType	String	否	Default	只读权重分配模式。取值： Default：标准权重分配（默认值）。 Custom：自定义权重分配。
ReadOnlyNodeWeight	Array of NodeWeightObject	否	[ {"NodeType" : "Primary", "Weight" : 100 }, { "NodeId" : "postgres-c23003b1****-rof359", "Weight" : 100 } ]	自定义读权重分配，即传入主节点和只读节点的读请求权重。以 100 递增，最大值为 40000。说明当 ReadOnlyNodeDistributionType 取值为 Custom 时，需要传入此参数。主节点需要传入 NodeType 为 Primary，只读节点需要传入 NodeID。权重不可全部设置为 0。
WriteNodeHaltWriting	Boolean	否	false	是否禁止终端将写请求发送给写节点（目前仅主节点为写节点）。取值： true：是。 false：否。说明为避免没有可用的连接终端承载写业务，需在实例有其他读写终端时才能开启此配置。

NodeWeightObject

参数	类型	是否必选	示例值	描述
NodeId	String	否	postgres-c23003b1****-ojmo	只读节点需要传入 NodeId。说明主节点可不传入 NodeId。
NodeType	String	是	Primary	节点类型。取值： Primary：主节点。 ReadOnly：只读节点。
Weight	Integer	是	100	节点的读权重，以 100 递增，最大值为 40000。说明权重不可全部设置为 0。

返回参数

null

示例

请求示例

返回示例

最近更新时间：2026.03.31 10:39:11

这个页面对您有帮助吗？

有用

无用