Nesta página, você verá como usar o recurso de replicação turbo em um bucket birregional.
Funções exigidas
Para receber as permissões necessárias a fim de usar a replicação turbo, peça ao
administrador para conceder a você o papel do IAM de Administrador
do Storage (roles/storage.admin
) no bucket.
Esse papel predefinido contém as permissões necessárias para usar a replicação turbo. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
storage.buckets.get
storage.buckets.update
Essas permissões também podem ser concedidas com papéis personalizados ou outros papéis predefinidos.
Para instruções sobre como conceder papéis nos buckets, consulte Usar o IAM com buckets.
Definir a replicação turbo
Para ativar ou desativar a replicação turbo em um bucket atual, conclua as instruções a seguir:
Console
- No Console do Google Cloud, acesse a página Buckets do Cloud Storage.
Na lista de buckets, clique no nome do bucket pretendido.
Clique na guia Configuração.
Na linha Replicação, clique em
Editar.A janela exibida indica se você está prestes a Ativar a replicação turbo ou Desativar a replicação turbo.
Clique em Salvar para confirmar a nova configuração.
Linha de comando
Use o comando gcloud storage buckets update
com a flag
--rpo
:
gcloud storage buckets update gs://BUCKET_NAME --rpo=STATE
Em que:
BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.STATE
éASYNC_TURBO
para ativar a replicação turbo ouDEFAULT
para desativar a replicação turbo.
Se bem-sucedida, a resposta terá esta aparência:
Updating gs://my-bucket/... Completed 1
Bibliotecas de cliente
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage C++.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
O exemplo a seguir ativa a replicação turbo em um bucket:
O exemplo a seguir ativa a replicação padrão em um bucket:
C#
Para mais informações, consulte a documentação de referência da API Cloud Storage C#.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
O exemplo a seguir ativa a replicação turbo em um bucket:
O exemplo a seguir ativa a replicação padrão em um bucket:
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage Go.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
O exemplo a seguir ativa a replicação turbo em um bucket:
O exemplo a seguir ativa a replicação padrão em um bucket:
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage Java.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
O exemplo a seguir ativa a replicação turbo em um bucket:
O exemplo a seguir ativa a replicação padrão em um bucket:
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage Node.js.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
O exemplo a seguir ativa a replicação turbo em um bucket:
O exemplo a seguir ativa a replicação padrão em um bucket:
PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage PHP.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
O exemplo a seguir ativa a replicação turbo em um bucket:
O exemplo a seguir ativa a replicação padrão em um bucket:
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage Python.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
O exemplo a seguir ativa a replicação turbo em um bucket:
O exemplo a seguir ativa a replicação padrão em um bucket:
Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage Ruby.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
O exemplo a seguir ativa a replicação turbo em um bucket:
O exemplo a seguir ativa a replicação padrão em um bucket:
APIs REST
API JSON
Ter a gcloud CLI instalada e inicializadapara gerar um token de acesso para o cabeçalho
Authorization
.Como alternativa, é possível criar um token de acesso usando o OAuth 2.0 Playground e incluí-lo no cabeçalho
Authorization
.Crie um arquivo JSON com as informações a seguir:
{ "rpo": "STATE" }
Em que
STATE
éASYNC_TURBO
para ativar a replicação turbo ouDEFAULT
para desativar a replicação turbo.Use
cURL
para chamar a API JSON com uma solicitação bucketPATCH
:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
Em que:
JSON_FILE_NAME
é o caminho para o arquivo JSON criado na Etapa 2.BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.
Se a solicitação for bem-sucedida, nenhuma resposta será retornada.
API XML
Esse recurso não pode ser gerenciado pela API XML. Use a API JSON.
Verificar o status da replicação de um bucket
Para verificar o objetivo do ponto de recuperação (RPO, na sigla em inglês) ou o status de replicação de um bucket, conclua estas instruções:
Console
- No Console do Google Cloud, acesse a página Buckets do Cloud Storage.
Na lista de buckets, clique no nome do bucket que você quer verificar.
Clique na guia Configuração.
Se a replicação turbo estiver ativada no bucket, Replicação estará definida como Turbo.
Linha de comando
Use o comando gcloud storage buckets describe
com a flag --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(rpo)"
Em que:
BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.
Se funcionar, a resposta será parecida com esta:
rpo: ASYNC_TURBO
Bibliotecas de cliente
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage C++.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
C#
Para mais informações, consulte a documentação de referência da API Cloud Storage C#.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage Go.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage Java.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage Node.js.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage PHP.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage Python.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage Ruby.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
APIs REST
API JSON
Ter a gcloud CLI instalada e inicializadapara gerar um token de acesso para o cabeçalho
Authorization
.Como alternativa, é possível criar um token de acesso usando o OAuth 2.0 Playground e incluí-lo no cabeçalho
Authorization
.Use
cURL
(em inglês) para chamar a API JSON com uma solicitaçãoGET
Bucket:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
Em que
BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.A resposta terá esta aparência:
{ "name": "my-bucket", "projectNumber": "234...", ... "rpo": "ASYNC_TURBO" }
Observe a chave
rpo
. O valorASYNC_TURBO
indica que a replicação turbo está ativada.DEFAULT
indica que a replicação padrão foi aplicada. O camporpo
está sempre presente para buckets de duas e várias regiões, mas está ausente em buckets de região única.
API XML
Esse recurso não pode ser gerenciado pela API XML. Use a API JSON.
A seguir
- Saiba mais sobre a replicação turbo.
- Saiba mais sobre os preços da replicação turbo.
- Saiba mais sobre métricas que monitoram o desempenho do bucket, incluindo o desempenho da replicação.
- Saiba como os alertas do Cloud Monitoring podem ser usados para criar políticas alternativas com base em métricas especificadas e gerenciar notificações associadas a elas.