查询客户端接入认证配置修改历史
调试
您可以在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/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
}
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。