角色写入共享请求与结果¶
创建与更新复用请求形状,但必填性、初始权限、请求 ID 和失败后的确认动作不同,不能整表互换。
请求字段¶
字段 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
string |
是 |
角色名称,1–255 个 UTF-8 字节,不含空白或控制字符;不能使用系统保留名称。 |
|
string |
否 |
角色说明,最多 4096 个 UTF-8 字节,不能含 NUL;省略或 null 保存为空字符串。 |
|
string |
是 |
权限定义返回的 schema_version。 |
|
string |
否 |
本次保存的业务请求 ID,最多 64 个 UTF-8 字节,不含空白或控制字符。省略时由服务端生成。 |
|
integer |
是 |
预期角色生命周期版本,必须大于 0。 |
|
integer |
是 |
预期应用策略版本。不小于 1。 |
|
integer |
否 |
预期数据权限版本。不小于 0。 |
|
object(对象数组) 或 null |
否 |
应用策略语句。 |
|
string |
否 |
IAM 策略语句唯一标识。 |
|
string |
对象提供时 |
权限动作。 |
|
string |
对象提供时 |
资源类型。 |
|
string |
对象提供时 |
资源范围。取值: |
|
string |
否 |
资源 ID。 |
|
string |
否 |
条件摘要。 |
|
string |
否 |
被授予动作。 |
|
string |
否 |
转授范围。取值: |
|
string |
否 |
转授目标资源 ID,按当前权限定义与 scope 填写。 |
|
boolean |
否 |
是否允许应用权限再转授。 |
|
object(对象数组) 或 null |
否 |
增量数据权限变更。 |
|
string |
对象提供时 |
操作。取值: |
|
string |
对象提供时 |
权限动作。 |
|
string |
对象提供时 |
资源类型。取值: |
|
string |
对象提供时 |
资源 ID。 |
|
string |
对象提供时 |
MatrixOne权限。取值: |
|
boolean |
否 |
授予权限时是否同时允许目标角色转授该数据权限。默认 false。 |
|
object 或 null |
表 SELECT grant 时 |
目标角色的行列规则处理。保留现有规则也需提交 mode=keep。 |
|
string |
提供 row_column 时 |
处理模式。取值: |
|
object |
mode=set 时 |
行列规则草稿。 |
|
string(字符串数组) 或 null |
否 |
禁止访问的列集合。 |
|
object(对象数组) 或 null |
否 |
行过滤规则。 |
|
string |
否 |
列名。 |
|
string |
否 |
条件连接关系。取值: |
|
object(对象数组) 或 null |
否 |
SQL 表达式规则。 |
|
string |
否 |
比较操作符。取值: |
|
string(字符串数组) 或 null |
否 |
条件值列表。 |
|
string |
否 |
值匹配类型。取值:空字符串、 |
statements 按完整替换处理,省略、null 或 [] 都表示提交空的自定义策略,不会保留原数组。系统必需的基础权限由服务端处理。data_privilege_mutations 按增量处理,省略、null 或 [] 均不新增数据权限变更。仅想修改说明时,也要提交需要保留的完整应用策略。
对表授予 SELECT 时必须提供 row_column,保留现有规则使用 {"mode":"keep"}。撤销时可省略或使用 clear;其他数据权限不接受行列规则。实际设置或清除规则还需当前权限定义支持。
创建与更新的差异¶
创建不提交三个已有角色版本;必须有业务 request_id,并至少有一项有效初始权限。更新按实际三个版本并发保护,request_id 可省略;完整替换自定义应用策略,增量处理数据权限。系统所需 baseline 仍由服务端处理。
角色创建成功为 201,更新为 200,成功对象是 role_id、role_version、policy_version、data_privilege_version、session_invalidation_status、idempotent_replay、provisioning_state/version/error_code 和请求/追踪标识。只有 ready 是本接口提交成功结果,内部 pending/failed 不能冒充成功。
失败结果与规范冲突¶
本地回滚、跨 MatrixOne 操作停止、结果未知分别由 ErrIAMRoleWriteRolledBack、ErrIAMRoleWriteFailed、ErrIAMRoleWriteResultUnknown 表达。较旧业务目录仍写编辑失败恢复旧 snapshot;04 生命周期、07 公开合同及当前 role_update owner 已区分本地回滚与跨库停止、不反向恢复权限。不能保留“所有失败都恢复旧权限”的承诺,规范漂移单列内部待确认;不修改产品规范或实现。
创建未知结果保留原业务编号和原内容确认;更新省略编号是新保存,保留草稿、刷新实际状态并由用户明确再次保存,不把创建的表单锁定协议强加所有设置。只有已确认回滚的对应错误才可能给出 cause_code;失败/未知不能通过底层错误链推断未生效。