跳到主要内容

list_grant()

Near Deprecation

此操作列出当前角色与指定对象之间的关系。

请求语法​

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

参数:

  • object (str)

    【必填】

    要授予权限的对象类型。

    该值区分大小写。详情请参见 Users & Roles。

  • object_name (str)

    【必填】

    object 中指定类型的目标对象名称。

    可以是 Collection 名称、用户名或通配符(*)。

  • db_name (str)

    对象所属 Database 的名称。如果未指定,则使用默认 Database。

返回类型:

GrantInfo

返回值:

一个 GrantInfo 对象,其中包含 GrantItem 对象列表。

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

GrantItem 对象包含以下字段:

  • object (str)

    权限所属对象的类型。

  • object_name (str)

    被授予指定权限的角色所对应对象的名称。

  • role_name (str)

    要检查的角色名称。

  • grantor_name (str)

    向用户授予特定角色的用户名称。

  • privilege (str)

    授予该角色的权限。

  • db_name (str)

    执行此操作所在 Database 的名称。

异常:

  • MilvusException

    当此操作期间发生任何错误时,将引发此异常。

示例​

python
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"
)

以下操作与 get_replicas() 相关:

最低 SDK 版本Inherit