精简角色上下文与能力对象¶
POST/user/info使用App Shell精简投影。独立GET/iam/me/roles及capabilities保留完整元数据,两类响应不互相复制字段表。
字段 |
类型 |
合同 |
|---|---|---|
iam_context.roles |
array(对象数组) |
直接角色选项,非权限并集 |
roles[].role_id / role_name |
string |
规范角色标识与名称 |
roles[].lifecycle_version |
integer |
Role生命周期版本 |
roles[].selectable |
boolean |
当前是否可选 |
roles[].disabled_reason |
string |
可用时空;ROLE_NOT_ACTIVE或ROLE_PROVISIONING_NOT_READY说明不可用 |
iam_context.default_role_id / explicit_role_id / effective_role_id |
string |
默认角色、未验证显式候选、当前唯一有效角色;空值有独立含义 |
iam_context.default_role_version |
integer |
默认角色绑定版本,非角色生命周期版本 |
iam_context.role_context_status |
string |
ready/default_missing/candidate_invalid/role_disabled |
iam_capabilities.effective_role_id |
string |
能力所用的有效角色 |
iam_capabilities.request_id / trace_id |
string |
诊断标识,不从精简iam_context寻找 |
iam_capabilities.items |
array(对象数组) |
精简能力项,非ready时当前不进行能力计算并返回空数组 |
items[].capability_id / reason_code |
string |
稳定能力标识和返回的原因码,不自行用显示名称推断 |
items[].allowed / all_resources |
boolean |
明确允许及对象范围类型 |
items[].resource_ids |
string[](字符串数组) |
精确对象范围;all_resources=true时应为空 |
Bootstrap不返回role option的lifecycle_state/system_role,不返回iam_context的schema/capability/request/trace元数据,不返回iam_capabilities.capability_version,也不返回item.action_id/resource_type。精简是handler与proto定义的合同,不计SDK丢字段;若需完整元数据调用相应独立接口。
未请求项/非ready空能力不能使用旧缓存补成allow。对象操作还需allowed=true且all_resources=true或canonical ID精确命中,实际写请求仍重做权限检查。切换候选后清旧context/capability/依赖缓存再bootstrap,不能把一次摘要永久当权限凭据。
iam_snapshot_version由展示事实、内部完整角色/版本、能力和授权快照等计算;部分参与字段不在精简JSON内,调用者不能仅用该JSON重算,也不把它当数据写入版本。当前service的Owner/保留成员旧展示和选路例外与规范边界继续按原IAM冲突记录核对,不通过改文档扩张授权模型。