DropRole()
Addedv2.6.x
This operation drops a role from the system.
func (c *Client) DropRole(ctx context.Context, opt DropRoleOption, callOpts ...grpc.CallOption) error
Request Syntax
option := milvusclient.NewDropRoleOption("my_role").
WithForce(true)
err := cli.DropRole(ctx, option)
PARAMETERS:
-
opt (DropRoleOption) -
The options for dropping the role.
BUILDER METHODS:
-
WithForce(force bool)This forces the drop operation, removing the role even if it is assigned to users or has privileges granted.
RETURN TYPE:
error
RETURNS:
Returns nil on success, or an error describing what went wrong.
EXCEPTIONS:
-
error
Check err != nil for failure details.
Example
import (
"context"
"log"
"github.com/milvus-io/milvus/client/v2/milvusclient"
)
ctx, cancel := context.WithCancel(context.Background())
defer cancel()
cli, err := milvusclient.New(ctx, &milvusclient.ClientConfig{
Address: "YOUR_CLUSTER_ENDPOINT",
})
if err != nil {
log.Fatal("failed to connect to milvus server: ", err.Error())
}
defer cli.Close(ctx)
// Drop a role normally
err = cli.DropRole(ctx, milvusclient.NewDropRoleOption("my_role"))
if err != nil {
log.Fatal("failed to drop role: ", err.Error())
}
// Force drop a role that is still assigned
err = cli.DropRole(ctx, milvusclient.NewDropRoleOption("my_role").WithForce(true))
if err != nil {
log.Fatal("failed to force drop role: ", err.Error())
}