该接口用于修改POLARDB的集群地址属性，包括读写模式、新节点是否自动加入本地址、一致性级别等。

说明 POLARDB兼容Oracle语法引擎暂不支持集群地址。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 否 ModifyDBClusterEndpoint

系统规定参数，取值：ModifyDBClusterEndpoint。

DBClusterId String 是 pc-xxxxxxxxxxxxxxxxxx

集群ID。
DBEndpointId String 是 pe-xxxxxxxx

集群地址ID。例如pe-xxxxxxxx。
Nodes String 否 pi-xxxxxxxxxx,pi-xxxxxxxxxx

加入本地址用于处理读请求的节点，用（,）分隔，至少两个。

默认为原有节点。
ReadWriteMode String 否 ReadWrite

读写模式：

  • ReadWrite：可读可写（自动读写分离）。
  • ReadOnly：只读。

默认为ReadOnly。

AutoAddNewNodes String 否 Enable

新节点是否自动加入本地址，取值：

  • Enable。
  • Disable。

默认为Disable。

EndpointConfig String 否 {"ConsistLevel": "1","DistributedTransaction": "on"}

集群地址的高级配置，格式为JSON，目前支持设置一致性级别和事务拆分。

说明 仅POLARDB MySQL支持设置事务拆分。

设置一致性级别，格式为{"ConsistLevel": "一致性级别"}

一致性级别取值为：

  • 0：最终一致性。
  • 1：会话一致性（默认值）。

设置事务拆分，格式为{"DistributedTransaction": "事务拆分设置"}

事务拆分设置取值为：

  • on：开启事务拆分（默认值）。
  • off：关闭事务拆分。
说明
  • 如果参数ReadWriteMode取值为ReadOnly，一致性级别取值只能为0。
  • 您可以同时设置一致性级别和事务拆分，例如{"ConsistLevel": "1","DistributedTransaction": "on"}。
  • 事务拆分的设置受一致性级别设置的约束。例如一致性级别取值为0时，不支持开启事务拆分；一致性级别取值为1时，支持开启事务拆分。

返回数据

名称 类型 示例值 描述
RequestId String CD3FA5F3-FAF3-44CA-AFFF-BAF869666D6B

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyDBClusterEndpoint
&DBClusterId=pc-xxxxxxxxxxxxxxxxxx
&DBEndpointId=pe-xxxxxxxx
&<公共请求参数>

正常返回示例

JSON 格式 

{
    "RequestId": "CD3FA5F3-FAF3-44CA-AFFF-BAF869666D6B"
}

XML 格式 

<ModifyDBClusterEndpointResponse>  
      <RequestId>CD3FA5F3-FAF3-44CA-AFFF-BAF869666D6B</RequestId>
</ModifyDBClusterEndpointResponse>

错误码

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