新增客户端接入认证配置
约束限制
客户端接入认证暂时不支持容灾关系内同步,如果实例已搭建容灾关系,建议在对端也进行相同的配置操作。
调试
您可以在API Explorer中调试该接口。
URI
POST /v3/{project_id}/instances/{instance_id}/hba-info
名称 |
是否必选 |
说明 |
---|---|---|
project_id |
是 |
参数解释: 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为32个字符。 默认取值: 不涉及。 |
instance_id |
是 |
参数解释: 实例ID,此参数是用户创建实例的唯一标识。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为36个字符。 默认取值: 不涉及。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
X-Language |
否 |
String |
参数解释: 语言。 约束限制: 不涉及。 取值范围:
默认取值: en-us |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
hba_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支持如下几种认证方式:
默认取值: 不涉及。 |
响应参数
无。
请求示例
新增客户端接入认证配置。
POST https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3.1/054b61972980d4552f0bc00ac8d3f5cd/instances/{instance_id}/hba-info { "hba_confs":[ { "type":"host", "database":"all", "user":"root", "address":"0.0.1.1/24", "method":"sha256" } ] }
响应示例
无。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。