Skip to main content

list_grant()

This operation lists the relationship between the current role and the specified object.

Request Syntax

list_grant(
object: str,
object_name: str,
db_name: str
)

PARAMETERS:

  • object (str)

    [REQUIRED]

    The type of the object to grant the privilege.

    The value is case-sensitive. For details, refer to Users & Roles.

  • object_name (str)

    [REQUIRED]

    The name of a target object of the type specified in object.

    It can be a collection name, a user name, or a wild card (*).

  • db_name (str)

    The name of a database the object belongs to. If left unspecified, the default database applies.

RETURN TYPE:

GrantInfo

RETURNS:

A GrantInfo object that contains a list of GrantItem objects.

├── GrantInfo
│ └── groups
│ └── GrantItem
│ ├── object
│ ├── object_name
│ ├── role_name
│ ├── grantor_name
│ ├── privilege
│ └── db_name

A GrantItem object contains the following fields:

  • object (str)

    The type of the object to which the privilege belongs.

  • object_name (str)

    The name of the object to which the role is granted the specified privilege.

  • role_name (str)

    The name of the role to check.

  • grantor_name (str

    The name of the user who granted a specific role to a user.

  • privilege (str)

    The privilege that is granted to the role.

  • db_name (str)

    The name of the database in which this operation has been executed.

EXCEPTIONS:

  • MilvusException

    This exception will be raised when any error occurs during this operation.

Examples

from pymilvus import Role

# Get an existing role
role = Role(name="root")

# List the relationship between the current role and the specified object.
res = list_grant(
object="Collection",
object_name="test_collection",
db_name="test_db"
)

The following operations are related to get_replicas():