Skip to main content

CreateRole

This operation creates a new role for access control.

go
func (c *Client) CreateRole(ctx context.Context, opt CreateRoleOption, callOpts ...grpc.CallOption) error

Request Syntax​

Creates the request for CreateRole().

go
option := milvusclient.NewCreateRoleOption(roleName)

err := client.CreateRole(ctx, option)

PARAMETERS:

  • roleName (string) -

    [REQUIRED]

    The name of the role.

BUILDER METHODS:

  • NewCreateRoleOption(roleName)

    Creates the request for CreateRole().

RETURN TYPE:

error

RETURNS:

Returns nil on success, or an error describing what went wrong.

ERROR HANDLING:

  • error

    The operation fails. Check err != nil for failure details.

Example​

Demonstrates CreateRole() usage.

go
import (
"context"

"github.com/milvus-io/milvus/client/v3/milvusclient"
)

ctx, cancel := context.WithCancel(context.Background())
defer cancel()

cli, err := milvusclient.New(ctx, &milvusclient.ClientConfig{
Address: "YOUR_CLUSTER_ENDPOINT",
})
if err != nil {
// handle error
}
defer cli.Close(ctx)

err = cli.CreateRole(ctx, milvusclient.NewCreateRoleOption("my_role"))
if err != nil {
// handle error
}
Minimum SDK versionv3.0.x
Was this page helpful?