All Products
Search
Document Center

PolarDB:DescribeContextDBInfo

Last Updated:Sep 10, 2026

Queries the information of a ContextDB-X instance.

Operation description

Note
  • The SQL audit and analysis feature of PolarDB-X 2.0 is free of charge. However, Simple Log Service charges fees for storage space, read traffic, number of requests, data transformation, and data shipping. For more information about the SQL audit feature, see Enable SQL audit and analysis.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

Yes

The region ID.

cn-hangzhou

DBInstanceName

string

Yes

The instance name.

pxc-********

Response elements

Element

Type

Description

Example

object

RequestId

string

Id of the request

1A586DCB-39A6-4050-81CC-C7BD4CCDB49F

Data

object

The instance data.

Instance

object

The instance information.

InstanceId

string

pxc-spsil01pww4hfz-mem

RegionId

string

ap-southeast-1

ZoneId

string

ap-southeast-1a

ClassCode

string

mysql.x2.large.2c

NodeCount

integer

1

CreateTime

string

2026-02-17T02:00:20Z

Status

string

Running

StorageType

string

local_ssd

VPCId

string

vpc-t4n4hf9xey7ea3lp4bwwx

VSwitchId

string

vsw-t4ny14pr37spmjsbv5dc2

OpenSearchInstanceName

string

pxs-********

ConnAddrs

array<object>

object

NodeType

string

service

Type

string

VPC

VPCId

string

vpc-t4n4hf9xey7ea3lp4bwwx

VSwitchId

string

vsw-t4ny14pr37spmjsbv5dc2

Port

integer

3306

VpcInstanceId

string

pxc-spsil01pww4hfzjayd-cn-20251013180429

ConnectionString

string

pxc-spsil01pww4hfz.polarx.singapore.rds.aliyuncs.com

ReplicaSets

array<object>

array<object>

NodeType

string

service

InstanceId

string

pxc-hzrbqgiocrpu8a

ZoneId

string

cn-beijing-i

ClassCode

string

pg.x2.13large.2c

NodeCount

integer

1

CreateTime

string

2026-07-28T02:01:13Z

Status

string

enabled

StorageType

string

cloud_essd

ConnAddrs

array<object>

object

NodeType

string

service

Type

string

RemoveHeader

VPCId

string

vpc-bp1550umsomy2mw24vhwl

VSwitchId

string

vsw-2zedp17pfss1133bvdizl

Port

integer

3306

VpcInstanceId

string

vpc-8vbdw66evguopfcfvieoi

ConnectionString

string

pxc-hzrlz8e3khuaoz.polarx.rds.aliyuncs.com

DBInstanceName

string

pxc-hzr9qzafkeury3

AccessDeniedDetail

object

The details of the access denial.

AuthAction

string

The authentication action.

xxx

AuthPrincipalType

string

The authentication principal type.

222

AuthPrincipalOwnerId

string

The owner ID of the authentication principal.

111

AuthPrincipalDisplayName

string

The display name of the authentication principal.

xxx

PolicyType

string

The policy type.

PRIORITY

NoPermissionType

string

The type of missing permission.

ImplicitDeny

EncodedDiagnosticMessage

string

The diagnostic information.

AQEAAAAAaKPfwjY0MzMyODRGLUZCQkQtNTA1RS04MUUxLTc5NTkzODk2MUIzMg==

Examples

Success response

JSON format

{
  "RequestId": "1A586DCB-39A6-4050-81CC-C7BD4CCDB49F",
  "Data": {
    "Instance": {
      "InstanceId": "pxc-spsil01pww4hfz-mem",
      "RegionId": "ap-southeast-1",
      "ZoneId": "ap-southeast-1a",
      "ClassCode": "mysql.x2.large.2c",
      "NodeCount": 1,
      "CreateTime": "2026-02-17T02:00:20Z",
      "Status": "Running",
      "StorageType": "local_ssd",
      "VPCId": "vpc-t4n4hf9xey7ea3lp4bwwx",
      "VSwitchId": "vsw-t4ny14pr37spmjsbv5dc2",
      "OpenSearchInstanceName": "pxs-********",
      "ConnAddrs": [
        {
          "NodeType": "service",
          "Type": "VPC",
          "VPCId": "vpc-t4n4hf9xey7ea3lp4bwwx",
          "VSwitchId": "vsw-t4ny14pr37spmjsbv5dc2",
          "Port": 3306,
          "VpcInstanceId": "pxc-spsil01pww4hfzjayd-cn-20251013180429",
          "ConnectionString": "pxc-spsil01pww4hfz.polarx.singapore.rds.aliyuncs.com"
        }
      ],
      "ReplicaSets": [
        {
          "NodeType": "service",
          "InstanceId": "pxc-hzrbqgiocrpu8a",
          "ZoneId": "cn-beijing-i",
          "ClassCode": "pg.x2.13large.2c",
          "NodeCount": 1,
          "CreateTime": "2026-07-28T02:01:13Z",
          "Status": "enabled",
          "StorageType": "cloud_essd",
          "ConnAddrs": [
            {
              "NodeType": "service",
              "Type": "RemoveHeader",
              "VPCId": "vpc-bp1550umsomy2mw24vhwl",
              "VSwitchId": "vsw-2zedp17pfss1133bvdizl",
              "Port": 3306,
              "VpcInstanceId": "vpc-8vbdw66evguopfcfvieoi",
              "ConnectionString": "pxc-hzrlz8e3khuaoz.polarx.rds.aliyuncs.com"
            }
          ]
        }
      ],
      "DBInstanceName": "pxc-hzr9qzafkeury3"
    }
  },
  "AccessDeniedDetail": {
    "AuthAction": "xxx",
    "AuthPrincipalType": "222",
    "AuthPrincipalOwnerId": "111",
    "AuthPrincipalDisplayName": "xxx",
    "PolicyType": "PRIORITY",
    "NoPermissionType": "ImplicitDeny",
    "EncodedDiagnosticMessage": "AQEAAAAAaKPfwjY0MzMyODRGLUZCQkQtNTA1RS04MUUxLTc5NTkzODk2MUIzMg=="
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.