向量库权限资源与分账管理 - V1--向量数据库VikingDB-火山引擎

文档中心

立即注册

导航

向量库权限资源与分账管理 - V1

最近更新时间：2025.09.30 16:26:38首次发布时间：2025.09.30 16:06:36

火山引擎上的权限管理主要是通过访问控制 IAM实现，主账号（或有相关权限的用户）通常会根据团队成员的职责、工作内容为不同的成员创建子账号（子用户），并可以基于资源、项目、标签进行更细粒度的权限划分，提升资源的安全性和管理的灵活性。

本文将介绍如何在 VikingDB 向量库中进行项目和用户操作来满足用户资源管理与分账诉求。
用户通常有两种管理诉求：

项目分账

如果用户有多个部门，需要彼此独立的使用向量库并且各自分账，则可以根据如下流程创建多个项目对应不同的部门，并为每个部门创建各自的子账号，权限配置每个子账号只能访问对应的项目。

标签分账

如果用户在一个部门内，希望能为不同的业务分别记账，则可以将不同业务的数据集打上对应的标签，这样可实现按照标签分账；如果需要进一步控制访问权限，则支持通过自定义权限限制不同业务的用户只能访问某个标签的数据集即可。

地域功能开放说明

地域	标签及分账
华北	支持
华东	支持
华南	不支持分账，支持标签
柔佛	暂不支持，正在开发中

具体功能操作如下：

子账号管理

创建用户

火山引擎提供了【用户】模块管理该账号下的所有子用户，在该模块下能够对子用户进行创建、删除、配置权限等操作。
使用前提
以主账号或者拥有【访问控制】权限的用户登录。
操作步骤

登录火山引擎控制台，单击顶部右上角的用户名称下的【访问控制】进入对应页面。
在左侧的导航栏依次单击【用户】-【新建用户】进入基本信息设置页面。

单击【通过用户名创建】，在【基本信息设置】页签下填写该子账号的名称。关键字段如下：

字段名称	字段说明
用户名	填写子用户的名称。必填。
控制台登录	为新用户配置子账号和密码，赋予用户通过控制台（Web 页面）访问平台的权限。需要通过 Web 页面访问平台的用户需要开启该权限。
编程访问	为用户生成 AK / SK。 AK / SK 作为用户的重要身份凭证，强烈建议开启。日常使用 API / SDK 时均需要 AK / SK 进行身份验证。获得 AK / SK 后请妥善保管切勿泄露。

【基本信息设置】页签填写完成后单击【下一步】，进入【权限设置】页签。在搜索框搜索策略名称，查找向量数据库 VikingDB 当前的权限策略，为新建用户勾选对应权限。权限分为系统预设策略和自定义策略两大类。
系统预设策略：
- MLPlatformVikingDBFullAccess/VikingdbFullAccess：该策略包含向量数据库 VikingDB API v1 v2 的全读写权限。
- MLPlatformVikingDBReadOnlyAccess/VikingdbReadOnlyAccess：该策略包含向量数据库 VikingDB API v1 v2 的只读权限。
  **自定义策略：**根据以上策略范围复制后，自定义支持的资源（数据集）/标签的权限范围。

策略管理

系统预设策略

当创建子账号成员未设置访问策略时，该子账号显示没有访问权限时，可通过如下操作步骤配置系统预设的策略。

以主账号或者拥有【访问控制】权限的用户登录火山引擎控制台，单击顶部右上角的用户名称下的【访问控制】进入对应页面。
在左侧导航栏选择【策略管理】，进入策略管理页面。在搜索框搜索 VikingDB，查找向量数据库 VikingDB 当前的权限策略。

自定义策略

火山引擎主账号或拥有访问控制管理权限的子用户进行授权时，若系统预设策略无法满足需求，可通过自定义策略精细化定义权限。包括：

对指定 Resource 授权完全权限策略或只读权限策略
对指定的项目资源授予策略权限。

登录火山引擎账号或拥有访问控制管理权限的子用户，进入“访问控制-策略管理”，点击“新建自定义策略”。

选择 JSON 编辑器进行策略的编辑

