全部产品
Search
文档中心

云原生数据库 PolarDB:DescribeContextDBSecurityIps - 查看上下文服务白名单

更新时间:Sep 10, 2026

查询 ContextDB-X 白名单

接口说明

说明
  • PolarDB-X 2.0 SQL 审计与分析功能本身免费使用,但日志服务会对存储空间、读取流量、请求数量、数据加工、数据投递等进行收费,更多关于 SQL 审计功能的详情,请参见开启 SQL 审计与分析

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值

RegionId

string

地域 ID。

cn-hangzhou

DBInstanceName

string

实例 ID。

pxc-hzjasd****

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID。

D6A4256F-7B83-5BD7-9AC0-72E1FAC05330

Data

object

实例列表分页结果

DBInstanceName

string

实例名称

pxc-*********

ContextDBInstanceName

string

上下文服务实例名

pxt-*********

GroupItems

array<object>

白名单分组列表。

object

白名单分组列表。

GroupName

string

白名单分组名称。

defaultGroup

SecurityIPList

string

分组白名单详情。

127.0.0.1,172.168.0.0

GroupTag

string

分组标签

group1

AccessDeniedDetail

object

无权限访问详情

AuthAction

string

鉴权动作

xxx

AuthPrincipalType

string

说明如上。

222

AuthPrincipalOwnerId

string

鉴权主体 OwnerId

111

AuthPrincipalDisplayName

string

鉴权主体名称

xxx

PolicyType

string

策略类型

PRIORITY

NoPermissionType

string

NoPermissionType

ImplicitDeny

EncodedDiagnosticMessage

string

诊断信息

AQEAAAAAaKPfwjY0MzMyODRGLUZCQkQtNTA1RS04MUUxLTc5NTkzODk2MUIzMg==

示例

正常返回示例

JSON格式

{
  "RequestId": "D6A4256F-7B83-5BD7-9AC0-72E1FAC05330",
  "Data": {
    "DBInstanceName": "pxc-*********",
    "ContextDBInstanceName": "pxt-*********",
    "GroupItems": [
      {
        "GroupName": "defaultGroup",
        "SecurityIPList": "127.0.0.1,172.168.0.0",
        "GroupTag": "group1"
      }
    ]
  },
  "AccessDeniedDetail": {
    "AuthAction": "xxx",
    "AuthPrincipalType": "222",
    "AuthPrincipalOwnerId": "111",
    "AuthPrincipalDisplayName": "xxx",
    "PolicyType": "PRIORITY",
    "NoPermissionType": "ImplicitDeny",
    "EncodedDiagnosticMessage": "AQEAAAAAaKPfwjY0MzMyODRGLUZCQkQtNTA1RS04MUUxLTc5NTkzODk2MUIzMg=="
  }
}

错误码

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

变更历史

更多信息,参考变更详情