Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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
editModifica.
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 addAggiungi un prefisso.
Per escludere gli oggetti in base al prefisso, inserisci un prefisso nella sezione
Escludi oggetti con prefisso, poi fai clic su
addAggiungi 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.
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.
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
editModifica.
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.
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
editModifica.
Nel riquadro Modifica replica tra bucket visualizzato, fai clic su
pauseMetti in pausa o
play_arrowRiavvia accanto al
job di replica che vuoi aggiornare.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-05 UTC."],[],[],null,["# Use cross-bucket replication\n\nThis page describes how to use [cross-bucket replication](/storage/docs/availability-durability#cross-bucket-replication), which uses\n[Storage Transfer Service](/storage-transfer/docs/overview) to copy new and updated objects asynchronously from a\nsource bucket to a destination bucket. When you use cross-bucket replication,\nyou create and manage replication jobs, which are a type of job in\nStorage Transfer Service.\n\nBefore you begin\n----------------\n\nTo use cross-bucket replication, you must complete prerequisite steps. For\ninstructions, refer to [Before you begin](/storage-transfer/docs/cross-bucket-replication#before-you-begin) in the Storage Transfer Service\ndocumentation.\n\nCreate a replication job\n------------------------\n\n### Console\n\nWhen you create a cross-bucket replication job using the\nGoogle Cloud console, the Storage Transfer Service service agent is\nautomatically granted the `storage.legacyBucketOwner` role on the source\nbucket and the `storage.legacyBucketWriter` role on the destination\nbucket.\n\nWhen using the Google Cloud console, you can create a replication job for\nexisting buckets or for new buckets during the bucket creation process.\n\nTo create a replication job for a new bucket, follow the instructions for\n[creating a new bucket](/storage/docs/creating-buckets#create-bucket).\n\nTo create a replication job for an existing bucket, complete the following\nsteps:\n\n1. In the Google Cloud console, go to the Cloud Storage **Buckets** page. \n\n [Go to Buckets](https://console.cloud.google.com/storage/browser)\n2. In the list of buckets, click the name of the source bucket whose objects\n you want to replicate.\n\n3. On the **Bucket details** page, click the **Configuration** tab.\n\n4. Locate the **Cross-bucket replication** option and click\n edit **Edit**.\n\n5. In the **Edit cross-bucket replication** pane that opens, click\n **Add a destination**.\n\n6. In the **Choose a destination** section, select a destination bucket,\n then click **Next**.\n\n7. In the **Choose replication settings** section, do the following:\n\n - Optional: To filter objects to replicate by object name prefix,\n select the **Replicate objects based on prefix** checkbox in the\n **Choose which objects to replicate** section.\n\n - To include objects by prefix, enter a prefix in the\n **Include objects with prefix** section, then\n click add **Add a prefix**.\n\n - To exclude objects by prefix, enter a prefix in the\n **Exclude objects with prefix** section, then click\n add **Add a prefix**.\n\n - Optional: To set a storage class for replicated objects, select a\n storage class from the menu in the\n **Set storage class for replicated objects** section.\n\n If you skip this step, replicated objects use the destination bucket's\n storage class by default.\n\n 1. Click **Save**.\n\n### Command line\n\nFor Google Cloud CLI instructions on how to create a replication job,\nrefer to [Create a replication job using the Google Cloud CLI](/storage-transfer/docs/cross-bucket-replication#create-replication-job).\n\n### REST APIs\n\n### JSON API\n\nFor JSON API instructions on how to create a replication job,\nrefer to [Create a replication job using the JSON API](/storage-transfer/docs/cross-bucket-replication#create-replication-job).\n\nTo check the status of the replication job,\n[view Cloud Logging for Storage Transfer Service logs](/storage-transfer/docs/transfer-logs#view-logs).\n\nList replication jobs\n---------------------\n\n### Console\n\nYou cannot list replication jobs using the Google Cloud console. See\n[View replication job](#view-replication-job) for instructions on how to view a single\nreplication job at a time.\n\n### Command line\n\nFor Google Cloud CLI instructions on how to list replication jobs,\nrefer to [List replication jobs using the Google Cloud CLI](/storage-transfer/docs/cross-bucket-replication#list-replication-jobs).\n\n### REST APIs\n\n### JSON API\n\nFor JSON API instructions on how to list replication jobs,\nrefer to [List replication jobs using the JSON API](/storage-transfer/docs/cross-bucket-replication#list-replication-jobs).\n\nView a replication job\n----------------------\n\n### Console\n\n1. In the Google Cloud console, go to the Cloud Storage **Buckets** page. \n\n [Go to Buckets](https://console.cloud.google.com/storage/browser)\n2. In the list of buckets, click the name of the source bucket whose\n cross-bucket replication job you want to view.\n\n3. On the **Bucket details** page, click the **Configuration** tab.\n\n4. Locate the **Cross-bucket replication** option and click\n edit **Edit**.\n\n The **Edit cross-bucket replication** pane appears, which displays\n the replication job for each destination bucket.\n\nOn the **Buckets** page, you can view the **Replication** column, which\ndisplays whether a bucket has a Turbo replication job or a cross-bucket\nreplication job running. For instructions on displaying the **Replication**\ncolumn, see [Show columns](/storage/docs/cloud-console#show-columns).\n\n### Command line\n\nFor Google Cloud CLI instructions on how to view a replication job,\nrefer to [View a replication job using the Google Cloud CLI](/storage-transfer/docs/cross-bucket-replication#view-replication-job).\n\n### REST APIs\n\n### JSON API\n\nFor JSON API instructions on how to view a replication job,\nrefer to [View a replication job using the JSON API](/storage-transfer/docs/cross-bucket-replication#view-replication-job).\n\nUpdate a replication job\n------------------------\n\nYou can update the following fields of a replication job:\n\n- The description of the replication job\n\n- The configuration for running a replication job\n\n- The configuration of notifications published to Pub/Sub\n\n- The logging behavior for replication job operations\n\n- The status of the replication job (whether it's enabled, disabled, or deleted)\n\n### Console\n\nWhen using the Google Cloud console, you can only update a replication\njob by pausing or unpausing the job.\n\n1. In the Google Cloud console, go to the Cloud Storage **Buckets** page. \n\n [Go to Buckets](https://console.cloud.google.com/storage/browser)\n2. In the list of buckets, click the name of the source bucket that\n you want to pause or unpause replicating.\n\n3. On the **Bucket details** page, click the **Configuration** tab.\n\n4. Locate the **Cross-bucket replication** option and click\n edit **Edit**.\n\n5. In the **Edit cross-bucket replication** pane that appears, click\n pause **Pause** or\n play_arrow **Unpause** next to the\n replication job you want to update.\n\n### Command line\n\nFor Google Cloud CLI instructions on how to update a replication job,\nrefer to [Update a replication job using the Google Cloud CLI](/storage-transfer/docs/cross-bucket-replication#update-replication-job).\n\n### REST APIs\n\n### JSON API\n\nFor JSON API instructions on how to update a replication job,\nrefer to [Update a replication job using the JSON API](/storage-transfer/docs/cross-bucket-replication#update-replication-job).\n\nDelete a replication job\n------------------------\n\n### Console\n\n1. In the Google Cloud console, go to the Cloud Storage **Buckets** page. \n\n [Go to Buckets](https://console.cloud.google.com/storage/browser)\n2. In the list of buckets, click the name of the source bucket you\n want to stop replicating.\n\n3. On the **Bucket details** page, click the **Configuration** tab.\n\n4. Locate the **Cross-bucket replication** option and click\n edit **Edit**.\n\n5. In the **Edit cross-bucket replication** pane that appears, click\n delete **Delete** next to the\n replication job you want to delete.\n\n6. In the dialogue that appears, click **Confirm**.\n\n### Command line\n\nFor Google Cloud CLI instructions on how to delete a replication job,\nrefer to [Delete a replication job using the Google Cloud CLI](/storage-transfer/docs/cross-bucket-replication#delete-replication-job).\n\n### REST APIs\n\n### JSON API\n\nFor JSON API instructions on how to delete a replication job,\nrefer to [Delete a replication job using the JSON API](/storage-transfer/docs/cross-bucket-replication#delete-replication-job).\n\nWhat's next\n-----------\n\n[Monitor your replicated objects](/storage/docs/monitoring#cross-bucket_replication_graphs)."]]
