跳到主要内容

用户管理

v3.0.0+

tcb user 命令自 v3.0.0 起提供。

tcb user 命令用于管理 CloudBase 环境中的终端用户（内部用户/外部用户），支持创建、查询、修改和删除。

与角色的关系

用户与角色（tcb role）相互关联。可在创建/修改用户时绑定角色，也可通过 tcb role update 管理角色成员。

tcb user create​

创建用户。

tcb user create <name> [options]

参数​

参数说明默认值
name用户名（必填）—
-e, --env-id <envId>环境 ID—
--uid <uid>自定义用户 ID（可选，不填则自动生成）—
--password <pwd>密码（可选）—
--type <type>用户类型：internalUser / externalUserinternalUser
--status <status>用户状态：ACTIVE / BLOCKEDACTIVE
--nickname <nickname>昵称—
--json输出 JSON—

示例​

# 创建内部用户
tcb user create alice -e my-env-id

# 创建用户并设置密码和昵称
tcb user create alice --password Secret123 --nickname "Alice" -e my-env-id

# 创建外部用户（默认封禁）
tcb user create external-bob --type externalUser --status BLOCKED -e my-env-id

tcb user list​

查询用户列表，支持多维度筛选。

tcb user list [options]

参数​

参数简写说明默认值
-e, --env-id <envId>—环境 ID—
--offset <n>—跳过条数0
--limit <n>—返回条数上限20
--username <name>—按用户名筛选—
--nickname <name>—按昵称筛选—
--phone <phone>—按手机号筛选—
--json—输出 JSON—

示例​

# 查看全部用户（分页）
tcb user list -e my-env-id

# 按用户名搜索
tcb user list --username alice -e my-env-id

# 翻页（第 2 页，每页 20 条）
tcb user list --offset 20 --limit 20 -e my-env-id

tcb user update​

修改用户信息。

tcb user update <uid> [options]

参数​

参数说明默认值
uid用户 ID（必填）—
-e, --env-id <envId>环境 ID—
--username <name>新用户名—
--type <type>用户类型：internalUser / externalUser—
--password <pwd>新密码—
--status <status>用户状态：ACTIVE / BLOCKED—
--nickname <nickname>昵称—
--json输出 JSON—

示例​

# 封禁用户
tcb user update user-uid-123 --status BLOCKED -e my-env-id

# 修改密码
tcb user update user-uid-123 --password NewSecret456 -e my-env-id

# 同时修改用户名和昵称
tcb user update user-uid-123 --username bob --nickname "Bob" -e my-env-id

tcb user delete​

删除一个或多个用户（不可恢复）。

tcb user delete <uid...> [options]

参数​

参数说明
uid...一个或多个用户 ID，空格分隔
-e, --env-id <envId>环境 ID
--json输出 JSON

示例​

# 删除单个用户
tcb user delete user-uid-123 -e my-env-id

# 批量删除
tcb user delete user-uid-123 user-uid-456 -e my-env-id
注意

删除操作不可撤销。建议先通过 tcb user list 确认用户 ID 后再执行。