Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Nesta página, descrevemos como usar a replicação entre buckets, que usa o
Serviço de transferência do Cloud Storage para copiar objetos novos e atualizados de forma assíncrona de um
bucket de origem para um de destino. Ao usar a replicação entre buckets,
você cria e gerencia jobs de replicação, que são um tipo de job no
Serviço de transferência do Cloud Storage.
Antes de começar
Para usar a replicação entre buckets, é necessário concluir as etapas de pré-requisito. Para instruções, consulte Antes de começar na documentação do Serviço de transferência do Cloud Storage.
Criar um job de replicação
Console
Quando você cria um job de replicação entre buckets usando o
consoleGoogle Cloud , o agente de serviço do Serviço de transferência do Cloud Storage recebe
automaticamente a função storage.legacyBucketOwner no bucket de origem
e a função storage.legacyBucketWriter no bucket de destino.
Ao usar o console Google Cloud , é possível criar um job de replicação para
buckets atuais ou novos durante o processo de criação de bucket.
Para criar um job de replicação para um novo bucket, siga as instruções para
criar um novo bucket.
Para criar um job de replicação para um bucket, siga estas
etapas:
No console Google Cloud , acesse a página Buckets do Cloud Storage.
Na lista de buckets, clique no nome do bucket de origem cujos objetos
você quer replicar.
Na página Detalhes do bucket, clique na guia Configuração.
Localize a opção Replicação entre buckets e clique em
editEditar.
No painel Editar replicação entre buckets que é aberto, clique em
Adicionar um destino.
Na seção Escolher um destino, selecione um bucket de destino e clique em Próxima.
Na seção Escolher as configurações de replicação, faça o seguinte:
Opcional: para filtrar objetos a serem replicados por prefixo de nome de objeto,
marque a caixa de seleção Replicar objetos com base no prefixo na seção
Escolher quais objetos serão replicados.
Para incluir objetos por prefixo, insira um prefixo na seção Incluir objetos com prefixo e clique em addAdicionar um prefixo.
Para excluir objetos por prefixo, insira um prefixo na seção Excluir objetos com prefixo e clique em addAdicionar um prefixo.
Opcional: para definir uma classe de armazenamento para objetos replicados, selecione uma
classe de armazenamento no menu da seção
Definir classe de armazenamento para objetos replicados.
Se você pular esta etapa, os objetos replicados vão usar a classe de armazenamento do bucket de destino por padrão.
Não é possível listar jobs de replicação usando o console Google Cloud . Consulte Conferir o job de replicação para instruções sobre como conferir um único job de replicação por vez.
Na lista de buckets, clique no nome do bucket de origem cujo
job de replicação entre buckets você quer conferir.
Na página Detalhes do bucket, clique na guia Configuração.
Localize a opção Replicação entre buckets e clique em
editEditar.
O painel Editar replicação entre buckets aparece, mostrando
o job de replicação para cada bucket de destino.
Na página Buckets, você pode conferir a coluna Replicação, que mostra se um bucket tem um job de replicação Turbo ou um job de replicação entre buckets em execução. Para instruções sobre como exibir a coluna Replicação, consulte Mostrar colunas.
Na lista de buckets, clique no nome do bucket de origem que
você quer pausar ou retomar a replicação.
Na página Detalhes do bucket, clique na guia Configuração.
Localize a opção Replicação entre buckets e clique em
editEditar.
No painel Editar replicação entre buckets que aparece, clique em
pausePausar ou
play_arrowRetomar ao lado do
job de replicação que você quer atualizar.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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)."]]