DescribeDBClusterEndpoints - 查询PolarDB集群的地址信息

查询PolarDB集群的地址信息。

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

polardb:DescribeDBClusterEndpoints

get

*dbcluster

acs:polardb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}

请求参数

名称

类型

必填

描述

示例值

DBClusterId

string

集群 ID。

说明

您可以通过 DescribeDBClusters 接口查看账号下所有集群的详细信息,包括集群 ID。

pc-*************

DBEndpointId

string

集群地址 ID。

pe-*************

DescribeType

string

是否需要返回 ai 节点信息。

AI

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID。

2DC120BF-6EBA-4C63-BE99-B09F9E******

Items

array<object>

集群地址详情。

object

Nodes

string

连接地址配置的节点列表。

pi-***************,pi-***************

ReadWriteMode

string

读写模式:

  • ReadWrite:可读可写(自动读写分离)。

  • ReadOnly:只读。

ReadOnly

AddressItems

array<object>

连接串信息。

object

VSwitchId

string

虚拟交换机 ID。

vsw-************

PrivateZoneConnectionString

string

绑定的私有域名,

***.***.**.com

ConnectionString

string

连接串。

********.rwlb.polardb-pg-public.rds.aliyuncs.com

NetType

string

网络类型,取值范围如下:

  • Public:公网

  • Private:私网

  • Inner:经典网络

仅 PolarDB MySQL 版集群支持经典网络类型。

Private

Port

string

端口。

1521

VpcInstanceId

string

VPC 实例 ID。

说明

仅 PolarDB MySQL 版集群会返回该参数。

pe-*************

VPCId

string

专有网络 ID。

vpc-***************

IPAddress

string

IP 地址。

192.***.***.***

DashboardUsed

boolean

是否为 PolarDB Search 节点 Dashboard 地址

  • Ture:是

  • False:否

True

DBEndpointId

string

连接地址 ID。

pe-*************

EndpointConfig

string

集群地址的高级配置。

  • DistributedTransaction:事务拆分状态,取值范围如下:

    • on:事务拆分已开启

    • off:事务拆分已关闭

  • ConsistLevel:会话一致性级别,取值范围如下:

    • 0:最终一致性

    • 1:会话一致性。

    • 2:全局一致性

  • LoadBalanceStrategy:负载均衡策略,基于负载的自动调度,取值固定为 load

  • MasterAcceptReads:主库是否接受读,取值范围如下:

    • on:主库接受读

    • off:主库不接受读

{\"DistributedTransaction\":\"off\",\"ConsistLevel\":\"0\",\"LoadBalanceStrategy\":\"load\",\"MasterAcceptReads\":\"on\"}

DBEndpointDescription

string

地址名称。

test

EndpointType

string

集群地址类型:

  • Cluster:默认集群地址。

  • Primary:主地址。

  • Custom:自定义集群地址。

Custom

AutoAddNewNodes

string

新节点是否自动加入默认集群地址:

  • Enable

  • Disable

Enable

DBClusterId

string

集群 ID。

pc-bp1s826a1up******

SccMode

string

节点是否开启全局一致性(高性能模式)功能。取值范围如下:

  • on:开启

  • off:关闭

on

PolarSccTimeoutAction

string

全局一致性超时策略。取值范围如下:

  • 0:发送该请求到主节点

  • 2:超时降级,当全局一致性读超时后,本次查询操作会自动降级为非一致性读取,且客户端不会收到报错信息

0

PolarSccWaitTimeout

string

全局一致性超时时间

100

NodeWithRoles

string

目标连接地址下各节点的角色名称,其中主节点为 Writer;由于一个连接地址下可加入多个只读节点,因此每个只读节点的角色名称后会加上数字作为区分,如 Reader1Reader2,以此类推。

说明

仅 PolarDB PostgreSQL 版集群和 PolarDB PostgreSQL 版(兼容 Oracle)集群支持该参数。

Reader1

示例

正常返回示例

JSON格式

{
  "RequestId": "2DC120BF-6EBA-4C63-BE99-B09F9E******",
  "Items": [
    {
      "Nodes": "pi-***************,pi-***************",
      "ReadWriteMode": "ReadOnly",
      "AddressItems": [
        {
          "VSwitchId": "vsw-************",
          "PrivateZoneConnectionString": "***.***.**.com",
          "ConnectionString": "********.rwlb.polardb-pg-public.rds.aliyuncs.com",
          "NetType": "Private",
          "Port": "1521",
          "VpcInstanceId": "pe-*************",
          "VPCId": "vpc-***************",
          "IPAddress": "192.***.***.***",
          "DashboardUsed": true
        }
      ],
      "DBEndpointId": "pe-*************",
      "EndpointConfig": "{\\\"DistributedTransaction\\\":\\\"off\\\",\\\"ConsistLevel\\\":\\\"0\\\",\\\"LoadBalanceStrategy\\\":\\\"load\\\",\\\"MasterAcceptReads\\\":\\\"on\\\"}",
      "DBEndpointDescription": "test",
      "EndpointType": "Custom",
      "AutoAddNewNodes": "Enable",
      "DBClusterId": "pc-bp1s826a1up******",
      "SccMode": "on",
      "PolarSccTimeoutAction": "0",
      "PolarSccWaitTimeout": "100",
      "NodeWithRoles": "Reader1"
    }
  ]
}

错误码

HTTP status code

错误码

错误信息

描述

404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records. 当前的记录中不存在提供的DBClusterId。
404 InvalidDBClusterId.NotFound The DBClusterId provided does not exist in our records. 当前的记录中不存在提供的 DBClusterId。
404 InvalidDBClusterId.Malformed The specified parameter DBClusterId is not valid. 指定的参数DBClusterId无效

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

变更历史

更多信息,参考变更详情