REST Resource: roleAssignments

Recurso: RoleAssignment

Define uma atribuição de uma função.

Representação JSON 
{
  "roleAssignmentId": string,
  "roleId": string,
  "kind": string,
  "etag": string,
  "assignedTo": string,
  "assigneeType": enum (AssigneeType),
  "scopeType": string,
  "orgUnitId": string,
  "condition": string
}
Campos
roleAssignmentId

string (int64 format)

ID desta roleAssignment.
roleId

string (int64 format)

O ID da função atribuída.
kind

string

O tipo do recurso da API. Esse valor é sempre admin#directory#roleAssignment.
etag

string

ETag do recurso.
assignedTo

string

O ID exclusivo da entidade a que este papel está atribuído: o userId de um usuário, o groupId de um grupo ou o uniqueId de uma conta de serviço, conforme definido no Gerenciamento de identidade e acesso (IAM).
assigneeType

enum (AssigneeType)

Apenas saída. O tipo de pessoa atribuída (USER ou GROUP).
scopeType

string

O escopo em que essa função é atribuída.

Os valores aceitáveis são:

  • CUSTOMER
  • ORG_UNIT
orgUnitId

string

Se a função for restrita a uma unidade organizacional, isso vai conter o ID da unidade em que o exercício dessa função é restrito.
condition

string

Opcional. A condição associada a essa atribuição de função.

Observação: o recurso está disponível para clientes do Enterprise Standard, Enterprise Plus, Google Workspace for Education Plus e Cloud Identity Premium.

Um RoleAssignment com o campo condition definido só vai entrar em vigor quando o recurso acessado atender à condição. Se condition estiver vazio, a função (roleId) será aplicada ao ator (assignedTo) no escopo (scopeType) incondicionalmente.

No momento, as seguintes condições são aceitas:

  • Para que o RoleAssignment seja aplicável apenas aos grupos de segurança: api.getAttribute('cloudidentity.googleapis.com/groups.labels', []).hasAny(['groups.security']) && resource.type == 'cloudidentity.googleapis.com/Group'

  • Para tornar o RoleAssignment não aplicável aos grupos de segurança: !api.getAttribute('cloudidentity.googleapis.com/groups.labels', []).hasAny(['groups.security']) && resource.type == 'cloudidentity.googleapis.com/Group'

No momento, as strings de condição precisam ser idênticas e só funcionam com as seguintes funções de administrador predefinidas:

  • Editor de grupos
  • Leitor de grupos

A condição segue a sintaxe de condição do Cloud IAM.

  • Para tornar o RoleAssignment não aplicável aos Grupos restritos: !api.getAttribute('cloudidentity.googleapis.com/groups.labels', []).hasAny(['groups.locked']) && resource.type == 'cloudidentity.googleapis.com/Group'

Essa condição também pode ser usada com uma condição relacionada à segurança.

AssigneeType

O tipo de identidade a que um papel é atribuído.

Enums
USER Um usuário individual no domínio.
GROUP Um grupo no domínio.

Métodos

delete

 Exclui uma atribuição de função.

get

 Recupera uma atribuição de função.

insert

 Cria uma atribuição de função.

list

 Recupera uma lista paginada de todas as roleAssignments.