Methode: projects.locations.instances.getIamPolicy

Ruft die Zugriffssteuerungsrichtlinie für eine Ressource ab. Gibt eine leere Richtlinie zurück, wenn die Ressource vorhanden und keine Richtlinie festgelegt ist.

HTTP-Anfrage

GET https://memcache.googleapis.com/v1beta2/{resource=projects/*/locations/*/instances/*}: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 in der Betriebsdokumentation.

Suchparameter

Parameter
options

object (GetPolicyOptions)

OPTIONAL: Ein Objekt des Typs GetPolicyOptions zum Festlegen von Optionen für instances.getIamPolicy. Dieses Feld wird nur von Cloud IAM verwendet.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentifizierung.

GetPolicyOptions

Kapselt die Einstellungen für "instances.getIamPolicy".

JSON-Darstellung

{
  "requestedPolicyVersion": integer
}
Felder
requestedPolicyVersion

integer

Optional. Die Version des Richtlinienformats, die zurückgegeben werden soll.

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 Bindungen können einen beliebigen gültigen Wert angeben oder das Feld ohne Festlegung lassen.