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, você precisa 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
Console do Google Cloud, o agente de serviço do Serviço de transferência do Cloud Storage recebe
automaticamente o papel storage.legacyBucketOwner no bucket de origem
e o papel storage.legacyBucketWriter no bucket de destino.
Ao usar o console do Google Cloud, é possível criar um job de replicação para buckets existentes 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 do 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 Editar.
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 Adicionar um prefixo.
Para excluir objetos por prefixo, insira um prefixo na seção Excluir objetos com prefixo e clique em Adicionar 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.
- Clique em Salvar.
Linha de comando
Para instruções sobre como criar um job de replicação na Google Cloud CLI, consulte Criar um job de replicação usando a Google Cloud CLI.
APIs REST
API JSON
Para instruções da API JSON sobre como criar um job de replicação, consulte Criar um job de replicação usando a API JSON.
Para verificar o status do job de replicação, consulte os registros do Cloud Logging para o Serviço de transferência do Cloud Storage.
Listar jobs de replicação
Console
Não é possível listar jobs de replicação usando o console do Google Cloud. Consulte Conferir o job de replicação para instruções sobre como conferir um único job de replicação por vez.
Linha de comando
Para instruções sobre como listar jobs de replicação na Google Cloud CLI, consulte Listar jobs de replicação usando a Google Cloud CLI.
APIs REST
API JSON
Para instruções da API JSON sobre como listar jobs de replicação, consulte Listar jobs de replicação usando a API JSON.
Visualizar um job de replicação
Console
- No Console do Google Cloud, acesse a página Buckets do Cloud Storage.
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 Editar.
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.
Linha de comando
Para instruções sobre como conferir um job de replicação na Google Cloud CLI, consulte Conferir um job de replicação usando a Google Cloud CLI.
APIs REST
API JSON
Para instruções da API JSON sobre como visualizar um job de replicação, consulte Visualizar um job de replicação usando a API JSON.
Atualizar um job de replicação
É possível atualizar os seguintes campos de um job de replicação:
A descrição do job de replicação
A configuração para executar um job de replicação
A configuração de notificações publicadas no Pub/Sub
O comportamento de geração de registros para operações de jobs de replicação
O status do job de replicação (ativado, desativado ou excluído)
Console
Ao usar o console do Google Cloud, só é possível pausar ou retomar um job de replicação para atualizar.
- No Console do Google Cloud, acesse a página Buckets do Cloud Storage.
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 Editar.
No painel Editar replicação entre buckets que aparece, clique em Pausar ou Retomar ao lado do job de replicação que você quer atualizar.
Linha de comando
Para instruções sobre como atualizar um job de replicação na Google Cloud CLI, consulte Atualizar um job de replicação usando a Google Cloud CLI.
APIs REST
API JSON
Para instruções da API JSON sobre como atualizar um job de replicação, consulte Atualizar um job de replicação usando a API JSON.
Excluir um job de replicação
Console
- No Console do Google Cloud, acesse a página Buckets do Cloud Storage.
Na lista de buckets, clique no nome do bucket de origem que você quer parar de replicar.
Na página Detalhes do bucket, clique na guia Configuração.
Localize a opção Replicação entre buckets e clique em Editar.
No painel Editar replicação entre buckets que aparece, clique em Excluir ao lado do job de replicação que você quer excluir.
Na caixa de diálogo que aparece, clique em Confirmar.
Linha de comando
Para instruções sobre como excluir um job de replicação na Google Cloud CLI, consulte Excluir um job de replicação usando a Google Cloud CLI.
APIs REST
API JSON
Para instruções da API JSON sobre como excluir um job de replicação, consulte Excluir um job de replicação usando a API JSON.