查询客户端接入认证配置修改历史
调试
您可以在API Explorer中调试该接口。
URI
GET /v3/{project_id}/instances/{instance_id}/hba-info/history
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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 |
请求参数
无。
响应参数
参数 |
参数类型 |
描述 |
---|---|---|
hba_histories |
Array of objects |
参数解释: 列表中每个元素表示一次客户端接入认证修改历史记录,详情参见表3。 |
total_count |
Integer |
参数解释: 总记录数。 取值范围: [0, 2^31-1],取决于实际查询大小。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
参数解释: 客户端接入认证修改记录的ID。 取值范围: 不涉及。 |
status |
String |
参数解释: 客户端接入认证修改的状态。 取值范围:
|
fail_reason |
String |
参数解释: 客户端接入认证修改失败的原因。仅当修改失败时返回该参数。 取值范围: 不涉及。 |
time |
String |
参数解释: 修改时间。格式为“yyyy-mm-dd hh:mm:ss”。 取值范围: 不涉及。 |
before_confs |
Array of objects |
参数解释: 修改前的客户端接入认证配置信息。 每一条记录表示一条客户端接入认证配置,详情参见表4。 |
after_confs |
Array of objects |
参数解释: 修改后的客户端接入认证配置信息。 每一条记录表示一条客户端接入认证配置,详情参见表4。 |
参数 |
参数类型 |
描述 |
---|---|---|
type |
String |
参数解释: 客户端连接类型。 取值范围:
|
database |
String |
参数解释: 声明记录所匹配且允许访问的数据库,多租特性场景下该参数声明记录所匹配且允许访问的PDB。 取值范围:
|
user |
String |
参数解释: 声明记录所匹配且允许访问的数据库用户。 取值范围:
|
address |
String |
参数解释: 指定与记录匹配且允许访问的IP地址范围。 取值范围: 支持IPv4和IPv6,可以使用如下形式来表示: IP地址/掩码长度。例如,10.10.0.0/24、2001:250:250:250:250:250:250:175/128。 |
method |
String |
参数解释: 声明连接时使用的认证方法。 取值范围: 用户API支持如下几种认证方式:
|
请求示例
查询客户端接入认证配置修改历史。
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 }
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。