Method: projects.locations.collections.engines.assistants.agents.getIamPolicy

Ruft die Zugriffssteuerungsrichtlinie für eine Agent-Ressource ab. Wenn die Ressource nicht vorhanden ist, wird ein NOT_FOUND-Fehler zurückgegeben. Eine leere Richtlinie wird zurückgegeben, wenn die Ressource vorhanden ist, aber keine Richtlinie dafür festgelegt wurde.

HTTP-Anfrage

GET https://discoveryengine.googleapis.com/v1alpha/{resource=projects/*/locations/*/collections/*/engines/*/assistants/*/agents/*}: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.

Anfrageparameter

Parameter
options

object (GetPolicyOptions)

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

Anfragetext

Der Anfragetext muss leer sein.

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/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite

Weitere Informationen finden Sie unter Authentication Overview.

GetPolicyOptions

Kapselt die Einstellungen für agents.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 Rollenbindungen müssen Version 3 angeben. Richtlinien ohne bedingte Rollenbindungen können einen beliebigen gültigen Wert angeben oder das Feld bleibt ohne festgelegten Wert.

Die Richtlinie in der Antwort kann die von Ihnen angegebene Richtlinienversion oder eine niedrigere Richtlinienversion verwenden. 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.