In questa pagina viene descritto come utilizzare la replica tra bucket, che utilizza Storage Transfer Service per copiare in modo asincrono gli oggetti nuovi e aggiornati da un bucket di origine a un bucket di destinazione. Quando utilizzi la replica tra bucket, crei e gestisci i job di replica, che sono un tipo di job in Storage Transfer Service.
Prima di iniziare
Per utilizzare la replica tra bucket, devi completare i passaggi dei prerequisiti. Per le istruzioni, consulta Prima di iniziare nella documentazione di Storage Transfer Service.
Crea un job di replica
Console
Quando crei un job di replica tra bucket utilizzando la consoleGoogle Cloud , all'agente di servizio Storage Transfer Service viene concesso automaticamente il ruolo storage.legacyBucketOwner sul bucket di origine e il ruolo storage.legacyBucketWriter sul bucket di destinazione.
Quando utilizzi la console Google Cloud , puoi creare un job di replica per i bucket esistenti o per i nuovi bucket durante il processo di creazione dei bucket.
Per creare un job di replica per un nuovo bucket, segui le istruzioni per creare un nuovo bucket.
Per creare un job di replica per un bucket esistente, completa i seguenti passaggi:
- Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket di origine di cui vuoi replicare gli oggetti.
Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.
Individua l'opzione Replica tra bucket e fai clic su Modifica.
Nel riquadro Modifica replica tra bucket che si apre, fai clic su Aggiungi una destinazione.
Nella sezione Scegli una destinazione, seleziona un bucket di destinazione, quindi fai clic su Avanti.
Nella sezione Scegli le impostazioni di replica, segui questi passaggi:
(Facoltativo) Per filtrare gli oggetti da replicare in base al prefisso del nome dell'oggetto, seleziona la casella di controllo Replica oggetti in base al prefisso nella sezione Scegli gli oggetti da replicare.
Per includere gli oggetti in base al prefisso, inserisci un prefisso nella sezione Includi oggetti con prefisso, quindi fai clic su Aggiungi un prefisso.
Per escludere gli oggetti in base al prefisso, inserisci un prefisso nella sezione Escludi oggetti con prefisso, quindi fai clic su Aggiungi un prefisso.
(Facoltativo) Per impostare una classe di archiviazione per gli oggetti replicati, seleziona una classe di archiviazione dal menu nella sezione Imposta classe di archiviazione per gli oggetti replicati.
Se salti questo passaggio, gli oggetti replicati utilizzano la classe di archiviazione del bucket di destinazione per impostazione predefinita.
- Fai clic su Salva.
Riga di comando
Per istruzioni su come creare un job di replica con Google Cloud CLI, consulta Crea un job di replica utilizzando Google Cloud CLI.
API REST
API JSON
Per istruzioni su come creare un job di replica con l'API JSON, consulta Crea un job di replica utilizzando l'API JSON.
Per controllare lo stato del job di replica, visualizza i log di Cloud Logging per Storage Transfer Service.
Elenca i job di replica
Console
Non puoi elencare i job di replica utilizzando la console Google Cloud . Consulta Visualizza job di replica per istruzioni su come visualizzare un singolo job di replica alla volta.
Riga di comando
Per istruzioni su come elencare i job di replica con Google Cloud CLI, consulta Elenca i job di replica utilizzando Google Cloud CLI.
API REST
API JSON
Per istruzioni sull'API JSON su come elencare i job di replica, consulta Elenca i job di replica utilizzando l'API JSON.
Visualizza un job di replica
Console
- Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket di origine di cui vuoi visualizzare il job di replica tra bucket.
Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.
Individua l'opzione Replica tra bucket e fai clic su Modifica.
Viene visualizzato il riquadro Modifica replica tra bucket, che mostra il job di replica per ogni bucket di destinazione.
Nella pagina Bucket, puoi visualizzare la colonna Replica, che mostra se per un bucket è in esecuzione un job di replica turbo o un job di replica tra bucket. Per istruzioni su come visualizzare la colonna Replica, consulta Mostra colonne.
Riga di comando
Per istruzioni su come visualizzare un job di replica con Google Cloud CLI, consulta Visualizza un job di replica utilizzando Google Cloud CLI.
API REST
API JSON
Per istruzioni sull'API JSON su come visualizzare un job di replica, consulta Visualizza un job di replica utilizzando l'API JSON.
Aggiorna un job di replica
Puoi aggiornare i seguenti campi di un job di replica:
La descrizione del job di replica
La configurazione per l'esecuzione di un job di replica
La configurazione delle notifiche pubblicate su Pub/Sub
Il comportamento di logging per le operazioni dei job di replica
Lo stato del job di replica (se è abilitato, disabilitato o eliminato)
Console
Quando utilizzi la console Google Cloud , puoi aggiornare un job di replica solo mettendolo in pausa o riprendendolo.
- Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket di origine per cui vuoi mettere in pausa o riprendere la replica.
Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.
Individua l'opzione Replica tra bucket e fai clic su Modifica.
Nel riquadro Modifica replica tra bucket visualizzato, fai clic su Metti in pausa o Riprendi accanto al job di replica che vuoi aggiornare.
Riga di comando
Per istruzioni su come aggiornare un job di replica con Google Cloud CLI, consulta Aggiorna un job di replica utilizzando Google Cloud CLI.
API REST
API JSON
Per istruzioni sull'API JSON su come aggiornare un job di replica, consulta Aggiorna un job di replica utilizzando l'API JSON.
Elimina un job di replica
Console
- Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket di origine per cui vuoi interrompere la replica.
Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.
Individua l'opzione Replica tra bucket e fai clic su Modifica.
Nel riquadro Modifica replica tra bucket visualizzato, fai clic su Elimina accanto al job di replica che vuoi eliminare.
Nella finestra di dialogo visualizzata, fai clic su Conferma.
Riga di comando
Per istruzioni su come eliminare un job di replica con Google Cloud CLI, consulta Elimina un job di replica utilizzando Google Cloud CLI.
API REST
API JSON
Per istruzioni sull'API JSON su come eliminare un job di replica, consulta Elimina un job di replica utilizzando l'API JSON.
Passaggi successivi
Monitora gli oggetti replicati.