Permessi e ruoli

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 dei criteri IAM, i job sono risorse figlio dei progetti, mentre le operazioni sono risorse figlio dei job.

Per concedere l'accesso a una risorsa, devi assegnare una o più autorizzazioni o ruoli a un utente, a un gruppo o a un account di servizio.

Autorizzazioni

Puoi concedere le seguenti autorizzazioni di Storage Transfer Service:

Trasferisci autorizzazione di progetto

Autorizzazione Descrizione
storagetransfer.projects.getServiceAccount Può leggere l'Account GoogleServiceAccount utilizzato da Storage Transfer Service per accedere ai bucket Cloud Storage.

Autorizzazioni 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.
storagetransfer.operations.cancel Può annullare le operazioni di trasferimento.
storagetransfer.operations.get Può ottenere i dettagli delle operazioni di trasferimento.
storagetransfer.operations.list Può elencare tutte le operazioni del 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 dell'operazione.
storagetransfer.operations.resume Può riprendere le operazioni di trasferimento in pausa.

Trasferisci autorizzazioni del pool di agenti

La tabella seguente descrive le autorizzazioni per i pool di agenti di trasferimento del file system:

Autorizzazione Descrizione
storagetransfer.agentpools.create Può creare pool di agenti.
storagetransfer.agentpools.update Può aggiornare i pool di agenti.
storagetransfer.agentpools.delete Può eliminare i pool di agenti.
storagetransfer.agentpools.get Può ottenere informazioni su pool di agenti specifici.
storagetransfer.agentpools.list Può elencare le informazioni per tutti i pool di agenti nel progetto.
storagetransfer.agentpools.report Utilizzato dagli agenti di trasferimento per segnalare lo stato.

Ruoli predefiniti

Questa sezione descrive i ruoli predefiniti di Storage Transfer Service. I ruoli sono il modo migliore per impostare le autorizzazioni IAM.

Confronto dei ruoli

Puoi assegnare il seguente ruolo di progetto o i ruoli predefiniti di Storage Transfer Service:

Capacità Editor (roles/editor) Trasferimento dello spazio di archiviazione (roles/storagetransfer.)
Amministratore (admin) Utente (user) Visualizzatore (viewer)
Elenco/recupera job
Creazione di job
Esegui job
Aggiorna job
Elimina i job
Elenca/recupera le operazioni di trasferimento
Metti in pausa/riprendi le operazioni di trasferimento
Leggi i dettagli dell'account di servizio Google utilizzati da Storage Transfer Service per accedere ai bucket Cloud Storage.
Elenca agenti
Elenca pool di agenti
Crea pool di agenti
Aggiorna pool di agenti
Elimina pool di agenti
Recupera pool di agenti
Leggi o imposta la larghezza di banda del progetto

Dettagli del ruolo

La seguente tabella descrive in dettaglio i ruoli predefiniti per Storage Transfer Service:

Ruolo Descrizione Autorizzazioni incluse
Amministratore Storage Transfer
(roles/storagetransfer.
admin
)

Fornisce tutte le autorizzazioni di Storage Transfer Service, inclusa l'eliminazione dei job.

Motivazione: si tratta del ruolo di livello più elevato con le responsabilità più ampie, ovvero il super user che supporta i propri colleghi durante i trasferimenti. Questo è più adatto alle persone che amministreranno i trasferimenti, ad esempio gli amministratori IT.

  • resourcemanager.projects.get
  • resourcemanager.projects.list
  • storagetransfer.*
Utente Storage Transfer
(roles/storagetransfer.
user
)

Fornisce all'utente le autorizzazioni per creare, ottenere, aggiornare ed elencare i job di trasferimento all'interno del progetto. Tuttavia, non possono eliminare i propri job.

Motivazione:questo ruolo consente di separare la creazione e la gestione dei job dall'eliminazione dei job. Questo ruolo è più adatto agli utenti a cui viene chiesto di eseguire trasferimenti nell'ambito della propria funzione lavorativa, ad esempio un dipendente. Questo ruolo non consente l'eliminazione del trasferimento, in modo che i revisori o il personale addetto alla sicurezza possano visualizzare un registro completamente conservato dei trasferimenti precedenti.

  • resourcemanager.projects.get
  • resourcemanager.projects.list
  • storagetransfer.agentpools.create
  • storagetransfer.agentpools.get
  • storagetransfer.agentpools.list
  • storagetransfer.agentpools.report
  • storagetransfer.agentpools.update
  • storagetransfer.jobs.create
  • storagetransfer.jobs.get
  • storagetransfer.jobs.list
  • storagetransfer.jobs.run
  • storagetransfer.jobs.update
  • storagetransfer.operations.*
  • storagetransfer.projects.getServiceAccount
Visualizzatore Storage Transfer
(roles/storagetransfer.
viewer
)

Fornisce le autorizzazioni per elencare e ottenere job e le operazioni di trasferimento all'interno del progetto. L'utente non può pianificare, aggiornare o eliminare job.

Motivazione:il ruolo Visualizzatore è destinato all'accesso di sola lettura per visualizzare le operazioni e i job di trasferimento. Questo ruolo consente di separare le attività del report e di controllo dalla creazione e dalla gestione dei job. Questo ruolo è più adatto agli utenti o ai team interni che controllano l'utilizzo del trasferimento, ad esempio responsabili della sicurezza, della conformità o delle unità aziendali.

  • resourcemanager.projects.get
  • resourcemanager.projects.list
  • storagetransfer.agentpools.get
  • storagetransfer.agentpools.list
  • storagetransfer.jobs.get
  • storagetransfer.jobs.list
  • storagetransfer.operations.get
  • storagetransfer.operations.list
  • storagetransfer.projects.getServiceAccount
Agente 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 "pubsub" non sono più necessarie.

Concedi questo ruolo all'utente o all'account di servizio utilizzato dagli agenti.

  • monitoring.timeSeries.create
  • storagetransfer.operations.get
  • storagetransfer.operations.report
  • storagetransfer.operations.assign
  • storagetransfer.agentpools.report
  • pubsub.topics.create
  • pubsub.topics.get
  • pubsub.topics.list
  • pubsub.subscriptions.create
  • pubsub.subscriptions.get
  • pubsub.subscriptions.delete
  • pubsub.subscriptions.consume
  • pubsub.topics.attachSubscription
  • pubsub.topics.publish
Agente di servizio Storage Transfer (roles/storagetransfer.serviceAgent)

Concede all' agente di servizio Storage Transfer Service le autorizzazioni necessarie per creare e modificare gli argomenti Pub/Sub in modo da comunicare da Google Cloud agli agenti per il trasferimento.

Concedi questo ruolo all' agente di servizio Storage Transfer Service.

  • pubsub.subscriptions.consume
  • pubsub.subscriptions.create
  • pubsub.subscriptions.delete
  • pubsub.subscriptions.get
  • pubsub.subscriptions.update
  • pubsub.topics.attachSubscription
  • pubsub.topics.create
  • pubsub.topics.delete
  • pubsub.topics.get
  • pubsub.topics.publish
  • pubsub.topics.update

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 garantire che vengano incluse le autorizzazioni corrette.

La console Google Cloud non funzionerà correttamente se il ruolo personalizzato non ha le autorizzazioni richieste. Ad esempio, alcune parti della console Google Cloud presuppongono che un ruolo abbia accesso in lettura per visualizzare un elemento prima di modificarlo, quindi un ruolo con solo autorizzazioni di scrittura potrebbe visualizzare schermate della console Google Cloud che non funzionano.