文档首页/ 云数据库 GaussDB/ API参考/ API(推荐)/ 管理数据库和用户/ 查询客户端接入认证配置修改历史
更新时间:2025-09-11 GMT+08:00
分享

查询客户端接入认证配置修改历史

功能介绍

查询实例的客户端接入认证配置修改历史。

调试

您可以在API Explorer中调试该接口。

URI

GET /v3/{project_id}/instances/{instance_id}/hba-info/history

表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

参数解释:

租户在某一Region下的项目ID。

获取方法请参见获取项目ID

约束限制:

不涉及。

取值范围:

只能由英文字母、数字组成,且长度为32个字符。

默认取值

不涉及。

instance_id

String

参数解释:

实例ID。实例的唯一标识。

约束限制:

不涉及。

取值范围:

只能由英文字母、数字组成,且长度为36个字符。

默认取值

不涉及。

start_time

String

参数解释:

查询区间开始时间。格式为“yyyy-mm-dd hh:mm:ss”。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值

不涉及。

end_time

String

参数解释:

查询区间结束时间。格式为“yyyy-mm-dd hh:mm:ss”。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值

不涉及。

offset

Integer

参数解释:

分页符。从第一条数据偏移offset页数据后开始查询。例如,该参数指定为1,limit指定为10,则只展示第11-20条数据。

约束限制:

不涉及。

取值范围:

[0, 2^31-1]

默认取值

默认为0(偏移0条数据,表示从第一条数据开始查询)。

limit

Integer

参数解释:

每页显示的条目数量。

约束限制:

不涉及。

取值范围:

[1, 100]

默认取值

10

请求参数

无。

响应参数

表2 参数说明

参数

参数类型

描述

hba_histories

Array of objects

参数解释:

列表中每个元素表示一次客户端接入认证修改历史记录,详情参见表3

total_count

Integer

参数解释:

总记录数。

取值范围:

[0, 2^31-1],取决于实际查询大小。

表3 hba_histories字段数据结构说明

参数

参数类型

描述

id

String

参数解释:

客户端接入认证修改记录的ID。

取值范围:

不涉及。

status

String

参数解释:

客户端接入认证修改的状态。

取值范围:

  • success:修改成功。
  • failed:修改失败。

fail_reason

String

参数解释:

客户端接入认证修改失败的原因。仅当修改失败时返回该参数。

取值范围:

不涉及。

time

String

参数解释:

修改时间。格式为“yyyy-mm-dd hh:mm:ss”。

取值范围:

不涉及。

before_confs

Array of objects

参数解释:

修改前的客户端接入认证配置信息。

每一条记录表示一条客户端接入认证配置,详情参见表4

after_confs

Array of objects

参数解释:

修改后的客户端接入认证配置信息。

每一条记录表示一条客户端接入认证配置,详情参见表4

表4 hba_confs字段数据结构说明

参数

参数类型

描述

type

String

参数解释:

客户端连接类型。

取值范围:

  • host:表示这条记录既接受一个普通的TCP/IP套接字连接,也接受一个经过SSL加密的TCP/IP套接字连接。
  • hostssl:表示这条记录只接受一个经过SSL加密的TCP/IP套接字连接。
  • hostnossl:表示这条记录只接受一个普通的TCP/IP套接字连接。

database

String

参数解释:

声明记录所匹配且允许访问的数据库,多租特性场景下该参数声明记录所匹配且允许访问的PDB。

取值范围:

  • all:表示该记录匹配所有数据库。
  • 特定的数据库名称或者用逗号分隔的数据库列表。
    说明:
    • 值replication表示如果请求一个复制连接,则匹配,但复制连接不表示任何特定的数据库。如需使用名为replication的数据库,需在database列使用记录“replication”作为数据库名。
    • 多租数据库下,值replication_pdb1表示如果请求一个名为pdb1数据库的复制连接,则匹配成功。值replication方式只生效Non-PDB。
    • PDB复制连接生效配置方式为replication_[pdbname],pdbname为用户创建PDB数据库时候的名字。
    • 如需使用名为replication_pdb1的数据库,需在database列使用记录“replication_pdb1”作为数据库名。

user

String

参数解释:

声明记录所匹配且允许访问的数据库用户。

取值范围:

  • all:表明该记录匹配所有用户。
  • 特定的数据库用户名或者用逗号分隔的用户列表。

address

String

参数解释:

指定与记录匹配且允许访问的IP地址范围。

取值范围:

支持IPv4和IPv6,可以使用如下形式来表示:

IP地址/掩码长度。例如,10.10.0.0/24、2001:250:250:250:250:250:250:175/128

method

String

参数解释:

声明连接时使用的认证方法。

取值范围:

用户API支持如下几种认证方式:

  • reject:无条件地拒绝连接。常用于过滤某些主机。
  • md5:MD5加密算法安全性低,存在安全风险,不推荐使用,建议使用更安全的加密算法。默认不支持,可通过password_encryption_type参数配置。
  • sha256:要求客户端提供一个sha256算法加密的口令进行认证,该口令在传送过程中结合salt(服务器发送给客户端的随机数)的单向sha256加密,增强了安全性。
  • sm3:要求客户端提供一个sm3算法加密口令进行认证,该口令在传送过程中结合salt(服务器发送给客户端的随机数)的单向sm3加密,增加了安全性。
  • cert:客户端证书认证模式,此模式需进行SSL连接配置且需要客户端提供有效的SSL证书,不需要提供用户密码。cert认证方式只支持hostssl类型的规则。

请求示例

查询客户端接入认证配置修改历史。

GET https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3.1/054b61972980d4552f0bc00ac8d3f5cd/instances/{instance_id}/hba-info/history
/history

响应示例

查询客户端客户端接入认证配置修改历史成功。

{
    "hba_histories": [
        {
            "id": "08508b98-2f1d-4f7a-bfbc-d990f69996a1",
            "status": "success",
            "time": "2025-06-13 01:51:44",
            "fail_reason": null,
            "before_confs": [
                {
                    "type": "host",
                    "database": "all",
                    "user": "all",
                    "address": "0.0.0.0/0",
                    "method": "sha256"
                }
            ],
            "after_confs": [
                {
                    "type": "host",
                    "database": "all",
                    "user": "root",
                    "address": "0.0.1.1/24",
                    "method": "sha256"
                },
                {
                    "type": "host",
                    "database": "all",
                    "user": "all",
                    "address": "0.0.0.0/0",
                    "method": "sha256"
                }
            ]
        }
    "total_count": 1
}

状态码

错误码

请参见错误码

相关文档