Storage Transfer Service utilizza le autorizzazioni e i ruoli di Identity and Access Management (IAM) per controllare chi può accedere alle risorse di Storage Transfer Service. I tipi principali di risorse disponibili in Storage Transfer Service sono job, operazioni e pool di agenti. Nella gerarchia delle policy IAM, i job sono risorse secondarie dei progetti e le operazioni sono risorse secondarie dei job.
Per concedere l'accesso a una risorsa, assegna una o più autorizzazioni o uno o più ruoli a un utente, un gruppo o un service account.
Autorizzazioni
Puoi concedere le seguenti autorizzazioni di Storage Transfer Service:
Autorizzazione di trasferimento del progetto
| Autorizzazione | Descrizione |
|---|---|
storagetransfer.projects.getServiceAccount |
Può leggere il GoogleServiceAccount utilizzato da Storage Transfer Service per accedere ai bucket Cloud Storage. |
Autorizzazioni per i job di trasferimento
La tabella seguente descrive le autorizzazioni per i job di Storage Transfer Service:
| Autorizzazione | Descrizione |
|---|---|
storagetransfer.jobs.create |
Può creare nuovi job di trasferimento. |
storagetransfer.jobs.delete |
Può eliminare i job di trasferimento esistenti. I job di trasferimento vengono eliminati chiamando la funzione patch. Tuttavia, gli utenti devono disporre di questa autorizzazione quando eliminano i job di trasferimento per evitare errori di autorizzazione. |
storagetransfer.jobs.get |
Può recuperare job specifici. |
storagetransfer.jobs.list |
Può elencare tutti i job di trasferimento. |
storagetransfer.jobs.run |
Può eseguire tutti i job di trasferimento. |
storagetransfer.jobs.update |
Può aggiornare le configurazioni dei job di trasferimento senza eliminarle. |
Autorizzazioni per le operazioni di trasferimento
La tabella seguente descrive le autorizzazioni per le operazioni di Storage Transfer Service:
| Autorizzazione | Descrizione |
|---|---|
storagetransfer.operations.assign |
Utilizzato dagli agenti di trasferimento per assegnare le operazioni. Non supportata nei ruoli personalizzati; concedi invece il ruolo roles/storagetransfer.transferAgent predefinito. |
storagetransfer.operations.cancel |
Può annullare le operazioni di trasferimento. |
storagetransfer.operations.get |
Può visualizzare i dettagli delle operazioni di trasferimento. |
storagetransfer.operations.list |
Può elencare tutte le operazioni dei job di trasferimento. |
storagetransfer.operations.pause |
Può mettere in pausa le operazioni di trasferimento. |
storagetransfer.operations.report |
Utilizzato dagli agenti di trasferimento per segnalare lo stato di attività. Non supportata nei ruoli personalizzati; concedi invece il ruolo roles/storagetransfer.transferAgent predefinito. |
storagetransfer.operations.resume |
Può riprendere le operazioni di trasferimento in pausa. |
Trasferisci le autorizzazioni del pool di agenti
La tabella seguente descrive le autorizzazioni per i pool di agenti di trasferimento:
| Autorizzazione | Descrizione |
|---|---|
storagetransfer.agentpools.create |
Può creare pool di agenti e configurare i limiti di larghezza di banda. |
storagetransfer.agentpools.update |
Può aggiornare i pool di agenti e i limiti di larghezza di banda. |
storagetransfer.agentpools.delete |
Può eliminare i pool di agenti. |
storagetransfer.agentpools.get |
Può ottenere informazioni e limiti di larghezza di banda per pool di agenti specifici. |
storagetransfer.agentpools.list |
Può elencare le informazioni e i limiti di larghezza di banda per tutti i pool di agenti nel progetto. |
storagetransfer.agentpools.report |
Utilizzato dagli agenti di trasferimento per segnalare lo stato. Non supportata nei ruoli personalizzati; concedi invece il ruolo roles/storagetransfer.transferAgent predefinito. |
Ruoli predefiniti
Questa sezione descrive i ruoli predefiniti per Storage Transfer Service. I ruoli sono il modo preferito per impostare le autorizzazioni IAM.
Confronto dei ruoli
Puoi assegnare alle entità i seguenti ruoli predefiniti di Storage Transfer Service:
| Capacità | Storage Transfer Admin ( roles/storagetransfer.admin) |
Storage Transfer User ( roles/storagetransfer.user) |
Storage Transfer Viewer ( roles/storagetransfer.viewer) |
|---|---|---|---|
| Elenca e recupera i job | |||
| Crea e configura i job | |||
| Esegui e aggiorna i job | |||
| Elimina i job | |||
| Elenca e ottieni le operazioni di trasferimento | |||
| Metti in pausa, riprendi e annulla le operazioni di trasferimento | |||
| Leggi i dettagli del account di servizio Storage Transfer Service | |||
| Elenca e ottieni i pool di agenti | |||
| Crea e aggiorna i pool di agenti | |||
| Elimina pool di agenti | |||
| Imposta i limiti di larghezza di banda del pool di agenti |
Dettagli del ruolo
La tabella seguente descrive in dettaglio i ruoli predefiniti per Storage Transfer Service:
| Ruolo | Descrizione | Autorizzazioni incluse |
|---|---|---|
|
Storage Transfer Admin ( roles/storagetransfer.admin)
|
Fornisce l'accesso amministrativo completo a tutte le risorse di Storage Transfer Service, tra cui la creazione, l'aggiornamento, l'esecuzione e l'eliminazione di job di trasferimento e pool di agenti. |
|
|
Storage Transfer User ( roles/storagetransfer.user)
|
Fornisce le autorizzazioni per creare, recuperare, aggiornare ed eseguire job di trasferimento e pool di agenti all'interno del progetto. Non è possibile eliminare i job di trasferimento o i pool di agenti, preservando un audit log completo dei trasferimenti passati. |
|
|
Storage Transfer Viewer ( roles/storagetransfer.viewer)
|
Fornisce l'accesso di sola lettura per visualizzare ed elencare i job di trasferimento, le operazioni e i pool di agenti all'interno del progetto. Non può creare, eseguire, aggiornare o eliminare i trasferimenti. |
|
Agente di Storage Transfer
(roles/storagetransfer.transferAgent)
|
Concede agli agenti di trasferimento le autorizzazioni di Storage Transfer Service necessarie per completare un trasferimento. A partire dal 1° maggio 2024, le autorizzazioni Concedi questo ruolo all'utente o al account di servizio utilizzato dagli agenti. |
|
Agente Storage Transfer Service
(roles/storagetransfer.serviceAgent)
|
Concede all'agente di servizio Storage Transfer Service le autorizzazioni necessarie per creare e modificare gli argomenti Pub/Sub per comunicare da Google Cloud agli agenti di trasferimento. Concedi questo ruolo all'agente di servizio Storage Transfer Service. |
|
Ruoli personalizzati
Puoi creare e applicare ruoli IAM personalizzati per soddisfare i requisiti di accesso della tua organizzazione.
Quando crei ruoli personalizzati, ti consigliamo di utilizzare una combinazione di ruoli predefiniti per assicurarti che siano incluse le autorizzazioni corrette.
La console Google Cloud non funzionerà correttamente se al ruolo personalizzato mancano le autorizzazioni richieste. Ad esempio, alcune parti della console Google Cloud presumono che un ruolo abbia accesso in lettura per visualizzare un elemento prima di modificarlo, pertanto un ruolo con autorizzazioni in scrittura potrebbe riscontrare schermate della console Google Cloud che non funzionano.