Method: projects.tenants.getIamPolicy

Mendapatkan kebijakan kontrol akses untuk resource. Error akan ditampilkan jika resource tidak ada. Kebijakan kosong akan ditampilkan jika resource ada, tetapi tidak memiliki kebijakan yang ditetapkan. Pemanggil harus memiliki izin Google IAM yang tepat pada resource.

Permintaan HTTP

POST https://identitytoolkit.googleapis.com/admin/v2/{resource=projects/*/tenants/*}:getIamPolicy

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
resource

string

WAJIB: Resource yang kebijakannya diminta. Lihat Nama resource untuk mengetahui nilai yang sesuai untuk kolom ini.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "options": {
    object (GetPolicyOptions)
  }
}
Kolom
options

object (GetPolicyOptions)

OPSIONAL: Objek GetPolicyOptions untuk menentukan opsi ke tenants.getIamPolicy.

Isi respons

Jika berhasil, isi respons akan berisi instance Policy.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/identitytoolkit
  • https://www.googleapis.com/auth/firebase
  • https://www.googleapis.com/auth/cloud-platform

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

GetPolicyOptions

mengenkapsulasi setelan yang diberikan ke tenants.getIamPolicy.

Representasi JSON 
{
  "requestedPolicyVersion": integer
}
Kolom
requestedPolicyVersion

integer

Opsional. Versi kebijakan maksimum yang akan digunakan untuk memformat kebijakan.

Nilai yang valid adalah 0, 1, dan 3. Permintaan yang menentukan nilai yang tidak valid akan ditolak.

Permintaan untuk kebijakan dengan binding peran bersyarat harus menentukan versi 3. Kebijakan tanpa binding peran kondisional dapat menentukan nilai yang valid atau membiarkan kolom tidak ditetapkan.

Kebijakan dalam respons mungkin menggunakan versi kebijakan yang Anda tentukan, atau mungkin menggunakan versi kebijakan yang lebih rendah. Misalnya, jika Anda menentukan versi 3, tetapi kebijakan tidak memiliki binding peran bersyarat, respons akan menggunakan versi 1.

Untuk mempelajari resource mana yang mendukung kondisi dalam kebijakan IAM-nya, lihat dokumentasi IAM.