Tous les produits
Search
Centre de documentation

:Modification du fichier pg_hba.conf d'une instance ApsaraDB RDS for PostgreSQL

Dernière mise à jour :Aug 08, 2026

Appelez l'opération ModifyPGHbaConfig pour modifier le fichier pg_hba.conf d'une instance ApsaraDB RDS for PostgreSQL.

ApsaraDB RDS for PostgreSQL vous permet de modifier le fichier pg_hba.conf selon vos besoins métier. Pour plus d'informations, consultez la documentation Présentation du fichier pg_hba.conf.

Modifiez les informations relatives au contrôleur de domaine Active Directory (AD) dans le fichier pg_hba.conf d'une instance pour connecter celle-ci à un domaine AD géré en interne. Pour plus d'informations, consultez la rubrique Connexion d'une instance ApsaraDB RDS for PostgreSQL à un domaine AD géré en interne.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération via OpenAPI Explorer pour plus de commodité. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

ParameterTypeRequiredExampleDescription
ActionStringYesModifyPGHbaConfig

Opération à exécuter. Définissez la valeur sur ModifyPGHbaConfig.

ClientTokenStringNo1

Paramètre réservé. Ne le spécifiez pas.

DBInstanceIdStringYespgm-bp1lymyn1v3i****

ID de l'instance. Appelez l'opération DescribeDBInstances pour récupérer les ID des instances.

OpsTypeStringYesadd

Méthode de modification du fichier pg_hba.conf. Valeurs possibles :

  • add : ajoute un ou plusieurs enregistrements. Veillez à ce que la valeur du paramètre PriorityId de chaque nouvel enregistrement diffère de celle de tout enregistrement existant.
  • delete : supprime un ou plusieurs enregistrements. Cette méthode supprime du fichier pg_hba.conf l'enregistrement correspondant à la valeur spécifiée du paramètre PriorityId.
  • modify : modifie un ou plusieurs enregistrements. Cette méthode modifie l'enregistrement correspondant à la valeur spécifiée du paramètre PriorityId.
  • update : remplace la configuration existante du fichier pg_hba.conf par la nouvelle configuration.
HbaItem.N.TypeStringYeshost

Type de connexion de l'enregistrement N.

Valeurs possibles :

  • host : l'enregistrement correspond aux connexions TCP/IP, y compris les connexions SSL et non SSL.
  • hostssl : l'enregistrement correspond uniquement aux connexions TCP/IP établies via SSL.
  • hostnossl : l'enregistrement correspond uniquement aux connexions TCP/IP qui ne sont pas établies via SSL.
    Remarque Définissez ce paramètre sur hostssl uniquement si le chiffrement SSL est activé pour l'instance. Pour plus d'informations, consultez la rubrique Configuration du chiffrement SSL pour une instance ApsaraDB RDS for PostgreSQL.
HbaItem.N.MaskStringNo0

Masque de l'enregistrement N. Si la valeur du paramètre Address est une adresse IP, utilisez ce paramètre pour spécifier le masque de cette adresse IP.

HbaItem.N.DatabaseStringYesall

Nom de la base de données pour l'enregistrement N. Si vous définissez ce paramètre sur all, les utilisateurs spécifiés peuvent accéder à toutes les bases de données de l'instance.

Pour spécifier plusieurs bases de données, séparez leurs noms par des virgules (,).

HbaItem.N.PriorityIdIntegerYes2

Priorité de l'enregistrement N. Une valeur de 0 attribue la priorité la plus élevée. Valeurs possibles : de 0 à 10000.

Ce paramètre identifie chaque enregistrement. Lors de l'ajout d'un enregistrement, la valeur du paramètre PriorityId doit différer de celle de tout enregistrement existant. Lors de la modification ou de la suppression d'un enregistrement, modifiez ou supprimez également la valeur du paramètre PriorityId associée à cet enregistrement.

HbaItem.N.AddressStringYes0.0.0.0/0

Adresses IP à partir desquelles les utilisateurs spécifiés peuvent accéder aux bases de données désignées. Si vous définissez ce paramètre sur 0.0.0.0/0, les utilisateurs spécifiés peuvent accéder aux bases de données désignées depuis toutes les adresses IP.

HbaItem.N.UserStringYesldapuser

Utilisateur autorisé à accéder aux bases de données spécifiées. Spécifiez l'utilisateur utilisé pour se connecter à l'instance RDS. Pour spécifier plusieurs utilisateurs, séparez leurs noms d'utilisateur par des virgules (,).

HbaItem.N.MethodStringYesldap

Méthode d'authentification. Valeurs possibles :

  • trust
  • reject
  • scram-sha-256
  • md5
  • password
  • gss
  • sspi
  • ldap
  • radius
  • cert
  • pam
HbaItem.N.OptionStringNoldapserver=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"

Facultatif. La valeur de ce paramètre varie selon celle du paramètre HbaItem.N.Method. Dans cette rubrique, LDAP est utilisé à titre d'exemple. Vous devez spécifier ce paramètre. Pour plus d'informations, consultez la documentation Méthodes d'authentification.

Paramètres de réponse

Parameter Type Example Description
RequestId String 458E0781-C46C-55F5-A0E5-1DD284B28A3F

ID de la requête.

Exemples

Exemple de requête

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"

Description de l'exemple de requête

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

Exemple de réponses réussies

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"
}

Codes d'erreur

HTTP status code Error code Error message Description
400 MinorVersionNotSupport The current database minor version does not support the operation. L'opération n'est pas prise en charge par la version mineure du moteur de base de données exécutée par l'instance.
400 InvalidDBInstanceName.NotFound The specified DB instance name does not exist. Le nom de l'instance spécifié est introuvable.
400 IncorrectDBInstanceType Current DB instance type does not support this operation. L'opération n'est pas prise en charge lorsque l'instance se trouve dans son état actuel.
403 IncorrectDBInstanceState Current DB instance state does not support this operation. L'opération n'est pas prise en charge lorsque l'instance se trouve dans son état actuel.
404 IncorrectDBInstanceLockMode Current DB instance lock mode does not support this operation. L'instance est verrouillée.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.