クラスターユーザーの管理（SDK）

Zilliz Cloud では、クラスターユーザーを作成してクラスターロールを割り当て、権限を定義することでデータセキュリティを確保できます。

このガイドでは、クラスターユーザーの作成、ユーザーへのロール付与、ユーザーからのロール取り消し、およびユーザー削除の手順を説明します。クラスターロールの詳細については、クラスターロールの管理（コンソール）を参照してください。

ユーザーの作成

次の例では、ユーザー名 user_1、パスワード P@ssw0rd のユーザーを作成する方法を示します。ユーザー名とパスワードは、以下の規則に従う必要があります。

ユーザー名: 先頭は英字で、使用できるのは大文字・小文字の英字、数字、アンダースコアのみです。
パスワード: 8〜64文字で、大文字、小文字、数字、特殊文字のうち3種類以上を含む必要があります。
（任意）説明: 最大1024バイト（UTF-8）まで指定できます。

Python
Java
NodeJS
cURL

python
from pymilvus import MilvusClient

client = MilvusClient(
    uri="YOUR_CLUSTER_ENDPOINT",
    token="YOUR_CLUSTER_TOKEN"
)

client.create_user(user_name="user_1", password="P@ssw0rd", description="a new user in the developers team")

java
import io.milvus.v2.client.ConnectConfig;
import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.service.rbac.request.CreateUserReq;

ConnectConfig connectConfig = ConnectConfig.builder()
        .uri("YOUR_CLUSTER_ENDPOINT")
        .token("YOUR_CLUSTER_TOKEN")
        .build();

MilvusClientV2 client = new MilvusClientV2(connectConfig);

CreateUserReq createUserReq = CreateUserReq.builder()
        .userName("user_1")
        .password("P@ssw0rd")
        .description("a new user in the developers team")
        .build();

client.createUser(createUserReq);

javascript
const { MilvusClient, DataType } = require("@zilliz/milvus2-sdk-node")

const address = "YOUR_CLUSTER_ENDPOINT";
const token = "YOUR_CLUSTER_TOKEN";
const client = new MilvusClient({address, token});

await milvusClient.createUser({
   username: 'user_1',
   password: 'P@ssw0rd',
 });

bash
export CLUSTER_ENDPOINT="YOUR_CLUSTER_ENDPOINT"
export TOKEN="YOUR_CLUSTER_TOKEN"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/users/create" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "userName": "user_1",
    "password": "P@ssw0rd"
    "description": "a new user in the developers team"
}'

ユーザーの一覧表示

複数のユーザーを作成した後は、既存のすべてのユーザーを一覧表示して確認できます。

Python
Java
NodeJS
cURL

python
from pymilvus import MilvusClient

client.list_users()

java

List<String> resp = client.listUsers();

javascript
const { MilvusClient, DataType } = require("@zilliz/milvus2-sdk-node")

await milvusClient.listUsers();

bash
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/users/list" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{}'

以下は出力例です。root は自動生成されるデフォルトユーザー、user_1 は新たに作成されたユーザーです。

bash

['root', 'user_1']

ユーザーへのロール付与

次の例では、ユーザー user_1 にロール role_a を付与する方法を示します。

Python
Java
NodeJS
cURL

python
from pymilvus import MilvusClient

client = MilvusClient(
    uri="YOUR_CLUSTER_ENDPOINT",
    token="YOUR_CLUSTER_TOKEN"
)

client.grant_role(user_name="user_1", role_name="role_a")

java
import io.milvus.v2.client.ConnectConfig;
import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.service.rbac.request.GrantRoleReq;

String CLUSTER_ENDPOINT = "YOUR_CLUSTER_ENDPOINT";
String TOKEN = "YOUR_CLUSTER_TOKEN";

ConnectConfig connectConfig = ConnectConfig.builder()
    .uri(CLUSTER_ENDPOINT)
    .token(TOKEN)
    .build();

MilvusClientV2 client = new MilvusClientV2(connectConfig);

GrantRoleReq grantRoleReq = GrantRoleReq.builder()
        .roleName("role_a")
        .userName("user_1")
        .build();
client.grantRole(grantRoleReq);

javascript
const { MilvusClient, DataType } = require("@zilliz/milvus2-sdk-node")

const address = "YOUR_CLUSTER_ENDPOINT";
const token = "YOUR_CLUSTER_TOKEN";
const client = new MilvusClient({address, token});

