Rediacc CLI 参考（云端 / 实验性）

概述

这些命令需要**云端适配器**（实验性）— 当配置包含 `apiUrl` 和 `token` 字段时激活。有关主要 CLI 参考，请参阅 [CLI 应用程序](/zh/docs/cli-application)。

1. 身份验证

身份验证命令

1.1 login

使用 Rediacc 进行身份验证

rdc auth login [options]

标志	描述	必填	默认值
-e, --email <email>	电子邮件地址	否	-
-p, --password <password>	密码（用于非交互式登录）	否	-
-m, --master-password <password>	保险箱加密的主密码	否	-
-n, --name <name>	会话名称	否	-
--endpoint <url>	API 端点 URL	否	-
--save-as <name>	将凭证保存到命名上下文	否	-

1.2 logout

清除存储的凭证

rdc auth logout

1.3 status

检查当前身份验证状态

rdc auth status

1.4 register

注册新组织和用户账户

注册后，请检查您的电子邮件以获取激活码。

rdc auth register [options]

标志	描述	必填	默认值
--organization <name>	组织名称	是	-
-e, --email <email>	电子邮件地址	是	-
-p, --password <password>	密码（用于非交互式登录）	是	-
-m, --master-password <password>	保险箱加密的主密码	否	-
--endpoint <url>	API 端点 URL	否	-
--plan <plan>	订阅计划（COMMUNITY、PROFESSIONAL、BUSINESS、ENTERPRISE）	否	COMMUNITY

1.5 activate

使用验证码激活账户

rdc auth activate [options]

标志	描述	必填	默认值
-e, --email <email>	电子邮件地址	是	-
-p, --password <password>	密码（用于非交互式登录）	是	-
--code <code>	来自电子邮件的激活码	是	-
--endpoint <url>	API 端点 URL	否	-

1.6 tfa

双因素认证管理

disable

禁用双因素认证

rdc auth tfa disable [options]

标志	描述	必填	默认值
--code <code>	用于验证的当前双因素认证代码	否	-
-y, --yes	跳过确认提示	否	-

enable

启用双因素认证

rdc auth tfa enable

status

检查双因素认证状态

rdc auth tfa status

1.7 token

令牌管理

fork

为另一个应用程序创建分叉令牌

rdc auth token fork [options]

标志	描述	必填	默认值
-n, --name <name>	令牌名称	否	CLI Fork
-e, --expires <hours>	过期时间（小时数，1-720）	否	24

list

列出活跃的令牌/会话

rdc auth token list

revoke

撤销特定令牌

rdc auth token revoke <requestId>

提示: 您的身份验证令牌存储在本地上下文中。使用 `--save-as` 将凭据存储在命名上下文下，以便用于多个环境。

---

2. 组织管理

组织管理命令

2.1 list

列出组织

rdc organization list

2.2 info

获取组织信息

rdc organization info

2.3 dashboard

获取组织仪表板数据

rdc organization dashboard

2.4 vault

组织保险箱管理

get

获取组织保险箱数据

rdc organization vault get

list

列出所有保险箱类型

rdc organization vault list

update

更新组织保险箱数据

rdc organization vault update [options]

标志	描述	必填	默认值
--vault <json>	保险箱内容为 JSON 字符串	否	-
--vault-version <n>	用于乐观锁定的当前保险箱版本	否	-

2.5 export

导出组织数据

rdc organization export [options]

标志	描述	必填	默认值
--path <path>	保存输出文件的路径	否	-

2.6 import

导入组织数据

rdc organization import <path> [options]

标志	描述	必填	默认值
--mode <mode>	导入模式（merge 或 replace）	否	merge

2.7 maintenance

启用或禁用维护模式（阻止非管理员登录）

rdc organization maintenance <action>

警告: 启用维护模式时，非管理员用户无法登录。

---

3. 用户管理

用户管理命令

3.1 list

列出所有用户

rdc user list

3.2 create

创建新用户

