Indice
IAMPolicy(interfaccia)Binding(messaggio)GetIamPolicyRequest(messaggio)GetPolicyOptions(messaggio)Policy(messaggio)SetIamPolicyRequest(messaggio)TestIamPermissionsRequest(messaggio)TestIamPermissionsResponse(messaggio)
IAMPolicy
Panoramica dell'API
Gestisce i criteri IAM (Identity and Access Management).
Qualsiasi implementazione di un'API che offre funzionalità di controllo dell'accesso dell'accesso implementa l'interfaccia google.iam.v1.IAMPolicy.
Modello dei dati
Il controllo dell'accesso viene applicato quando un'entità (utente o account di servizio) esegue un'azione su una risorsa esposta da un servizio. Le risorse, identificate da nomi simili a URI, sono l'unità di specifica controllo dell'accesso#39;accesso. Le implementazioni dei servizi possono scegliere la granularità del controllo dell'accesso'accesso e le autorizzazioni supportate per le proprie risorse. Ad esempio, un servizio di database potrebbe consentire di specificare il controllo dell'accesso solo a livello di tabella, mentre un altro potrebbe consentire di specificarlo anche a livello di colonna.
Struttura delle norme
Vedi google.iam.v1.Policy
Questa API non è intenzionalmente in stile CRUD perché le policy di controllo dell'accesso vengono create ed eliminate implicitamente con le risorse a cui sono associate.
| GetIamPolicy |
|---|
|
Recupera la policy di controllo dell'accesso per una risorsa. Restituisce una policy vuota se la risorsa esiste e non è stata impostata una policy.
|
| SetIamPolicy |
|---|
|
Imposta la policy di controllo dell'accesso sulla risorsa specificata. Sostituisce qualsiasi policy esistente. Può restituire errori
|
| TestIamPermissions |
|---|
|
Restituisce le autorizzazioni di cui dispone un chiamante per la risorsa specificata. Se la risorsa non esiste, verrà restituito un insieme vuoto di autorizzazioni, non un errore Nota: questa operazione è progettata per la creazione di UI e strumenti a riga di comando che tengano conto delle autorizzazioni, non per il controllo delle autorizzazioni. Potrebbe verificarsi il "fail open" di questa operazione senza preavviso.
|
Associazione
Associa members, o entità, a un role.
| Campi | |
|---|---|
role |
Ruolo assegnato all'elenco di Per una panoramica dei ruoli e delle autorizzazioni IAM, consulta la documentazione di IAM. Per un elenco dei ruoli predefiniti disponibili, consulta questa pagina. |
members[] |
Specifica le entità che richiedono l'accesso a una risorsa Google Cloud.
|
condition |
La condizione associata a questa associazione. Se la condizione restituisce Se la condizione restituisce Per scoprire quali risorse supportano le condizioni nelle relative policy IAM, consulta la documentazione di IAM. |
GetIamPolicyRequest
Messaggio di richiesta per il metodo GetIamPolicy.
| Campi | |
|---|---|
resource |
OBBLIGATORIO: la risorsa per cui viene richiesta la policy. Per conoscere il valore appropriato per questo campo, consulta Nomi delle risorse. |
options |
FACOLTATIVO: un oggetto |
GetPolicyOptions
Contiene le impostazioni fornite a GetIamPolicy.
| Campi | |
|---|---|
requested_policy_version |
Facoltativo. La versione massima della policy che verrà utilizzata per formattarla. I valori validi sono 0, 1 e 3. Le richieste che specificano un valore non valido verranno rifiutate. Le richieste di norme con associazioni di ruoli condizionali devono specificare la versione 3. Le policy 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 oppure una versione precedente. Ad esempio, se specifichi la versione 3, ma la norma non ha associazioni di ruoli condizionali, la risposta utilizza la versione 1. Per scoprire quali risorse supportano le condizioni nelle relative policy IAM, consulta la documentazione di IAM. |
Norme
Una policy Identity and Access Management (IAM) che specifica i controlli dell'accesso per le risorse Google Cloud.
Una Policy è una raccolta di bindings. Un binding vincola uno o più members, o entità, a un singolo role. Le entità possono essere account utente, service account, gruppi Google e domini (ad esempio G Suite). Un role è un elenco denominato di autorizzazioni; ogni role può essere un ruolo predefinito IAM o un ruolo personalizzato creato dall'utente.
Per alcuni tipi di risorse Google Cloud, un binding può anche specificare una condition, ovvero un'espressione logica che consente l'accesso a una risorsa solo se l'espressione restituisce true. Una condizione può aggiungere vincoli in base agli attributi della richiesta, della risorsa o di entrambi. Per scoprire quali risorse supportano le condizioni nelle relative policy IAM, consulta la documentazione di IAM.
Esempio JSON:
{
"bindings": [
{
"role": "roles/resourcemanager.organizationAdmin",
"members": [
"user:mike@example.com",
"group:admins@example.com",
"domain:google.com",
"serviceAccount:my-project-id@appspot.gserviceaccount.com"
]
},
{
"role": "roles/resourcemanager.organizationViewer",
"members": [
"user:eve@example.com"
],
"condition": {
"title": "expirable access",
"description": "Does not grant access after Sep 2020",
"expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')",
}
}
],
"etag": "BwWWja0YfJA=",
"version": 3
}
Esempio YAML:
bindings:
- members:
- user:mike@example.com
- group:admins@example.com
- domain:google.com
- serviceAccount:my-project-id@appspot.gserviceaccount.com
role: roles/resourcemanager.organizationAdmin
- members:
- user:eve@example.com
role: roles/resourcemanager.organizationViewer
condition:
title: expirable access
description: Does not grant access after Sep 2020
expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
etag: BwWWja0YfJA=
version: 3
Per una descrizione di IAM e delle sue funzionalità, consulta la documentazione di IAM.
| Campi | |
|---|---|
version |
Specifica il formato della policy. I valori validi sono Qualsiasi operazione che influisce sulle associazioni di ruoli condizionali deve specificare la versione
Importante: se utilizzi le condizioni IAM, devi includere il campo Se una policy non include condizioni, le operazioni su questa policy possono specificare qualsiasi versione valida o lasciare il campo non impostato. Per scoprire quali risorse supportano le condizioni nelle relative policy IAM, consulta la documentazione di IAM. |
bindings[] |
Associa un elenco di I |
etag |
Importante: se utilizzi le condizioni IAM, devi includere il campo |
SetIamPolicyRequest
Messaggio di richiesta per il metodo SetIamPolicy.
| Campi | |
|---|---|
resource |
OBBLIGATORIO: la risorsa per cui viene specificata la policy. Per conoscere il valore appropriato per questo campo, consulta Nomi delle risorse. |
policy |
OBBLIGATORIO: la policy completa da applicare a |
TestIamPermissionsRequest
Messaggio di richiesta per il metodo TestIamPermissions.
| Campi | |
|---|---|
resource |
OBBLIGATORIO: la risorsa per cui vengono richiesti i dettagli della policy. Per conoscere il valore appropriato per questo campo, consulta Nomi delle risorse. |
permissions[] |
L'insieme di autorizzazioni da controllare per |
TestIamPermissionsResponse
Messaggio di risposta per il metodo TestIamPermissions.
| Campi | |
|---|---|
permissions[] |
Un sottoinsieme di |