调用DescribeDBInstanceTopology接口获取实例拓扑信息。

调试

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

请求参数

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

系统规定参数。取值:DescribeDBInstanceTopology

RegionId String cn-hangzhou

实例所属的地域ID。

DBInstanceName String pxc-********

实例ID。

返回数据

名称 类型 示例值 描述
RequestId String C458B1E8-1683-3645-B154-6BA32080EEA

请求ID。

Data Object

数据结构体。

LogicInstanceTopology Object

拓扑信息。

DBInstanceName String pxc-sprcym7g7w****

实例名称。

DBInstanceCreateTime String 2021-10-21T10:30:45Z 04:00:00

实例创建时间。

MaintainStartTime String 04:00:00

运维开始时间。

MaintainEndTime String 05:00:00

运维结束时间。

LockReason String 欠费

锁定原因。

DBInstanceStatus Integer 8

实例状态。

LockMode Integer 0

锁定状态 :

  • 0:未锁定;
  • 1:锁定。
EngineVersion String 2.0

引擎版本,默认2.0。

DBInstanceStorage Integer 1

存储节点个数。

DBInstanceConnType String lvs

表示用lvs做负载均衡。

DBInstanceId String 304726047

实例ID。

Engine String polarx

引擎, 默认:polarx。

DBInstanceDescription String pxc-sprcym7g7wj7k

实例描述。

DBInstanceStatusDescription String TDE_MODIFYING

实例状态描述。

Items Array of Items

节点列表。

DBInstanceCreateTime String 2021-10-21T10:30:45Z

实例创建时间。

DBInstanceName String pxc-i-tk6t4z****

实例名称。

CharacterType String 节点角色

节点属性,取值如下:

  • polarx_cn:计算节点;
  • polarx_store:数据节点;
  • polarx_gms:GMS节点。
MaintainStartTime String 不展示

运维开始时间。

DiskSize Long 3145728

磁盘大小。

MaintainEndTime String 不展示

运维结束时间。

LockReason String 不展示

锁定原因。

DBInstanceStatus Integer 8

实例状态。

LockMode Integer 0

是否锁定,取值如下:

  • 0:未锁定;
  • 1:锁定。
EngineVersion String 5.7

引擎版本,默认2.0。

DBInstanceConnType Integer 不展示

连接类型。

MaxConnections Integer 4000

最大连接数。

DBInstanceId String 304726049

实例ID。

Engine String mysql

引擎版本,取值如下:

  • mysql
  • polarx_cdc
  • polarx_dn
MaxIops Integer 7000

最大Iops。

DBInstanceDescription String 不展示

实例描述。

DBInstanceStatusDescription String 不展示

实例状态描述。

ConnectionIp Array of ConnectionIp

数据结构体。

Port String 3306

端口。

DBInstanceNetType Integer 1

内部连接的方式,固定取值为1,表示经典网络。

ConnectionString String pxc-xdb-m-pxcdym7g7w********.mysql.singapore.rds.aliyuncs.com

连接信息。

Region String cn-hangzhou

节点所属地域,如果为RDS节点,多个子节点的地域以 ';' 分割。

Azone String cn-hangzhou-a

节点所属可用区,如果为RDS节点,多个子节点的可用区以';'分割。

Role String master

节点角色,取值如下:

  • master:主节点
  • standby:备节点
Activated Boolean true

节点是否启用,计算层仅启用主可用区节点,在实例执行主备切换后计算层备用节点会切换为主节点,所有存储层节点均启用。

AzoneRoleList Array of aoneRoleMap

RDS三节点的数据信息列表。

Azone String cn-hangzhou-a

RDS三节点中某个节点所属可用区。

Role String leader

