appRoleAssignment 资源类型

命名空间:microsoft.graph

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

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

当已分配给主体 的应用角色 具有 nonempty 属性时,它将包含在令牌 的角色 声明中,其中主体是分配的主体 (例如 SAML 响应、ID 令牌、标识已登录用户的访问令牌或标识服务主体) 的访问令牌。 应用程序和 API 会将这些声明用作其授权逻辑的一部分。

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

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

方法

方法 返回类型 说明
列出组的应用角色分配 appRoleAssignment 集合 获取组的 appRoleAssignment 对象及其属性的列表。
列出用户的应用角色分配 appRoleAssignment 集合 获取用户的 appRoleAssignment 对象及其属性的列表。
列出客户端服务主体的应用角色分配 appRoleAssignment 集合 获取客户端服务主体的 appRoleAssignment 对象及其属性的列表。
列出资源服务主体的用户、组和客户端服务主体的应用角色分配 appRoleAssignment 集合 获取指定资源服务主体的用户、组和客户端服务主体 的 appRoleAssignment 对象及其属性的列表。
向组授予应用角色 appRoleAssignment 为组创建新的 appRoleAssignment 对象。
向用户授予应用角色 appRoleAssignment 为用户创建新的 appRoleAssignment 对象。
向客户端服务主体授予应用角色 appRoleAssignment 集合 为客户端服务主体创建新的 appRoleAssignment 对象。
将应用角色分配授予资源服务主体的用户、组或客户端服务主体 appRoleAssignment 集合 为指定资源服务主体的用户、组或客户端服务主体创建新的 appRoleAssignment 对象。
获取应用角色分配 appRoleAssignment 获取分配给资源服务主体的用户、组或客户端服务主体的 appRoleAssignment 对象。
删除组的应用角色分配 None 从组中删除 appRoleAssignment 对象。
删除用户的应用角色分配 None 从用户中删除 appRoleAssignment 对象。
删除客户端服务主体的应用角色分配 None 从客户端服务主体中删除 appRoleAssignment 对象。
将用户、组或客户端服务主体的应用角色分配删除到资源服务主体 None 从指定资源服务主体的用户、组或客户端服务主体中删除 appRoleAssignment 对象。

属性

属性 类型 说明
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。 只读。
deletedDateTime DateTimeOffset 删除应用角色分配的日期和时间。 始终 null 针对尚未删除的 appRoleAssignment 对象。 继承自 directoryObject
id String appRoleAssignment 密钥的唯一标识符。 不可为 null。 只读。
principalDisplayName 字符串 已被授予应用角色分配的用户、组或服务主体的显示名称。 只读。 支持 $filtereqstartswith)。
principalId Guid 被授予应用角色的用户安全组或服务主体的唯一标识符 (ID) 。 支持具有动态成员身份的安全组。 创建时为必需项。
principalType 字符串 已分配的主体的类型。 这可以是 UserGroupServicePrincipal。 只读。
resourceDisplayName 字符串 已为其分配的资源应用的服务主体的显示名称。
resourceId Guid 已为其分配的资源服务主体的唯一标识符 (id)。 创建时为必需项。 支持 $filter(仅 eq)。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

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