SetRLSPrincipalTagsAsync()

Upserts the RLS principal tags for a principal on a collection.

public async Task SetRLSPrincipalTagsAsync(SetRLSPrincipalTagsReq request, CancellationToken cancellationToken = default)

Request Syntax

var request = new SetRLSPrincipalTagsReq
{
    CollectionName = "my_collection",
    PrincipalName = "user1",
    Tags = new Dictionary<string, object?>
    {
        ["department"] = "engineering"
    }
};

await client.SetRLSPrincipalTagsAsync(request);

REQUEST PARAMETERS:

  • DatabaseName (string?) -

    An optional database name to operate on. When empty, the client’s currently selected database is used, matching the Java/C++ SDKs’ request-level database override.

  • CollectionName (string) -

    The name of the collection the principal tags belong to.

  • PrincipalName (string) -

    The name of the principal whose tags are upserted.

  • Tags (IDictionary) -

    The tag keys and values to upsert.

RETURN TYPE:

Task

RETURNS:

This method does not return a value.

EXCEPTIONS:

  • MilvusException

    Thrown when the RPC fails or the server returns an error. Inspect the exception message for details.

Example

using Milvus.Client.V2;
using Milvus.Client.V2.Requests.Rls;
using Milvus.Client.V2.Types;

using var client = new MilvusClientV2(new ConnectConfig
{
    Uri = "localhost:19530",
    Username = "root",
    Password = "Milvus"
});
await client.ConnectAsync();

await client.SetRLSPrincipalTagsAsync(new SetRLSPrincipalTagsReq
{
    CollectionName = "my_collection",
    PrincipalName = "user1",
    Tags =
    {
        ["department"] = "engineering"
    }
});

Try Managed Milvus for Free

Zilliz Cloud is hassle-free, powered by Milvus and 10x faster.

Get Started
Feedback

Was this page helpful?