Method: projects.tenants.getIamPolicy

Ruft die Zugriffssteuerungsrichtlinie für eine Ressource ab. Wenn die Ressource nicht vorhanden ist, wird ein Fehler zurückgegeben. Es wird eine leere Richtlinie zurückgegeben, wenn die Ressource vorhanden ist, aber keine Richtlinie festgelegt wurde. Der Aufrufer muss die richtige Google IAM-Berechtigung für die Ressource haben.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
resource

string

ERFORDERLICH: Die Ressource, für die die Richtlinie angefragt wird. Den passenden Wert für dieses Feld finden Sie unter Ressourcennamen.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "options": {
    object (GetPolicyOptions)
  }
}
Felder
options

object (GetPolicyOptions)

OPTIONAL: Ein Objekt des Typs GetPolicyOptions zum Festlegen von Optionen für tenants.getIamPolicy.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Policy.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.

GetPolicyOptions

Kapselt die Einstellungen für tenants.getIamPolicy.

JSON-Darstellung 
{
  "requestedPolicyVersion": integer
}
Felder
requestedPolicyVersion

integer

Optional. Die maximale Richtlinienversion, die zum Formatieren der Richtlinie verwendet wird.

Gültige Werte sind 0, 1 und 3. Anfragen mit einem ungültigen Wert werden abgelehnt.

Anfragen für Richtlinien mit bedingten Bindungen müssen Version 3 angeben. Richtlinien ohne bedingte Rollenbindungen können einen beliebigen gültigen Wert angeben oder das Feld ohne Festlegung lassen.

Die Richtlinie in der Antwort verwendet möglicherweise die von Ihnen angegebene Richtlinienversion oder eine niedrigere Richtlinienversion. Wenn Sie beispielsweise Version 3 angeben, die Richtlinie jedoch keine bedingten Rollenbindungen hat, verwendet die Antwort Version 1.

Welche Ressourcen Bedingungen in ihren IAM-Richtlinien unterstützen, erfahren Sie in der IAM-Dokumentation.