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

Récupère la stratégie de contrôle des accès pour une ressource d'agent. Une erreur NOT_FOUND est renvoyée si la ressource n'existe pas. Une stratégie vide est renvoyée si la ressource existe, mais ne dispose d'aucune stratégie.

Requête HTTP

GET https://discoveryengine.googleapis.com/v1alpha/{resource=projects/*/locations/*/collections/*/engines/*/assistants/*/agents/*}:getIamPolicy

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
resource

string

OBLIGATOIRE : Ressource pour laquelle la stratégie est demandée. Consultez la section Noms des ressources pour connaître la valeur appropriée pour ce champ.

Paramètres de requête

Paramètres
options

object (GetPolicyOptions)

FACULTATIF : Objet GetPolicyOptions permettant de spécifier des options pour agents.getIamPolicy.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Policy.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour plus d'informations, consultez la Authentication Overview.

GetPolicyOptions

Encapsule les paramètres fournis à agents.getIamPolicy.

Représentation JSON 
{
  "requestedPolicyVersion": integer
}
Champs
requestedPolicyVersion

integer

Facultatif. Version maximale de la stratégie qui sera utilisée pour mettre en forme la stratégie.

Les valeurs acceptables sont 0, 1 et 3. Les requêtes spécifiant une valeur non valide seront rejetées.

Les requêtes de stratégies comportant des liaisons de rôle conditionnelles doivent spécifier la version 3. Les stratégies sans liaison de rôle conditionnelle peuvent spécifier une valeur valide ou laisser le champ non défini.

La stratégie de la réponse peut utiliser la version de stratégie que vous avez spécifiée ou une version antérieure. Par exemple, si vous spécifiez la version 3, mais que la stratégie ne comporte aucune liaison de rôle conditionnelle, la réponse utilise la version 1.

Pour savoir quelles ressources acceptent les conditions dans leurs stratégies IAM, consultez la documentation IAM.