Modifica o arquivo pg_hba.conf de uma instância ApsaraDB RDS for PostgreSQL - : Central de Documentação do Alibaba Cloud

O ApsaraDB RDS for PostgreSQL permite modificar o arquivo pg_hba.conf de acordo com os requisitos do negócio. Para obter mais informações, consulte Introdução ao arquivo pg_hba.conf.

É possível modificar as informações do controlador de domínio Active Directory (AD) no arquivo pg_hba.conf de uma instância e, em seguida, conectá-la a um domínio AD autogerenciado. Para obter mais informações, consulte Conectar uma instância ApsaraDB RDS for PostgreSQL a um domínio AD autogerenciado.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para maior comodidade, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de requisição

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyPGHbaConfig	A operação a ser executada. Defina o valor como ModifyPGHbaConfig.
ClientToken	String	No	1	Este parâmetro está reservado. Não é necessário especificá-lo.
DBInstanceId	String	Yes	pgm-bp1lymyn1v3i****	O ID da instância. Chame a operação DescribeDBInstances para consultar os IDs das instâncias.
OpsType	String	Yes	add	O método usado para modificar o arquivo pg_hba.conf. Valores válidos: add: adiciona um ou mais registros. Ao usar este método, certifique-se de que o valor do parâmetro PriorityId de cada novo registro seja diferente do valor do parâmetro PriorityId de qualquer registro existente. delete: exclua um ou mais registros. Com este método, o registro correspondente ao valor especificado do parâmetro PriorityId é removido do arquivo pg_hba.conf. modify: modifique um ou mais registros. Com este método, o registro correspondente ao valor especificado do parâmetro PriorityId é alterado. update: atualize a configuração existente no arquivo pg_hba.conf pela nova configuração.
HbaItem.N.Type	String	Yes	host	O tipo de conexão do registro N. Valores válidos: host: o registro corresponde a conexões TCP/IP, incluindo conexões SSL e não SSL. hostssl: o registro corresponde apenas a conexões TCP/IP estabelecidas via SSL. hostnossl: o registro corresponde apenas a conexões TCP/IP não estabelecidas via SSL. Nota Este parâmetro pode ser definido como hostssl somente quando a criptografia SSL estiver ativada para a instância. Para obter mais informações, consulte Configurar criptografia SSL para uma instância ApsaraDB RDS for PostgreSQL.
HbaItem.N.Mask	String	No	0	A máscara do registro N. Quando o valor do parâmetro Address for um endereço IP, use este parâmetro para especificar a máscara desse endereço IP.
HbaItem.N.Database	String	Yes	all	O nome do banco de dados do registro N. Se este parâmetro for definido como all, os usuários especificados poderão acessar todos os bancos de dados da instância. Para especificar vários bancos de dados, separe os nomes com vírgulas (,).
HbaItem.N.PriorityId	Integer	Yes	2	A prioridade do registro N. Ao definir este parâmetro como 0, o registro recebe a prioridade mais alta. Valores válidos: 0 a 10000. Este parâmetro identifica cada registro individualmente. Ao adicionar um registro, o valor de PriorityId deve ser diferente do de qualquer registro existente. Ao modificar ou excluir um registro, o valor de PriorityId correspondente também deve ser modificado ou excluído.
HbaItem.N.Address	String	Yes	0.0.0.0/0	Os endereços IP a partir dos quais os usuários especificados podem acessar os bancos de dados especificados. Ao definir este parâmetro como 0.0.0.0/0, o acesso é permitido a partir de qualquer endereço IP.
HbaItem.N.User	String	Yes	ldapuser	O usuário com permissão para acessar os bancos de dados especificados. É obrigatório especifique o usuário utilizado para fazer login na instância RDS. Para vários usuários, separe os nomes de usuário com vírgulas (,).
HbaItem.N.Method	String	Yes	ldap	O método de autenticação. Valores válidos: trust reject scram-sha-256 md5 password gss sspi ldap radius cert pam
HbaItem.N.Option	String	No	ldapserver=Private IP address of the ECS instance ldapbasedn="CN=Users,DC=pgsqldomain,DC=net" ldapbinddn="CN=Username of the administrator user of the AD domain controller,CN=Users,DC=pgsqldomain,DC=net" ldapbindpasswd="Password of the administrator user of the AD domain controller" ldapsearchattribute="sAMAccountName"	Opcional. O valor deste parâmetro varia conforme o valor do parâmetro HbaItem.N.Method. Neste tópico, LDAP é usado como exemplo e a especificação deste parâmetro é obrigatória. Para obter mais informações, consulte Authentication Methods.

Parâmetros de resposta

Parameter	Type	Example	Description
RequestId	String	458E0781-C46C-55F5-A0E5-1DD284B28A3F	O ID da requisição.

Exemplos

Exemplos de requisição

http(s)://rds.aliyuncs.com/?Action=ModifyPGHbaConfig
&DBInstanceId=pgm-bp1lymyn1v3ifjyj
&OpsType=add
&HbaItem.1.Address=0.0.0.0/0
&HbaItem.1.Database=all
&HbaItem.1.Method=ldap
&HbaItem.1.PriorityId=2
&HbaItem.1.Type=host
&HbaItem.1.User=ldapuser
&HbaItem.1.Option=ldapserver=172.16.XX.XX ldapbasedn="CN=Users,DC=pgsqldomain,DC=net" ldapbinddn="CN=pgadmin,CN=Users,DC=pgsqldomain,DC=net" ldapbindpasswd="test_123456" ldapsearchattribute="sAMAccountName"

Descrição do exemplo de requisição

When you use an HTTPS request, you must encode the URL.

Exemplos de respostas bem-sucedidas

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyPGHbaConfigResponse>
    <RequestId>458E0781-C46C-55F5-A0E5-1DD284B28A3F</RequestId>
</ModifyPGHbaConfigResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "458E0781-C46C-55F5-A0E5-1DD284B28A3F"
}

Códigos de erro

HTTP status code	Error code	Error message	Description
400	MinorVersionNotSupport	The current database minor version does not support the operation.	A operação não é compatível com a versão secundária do mecanismo em execução na instância.
400	InvalidDBInstanceName.NotFound	The specified DB instance name does not exist.	O nome da instância especificado não foi encontrado.
400	IncorrectDBInstanceType	Current DB instance type does not support this operation.	Esta operação não é compatível com o tipo atual da instância de banco de dados.
403	IncorrectDBInstanceState	Current DB instance state does not support this operation.	Esta operação não é compatível com o estado atual da instância de banco de dados.
404	IncorrectDBInstanceLockMode	Current DB instance lock mode does not support this operation.	A instância está bloqueada.

Para obter a lista de códigos de erro, acesse o API Error Center.