精简角色上下文与能力对象

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冲突记录核对,不通过改文档扩张授权模型。

最后更新于