< Docs
  • Java


A MilvusClient interface. This method grants privileges to a role.

Note: Grants privileges to a role.
R<RpcStatus> grantRolePrivilege(GrantRolePrivilegeParam requestParam);


Use the GrantRolePrivilegeParam.Builder to construct a GrantRolePrivilegeParam object.

import io.milvus.param.GrantRolePrivilegeParam;
GrantRolePrivilegeParam.Builder builder = GrantRolePrivilegeParam.newBuilder();

Methods of GrantRolePrivilegeParam.Builder:

withRoleName(String roleName)Sets the role name.
The role name cannot be empty or null.
roleName: The role name.
withObject(String object)Sets the object.
The object cannot be empty or null.
object: A granted object in Milvus, such as collection, partition, and database.
withObjectName(String objectName)Sets the object name.
The object name cannot be empty or null.
objectName: The object name.
withPrivilege(String privilege)Sets the privilege.
The privilege cannot be empty or null.
privilege: A concrete permission for accessing some object.

For details on applicable objects and privileges, refer to Users and Roles.

The can throw the following exceptions:

  • ParamException: error if the parameter is invalid.


This method catches all the exceptions and returns an R object.

  • If the API fails on the server side, it returns an error code and an error message.
  • If the API fails due to RPC exceptions, it returns R.Status.Unknown and error message of the exception.
  • If the API succeeds, it returns R.Status.Success.


import io.milvus.param.GrantRolePrivilegeParam;

R<RpcStatus> response = client.grantRolePrivilege(GrantRolePrivilegeParam.newBuilder()

if (response.getStatus() != R.Status.Success.getCode()) {
    throw new RuntimeException(response.getMessage());