大网数据广告活动
Microsoft Graph 接口

appRoleAssignment 资源类型

· 52CE 我爱测

用于记录何时将用户、组或服务主体分配给应用程序的服务主体上的应用角色。可以创建、读取和删除应用角色分配。

命名空间:microsoft.graph

用于记录何时将用户、组或服务主体分配给应用的应用角色。

应用角色分配是分配的主体(用户、组或服务主体)、资源应用程序(应用的服务主体)与在资源应用程序上定义的应用角色之间的关系。

如果已分配给主体的 应用角色 的 值 属性不为空,则将其包含在主题为已分配主体的令牌(例如 SAML 响应、ID 令牌、标识已登录用户的访问令牌或者标识服务主体的访问令牌)角色 声明中。应用程序和 API 将这些声明用作授权逻辑的一部分。

可直接向用户分配应用角色。 如果将某应用角色分配给组,则该组的直接成员也将被视为已分配了该应用角色。 向用户分配应用程序的应用角色后,该应用程序的磁贴将显示在用户的 MyApps 门户和 Microsoft 365 应用启动器中。

分配的主体为服务主体的应用角色分配是 仅限应用权限 授予。当用户或管理员同意仅限应用的权限时,将创建应用角色分配,其中分配的主体是客户端应用程序的服务主体,资源是目标 API 的服务主体。

属性

属性 类型 说明
appRoleId Guid 分配给主体的 应用角色的标识符 (id)。 必须在资源应用程序的服务主体 (resourceId) 上的 appRoles 属性中公开此应用角色。 如果资源应用程序尚未声明任何应用角色,则可以指定默认应用角色 ID 00000000-0000-0000-0000-000000000000,以表示将主体分配给资源应用,但没有任何特定应用角色。 创建时为必需项。
createdDateTime DateTimeOffset 创建应用角色分配的时间。时间戳类型表示使用 ISO 8601 格式的日期和时间信息,并且始终采用 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 表示为:2014-01-01T00:00:00Z。只读。
id String appRoleAssignment 键的唯一标识符。不可为 null。只读。
principalDisplayName String 已被授予应用角色分配的用户、组或服务主体的显示名称。支持 $filter(eq 和 startswith)。
principalId Guid 被授予应用角色的 用户、组 或 服务主体 的唯一标识符(id)。创建时需要。
principalType 字符串 已分配的主体的类型。 这可以是 User、Group 或 ServicePrincipal。 只读。
resourceDisplayName 字符串 已为其分配的资源应用的服务主体的显示名称。
resourceId Guid 已为其进行分配的资源 服务主体 的唯一标识符(id)。创建时需要。支持$filter(仅限 eq)。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "appRoleId": "Guid",
  "createdDateTime": "String (timestamp)",
  "id": "String",
  "principalDisplayName": "String",
  "principalId": "Guid",
  "principalType": "String",
  "resourceDisplayName": "String",
  "resourceId": "Guid"
}

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 psignoret)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。