create_role()

Adds optional role description. Async variant shares the sync method parameter and response contract.

Request Syntax

Python

create_role(
    role_name: str,
    timeout: Optional[float] = None,
    description: str = "",
    **kwargs,
) -> None

PARAMETERS:

• role_name (str) - [REQUIRED] The name of the role to create.

• timeout (Optional[float]) - Default: None The maximum time, in seconds, to wait for the RPC to complete.

• description (str) - Default: "" The optional description of the role.

• kwargs (Any) - The additional request context options.

RETURN TYPE:

None

RETURNS:

Returns no value after the role is created successfully.

EXCEPTIONS:

• MilvusException Raised when the server rejects the request or the RPC fails. Inspect the server error message for exact failure details.

Examples

Demonstrates create role usage.

Python

from pymilvus import MilvusClient

client = MilvusClient(uri="http://localhost:19530", token="root:Milvus")
client.create_user("analyst", "Milvus123", description="Analytics account")
client.update_user("analyst", description="Updated analytics account")
client.create_role("read_only", description="Read-only role")
client.alter_role("read_only", description="Updated read-only role")
print(client.describe_user("analyst"))
print(client.describe_role("read_only"))