クラスターリソースの権限と権限グループ

権限とは、クラスター、データベース、コレクションなどの特定の Zilliz Cloud リソースに対して特定の操作を実行するための許可を指します。権限はロールに割り当てられ、そのロールがユーザーに付与されることで、ユーザーがリソース上で実行できる操作が定義されます。例えば、collection_01 という名前のコレクションにデータを挿入する許可も権限の一例です。

権限グループは、個別の権限を組み合わせたものです。よく使用する権限をまとめて権限グループを作成することで、ロール付与の手順を簡素化できます。利便性向上のため、Zilliz Cloud ではコレクション、データベース、クラスターの各レベルに合計9つの組み込み権限グループを用意しています。

次の図は、個々の権限と権限グループそれぞれの付与プロセスの違いを示しています。

SsW6w8kaNhz4iQbEMYmcbUzsnOc

このトピックでは、Zilliz Cloud で利用可能な組み込み権限グループおよび権限について詳しく説明します。

権限グループ

組み込み権限グループ

Zilliz Cloud は、コレクション、データベース、クラスターの各レベルに合計9つの組み込み権限グループを提供しており、ロールの作成時に直接付与できます。

📘Notes

これら3つのレベルの組み込み権限グループの間にはカスケード関係はありません。クラスターレベルで権限グループを設定しても、そのインスタンス配下のすべてのデータベースやコレクションに自動的に権限が適用されるわけではありません。データベースレベルおよびコレクションレベルの権限は、それぞれ手動で設定する必要があります。

コレクションレベルの権限グループ

CollectionReadOnly (COLL_RO)：コレクションデータの読み取り権限を含みます。
CollectionReadWrite (COLL_RW)：コレクションデータの読み取りおよび書き込み権限を含みます。
CollectionAdmin (COLL_ADMIN)：コレクションデータの読み取り・書き込み、およびコレクション管理の権限を含みます。

次の表に、コレクションレベルの3つの組み込み権限グループに含まれる具体的な権限の一覧を示します。

権限	CollectionReadOnly	CollectionReadWrite	CollectionAdmin
Query
Search
IndexDetail
GetFlushState
GetLoadState
GetLoadingProgress
HasPartition
ShowPartitions
ListAliases
DescribeCollection
DescribeAlias
GetStatistics
CreateIndex
DropIndex
CreatePartition
DropPartition
Load
Release
Insert
Delete
Upsert
Import
Flush
Compaction
LoadBalance
CreateAlias
DropAlias
AddCollectionField

データベースレベルの権限グループ

DatabaseReadOnly (DB_RO)：データベースデータの読み取り権限を含みます。
DatabaseReadWrite (DB_RW)：データベースデータの読み取りおよび書き込み権限を含みます。
DatabaseAdmin (DB_Admin)：データベースデータの読み取り・書き込み、およびデータベース管理の権限を含みます。

次の表に、データベースレベルの3つの組み込み権限グループに含まれる具体的な権限の一覧を示します。

権限	DatabaseReadOnly	DatabaseReadWrite	DatabaseAdmin
ShowCollections
DescribeDatabase
CreateCollection
DropCollection
AlterDatabase

クラスターレベルの権限グループ

ClusterReadOnly (Cluster_RO)：インスタンスデータの読み取り権限を含みます。
ClusterReadWrite (Cluster_RW)：インスタンスデータの読み取りおよび書き込み権限を含みます。
ClusterAdmin (Cluster_Admin)：インスタンスデータの読み取り・書き込み、およびインスタンス管理の権限を含みます。

次の表に、クラスターレベルの3つの組み込み権限グループに含まれる具体的な権限の一覧を示します。

権限	ClusterReadOnly	ClusterReadWrite	ClusterAdmin
ListDatabases
RenameCollection
CreateOwnership
UpdateUser
DropOwnership
SelectOwnership
ManageOwnership
SelectUser
BackupRBAC
RestoreRBAC
CreateResourceGroup
DropResourceGroup
UpdateResourceGroups
DescribeResourceGroup
ListResourceGroups
TransferNode
TransferReplica
CreateDatabase
DropDatabase
FlushAll
CreatePrivilegeGroup
DropPrivilegeGroup
ListPrivilegeGroups
OperatePrivilegeGroup

カスタム権限グループ | PRIVATE

組み込み権限で要件を満たせない場合は、SDKを使用してカスタム権限グループを作成し、任意の権限を追加できます。

📘📘 Notes

この機能はPrivate Previewとして提供されています。ご利用をご希望の場合は、サポートチケットを作成して有効化をリクエストしてください。

カスタム権限グループの作成

次の例では、privilege_group_1 という名前の権限グループを作成する方法を示します。

Python
Go
Java
NodeJS
cURL