milvusClient.grantRole({
   username: 'user_1',
   roleName: 'role_a'
 })

bash
export CLUSTER_ENDPOINT="YOUR_CLUSTER_ENDPOINT"
export TOKEN="YOUR_CLUSTER_TOKEN"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/users/grant_role" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "roleName": "role_a",
    "userName": "user_1"
}'

ユーザー情報の確認

ロール付与後、describe_user() メソッドを使って操作が成功したかを確認できます。

次の例では、ユーザー user_1 に割り当てられているロールを確認する方法を示します。

Python
Java
NodeJS
cURL

python
from pymilvus import MilvusClient

client.describe_user(user_name="user_1")

java
import io.milvus.v2.service.rbac.request.DescribeUserReq;
import io.milvus.v2.service.rbac.response.DescribeUserResp;

DescribeUserReq describeUserReq = DescribeUserReq.builder()
        .userName("user_1")
        .build();
DescribeUserResp describeUserResp = client.describeUser(describeUserReq);

javascript
const { MilvusClient, DataType } = require("@zilliz/milvus2-sdk-node")

milvusClient.describeUser({username: 'user_1'})

bash
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/users/describe" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "userName": "user_1"
}'

以下は出力例です。

bash

{'user_name': 'user_1', 'description':'a new user in the developers team', 'roles': 'role_a'}

ロールの取り消し

ユーザーに割り当てたロールを取り消すこともできます。

次の例では、ユーザー user_1 からロール role_a を取り消す方法を示します。

Python
Java
NodeJS
cURL

python
from pymilvus import MilvusClient

client.revoke_role(
    user_name='user_1',
    role_name='role_a'
)

java
import io.milvus.v2.service.rbac.request.RevokeRoleReq;

client.revokeRole(RevokeRoleReq.builder()
        .userName("user_1")
        .roleName("role_a")
        .build());

javascript
await client.revokeRole({
    username: 'user_1',
    roleName: 'role_a'
});

bash
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/users/revoke_role" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "userName": "user_1",
    "roleName": "role_a"
}'

ユーザーの削除

次の例では、ユーザー user_1 を削除する方法を示します。

📘Notes

root ユーザーは削除できません。

Python
Java
NodeJS
cURL

python
from pymilvus import MilvusClient

client = MilvusClient(
    uri="YOUR_CLUSTER_ENDPOINT",
    token="YOUR_CLUSTER_TOKEN"
)

# create a user
client.drop_user(user_name="user_1")

java
import io.milvus.v2.client.ConnectConfig
import io.milvus.v2.client.MilvusClientV2
import io.milvus.v2.service.rbac.request.DropUserReq

ConnectConfig connectConfig = ConnectConfig.builder()
        .uri("YOUR_CLUSTER_ENDPOINT")
        .token("YOUR_CLUSTER_TOKEN")
        .build();

MilvusClientV2 client = new MilvusClientV2(connectConfig);

DropUserReq dropUserReq = DropUserReq.builder()
        .userName("user_1")
        .build();
client.dropUser(dropUserReq);

javascript
const { MilvusClient, DataType } = require("@zilliz/milvus2-sdk-node")

const address = "YOUR_CLUSTER_ENDPOINT";
const token = "YOUR_CLUSTER_TOKEN";
const client = new MilvusClient({address, token});

milvusClient.deleteUser({
    username: 'user_1'
})

bash
export CLUSTER_ENDPOINT="YOUR_CLUSTER_ENDPOINT"
export TOKEN="YOUR_CLUSTER_TOKEN"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/users/drop" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "userName": "user_1"
}'

ユーザーを削除したら、既存のユーザー一覧を確認して、削除操作が成功したかどうかを検証できます。

Python
Java
NodeJS
cURL

python
from pymilvus import MilvusClient

client.list_users()

java
import io.milvus.v2.service.rbac.request.listUsersReq

List<String> resp = client.listUsers();

javascript
const { MilvusClient, DataType } = require("@zilliz/milvus2-sdk-node")

milvusClient.listUsers()

bash
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/users/list" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{}'

以下は出力例です。一覧に user_1 が含まれていないため、削除操作は成功しています。

bash

['root']

ユーザーの作成​

ユーザーの一覧表示​

ユーザーへのロール付与​

ユーザー情報の確認​

ロールの取り消し​

ユーザーの削除​

ユーザーの作成

ユーザーの一覧表示

ユーザーへのロール付与

ユーザー情報の確認

ロールの取り消し

ユーザーの削除