j 6ddlmZd\ZZGddZdS)) connections)TFc eZdZdZddededdfdZdZed Zd Z d Z d efd Z d efdZ dZ dZddedededefdZddedededefdZddededefdZddefdZdS)RolezPRole, can be granted privileges which are allowed to execute some objects' apis.defaultnameusingreturnNc 0||_||_||_dS)z[Constructs a role by name :param name: role name. :type name: str N)_name_using_kwargs)selfrrkwargss [/lsinfo/ai/hellotax_ai/base_platform/venv/lib/python3.11/site-packages/pymilvus/orm/role.py__init__z Role.__init__s    c4tj|jSN)r_fetch_handlerr rs r_get_connectionzRole._get_connections)$+666rc|jSr)r rs rrz Role.name!s zrcZ||jS)aCreate a role It will success if the role isn't existed, otherwise fail. :example: >>> from pymilvus import connections, utility >>> from pymilvus.orm.role import Role >>> connections.connect() >>> role = Role(name=role_name) >>> role.create() >>> roles = utility.list_roles() >>> print(f"roles in Milvus: {roles}") )r create_roler rs rcreatez Role.create%s&##%%11$*===rcZ||jS)aDrop a role It will success if the role is existed, otherwise fail. :example: >>> from pymilvus import connections, utility >>> from pymilvus.orm.role import Role >>> connections.connect() >>> role = Role(name=role_name) >>> role.drop() >>> roles = utility.list_roles() >>> print(f"roles in Milvus: {roles}") )r drop_roler rs rdropz Role.drop4s&##%%// ;;;rusernamec\|||jS)aAdd user to role The user will get permissions that the role are allowed to perform operations. :param username: user name. :type username: str :example: >>> from pymilvus import connections >>> from pymilvus.orm.role import Role >>> connections.connect() >>> role = Role(name=role_name) >>> role.add_user(username) >>> users = role.get_users() >>> print(f"users added to the role: {users}") )radd_user_to_roler rrs radd_userz Role.add_userCs(##%%66xLLLrc\|||jS)aRemove user from role The user will remove permissions that the role are allowed to perform operations. :param username: user name. :type username: str :example: >>> from pymilvus import connections >>> from pymilvus.orm.role import Role >>> connections.connect() >>> role = Role(name=role_name) >>> role.remove_user(username) >>> users = role.get_users() >>> print(f"users added to the role: {users}") )rremove_user_from_roler r"s r remove_userzRole.remove_userTs(##%%;;HdjQQQrc||jt}t |jdkrgS|jdjS)aKGet all users who are added to the role. :return a RoleInfo object which contains a RoleItem group According to the RoleItem, you can get a list of usernames. RoleInfo groups: - UserItem: , :example: >>> from pymilvus import connections >>> from pymilvus.orm.role import Role >>> connections.connect() >>> role = Role(name=role_name) >>> users = role.get_users() >>> print(f"users added to the role: {users}") )rselect_one_roler INCLUDE_USER_INFOlengroupsusersrroless r get_userszRole.get_usersesQ $$&&66tzCTUU u|   ! !I|A$$rc||jt}t |jdkS)aCheck whether the role is existed. :return a bool value It will be True if the role is existed, otherwise False. :example: >>> from pymilvus import connections >>> from pymilvus.orm.role import Role >>> connections.connect() >>> role = Role(name=role_name) >>> is_exist = role.is_exist() >>> print(f"the role: {is_exist}") r()rr)r NOT_INCLUDE_USER_INFOr+r,r.s ris_existz Role.is_existzs=$$&&66tzCXYY5<  A%%robject object_name privilegedb_namecb||j||||S)arGrant a privilege for the role :param object: object type. :type object: str :param object_name: identifies a specific object name. :type object_name: str :param privilege: privilege name. :type privilege: str :param db_name: db name. :type db_name: str :example: >>> from pymilvus import connections >>> from pymilvus.orm.role import Role >>> connections.connect() >>> role = Role(role_name) >>> role.grant("Collection", collection_name, "Insert") )rgrant_privileger rr5r6r7r8s rgrantz Role.grants5$##%%55 J Y   rcb||j||||S)aRevoke a privilege for the role Args: object(str): object type. object_name(str): identifies a specific object name. privilege(str): privilege name. db_name(str): db name. Examples: >>> from pymilvus import connections >>> from pymilvus.orm.role import Role >>> connections.connect() >>> role = Role(role_name) >>> role.revoke("Collection", collection_name, "Insert") )rrevoke_privileger r;s rrevokez Role.revokes5##%%66 J Y   rc`||j|||S)a"List a grant info for the role and the specific object :param object: object type. :type object: str :param object_name: identifies a specific object name. :type object_name: str :param db_name: db name. :type db_name: str :return a GrantInfo object :rtype GrantInfo GrantInfo groups: - GrantItem: , , , , :example: >>> from pymilvus import connections >>> from pymilvus.orm.role import Role >>> connections.connect() >>> role = Role(role_name) >>> role.list_grant("Collection", collection_name) )r select_grant_for_role_and_objectr )rr5r6r8s r list_grantzRole.list_grants3,##%%FF J W   rc\||j|S)a<List a grant info for the role :param db_name: db name. :type db_name: str :return a GrantInfo object :rtype GrantInfo GrantInfo groups: - GrantItem: , , , , :example: >>> from pymilvus import connections >>> from pymilvus.orm.role import Role >>> connections.connect() >>> role = Role(role_name) >>> role.list_grants() )rselect_grant_for_one_roler )rr8s r list_grantszRole.list_grantss($##%%?? GTTTr)r)r4)__name__ __module__ __qualname____doc__strrrpropertyrrrr#r&r0r3r<r?rBrErrrrsZZSt777X > > > < < <MMMMM"RCRRRR"%%%*&&&   C c c C    ,  S s s S    &   3     4UU3UUUUUUrrN)rr*r2rrLrrrMsk%$$$$$+6((MUMUMUMUMUMUMUMUMUMUr