Privileges

Module pglift.privileges exposes the following API to manipulate access privileges:

async pglift.privileges.get(instance, *, databases=(), roles=(), defaults=False)

List access privileges for databases of an instance.

Parameters:
  • databases (Sequence[str]) – list of databases to inspect (all will be inspected if unspecified).

  • roles (Sequence[str]) – list of roles to restrict inspection on.

  • defaults (bool) – if True, get default privileges.

  • instance (PostgreSQLInstance)

Raises:

ValueError – if an element of databases or roles does not exist.

Return type:

list[DefaultPrivilege] | list[Privilege]