ModifyDBClusterEndpointZonal - 修改边缘集群集群地址属性_云原生数据库 PolarDB(PolarDB)-阿里云帮助中心

PolarDB边缘集群修改链接地址

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

POST  HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
DBClusterId	string	是	集群 ID。	pc-**************
DBEndpointId	string	是	集群地址 ID。	pe-****************
Nodes	string	否	加入目标地址的读负载节点，多个节点间用英文逗号（,）分隔。默认为原有节点。说明 PolarDB MySQL 版需要传入节点 ID。 PolarDB PostgreSQL 版和 PolarDB PostgreSQL 版（兼容 Oracle）需要传入节点角色名称，例如`Writer,Reader1,Reader2`。 ReadWriteMode 取值为 ReadOnly 时，支持只挂载一个节点。但当此节点故障时，该地址可能会有最多 1 小时的不可用，请勿用于生产环境。因此，推荐至少选择 2 个节点，以提升可用性。 ReadWriteMode 取值为 ReadWrite 时，至少要选择 2 个节点。 * PolarDB MySQL 版支持选择任意两个节点。当两个节点都是只读节点时，写请求都会发往主节点。 * PolarDB PostgreSQL 版和 PolarDB PostgreSQL 版（兼容 Oracle）必须包含主节点。	pi-************,pi-***********
ReadWriteMode	string	否	读写模式，取值范围如下： ReadWrite：可读可写（自动读写分离） ReadOnly：只读	ReadWrite
AutoAddNewNodes	string	否	新节点是否自动加入本地址，取值范围如下： Enable：是 Disable：否（默认值）	Enable
EndpointConfig	string	否	集群地址的高级配置，格式为 JSON，目前支持设置一致性级别、事务拆分、主库是否接受读和连接池等。设置负载均衡策略，格式为`{\"LoadBalancePolicy\":\"负载均衡策略\"}`。取值范围如下： 0：基于连接数负载均衡（默认） 1：基于活跃请求数负载均衡设置主库是否接受读，格式为`{\"MasterAcceptReads\":\"主库是否接受读\"}`。取值范围如下： on：表示主库接受读（默认） off：表示主库不接受读设置事务拆分，格式为`{\"DistributedTransaction\":\"事务拆分\"}`。取值范围如下： on：开启事务拆分（默认） off：关闭事务拆分设置一致性级别，格式为`{\"ConsistLevel\":\"一致性级别\"}`。取值范围如下： 0：最终一致性（弱） 1：会话一致性（中）（默认） 2：全局一致性（强）设置全局一致性读超时时间，格式为`{\"ConsistTimeout\":\"全局一致性读超时时间\"}`。取值范围：0~60000。默认值为 20。单位为 ms。设置会话一致性读超时时间，格式为`{\"ConsistSessionTimeout\":\"会话一致性读超时时间\"}`。取值范围：0~60000。默认值为 0。单位为 ms。设置全局（或会话）一致性读超时策略，格式为`{\"ConsistTimeoutAction\":\"全局一致性读超时策略\"}`。取值范围如下： 0：将读请求发往主节点（默认）。 1：代理返回一个错误报文 wait replication complete timeout, please retry 给应用端。设置连接池，格式为`{\"ConnectionPersist\":\"连接池\"}`。取值范围如下： off：关闭连接池（默认） Session：开启会话级连接池 Transaction：开启事务级连接池设置并行查询，格式为`{\"MaxParallelDegree\":\"并行查询\"}`。取值范围如下： on：开启并行查询 off：关闭并行查询（默认）设置行存/列存自动引流，格式为`{\"EnableHtapImci\":\"行存/列存自动引流\"}`。取值范围如下： on：开启行存/列存自动引流功能 off：关闭行存/列存自动引流功能（默认）设置是否开启过载保护，格式为`{\"EnableOverloadThrottle\":\"是否开启过载保护\"}`。取值范围如下： on：开启过载保护 off：关闭过载保护（默认）说明仅当 PolarDB MySQL 版集群地址的读写模式为可读可写（自动读写分离）时，支持设置事务拆分、主库是否接受读、连接池和是否开启过载保护。当 PolarDB MySQL 版集群地址的读写模式为只读时，支持基于连接数负载均衡和基于活跃请求数负载均衡两种负载均衡策略；可读可写（自动读写分离）模式的集群地址仅支持基于活跃请求数负载均衡策略。当 PolarDB MySQL 版集群地址的读写模式为可读可写（自动读写分离），或集群地址的读写模式为只读且负载均衡策略为基于活跃请求数负载均衡时，支持设置行存/列存自动引流。仅 PolarDB MySQL 版支持一致性级别设置为全局一致性。如果参数 ReadWriteMode 取值为 ReadOnly，一致性级别取值只能为 0。您可以同时设置一致性级别、事务拆分、主库是否接受读和连接池，例如`{\"ConsistLevel\":\"1\",\"DistributedTransaction\":\"on\",\"ConnectionPersist\":\"Session\",\"MasterAcceptReads\":\"on\"}`。事务拆分的设置受一致性级别设置的约束。例如一致性级别取值为 0 时，不支持开启事务拆分；一致性级别取值为 1 或 2 时，支持开启事务拆分。	{\"DistributedTransaction\":\"off\",\"ConsistLevel\":\"0\",\"LoadBalanceStrategy\":\"load\",\"MasterAcceptReads\":\"on\"}
DBEndpointDescription	string	否	地址名称。	test
SccMode	string	否	节点是否开启全局一致性（高性能模式）功能。取值范围如下： ON：开启 OFF：关闭	OFF
PolarSccWaitTimeout	string	否	全局一致性超时时间	100
PolarSccTimeoutAction	string	否	全局一致性超时策略。取值范围如下： 0：发送该请求到主节点 2：超时降级，当全局一致性读超时后，本次查询操作会自动降级为非一致性读取，且客户端不会收到报错信息	0
ClientToken	string	否	用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，保证在不同请求间唯一，大小写敏感、不超过 64 个 ASCII 字符。	6000170000591aed949d0f******************

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	F2A9EFA7-915F-4572-8299-85A307******

示例

正常返回示例

JSON格式

{
  "RequestId": "F2A9EFA7-915F-4572-8299-85A307******"
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidEndpointConfig.Malformed	The specified parameter EndpointConfig is not valid.	指定的参数EndpointConfig无效
400	InvalidDBEndpointId.Malformed	The specified parameter DBEndpointId is not valid.	指定的参数DBEndpointId无效
400	InvalidNodes.Malformed	The specified parameter Nodes is not valid.	指定的参数Nodes无效。
403	OperationDenied.InstanceType	The operation is not permitted due to instance type.	由于实例类型的原因，不允许执行该操作
404	InvalidDBCluster.NotFound	The DBClusterId provided does not exist in our records.	当前的记录中不存在提供的DBClusterId。
404	EndpointStatus.NotSupport	Current endpoint status does not support this operation.	当前节点状态不支持此操作
404	InvalidDBClusterId.Malformed	The specified parameter DBClusterId is not valid.	指定的参数DBClusterId无效
404	InvalidDBClusterId.NotFound	The DBInstanceId provided does not exist in our records.	当前的记录中不存在提供的DBClusterId。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。