milvus-logo
LFAI
< Docs
  • Node

listGrants()

This operation lists the privileges granted to the specified role.

listGrants(data): Promise<SelectGrantResponse>

Request Syntax

 milvusClient.listGrants({
   roleName: 'roleName',
 });

PARAMETERS:

  • roleName (string)

    The target role name

    Setting this to the name of a non-existing role may result in errors.

Returns Promise<SelectGrantResponse>

This method returns a promise that resolves to a SelectGrantResponse object.

{
    "entities": [
        {
            db_name: string,
            grantor: { privilege: { name: string }, user: { name: string } },
            object: { name: string },
            object_name: string,
            role: { name: string }
        }
    ],
    "status": ResStatus

PARAMETERS:

  • entities (GrantEntity[]) -

    A list of grant entities, each of which is shaped as follows:

    • db_name (string) -

      The name of the database in which the privilege has been granted.

    • grantor (Grantor) -

      A Grantor object that is shaped as follows:

      • privilege (PrivilegeEntity) -

        A PrivilegeEntity object that is shaped as follows:

        • name (string) -

          The name of the granted privilege.

      • user (User) -

        A User object that is shaped as follows:

        • name (string) -

          The name of the user that grants the above privilege to the role.

    • object (ObjectEntity) -

      An ObjectEntity object that is shaped as follows:

      • name (string) -

        The name of the object entity.

    • object_name (string) -

      The name of a specific object within the above object entity.

    • role (RoleEntity) -

      A RoleEntity object that is shaped as follows:

      • name (string) -

        The name of the role to which the privilege has been granted.

  • status (ResStatus) -

    A **ResStatus object.

    • code (number) -

      A code that indicates the operation result. It remains 0 if this operation succeeds.

    • error_code (string | number) -

      An error code that indicates an occurred error. It remains Success if this operation succeeds.

    • reason (string) -

      The reason that indicates the reason for the reported error. It remains an empty string if this operation succeeds.

Example

 milvusClient.listGrants({
   roleName: 'roleName',
 });

Try Managed Milvus for Free

Zilliz Cloud is hassle-free, powered by Milvus and 10x faster.

Get Started
Feedback

Was this page helpful?