rdc user create <email> [options]

标志	描述	必填	默认值
-p, --password <password>	新用户的密码	否	-

3.3 activate

激活用户账户

rdc user activate <email> <activationCode>

3.4 deactivate

停用用户账户

rdc user deactivate <email> [options]

标志	描述	必填	默认值
-f, --force	跳过确认提示	否	-

3.5 reactivate

重新激活已停用的用户账户

rdc user reactivate <email>

3.6 update-email

更改用户的电子邮件地址

rdc user update-email <currentEmail> <newEmail>

3.7 update-password

更改您的密码

rdc user update-password [options]

标志	描述	必填	默认值
--password <password>	新密码（非交互式模式）	否	-
--confirm <confirm>	确认密码（非交互式模式）	否	-

3.8 update-language

设置当前用户的首选语言

rdc user update-language <language>

3.9 exists

检查用户是否存在

rdc user exists <email>

3.10 vault

用户保险箱管理

get

获取当前用户保险箱数据

rdc user vault get

update

更新当前用户保险箱数据

rdc user vault update [options]

标志	描述	必填	默认值
--vault <json>	保险箱内容为 JSON 字符串	否	-
--vault-version <n>	用于乐观锁定的当前保险箱版本	否	-

3.11 permission

用户权限管理

assign

为用户分配权限组

rdc user permission assign <userEmail> <groupName>

---

4. 团队管理

团队管理

4.1 list

列出团队

rdc team list [options]

标志	描述	必填	默认值
--search <text>	在 {{field}} 中搜索	否	-
--sort <field>	按字段排序	否	-
--desc	降序排序	否	-

4.2 create

创建团队

rdc team create <name>

4.3 member

团队成员管理

list

列出团队成员

rdc team member list <teamName>

add

将用户添加到团队

rdc team member add <teamName> <userEmail>

remove

从团队中移除用户

rdc team member remove <teamName> <userEmail>

---

5. 权限管理

权限管理命令

5.1 list

列出权限

rdc permission list

5.2 group

权限组管理

list

列出所有权限组

rdc permission group list

create

创建新权限组

rdc permission group create <name>

delete

删除权限组

rdc permission group delete <name> [options]

标志	描述	必填	默认值
-f, --force	跳过确认提示	否	-

show

显示权限组详情

rdc permission group show <name>

5.3 add

向组添加权限

rdc permission add <groupName> <permission>

5.4 remove

从组中移除权限

rdc permission remove <groupName> <permission>

---

6. 区域管理

区域管理

6.1 list

列出区域

rdc region list [options]

标志	描述	必填	默认值
--search <text>	在 {{field}} 中搜索	否	-
--sort <field>	按字段排序	否	-
--desc	降序排序	否	-

---

7. 桥接管理

网桥管理

7.1 list

列出网桥

rdc bridge list [options]

标志	描述	必填	默认值
-r, --region <name>	区域名称	否	-
--search <text>	在 {{field}} 中搜索	否	-
--sort <field>	按字段排序	否	-
--desc	降序排序	否	-

7.2 reset-auth

重置网桥授权令牌

rdc bridge reset-auth <name> [options]

标志	描述	必填	默认值
-r, --region <name>	区域名称	否	-

---

8. 仓库管理

仓库管理命令

8.1 list

列出仓库

