Autorizzazioni 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. Storage Transfer Service offre vari tipi di 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, assegna una o più autorizzazioni o ruoli a un utente, un gruppo o un account di servizio.

Autorizzazioni

Puoi concedere le seguenti autorizzazioni di Storage Transfer Service:

Trasferisci autorizzazione progetto

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

Trasferisci autorizzazioni job

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 del job di trasferimento senza eliminarle.

Autorizzazioni per Transfer Operations

La seguente tabella 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 Consente di 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.

Autorizzazioni del pool di agenti di trasferimento

La seguente tabella 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ò ricevere 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 per Storage Transfer Service. I ruoli sono il modo preferito per impostare le autorizzazioni IAM.

Confronto ruoli

Puoi assegnare i seguenti ruoli di progetto o ruoli predefiniti di Storage Transfer Service:

Capacità Editor (roles/editor) Trasferimento spazio di archiviazione (roles/storagetransfer.)
Amministratore (admin) Utente (user) Visualizzatore (viewer)
Elenca/recupera job
Creazione di job
Esegui job
Aggiorna job
Elimina i job
Operazioni di trasferimento list/get
Metti in pausa/riprendi le operazioni di trasferimento
Legge 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
Ottieni pool di agenti
Lettura o impostazione della larghezza di banda del progetto

Dettagli del ruolo

La tabella seguente 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:questo è il ruolo di livello più alto con responsabilità più ampie, ovvero il super user che supporta i colleghi durante i trasferimenti. Questa opzione è più adatta a chi amministrerà 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 che devono eseguire trasferimenti nell'ambito della loro funzione lavorativa, ad esempio un dipendente. Questo ruolo non consente l'eliminazione del trasferimento, in modo che i revisori o il personale di sicurezza possano visualizzare un registro completamente conservato dei trasferimenti passati.

  • 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 operazioni di trasferimento all'interno del progetto. L'utente non può pianificare, aggiornare o eliminare i job.

Motivazione:il ruolo di visualizzatore è destinato all'accesso di sola lettura per visualizzare i job e le operazioni di trasferimento. Questo ruolo consente di separare le attività di report e controllo dalla creazione e dalla gestione dei job. Questo ruolo è più adatto agli utenti o ai team interni che controllano l'utilizzo dei trasferimenti, ad esempio responsabili di sicurezza, conformità o di 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'account utente o 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 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.

  • 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 dell'organizzazione.

Quando crei ruoli personalizzati, ti consigliamo di utilizzare una combinazione di ruoli predefiniti per garantire 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 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.