跳到主要内容

tcb role update

v3.0.0+

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

更新角色信息（名称、描述、成员、策略）。

语法​

tcb role update --id <roleId> [options]
系统角色修改限制
  • 管理员角色：只能修改成员，不能修改策略
  • 注册用户/组织成员/匿名用户/所有用户：只能修改策略，不能修改成员
  • 所有系统角色：不可修改角色名称
  • 自定义角色：以上均可修改

参数​

参数说明
--id <roleId>角色 ID（必填）
--name <name>修改角色名称（自定义角色专用）
--description <desc>修改角色描述
--add-users <uids>添加成员，逗号分隔 UID
--remove-users <uids>移除成员，逗号分隔 UID
--add-policies <json>添加策略，格式同 role create --policies
--remove-policies <json>移除策略，传策略 code 字符串数组
-e, --env-id <envId>环境 ID

示例​

# 修改角色名称
tcb role update --id 2032299359962361858 --name "高级开发者" -e my-env-id

# 同时添加/移除成员
tcb role update --id 2032299359962361858 \
  --add-users "1001,1002" \
  --remove-users "1003" \
  -e my-env-id

# 修改策略
tcb role update --id 2032299359962361858 \
  --add-policies '["FunctionsAccess"]' \
  --remove-policies '["StoragesDeny"]' \
  -e my-env-id