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입니다. Identity and Access Management (IAM)에 정의된 대로 사용자의 userId, 그룹의 groupId 또는 서비스 계정의 uniqueId입니다.
assigneeType

enum (AssigneeType)

출력 전용입니다. 할당된 담당자의 유형 (USER 또는 GROUP)입니다.
scopeType

string

이 역할이 할당된 범위입니다.

사용 가능한 값:

  • CUSTOMER
  • ORG_UNIT
orgUnitId

string

역할이 조직 단위로 제한된 경우 이 역할의 실행이 제한된 조직 단위의 ID가 포함됩니다.
condition

string

선택사항입니다. 이 역할 할당과 연결된 조건입니다.

참고: 이 기능은 Enterprise Standard, Enterprise Plus, Google Workspace for Education Plus, Cloud ID Premium 고객에게 제공됩니다.

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 조건 구문을 따릅니다.

  • RoleAssignment가 잠긴 그룹에 적용되지 않도록 하려면 다음을 실행하세요. !api.getAttribute('cloudidentity.googleapis.com/groups.labels', []).hasAny(['groups.locked']) && resource.type == 'cloudidentity.googleapis.com/Group'

이 조건은 보안 관련 조건과 함께 사용할 수도 있습니다.

AssigneeType

역할이 할당된 ID의 유형입니다.

열거형
USER 도메인 내의 개별 사용자입니다.
GROUP 도메인 내 그룹

메서드

delete

 역할 할당을 삭제합니다.

get

 역할 할당을 가져옵니다.

insert

 역할 할당을 만듭니다.

list

 모든 roleAssignments의 페이지로 구분된 목록을 가져옵니다.