文档首页/ 云数据库 RDS/ API参考/ API v3（推荐）/ 管理数据库和用户（PostgreSQL）/ 查询实例的pg_hba.conf文件修改历史
更新时间：2024-08-09 GMT+08:00
查看PDF
分享

查询实例的pg_hba.conf文件修改历史

功能介绍

查询实例的pg_hba.conf文件修改历史。

调试

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

URI

  • URI格式

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

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    是

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

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

    instance_id

    是

    实例ID。
    表2 请求参数

    参数

    是否必选

    参数类型

    描述

    start_time

    否

    String

    开始时间，不传默认当天0点（UTC时区）。

    end_time

    否

    String

    结束时间，不传默认当前时间（UTC时区）。

请求消息

  • 请求参数

    无。

  • URI样例

    GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/e28979107ed04d3b8b2f1b819b8d2be3in03/hba-info/history?start_time=2023-08-01 00:00:00&end_time=2023-08-03 00:00:00

响应消息

  • 正常响应要素说明
    表3 要素说明

    参数

    参数类型

    描述

    数组元素

    Array of objects

    参数列表。

    详情请参见表4。
    表4 参数说明

    名称

    参数类型

    说明

    status

    String

    修改结果。

    • success：已生效
    • failed：未生效
    • setting：设置中

    time

    String

    修改时间。

    fail_reason

    String

    修改失败原因。

    before_confs

    Array of objects

    修改之前的值。

    详情请参见表5。

    after_confs

    Array of objects

    修改之后的值。

    详情请参见表6。
    表5 before_confs字段说明

    参数

    参数类型

    描述

    type

    String

    连接类型。枚举值：host、hostssl、hostnossl

    database

    String

    数据库名。除template0，template1的数据库名，多个以逗号隔开。

    user

    String

    除内置用户（rdsAdmin, rdsMetric, rdsBackup, rdsRepl, rdsProxy）以外的用户名。

    • 值为all：表示当前实例的所有数据库用户。
    • 值为具体的用户名，多个以逗号隔开。

    address

    String

    客户端IP地址。0.0.0.0/0表示允许用户从任意IP地址访问数据库。

    mask

    String

    掩码，默认为空字符串。

    method

    String

    认证方式。枚举值：reject、md5、scram-sha-256

    priority

    Integer

    优先级，表示配置的先后。
    表6 after_confs字段说明

    参数

    参数类型

    描述

    type

    String

    连接类型。枚举值：host、hostssl、hostnossl

    database

    String

    数据库名。除template0，template1的数据库名，多个以逗号隔开。

    user

    String

    除内置用户（rdsAdmin, rdsMetric, rdsBackup, rdsRepl, rdsProxy）以外的用户名。

    • 值为all：表示当前实例的所有数据库用户。
    • 值为具体的用户名，多个以逗号隔开。

    address

    String

    客户端IP地址。0.0.0.0/0表示允许用户从任意IP地址访问数据库。

    mask

    String

    掩码，默认为空字符串。

    method

    String

    认证方式。枚举值：reject、md5、scram-sha-256

    priority

    Integer

    优先级，表示配置的先后。
  • 正常响应样例 
    [ { 
   "status" : "success", 
   "time" : "2023-08-01 09:00:00", 
   "fail_reason" : "", 
   "before_confs" : [ { 
     "type" : "host", 
     "database" : "all", 
     "user" : "all", 
     "address" : "0.0.0.0/0", 
     "mask" : "", 
     "method" : "md5", 
     "priority" : 0 
   } ], 
   "after_confs" : [ { 
     "type" : "hostssl", 
     "database" : "all", 
     "user" : "all", 
     "address" : "0.0.0.0/0", 
     "mask" : "", 
     "method" : "md5", 
     "priority" : 0 
   } ] 
 } ]

状态码

错误码

请参见错误码。

相关文档