Méthode : projects.locations.instances.getIamPolicy

Récupère la stratégie de contrôle d'accès d'une ressource. Renvoie une stratégie vide si la ressource existe, mais ne dispose d'aucune stratégie.

Requête HTTP

GET https://memcache.googleapis.com/v1beta2/{resource=projects/*/locations/*/instances/*}: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 documentation sur l'opération pour connaître la valeur appropriée de ce champ.

Paramètres de requête

Paramètres
options

object (GetPolicyOptions)

FACULTATIF : Objet GetPolicyOptions permettant de spécifier des options pour instances.getIamPolicy. Ce champ est utilisé uniquement par Cloud IAM.

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.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

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

Pour en savoir plus, consultez la section Présentation de l'authentification.

GetPolicyOptions

Encapsule les paramètres fournis à instances.getIamPolicy.

Représentation JSON

{
  "requestedPolicyVersion": integer
}
Champs
requestedPolicyVersion

integer

Facultatif. Version du format de stratégie à renvoyer.

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

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