Esta página descreve como usar a replicação entre contentores, que usa o Serviço de transferência de armazenamento para copiar objetos novos e atualizados de forma assíncrona de um contentor de origem para um contentor de destino. Quando usa a replicação entre contentores, cria e gere tarefas de replicação, que são um tipo de tarefa no Storage Transfer Service.
Antes de começar
Para usar a replicação entre contentores, tem de concluir os passos pré-requisitos. Para ver instruções, consulte a secção Antes de começar na documentação do serviço de transferência de armazenamento.
Crie um trabalho de replicação
Consola
Quando cria uma tarefa de replicação entre contentores através da consola, o agente de serviço do Serviço de transferência de armazenamento recebe automaticamente a função storage.legacyBucketOwner no contentor de origem e a função storage.legacyBucketWriter no contentor de destino.Google Cloud
Quando usa a Google Cloud consola, pode criar uma tarefa de replicação para contentores existentes ou para novos contentores durante o processo de criação de contentores.
Para criar uma tarefa de replicação para um novo contentor, siga as instruções para criar um novo contentor.
Para criar uma tarefa de replicação para um contentor existente, conclua os seguintes passos:
- Na Google Cloud consola, aceda à página Recipientes do Cloud Storage.
Na lista de contentores, clique no nome do contentor de origem cujos objetos quer replicar.
Na página Detalhes do contentor, clique no separador Configuração.
Localize a opção Replicação entre contentores e clique em Editar.
No painel Editar replicação entre contentores apresentado, clique em Adicionar um destino.
Na secção Escolha um destino, selecione um grupo de destino e, de seguida, clique em Seguinte.
Na secção Escolha as definições de replicação, faça o seguinte:
Opcional: para filtrar objetos a replicar por prefixo do nome do objeto, selecione a caixa de verificação Replicar objetos com base no prefixo na secção Escolha os objetos a replicar.
Para incluir objetos por prefixo, introduza um prefixo na secção Incluir objetos com prefixo e, de seguida, clique em Adicionar um prefixo.
Para excluir objetos por prefixo, introduza um prefixo na secção Excluir objetos com prefixo e, de seguida, clique em Adicionar um prefixo.
Opcional: para definir uma classe de armazenamento para objetos replicados, selecione uma classe de armazenamento no menu na secção Definir classe de armazenamento para objetos replicados.
Se ignorar este passo, os objetos replicados usam a classe de armazenamento do contentor de destino por predefinição.
- Clique em Guardar.
Linha de comandos
Para ver instruções da CLI do Google Cloud sobre como criar uma tarefa de replicação, consulte o artigo Crie uma tarefa de replicação com a CLI do Google Cloud.
APIs REST
API JSON
Para obter instruções da API JSON sobre como criar uma tarefa de replicação, consulte o artigo Crie uma tarefa de replicação com a API JSON.
Para verificar o estado da tarefa de replicação, veja os registos do Cloud Logging para o Serviço de transferência de armazenamento.
Apresentar tarefas de replicação
Consola
Não pode listar tarefas de replicação através da consola Google Cloud . Consulte o artigo Ver tarefa de replicação para obter instruções sobre como ver uma única tarefa de replicação de cada vez.
Linha de comandos
Para ver instruções da CLI do Google Cloud sobre como listar tarefas de replicação, consulte o artigo Liste tarefas de replicação com a CLI do Google Cloud.
APIs REST
API JSON
Para obter instruções da API JSON sobre como listar tarefas de replicação, consulte o artigo Liste tarefas de replicação com a API JSON.
Veja uma tarefa de replicação
Consola
- Na Google Cloud consola, aceda à página Recipientes do Cloud Storage.
Na lista de contentores, clique no nome do contentor de origem cuja tarefa de replicação entre contentores quer ver.
Na página Detalhes do contentor, clique no separador Configuração.
Localize a opção Replicação entre contentores e clique em Editar.
É apresentado o painel Editar replicação entre contentores, que apresenta a tarefa de replicação para cada contentor de destino.
Na página Recipientes, pode ver a coluna Replicação, que apresenta se um recipiente tem uma tarefa de replicação Turbo ou uma tarefa de replicação entre recipientes em execução. Para ver instruções sobre como apresentar a coluna Replicação, consulte o artigo Mostrar colunas.
Linha de comandos
Para ver instruções da CLI do Google Cloud sobre como ver uma tarefa de replicação, consulte o artigo Veja uma tarefa de replicação com a CLI do Google Cloud.
APIs REST
API JSON
Para instruções da API JSON sobre como ver uma tarefa de replicação, consulte o artigo Veja uma tarefa de replicação através da API JSON.
Atualize uma tarefa de replicação
Pode atualizar os seguintes campos de uma tarefa de replicação:
A descrição da tarefa de replicação
A configuração para executar uma tarefa de replicação
A configuração das notificações publicadas no Pub/Sub
O comportamento de registo das operações de tarefas de replicação
O estado da tarefa de replicação (se está ativada, desativada ou eliminada)
Consola
Quando usa a Google Cloud consola, só pode atualizar uma tarefa de replicação pausando ou retomando a tarefa.
- Na Google Cloud consola, aceda à página Recipientes do Cloud Storage.
Na lista de contentores, clique no nome do contentor de origem cuja replicação quer pausar ou retomar.
Na página Detalhes do contentor, clique no separador Configuração.
Localize a opção Replicação entre contentores e clique em Editar.
No painel Editar replicação entre contentores apresentado, clique em Pausar ou Retomar junto à tarefa de replicação que quer atualizar.
Linha de comandos
Para obter instruções da CLI do Google Cloud sobre como atualizar uma tarefa de replicação, consulte o artigo Atualize uma tarefa de replicação com a CLI do Google Cloud.
APIs REST
API JSON
Para obter instruções da API JSON sobre como atualizar uma tarefa de replicação, consulte o artigo Atualize uma tarefa de replicação através da API JSON.
Elimine uma tarefa de replicação
Consola
- Na Google Cloud consola, aceda à página Recipientes do Cloud Storage.
Na lista de contentores, clique no nome do contentor de origem cuja replicação quer parar.
Na página Detalhes do contentor, clique no separador Configuração.
Localize a opção Replicação entre contentores e clique em Editar.
No painel Editar replicação entre contentores apresentado, clique em Eliminar junto à tarefa de replicação que quer eliminar.
Na caixa de diálogo apresentada, clique em Confirmar.
Linha de comandos
Para ver instruções da CLI do Google Cloud sobre como eliminar uma tarefa de replicação, consulte o artigo Elimine uma tarefa de replicação com a CLI do Google Cloud.
APIs REST
API JSON
Para obter instruções da API JSON sobre como eliminar uma tarefa de replicação, consulte o artigo Elimine uma tarefa de replicação através da API JSON.
O que se segue?
Monitorize os seus objetos replicados.