用途:通过 ax CLI 对 Arize 做程序化管理,覆盖用户、组织、空间、项目、角色、角色绑定、资源限制与 API 密钥,适合企业访问控制、入职与离职、CI/CD 服务密钥等场景。
主要能力:用户层面可列出、创建、更新、删除用户,重发邀请、重置密码;组织层面可创建、更新、增删用户;空间层面可创建、更新、增删成员;角色层面可创建自定义 RBAC 角色并绑定到空间或项目;资源限制可将项目或仪表盘设为仅显式绑定用户可访问;API 密钥支持列出、创建用户密钥与服务密钥、吊销与刷新(零停机轮换)。
必要用法:先通过 ax organizations list、ax spaces list、ax projects list 等命令获取 ID;多步流程建议先收集信息再执行。涉及 delete、revoke、remove-user、unrestrict 等破坏性操作,须先总结影响并让用户确认,再以 --force 跳过交互确认,未确认不得运行 --force。服务密钥通过 ax api-keys create-service-key 的 --assignments JSON 指定范围,不使用单独的 --space/--space-role/--org-role 参数。
限制与注意:多数操作需 org-admin 或 account-admin 权限,403 Forbidden 表示当前 profile 权限不足;ax api-keys list 仅返回当前认证用户拥有的密钥。原始密钥只显示一次,需立即保存。不要读取 .env 或搜索凭据,不要要求用户在对话中粘贴密钥。认证失败可查看 ax profiles show;v0.18.0+ 支持 ax auth login 的 OAuth 登录。创建服务密钥的具体字段、过期日期等细节以命令帮助与随附参考文档为准,本简介不展开完整代码。