REST Resource: roleAssignments

Resource: RoleAssignment

Menentukan penetapan peran.

Representasi JSON 
{
  "roleAssignmentId": string,
  "roleId": string,
  "kind": string,
  "etag": string,
  "assignedTo": string,
  "assigneeType": enum (AssigneeType),
  "scopeType": string,
  "orgUnitId": string,
  "condition": string,
  "expirationDetails": {
    object (ExpirationDetails)
  }
}
Kolom
roleAssignmentId

string (int64 format)

ID roleAssignment ini.
roleId

string (int64 format)

ID peran yang ditetapkan.
kind

string

Jenis resource API. Ini selalu admin#directory#roleAssignment.
etag

string

ETag resource.
assignedTo

string

ID unik entitas yang diberi peran ini—baik userId pengguna, groupId grup, atau uniqueId akun layanan seperti yang ditentukan dalam Identity and Access Management (IAM).
assigneeType

enum (AssigneeType)

Hanya output. Jenis penerima tugas (USER atau GROUP).
scopeType

string

Cakupan tempat peran ini ditetapkan.

Nilai yang dapat diterima adalah:

  • CUSTOMER
  • ORG_UNIT
orgUnitId

string

Jika peran dibatasi untuk unit organisasi, kolom ini berisi ID untuk unit organisasi yang membatasi penggunaan peran ini.
condition

string

Opsional. Kondisi yang terkait dengan penetapan peran ini.

Catatan: Fitur ini tersedia untuk pelanggan Enterprise Standard, Enterprise Plus, Google Workspace for Education Plus, dan Cloud Identity Premium.

RoleAssignment dengan kolom condition yang ditetapkan hanya akan berlaku jika resource yang diakses memenuhi kondisi. Jika condition kosong, peran (roleId) diterapkan ke aktor (assignedTo) pada cakupan (scopeType) tanpa syarat.

Saat ini, kondisi berikut didukung:

  • Agar RoleAssignment hanya berlaku untuk Grup Keamanan: api.getAttribute('cloudidentity.googleapis.com/groups.labels', []).hasAny(['groups.security']) && resource.type == 'cloudidentity.googleapis.com/Group'

  • Agar RoleAssignment tidak berlaku untuk Grup Keamanan: !api.getAttribute('cloudidentity.googleapis.com/groups.labels', []).hasAny(['groups.security']) && resource.type == 'cloudidentity.googleapis.com/Group'

Saat ini, string kondisi harus sama persis dan hanya berfungsi dengan peran administrator standar berikut:

  • Groups Editor
  • Groups Reader

Kondisi mengikuti sintaksis kondisi Cloud IAM.

  • Agar RoleAssignment tidak berlaku untuk Grup Terkunci: !api.getAttribute('cloudidentity.googleapis.com/groups.labels', []).hasAny(['groups.locked']) && resource.type == 'cloudidentity.googleapis.com/Group'

Kondisi ini juga dapat digunakan bersama dengan kondisi terkait Keamanan.
expirationDetails

object (ExpirationDetails)

Opsional. Detail terkait masa berlaku penetapan peran ini.

AssigneeType

Jenis identitas yang diberi peran.

Enum
USER Pengguna perorangan dalam domain.
GROUP Grup dalam domain.

ExpirationDetails

Detail terkait masa berlaku penetapan peran ini. Digunakan untuk mencabut akses secara otomatis saat batas waktu tercapai.

Representasi JSON 
{

  "expireTime": string
}
Kolom

Kolom union expiration.

expiration hanya dapat berupa salah satu dari hal berikut:
expireTime

string (Timestamp format)

Stempel waktu spesifik saat penetapan peran berakhir.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

Metode

delete

 Menghapus penetapan peran.

get

 Mengambil penetapan peran.

insert

 Membuat penetapan peran.

list

 Mengambil daftar semua roleAssignment bernomor halaman.