RDS三节点中某个节点的角色,取值如下:

  • leader:主节点
  • follower:从节点
  • logger:日志节点

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeDBInstanceTopology
&RegionId=cn-hangzhou
&DBInstanceName=pxc-********
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDBInstanceTopologyResponse>
    <RequestId>C458B1E8-1683-3645-B154-6BA32080EEA</RequestId>
    <Data>
        <LogicInstanceTopology>
            <DBInstanceName>pxc-sprcym7g7w****</DBInstanceName>
            <DBInstanceCreateTime>2021-10-21T10:30:45Z 04:00:00</DBInstanceCreateTime>
            <MaintainStartTime>04:00:00</MaintainStartTime>
            <MaintainEndTime>05:00:00</MaintainEndTime>
            <LockReason>欠费</LockReason>
            <DBInstanceStatus>8</DBInstanceStatus>
            <LockMode>0</LockMode>
            <EngineVersion>2.0</EngineVersion>
            <DBInstanceStorage>1</DBInstanceStorage>
            <DBInstanceConnType>lvs</DBInstanceConnType>
            <DBInstanceId>304726047</DBInstanceId>
            <Engine>polarx</Engine>
            <DBInstanceDescription>pxc-sprcym7g7wj7k</DBInstanceDescription>
            <DBInstanceStatusDescription>TDE_MODIFYING</DBInstanceStatusDescription>
            <Items>
                <DBInstanceCreateTime>2021-10-21T10:30:45Z</DBInstanceCreateTime>
                <DBInstanceName>pxc-i-tk6t4zfn2m</DBInstanceName>
                <CharacterType>节点角色</CharacterType>
                <MaintainStartTime>不展示</MaintainStartTime>
                <DiskSize>3145728</DiskSize>
                <MaintainEndTime>不展示</MaintainEndTime>
                <LockReason>不展示</LockReason>
                <DBInstanceStatus>8</DBInstanceStatus>
                <LockMode>0</LockMode>
                <EngineVersion>5.7</EngineVersion>
                <MaxConnections>4000</MaxConnections>
                <DBInstanceId>304726049</DBInstanceId>
                <Engine>mysql</Engine>
                <MaxIops>7000</MaxIops>
                <DBInstanceDescription>不展示</DBInstanceDescription>
                <DBInstanceStatusDescription>不展示</DBInstanceStatusDescription>
                <ConnectionIp>
                    <Port>3306</Port>
                    <DBInstanceNetType>1</DBInstanceNetType>
                    <ConnectionString>pxc-xdb-m-pxcdym7g7wj7kv5dea.mysql.singapore.rds.aliyuncs.com</ConnectionString>
                </ConnectionIp>
                <Region>cn-hangzhou</Region>
                <Azone>cn-hangzhou-a</Azone>
                <Role>master</Role>
                <Activated>true</Activated>
                <AzoneRoleList>
                    <Azone>cn-hangzhou-a</Azone>
                    <Role>leader</Role>
                </AzoneRoleList>
            </Items>
        </LogicInstanceTopology>
    </Data>
</DescribeDBInstanceTopologyResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "C458B1E8-1683-3645-B154-6BA32080EEA",
  "Data" : {
    "LogicInstanceTopology" : {
      "DBInstanceName" : "pxc-sprcym7g7w****",
      "DBInstanceCreateTime" : "2021-10-21T10:30:45Z 04:00:00",
      "MaintainStartTime" : "04:00:00",
      "MaintainEndTime" : "05:00:00",
      "LockReason" : "欠费",
      "DBInstanceStatus" : 8,
      "LockMode" : 0,
      "EngineVersion" : "2.0",
      "DBInstanceStorage" : 1,
      "DBInstanceConnType" : "lvs",
      "DBInstanceId" : "304726047",
      "Engine" : "polarx",
      "DBInstanceDescription" : "pxc-sprcym7g7wj7k",
      "DBInstanceStatusDescription" : "TDE_MODIFYING",
      "Items" : [ {
        "DBInstanceCreateTime" : "2021-10-21T10:30:45Z",
        "DBInstanceName" : "pxc-i-tk6t4zfn2m",
        "CharacterType" : "节点角色",
        "MaintainStartTime" : "不展示",
        "DiskSize" : 3145728,
        "MaintainEndTime" : "不展示",
        "LockReason" : "不展示",
        "DBInstanceStatus" : 8,
        "LockMode" : 0,
        "EngineVersion" : "5.7",
        "MaxConnections" : 4000,
        "DBInstanceId" : "304726049",
        "Engine" : "mysql",
        "MaxIops" : 7000,
        "DBInstanceDescription" : "不展示",
        "DBInstanceStatusDescription" : "不展示",
        "ConnectionIp" : [ {
          "Port" : "3306",
          "DBInstanceNetType" : 1,
          "ConnectionString" : "pxc-xdb-m-pxcdym7g7wj7kv5dea.mysql.singapore.rds.aliyuncs.com"
        } ],
        "Region" : "cn-hangzhou",
        "Azone" : "cn-hangzhou-a",
        "Role" : "master",
        "Activated" : true,
        "AzoneRoleList" : [ {
          "Azone" : "cn-hangzhou-a",
          "Role" : "leader"
        } ]
      } ]
    }
  }
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidDBInstance.NotFound The specified DB instance does not exist. 数据库实例不存在

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