用途:zilliz acl 是 Zilliz Cloud 的访问控制(RBAC)命令树,管理组织与项目层面的角色、策略及角色绑定,不涉及 Milvus 集群内部的数据库用户与权限。
主要能力:命令分为 acl role、acl member、acl group 三层。role 支持 list、describe、principals、create、update、delete;member 支持 roles、grant、revoke;group 支持 list、members、roles、grant、revoke。角色策略可用 --policy 简写(RESOURCE:ACTION[=SELECTION][@cluster=ID],可重复)、--policies-file JSON 文件,或在终端交互式构建。
使用方式:需先安装并登录 CLI(见 setup 技能),无需集群上下文。示例:zilliz acl role list --project-id <project-id>;zilliz acl role create --name <role-name> --project-id <project-id> --policy project_member:view;zilliz acl member grant <email|user-id> --role <role-id|role-name>。
限制:仅项目角色可创建,组织角色在此只读;update 整体替换策略而非合并;grant/revoke 非幂等,重复操作会被后端拒绝;删除角色会级联删除其绑定。--project-id 仅在 API 真正需要时提示,且不写入配置文件。组由 SCIM 预配,本命令只读取并管理其角色绑定。若命令返回 404,表示该端点的 ACL 路由尚未启用,属灰度状态,应联系支持而非重试。
适用场景:在 Zilliz Cloud 中为组织或项目配置自定义角色、分配权限,并管理成员与组的角色绑定。