python
from pymilvus import MilvusClient
client.create_privilege_group(group_name='privilege_group_1'）

go
import "github.com/milvus-io/milvus/client/v2/milvusclient"

err = client.CreatePrivilegeGroup(ctx, milvusclient.NewCreatePrivilegeGroupOption("privilege_group_1"))
if err != nil {
    fmt.Println(err.Error())
    // handle error
}

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

client.createPrivilegeGroup(CreatePrivilegeGroupReq.builder()
        .groupName("privilege_group_1")
        .build());

javascript
await client.createPrivilegeGroup({
  group_name: 'privilege_group_1',
});

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

カスタム権限グループの作成後、そのグループに権限を追加できます。

カスタム権限グループへの権限の追加

次の例では、作成したばかりの権限グループ privilege_group_1 に権限 PrivilegeBackupRBAC と PrivilegeRestoreRBAC を追加する方法を示します。Zilliz Cloud で利用可能なすべての権限の詳細については、すべての権限を参照してください。

Python
Go
Java
NodeJS
cURL

python
from pymilvus import MilvusClient
client.add_privileges_to_group(group_name='privilege_group_1', privileges=['Query', 'Search'])

go
import "github.com/milvus-io/milvus/client/v2/milvusclient"

privileges := []string{"Query", "Search"}
err = client.AddPrivilegesToGroup(ctx, milvusclient.NewAddPrivilegesToGroupOption("privilege_group_1", privileges...))
if err != nil {
    fmt.Println(err.Error())
    // handle error
}

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

client.addPrivilegesToGroup(AddPrivilegesToGroupReq.builder()
        .groupName("privilege_group_1")
        .privileges(Arrays.asList("Query", "Search"))
        .build());

javascript
await client.addPrivilegesToGroup({
  group_name: privilege_group_1,
  privileges: ['Query', 'Search'],
});

bash
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/privilege_groups/add_privileges_to_group" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "privilegeGroupName":"privilege_group_1",
    "privileges":["Query", "Search"]
}'

権限グループに権限を追加したら、その権限グループをロールに付与できます。詳細については、クラスターロールの管理 (SDK)を参照してください。

カスタム権限グループからの権限の削除

次の例では、権限グループ privilege_group_1 から権限 PrivilegeRestoreRBAC を削除する方法を示します。

Python
Go
Java
NodeJS
cURL

python
from pymilvus import MilvusClient
client.remove_privileges_from_group(group_name='privilege_group_1', privileges='Search')

go
import "github.com/milvus-io/milvus/client/v2/milvusclient"

err = client.RemovePrivilegesFromGroup(ctx, milvusclient.NewRemovePrivilegesFromGroupOption("privilege_group_1", []string{"Search"}...))
if err != nil {
    fmt.Println(err.Error())
    // handle error
}

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

client.removePrivilegesFromGroup(RemovePrivilegesFromGroupReq.builder()
        .groupName("privilege_group_1")
        .privileges(Collections.singletonList("Search"))
        .build());

javascript
await client.removePrivilegesFromGroup({
  group_name: "privilege_group_1",
  privileges: ["Search"],
});

bash
curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/privilege_groups/remove_privileges_from_group" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "privilegeGroupName":"privilege_group_1",
    "privileges":["Search"]
}'

権限グループの一覧表示

次の例では、既存のすべての権限グループを一覧表示する方法を示します。

Python
Go
Java
NodeJS
cURL

python
from pymilvus import MilvusClient
client.list_privilege_groups()

go
import "github.com/milvus-io/milvus/client/v2/milvusclient"

groups, err := client.ListPrivilegeGroups(ctx, milvusclient.NewListPrivilegeGroupsOption())
if err != nil {
    fmt.Println(err.Error())
    // handle error
}

java
import io.milvus.v2.service.rbac.PrivilegeGroup;
import io.milvus.v2.service.rbac.request.ListPrivilegeGroupsReq;
import io.milvus.v2.service.rbac.response.ListPrivilegeGroupsResp;

ListPrivilegeGroupsResp resp = client.listPrivilegeGroups(ListPrivilegeGroupsReq.builder()
        .build());
List<PrivilegeGroup> groups = resp.getPrivilegeGroups();

javascript
await client.listPrivilegeGroups();

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

以下に出力例を示します。

bash

PrivilegeGroupItem: <privilege_group:privilege_group_1>, <privileges:('Search', 'Query')>

カスタム権限グループの削除

次の例では、権限グループ privilege_group_1 を削除する方法を示します。

Python
Go
Java
NodeJS
cURL

python
from pymilvus import MilvusClient
client.drop_privilege_group(group_name='privilege_group_1')

go
import "github.com/milvus-io/milvus/client/v2/milvusclient"