rdc repository list [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-

8.2 create

创建新仓库

rdc repository create <name> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--tag <tag>	仓库标签	否	latest
--parent <name>	父仓库（用于分叉）	否	-
--parent-tag <tag>	父仓库标签	否	-

8.3 rename

重命名仓库

rdc repository rename <oldName> <newName> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--tag <tag>	仓库标签	否	latest

8.4 delete

删除仓库

rdc repository delete <name> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--tag <tag>	仓库标签	否	latest
-f, --force	跳过确认提示	否	-

8.5 promote

将分叉提升为主状态

rdc repository promote <name> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--tag <tag>	仓库标签	否	latest
-f, --force	跳过确认提示	否	-

注意: 提升 fork 会将其从父（grand）仓库中分离出来，使其独立。

8.6 vault

仓库保险箱管理

get

获取仓库保险箱数据

rdc repository vault get <repositoryName> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--tag <tag>	仓库标签	否	latest

update

更新仓库保险箱数据

rdc repository vault update <repositoryName> [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--tag <tag>	仓库标签	否	latest
--vault <json>	保险箱内容为 JSON 字符串	否	-
--vault-version <n>	用于乐观锁定的当前保险箱版本	否	-

---

9. 队列操作

队列管理

队列系统是 Rediacc 任务执行的核心。每个操作（部署、备份、脚本执行）都通过队列运行。

9.1 list

列出队列项

rdc queue list [options]

标志	描述	必填	默认值
-t, --team <name>	团队名称	否	-
--status <status>	按状态过滤	否	-
--priority-min <n>	最小优先级（1-5）	否	-
--priority-max <n>	最大优先级（1-5）	否	-
--search <text>	在任务 ID、团队、机器、网桥中搜索	否	-
--sort <field>	按字段排序	否	-
--desc	降序排序	否	-
--limit <n>	最大结果数	否	50

9.2 create

创建队列项

rdc queue create [options]

标志	描述	必填	默认值
-f, --function <name>	要执行的函数名称	是	-
-t, --team <name>	团队名称	否	-
-m, --machine <name>	机器名称	否	-
-b, --bridge <name>	网桥名称	否	-
-p, --priority <1-5>	优先级（1=最高）	否	3
--param <key=value>	函数参数	否	-
--vault <json>	原始保险箱 JSON（用于脚本/CI）	否	-

9.3 cancel

取消队列项

rdc queue cancel <taskId>

9.4 retry

重试失败的队列项

rdc queue retry <taskId>

9.5 trace

跟踪队列项执行

rdc queue trace <taskId> [options]

标志	描述	必填	默认值
-w, --watch	监视更新	否	-
--interval <ms>	轮询间隔（毫秒）	否	2000

提示: 使用 `--watch` 实时跟踪任务直到完成。

9.6 delete

删除队列项

rdc queue delete <taskId> [options]

标志	描述	必填	默认值
-f, --force	跳过确认提示	否	-

---

10. Ceph 存储管理

Ceph 分布式存储管理

10.1 cluster

Ceph 集群管理

list

列出 Ceph 集群

rdc ceph cluster list

create

创建新的 Ceph 集群

rdc ceph cluster create <name> [options]

标志	描述	必填	默认值
--vault <content>	保险箱内容为 JSON 字符串	否	-

delete

删除 Ceph 集群

rdc ceph cluster delete <name> [options]

标志	描述	必填	默认值
-f, --force	跳过确认提示	否	-

machines

列出 Ceph 集群中的机器

rdc ceph cluster machines <name>

vault

Ceph 集群保险库管理

get:

获取集群保险库数据

rdc ceph cluster vault get <name>

update:

更新集群保险库数据

rdc ceph cluster vault update <name> [options]

标志	描述	必填	默认值
--vault <content>	保险箱内容为 JSON 字符串	是	-

10.2 pool

Ceph 存储池管理

list

列出 Ceph 存储池

rdc ceph pool list [options]

标志	描述	必填	默认值
--team <name>	团队名称	否	-
--cluster <name>	Ceph 集群名称	否	-

create

创建新的 Ceph 存储池

rdc ceph pool create <name> [options]

标志	描述	必填	默认值
--cluster <name>	Ceph 集群名称	是	-
--team <name>	团队名称	是	-
--vault <content>	保险箱内容为 JSON 字符串	否	-

delete

删除 Ceph 存储池

rdc ceph pool delete <name> [options]

标志	描述	必填	默认值
--team <name>	团队名称	是	-
-f, --force	跳过确认提示	否	-

vault

Ceph 存储池保险库管理

get:

获取存储池保险库数据

rdc ceph pool vault get <name> [options]

标志	描述	必填	默认值
--team <name>	团队名称	是	-

update:

更新存储池保险库数据

rdc ceph pool vault update <name> [options]

标志	描述	必填	默认值
--team <name>	团队名称	是	-
--vault <content>	保险箱内容为 JSON 字符串	是	-

10.3 image

Ceph RBD 镜像管理

list

列出 RBD 镜像

rdc ceph image list [options]

标志	描述	必填	默认值
--pool <name>	Ceph 池名称	否	-
--team <name>	团队名称	否	-

create

创建新的 RBD 镜像

rdc ceph image create <name> [options]

标志	描述	必填	默认值
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-
--machine <name>	机器名称	是	-
--vault <content>	保险箱内容为 JSON 字符串	否	-

delete

删除 RBD 镜像

rdc ceph image delete <name> [options]

标志	描述	必填	默认值
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-
-f, --force	跳过确认提示	否	-

10.4 snapshot

Ceph RBD 快照管理

list

列出 RBD 快照

rdc ceph snapshot list [options]

标志	描述	必填	默认值
--image <name>	RBD 镜像名称	否	-
--pool <name>	Ceph 池名称	否	-
--team <name>	团队名称	否	-

create

创建新的 RBD 快照

rdc ceph snapshot create <name> [options]

标志	描述	必填	默认值
--image <name>	RBD 镜像名称	是	-
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-
--vault <content>	保险箱内容为 JSON 字符串	否	-

delete

删除 RBD 快照

rdc ceph snapshot delete <name> [options]

标志	描述	必填	默认值
--image <name>	RBD 镜像名称	是	-
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-
-f, --force	跳过确认提示	否	-

10.5 clone

Ceph RBD 克隆管理

list

列出 RBD 克隆

rdc ceph clone list [options]

标志	描述	必填	默认值
--snapshot <name>	RBD 快照名称	否	-
--image <name>	RBD 镜像名称	否	-
--pool <name>	Ceph 池名称	否	-
--team <name>	团队名称	否	-

create

从快照创建新的 RBD 克隆

rdc ceph clone create <name> [options]

标志	描述	必填	默认值
--snapshot <name>	RBD 快照名称	是	-
--image <name>	RBD 镜像名称	是	-
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-
--vault <content>	保险箱内容为 JSON 字符串	否	-

delete

删除 RBD 克隆

rdc ceph clone delete <name> [options]

标志	描述	必填	默认值
--snapshot <name>	RBD 快照名称	是	-
--image <name>	RBD 镜像名称	是	-
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-
-f, --force	跳过确认提示	否	-

machines

列出分配给克隆的机器

rdc ceph clone machines <name> [options]

标志	描述	必填	默认值
--snapshot <name>	RBD 快照名称	是	-
--image <name>	RBD 镜像名称	是	-
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-

assign

将机器分配给克隆

rdc ceph clone assign <name> [options]

标志	描述	必填	默认值
--snapshot <name>	RBD 快照名称	是	-
--image <name>	RBD 镜像名称	是	-
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-
--machines <names>	机器名称（逗号分隔）	是	-

unassign

从克隆移除机器

rdc ceph clone unassign <name> [options]

标志	描述	必填	默认值
--snapshot <name>	RBD 快照名称	是	-
--image <name>	RBD 镜像名称	是	-
--pool <name>	Ceph 池名称	是	-
--team <name>	团队名称	是	-
--machines <names>	机器名称（逗号分隔）	是	-

---

11. 审计与合规

审计日志命令

11.1 list

列出审计日志条目

rdc audit list

11.2 log

查看审计日志

rdc audit log [options]

标志	描述	必填	默认值
--limit <n>	最大结果数	否	100

11.3 trace

跟踪实体的审计历史

rdc audit trace <entityType> <entityId>

11.4 history

查看实体历史

rdc audit history <entityType> <entityId>

---