Method: projects.tenants.getIamPolicy

Recupera il criterio di controllo dell'accesso per una risorsa. Se la risorsa non esiste, viene restituito un errore. Viene restituito un criterio vuoto se la risorsa esiste, ma non è impostato alcun criterio. L'utente che chiama deve disporre dell'autorizzazione Google IAM corretta per la risorsa.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
resource

string

OBBLIGATORI: la risorsa per cui viene richiesto il criterio. Consulta Nomi delle risorse per il valore appropriato per questo campo.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "options": {
    object (GetPolicyOptions)
  }
}
Campi
options

object (GetPolicyOptions)

(FACOLTATIVO) Un oggetto GetPolicyOptions per specificare le opzioni per tenants.getIamPolicy.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Policy.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la sezione Authentication Overview.

GetPolicyOptions

Incapsula le impostazioni fornite a tenants.getIamPolicy.

Rappresentazione JSON 
{
  "requestedPolicyVersion": integer
}
Campi
requestedPolicyVersion

integer

Facoltativo. La versione massima del criterio che verrà utilizzata per formattare il criterio.

I valori validi sono 0, 1 e 3. Le richieste che specificano un valore non valido verranno rifiutate.

Le richieste di criteri con associazioni di ruoli condizionali devono specificare la versione 3. I criteri senza associazioni di ruoli condizionali possono specificare qualsiasi valore valido o lasciare il campo non impostato.

Il criterio nella risposta potrebbe utilizzare la versione del criterio specificata o una versione precedente. Ad esempio, se specifichi la versione 3, ma il criterio non ha associazioni di ruoli condizionali, la risposta utilizza la versione 1.

Per scoprire quali risorse supportano le condizioni nei propri criteri IAM, consulta la documentazione di IAM.