err = client.DropPrivilegeGroup(ctx, milvusclient.NewDropPrivilegeGroupOption("privilege_group_1"))
if err != nil {
    fmt.Println(err.Error())
    // handle error
}

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

client.dropPrivilegeGroup(DropPrivilegeGroupReq.builder()
        .groupName("privilege_group_1")
        .build());

javascript
await client.dropPrivilegeGroup({group_name: 'privilege_group_1'});

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

すべての権限

以下は、Zilliz Cloud で利用可能なすべての権限です。

以下の権限を使用して独自の権限グループを作成する場合や、特定の権限を持つカスタムロールを作成する場合は、お問い合わせください。

データベース権限

権限	説明
ListDatabases	現在のインスタンス内のすべてのデータベースを表示します
DescribeDatabase	データベースの詳細を表示します
CreateDatabase	データベースを作成します
DropDatabase	データベースを削除します
AlterDatabase	データベースのプロパティを変更します

コレクション権限

権限	説明
GetFlushState	コレクションのフラッシュ操作のステータスを確認します
GetLoadState	コレクションのロード状態を確認します
GetLoadingProgress	コレクションのロード進行状況を確認します
ShowCollections	コレクション権限を持つすべてのコレクションを表示します
ListAliases	コレクションのすべてのエイリアスを表示します
DescribeCollection	コレクションの詳細を表示します
DescribeAlias	エイリアスの詳細を表示します
GetStatistics	コレクションの統計情報を取得します（例：コレクション内のエンティティ数）
CreateCollection	コレクションを作成します
DropCollection	コレクションを削除します
Load	コレクションをロードします
Release	コレクションをリリースします
Flush	コレクション内のすべてのエンティティをシールド済みセグメントに永続化します。フラッシュ操作後に挿入されたエンティティは、新しいセグメントに格納されます。
Compaction	手動で Compaction をトリガーします
RenameCollection	コレクションの名前を変更します
CreateAlias	コレクションのエイリアスを作成します
DropAlias	コレクションのエイリアスを削除します
FlushAll	データベース内のすべてのコレクションをフラッシュします
AddCollectionField	既存のコレクションにフィールドを追加します

パーティション権限

権限	説明
HasPartition	パーティションの存在を確認します
ShowPartitions	コレクション内のすべてのパーティションを一覧表示します
CreatePartition	パーティションを作成します
DropPartition	パーティションを削除します

インデックス権限

権限	説明
IndexDetail	インデックスの詳細を表示します
CreateIndex	インデックスを作成します
DropIndex	インデックスを削除します

リソース管理権限

権限	説明
LoadBalance	負荷分散を実行します
CreateResourceGroup	リソースグループを作成します
DropResourceGroup	リソースグループを削除します
UpdateResourceGroups	リソースグループを更新します
DescribeResourceGroup	リソースグループの詳細を表示します
ListResourceGroups	現在のインスタンスのすべてのリソースグループを一覧表示します
TransferNode	リソースグループ間でノードを移動します
TransferReplica	リソースグループ間でレプリカを移動します
BackupRBAC	現在のインスタンスにおけるすべての RBAC 関連操作のバックアップを作成します
RestoreRBAC	現在のインスタンスにおけるすべての RBAC 関連操作のバックアップを復元します

エンティティ権限

権限	説明
Query	クエリを実行します
Search	検索を実行します
Insert	エンティティを挿入します
Delete	エンティティを削除します
Upsert	エンティティを Upsert します
Import	エンティティを一括挿入またはインポートします

RBAC 権限

権限	説明
CreateOwnership	ユーザーまたはロールを作成します
UpdateUser	ユーザーのパスワードを更新します
DropOwnership	ユーザーのパスワードまたはロールを削除します
SelectOwnership	特定のロールが付与されているすべてのユーザーを一覧表示します
ManageOwnership	ユーザーやロールの管理、またはユーザーへのロール付与を行います
SelectUser	ユーザーに付与されているすべてのロールを一覧表示します
CreatePrivilegeGroup	権限グループを作成します
DropPrivilegeGroup	権限グループを削除します
ListPrivilegeGroups	現在のインスタンス内のすべての権限グループを一覧表示します
OperatePrivilegeGroup	権限グループに対して権限の追加または削除を行います

権限グループ​

組み込み権限グループ​

コレクションレベルの権限グループ​

データベースレベルの権限グループ​

クラスターレベルの権限グループ​

カスタム権限グループ | PRIVATE​

カスタム権限グループの作成​

カスタム権限グループへの権限の追加​

カスタム権限グループからの権限の削除​

権限グループの一覧表示​

カスタム権限グループの削除​

すべての権限​

データベース権限​

コレクション権限​

パーティション権限​

インデックス権限​

リソース管理権限​

エンティティ権限​

RBAC 権限​