策略修改方法：
1. 对指定 Resource 授权完全权限策略

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ml_platform:IsVikingdbOpened",
        "ml_platform:HandleVikingdbTradeCallback",
        "ml_platform:Ping",
        "ml_platform:CreateCollection",
        "ml_platform:FieldTypeList",
        "ml_platform:ListFieldTypes",
        "ml_platform:ListPipelines",
        "ml_platform:DeleteIndex",
        "ml_platform:CreateIndex",
        "ml_platform:DeleteCollection",
        "ml_platform:CollectionList",
        "ml_platform:ListCollections",
        "ml_platform:CollectionInfo",
        "ml_platform:GetCollectionInfo",
        "ml_platform:IndexList",
        "ml_platform:ListIndexes",
        "ml_platform:TerminateVikingdbInstance",
        "ml_platform:IndexInfo",
        "ml_platform:GetIndexInfo",
        "ml_platform:GetVikingdbInstanceDetail",
        "ml_platform:SearchDebug",
        "ml_platform:GetSearchData",
        "ml_platform:UpdateCollection",
        "ml_platform:TccConfig",
        "ml_platform:GetTccConfig",
        "ml_platform:UpdateIndex",
        "ml_platform:VikingDBAPIRead",
        "ml_platform:VikingDBAPIWrite",
        "ml_platform:CollectionAliasInfo",
        "ml_platform:GetCollectionAliasInfo",
        "ml_platform:CloseVikingDBService",
        "ml_platform:GetPreSignedUrl",
        "ml_platform:UpsertData",
        "ml_platform:FetchDataByCollection",
        "ml_platform:FetchDataByIndex",
        "ml_platform:UpdateData",
        "ml_platform:DeleteData",
        "ml_platform:ListIndexesByCollection",
        "ml_platform:UpdateTask",
        "ml_platform:DeleteTask",
        "ml_platform:ListTask",
        "ml_platform:FindTask",
        "ml_platform:CreateTask",
        "ml_platform:ListTasks",
        "ml_platform:IsVikingdbOpenedBp",
        "ml_platform:CloseVikingDBServiceBp",
        "ml_platform:PreviewDataByCollection",
        "ml_platform:TagResource",
        "ml_platform:UntagResource",
        "tag:GetTagValues",
        "tag:GetTagKeys",
        "vikingdb:*"
      ],
      "Resource": [
        "trn:vikingdb:cn-beijing:账号ID:vikingdbcollection/resource ID",
        "trn:vikingdb:cn-beijing:账号ID:vikingdbcollection/resource ID"
      ]
    }
  ]
}

对指定的 Resource 授权只读权限策略

{
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ml_platform:IsVikingdbOpened",
                "ml_platform:IsKnowledgeBaseOpened",
                "ml_platform:HandleVikingdbTradeCallback",
                "ml_platform:Ping",
                "ml_platform:FieldTypeList",
                "ml_platform:ListFieldTypes",
                "ml_platform:ListPipelines",
                "ml_platform:CollectionList",
                "ml_platform:ListCollections",
                "ml_platform:CollectionInfo",
                "ml_platform:GetCollectionInfo",
                "ml_platform:IndexList",
                "ml_platform:ListIndexes",
                "ml_platform:IndexInfo",
                "ml_platform:GetIndexInfo",
                "ml_platform:GetVikingdbInstanceDetail",
                "ml_platform:SearchDebug",
                "ml_platform:GetSearchData",
                "ml_platform:TccConfig",
                "ml_platform:GetTccConfig",
                "ml_platform:DocList",
                "ml_platform:ListDocs",
                "ml_platform:DocInfo",
                "ml_platform:GetDocInfo",
                "ml_platform:ProcessingResultList",
                "ml_platform:ListChunks",
                "ml_platform:VikingDBAPIRead",
                "ml_platform:CollectionAliasInfo",
                "ml_platform:GetCollectionAliasInfo",
                "ml_platform:CreateSearchConfig",
                "ml_platform:GetKnowledgeBaseOpened",
                "ml_platform:GetKnowledgeBaseServiceInfo",
                "ml_platform:GetPreSignedUrl",
                "ml_platform:GetKnowledgeBasePreSignedUrl",
                "ml_platform:DeleteKnowledgeBaseTosObject",
                "ml_platform:CreateConversation",
                "ml_platform:DocQuery",
                "ml_platform:GetLarkDocInfoByLink",
                "ml_platform:GetLarkFileTree",
                "ml_platform:GetUnbindLarkAccount",
                "ml_platform:GetBindLarkAccount",
                "ml_platform:FetchDataByCollection",
                "ml_platform:FetchDataByIndex",
                "ml_platform:ListIndexesByCollection",
                "ml_platform:GetBatchToPipeline",
                "ml_platform:GetReProcessDoc",
                "ml_platform:GetPipelineInfo",
                "ml_platform:ListPipelines",
                "ml_platform:ListSearchConfigs",
                "ark:ListEndpoints",
                "ark:ListCustomModels",
                "ark:ListFoundationModels",
                "ark:ListFoundationModelVersions",
                "ark:GetApiKey",
                "ml_platform:ListTask",
                "ml_platform:FindTask",
                "ml_platform:ListTasks",
                "ml_platform:IsVikingdbOpenedBp",
                "ml_platform:PreviewDataByCollection",
                "tag:GetTagValues",
                "tag:GetTagKeys",
                "vikingdb:Get*",
                "vikingdb:List*",
                "vikingdb:Read*"
            ],
            "Resource": [
                 "trn:vikingdb:cn-beijing:账号ID:vikingdbcollection/resource ID"
            ]
        }
    ]
}