REST Resource: roleAssignments

资源：RoleAssignment

定义角色的分配。

JSON 表示法 
{
  "roleAssignmentId": string,
  "roleId": string,
  "kind": string,
  "etag": string,
  "assignedTo": string,
  "assigneeType": enum (AssigneeType),
  "scopeType": string,
  "orgUnitId": string,
  "condition": string
}
字段
roleAssignmentId

string (int64 format)

相应 roleAssignment 的 ID。
roleId

string (int64 format)

已分配的角色的 ID。
kind

string

API 资源的类型。始终为 admin#directory#roleAssignment。
etag

string

资源的 ETag。
assignedTo

string

此角色所分配到的实体的唯一 ID，即用户的 userId、群组的 groupId 或服务账号的 uniqueId（如 Identity and Access Management (IAM) 中所定义）。
assigneeType

enum (AssigneeType)

仅限输出。分配对象的类型（USER 或 GROUP）。
scopeType

string

分配此角色的范围。

可接受的值包括：

  • CUSTOMER
  • ORG_UNIT
orgUnitId

string

如果角色仅限在某个组织部门中使用，则此字段包含相应组织部门的 ID。
condition

string

可选。与此角色分配相关联的条件。

注意：此功能适用于企业标准版、企业 Plus 版、Google Workspace 教育 Plus 版和 Cloud Identity 专业版客户。

设置了 condition 字段的 RoleAssignment 仅在所访问的资源满足相应条件时才会生效。如果 condition 为空，则将角色 (roleId) 无条件地应用于范围 (scopeType) 内的行为者 (assignedTo)。

目前，支持以下条件：

  • 如需使 RoleAssignment 仅适用于安全组，请执行以下操作：api.getAttribute('cloudidentity.googleapis.com/groups.labels', []).hasAny(['groups.security']) && resource.type == 'cloudidentity.googleapis.com/Group'

  • 如需使 RoleAssignment 不适用于安全组，请执行以下操作：!api.getAttribute('cloudidentity.googleapis.com/groups.labels', []).hasAny(['groups.security']) && resource.type == 'cloudidentity.googleapis.com/Group'

目前，条件字符串必须完全相同，并且仅适用于以下预先创建的管理员角色：

  • Groups Editor
  • Groups Reader

条件遵循 Cloud IAM 条件语法。

  • 如需使 RoleAssignment 不适用于锁定的群组，请执行以下操作：!api.getAttribute('cloudidentity.googleapis.com/groups.labels', []).hasAny(['groups.locked']) && resource.type == 'cloudidentity.googleapis.com/Group'

此条件也可与安全相关条件搭配使用。

AssigneeType

分配角色的身份类型。

枚举
USER 网域中的个人用户。
GROUP 网域中的群组。

方法

delete

 删除角色分配。

get

 检索角色分配。

insert

 创建角色分配。

list

 检索所有 roleAssignment 的分页列表。