Questa pagina descrive come utilizzare la replica tra bucket, che utilizza Storage Transfer Service per copiare oggetti nuovi e aggiornati in modo asincrono 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 preliminari. Per istruzioni, consulta la sezione Prima di iniziare della documentazione di Storage Transfer Service.
Crea un job di replica
Console
Quando crei un job di replica tra bucket utilizzando la console Google Cloud, all'agente di servizio Storage Transfer Service viene assegnato automaticamente il ruolo storage.legacyBucketOwner per il bucket di origine e il ruolo storage.legacyBucketWriter per il 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 la procedura di creazione dei bucket.
Per creare un job di replica per un nuovo bucket, segui le istruzioni per la creazione di 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, poi fai clic su Avanti.
Nella sezione Scegli le impostazioni di replica, svolgi i seguenti 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 Scegliere gli oggetti da replicare.
Per includere gli oggetti per 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 e poi 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 utilizzeranno per impostazione predefinita la classe di archiviazione del bucket di destinazione.
- Fai clic su Salva.
Riga di comando
Per istruzioni su come creare un job di replica con Google Cloud CLI, consulta Creare un job di replica utilizzando Google Cloud CLI.
API REST
API JSON
Per istruzioni sull'API JSON su come creare un job di replica, consulta Creare 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 job di replica
Console
Non puoi elencare i job di replica utilizzando la console Google Cloud. Per istruzioni su come visualizzare un singolo job di replica alla volta, consulta Visualizzare il job di replica.
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.
Visualizzare 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 indica se in 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 Mostrare le colonne.
Riga di comando
Per istruzioni su come visualizzare un job di replica con Google Cloud CLI, consulta Visualizzare 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 Visualizzare un job di replica utilizzando l'API JSON.
Aggiornare 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 in Pub/Sub
Il comportamento di registrazione per le operazioni dei job di replica
Lo stato del job di replica (se è attivato, disattivato o eliminato)
Console
Quando utilizzi la console Google Cloud, puoi aggiornare un job di replica solo mettendolo in pausa o riattivandolo.
- 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 la replica tra bucket visualizzato, fai clic su Metti in pausa o Ripristina accanto al job di replica da aggiornare.
Riga di comando
Per istruzioni su come aggiornare un job di replica con Google Cloud CLI, consulta Aggiornare 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 Aggiornare un job di replica utilizzando l'API JSON.
Eliminare 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 da 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 Eliminare 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 Eliminare un job di replica utilizzando l'API JSON.