创建自定义角色。指定 base_role_key 时,新角色以该角色权限规则的副本作为初始内容;副本相互独立——之后对任一角色的更改不会影响另一个。仅团队所有者可管理角色。
所需权限: policy:custom_role_manage
请求头
可选。使用相同值重试会重放首次结果,而不会创建第二个角色。
请求体
可选。tenant_admin、tenant_member 或本团队的自定义角色键:新角色以该角色权限规则的副本为起点(之后任一角色的变更都不影响另一个)。省略则创建无任何权限的角色。所有者角色不能作为基础。
响应
为 true 时,该角色属于管理员级:只有团队所有者可以授予(更改角色或邀请),虚拟成员不能持有。这是角色本身的属性,对所有调用方都相同;不同于控制台角色列表中按调用方计算的可分配标志。
成员与邀请的写操作是否接受此角色——对所有调用方相同。所有者角色始终不接受。与控制台的角色列表不同,此字段不表示您本人能否授予该角色:如需判断,请结合 admin_grant_only 与您自己的角色。
每个团队都有的三个角色为 true;在本团队中创建的角色为 false
显示名称。内置角色带有固定的英文标签;自定义角色使用操作者设置的名称。
对于自定义角色:创建时被复制权限规则的来源角色。内置角色以及未指定基础角色创建的自定义角色不包含此字段。
与 base_role_key 的值相同;为兼容现有客户端而保留。
该角色授予的全部权限及其来源。仅返回给在 tenant:policy 上持有 policy:manage 的调用方;对其他调用方省略。空列表表示该角色不授予任何权限。实例限制(该角色的访问范围)不在此体现。
权限,格式为 <resource_type>:<action>(例如 memorylake:project:project:read)
built_in:属于内置角色定义的一部分。base_role:基础角色同样授予该权限——在创建此角色时从基础角色复制而来。role_rule:仅由此角色自身的权限规则授予。
错误
出错时返回 success: false、message 和 error_code。全部错误码见错误码。