Questa pagina descrive come utilizzare la replica tra bucket , che utilizza Storage Transfer Service per copiare in modo asincrono 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 istruzioni, consulta la sezione Prima di iniziare nella documentazione di Storage Transfer Service.
Creare un job di replica
Console
Quando crei un job di replica tra bucket utilizzando la
Google Cloud console, 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 Google Cloud console, puoi creare un job di replica per i bucket esistenti o per i nuovi bucket durante la procedura di creazione del 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 Google Cloud console, 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 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 e fai clic su Avanti.
Nella sezione Scegli le impostazioni di replica, procedi nel seguente modo:
(Facoltativo) Per filtrare gli oggetti da replicare in base al prefisso del nome dell'oggetto, seleziona la casella di controllo Replica gli 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 Escludi oggetti con prefisso sezione, 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 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 i log di Cloud Logging per Storage Transfer Service.
Elencare i job di replica
Console
Non puoi elencare i job di replica utilizzando la Google Cloud console. Per istruzioni su come visualizzare un singolo job di replica alla volta, consulta Visualizzare un job di replica.
Riga di comando
Per istruzioni su Google Cloud CLI su come elencare i job di replica, consulta Elencare 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 Google Cloud console, 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 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 un bucket ha un job di replica Turbo o un job di replica tra bucket in esecuzione. Per istruzioni su come visualizzare la 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.
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 su Pub/Sub
Il comportamento di logging per le operazioni del job di replica
Lo stato del job di replica (se è abilitato, disabilitato o eliminato)
Console
Quando utilizzi la Google Cloud console, puoi aggiornare un job di replica solo mettendo in pausa o riattivando il job.
- Nella Google Cloud console, vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket di origine di 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 Modifica.
Nel riquadro Modifica replica tra bucket visualizzato, fai clic su Metti in pausa o Riattiva 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.
Eliminare un job di replica
Console
- Nella Google Cloud console, vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket di origine di cui vuoi interrompere la replica.
Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.
Individua l'opzione Replica tra bucket e fai clic 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 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.
Passaggi successivi
Monitora gli oggetti replicati.