REST Resource: roleAssignments

{
  "roleAssignmentId": string,
  "roleId": string,
  "kind": string,
  "etag": string,
  "assignedTo": string,
  "assigneeType": enum (AssigneeType),
  "scopeType": string,
  "orgUnitId": string,
  "condition": string
}

string (int64 format)

此 roleAssignment 的 ID。

string (int64 format)

已分配的角色的 ID。

string

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

string

资源的 ETag。

string

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

enum (AssigneeType)

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

string

分配此角色的范围。

可接受的值包括：

• CUSTOMER
• ORG_UNIT

string

如果角色仅限于某个组织部门，则此字段包含仅限于该组织部门才能执行此角色的 ID。

string

可选。（公开 Beta 版 - 适用于 API 的 /admin/directory/v1.1beta1 版本）

注意：此功能适用于企业标准版、企业 Plus 版、Google Workspace 教育版 Plus 和 Cloud Identity 专业版客户。使用该功能无需进行额外设置。目前，在 Beta 版中，管理控制台 (http://admin.google.com) 尚不支持与 condition 关联的 RoleAssignment。

与此角色分配关联的条件。只有当被访问的资源满足相应条件时，设置了 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'

目前，这两个条件字符串必须是原文，并且仅适用于以下预构建的管理员角色：

• 群组编辑器
• 群组读取器

条件遵循 Cloud IAM 条件语法。