Questa pagina descrive 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 preliminari. Per istruzioni, consulta la sezione 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 bucket esistenti o per nuovi bucket durante il processo di creazione del 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, poi 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, poi fai clic su Aggiungi un prefisso.
Per escludere gli oggetti in base al prefisso, inserisci un prefisso nella sezione Escludi oggetti con prefisso, 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 utilizzano per impostazione predefinita la classe di archiviazione del bucket di destinazione.
- Fai clic su Salva.
Riga di comando
Per istruzioni su Google Cloud CLI su come creare un job di replica, 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 Cloud Logging per i logStorage Transfer Servicei Storage.
Elenca i job di replica
Console
Non puoi elencare i job di replica utilizzando la Google Cloud console. Consulta Visualizzare il job di replica per istruzioni su come visualizzare un singolo job di replica alla volta.
Riga di comando
Per istruzioni su Google Cloud CLI su come elencare i job di replica, 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 Elencare 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 mostra se è in esecuzione un job di replica turbo o un job di replica tra bucket. Per istruzioni sulla visualizzazione della colonna Replica, consulta Mostrare le colonne.
Riga di comando
Per istruzioni su Google Cloud CLI su come visualizzare un job di replica, 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.
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 è attivato, disattivato o eliminato)
Console
Quando utilizzi la console Google Cloud , puoi aggiornare un job di replica solo mettendo in pausa o riattivando il job.
- 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 riattivare 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 Riavvia accanto al job di replica che vuoi aggiornare.
Riga di comando
Per istruzioni su Google Cloud CLI su come aggiornare un job di replica, 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.
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 che 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 Google Cloud CLI su come eliminare un job di replica, 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 Eliminare un job di replica utilizzando l'API JSON.
Passaggi successivi
Monitora gli oggetti replicati.