Realocar buckets

Console

1. No console do Cloud de Confiance , acesse a página Buckets do Cloud Storage.
   

   Acessar buckets

2. Na lista de buckets, clique no nome do bucket que você quer realocar.
3. Na página Detalhes do bucket, clique na guia Configuração.
4. Na seção Visão geral, clique em edit Editar ao lado do campo Localização.
5. Na página Mudar local do bucket, insira o novo local do bucket. Após cada uma das etapas a seguir, clique em Continuar para prosseguir para a próxima etapa:
   1. Na seção Confirme o bucket que você planeja realocar, revise o bucket e o local dele.
   2. Na seção Antes de continuar, revise as configurações que bloqueiam a realocação. Se uma restrição se aplicar ao seu bucket, considere o Serviço de transferência do Cloud Storage como uma solução alternativa.

   3. Na seção Escolha onde realocar seu bucket, faça o seguinte:

      1. Selecione um tipo de local.

      2. Selecione um local onde os dados de objetos no bucket serão armazenados.

         Com base no local de origem e destino, você vai saber se é necessário um tempo de inatividade de gravação. Para informações sobre os tipos de realocação e inatividade, consulte Tipos de realocação.

   4. Na seção Escolha como você quer continuar, clique em Comece com uma simulação (recomendado). Uma simulação identifica possíveis problemas sem mover dados.
   5. Clique em Continuar.
6. Clique em Iniciar.
7. Na caixa de diálogo de confirmação Começar com uma simulação, leia a mensagem que aparece e clique em Iniciar simulação.

Depois de iniciar uma simulação, uma operação de longa duração é iniciada. É possível monitorar o progresso na guia Operações da página detalhes do bucket.

Linha de comando

Para iniciar uma simulação, execute o comando gcloud storage buckets relocate com a flag --dry-run:

gcloud storage buckets relocate gs://BUCKET_NAME --location=LOCATION --dry-run

Em que:

• BUCKET_NAME é o nome do bucket que você quer realocar.

• LOCATION é o local de destino do bucket.

Depois de iniciar uma simulação, uma operação de longa duração é iniciada. Você vai receber um ID e uma descrição da operação. Acompanhe o progresso e a conclusão da simulação acessando os detalhes da operação de longa duração.

Se a simulação revelar algum problema, resolva-o antes de prosseguir para a etapa de realocação.

API JSON

1. Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho Authorization.

2. Crie um arquivo JSON com as configurações do bucket, que precisa incluir os parâmetros destinationLocation e validateOnly. Consulte a documentação do Buckets: relocate para ver uma lista completa de configurações. Veja a seguir configurações comuns a serem incluídas:

   {
     "destinationLocation": "DESTINATION_LOCATION",
     "destinationCustomPlacementConfig": {
       "dataLocations": [
         LOCATIONS,
           ...
           ]
       },
     "validateOnly": "true"
     }

   Em que:

   • DESTINATION_LOCATION é o local de destino do bucket.
   • LOCATIONS é uma lista de códigos de local a serem usados para a birregião configurável.
   • validateOnly está definido como true para realizar uma simulação.

3. Use cURL para chamar a API JSON:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/relocate"

   Em que:

   • JSON_FILE_NAME é o nome do arquivo JSON criado.
   • BUCKET_NAME é o nome do bucket que você quer realocar.

   Depois de iniciar uma simulação, uma operação de longa duração é iniciada. A simulação é bem-sucedida quando as seguintes condições são atendidas:

   • A simulação não informa erros.

   • O recurso operations retorna um valor de campo done de true.

     {
     "kind": "storage#operation",
     "name": "projects/_/buckets/bucket/operations/operation_id",
     "metadata": {
       "@type": OperationMetadataType*,
       metadata OperationMetadata*
     },
     "done": "true",
     "response": {
           "@type": ResponseResourceType*,
           response ResponseResource*
         }
       }

     Se a simulação revelar algum problema, resolva-o antes de prosseguir para a etapa Iniciar a realocação.

Console

1. No console do Cloud de Confiance , acesse a página Buckets do Cloud Storage.
   

   Acessar buckets

2. Na lista de buckets, clique no nome do bucket que você quer realocar.
3. Na página Detalhes do bucket, clique na guia Configuração.
4. Na seção Visão geral, clique em edit Editar ao lado do campo Localização.
5. Na página Mudar local do bucket, insira o novo local do bucket. Após cada uma das etapas a seguir, clique em Continuar para prosseguir para a próxima etapa:
   1. Na seção Confirme o bucket que você planeja realocar, revise o bucket e o local dele.
   2. Na seção Antes de continuar, revise as configurações que bloqueiam a realocação. Se uma restrição se aplicar ao seu bucket, considere o Serviço de transferência do Cloud Storage como uma solução alternativa.

   3. Na seção Escolha onde realocar seu bucket, faça o seguinte:

      1. Selecione um tipo de local.

      2. Selecione um local onde os dados de objetos no bucket serão armazenados.

         Com base no local de origem e destino, você vai saber se é necessário um tempo de inatividade de gravação. Para informações sobre os tipos de realocação e tempo de inatividade, consulte Tipos de realocação.

   4. Na seção Escolha como você quer continuar, clique em Mudar agora.
   5. Clique em Continuar.
6. Para iniciar o processo de realocação, clique em Iniciar.
7. Na caixa de diálogo de confirmação Mudar agora, leia a mensagem que aparece e clique em Iniciar mudança.

Depois de iniciar o processo de realocação, uma operação de longa duração será iniciada. É possível monitorar o progresso na guia Operações da página de detalhes do bucket.

Linha de comando

Para iniciar a realocação de bucket, execute o comando gcloud storage buckets relocate:

gcloud storage buckets relocate gs://BUCKET_NAME --location=LOCATION

Em que:

• BUCKET_NAME é o nome do bucket que você quer realocar.

• LOCATION é o local de destino do bucket.

API JSON

1. Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho Authorization.

2. Crie um arquivo JSON com as configurações do bucket. Consulte a documentação de Buckets: relocate para ver uma lista completa de configurações. Veja a seguir configurações comuns a serem incluídas:

   {
     "destinationLocation": "DESTINATION_LOCATION",
     "destinationCustomPlacementConfig": {
     "dataLocations": [
       LOCATIONS,
       ...
       ]
       },
     "validateOnly": "false"
     }

   Em que:

   • DESTINATION_LOCATION é o local de destino do bucket.
   • LOCATIONS é uma lista de códigos de local a serem usados na birregião configurável.
   • validateOnly é definido como false para iniciar a realocação do bucket.

3. Use cURL para chamar a API JSON:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/relocate"

   Em que:

   • JSON_FILE_NAME é o nome do arquivo JSON criado.
   • BUCKET_NAME é o nome do bucket que você quer realocar.

Console

Para monitorar o progresso da simulação ou do processo de realocação, siga estas etapas:

1. No console do Cloud de Confiance , acesse a página Buckets do Cloud Storage.
   

   Acessar buckets

2. Na lista de buckets, clique no nome do bucket que você está realocando.

3. Na página Detalhes do bucket, clique na guia Operações.

4. Na lista de operações de bucket que aparece, clique na simulação ou na operação de realocação para ver os detalhes.

A página de detalhes da operação mostra o resumo da realocação, as principais métricas e um resumo dos erros.

Linha de comando

Depois de iniciar uma realocação de bucket, uma operação de longa duração é iniciada. Você vai receber um ID e uma descrição da operação. Acompanhe o progresso e a conclusão do processo de realocação recebendo os detalhes da operação de longa duração.

API JSON

A realocação de bucket é uma operação de longa duração que requer monitoramento. Para verificar o status do processo, analise regularmente os detalhes da operação de longa duração. Para saber como verificar o status do processo de realocação, consulte Ver detalhes de uma operação de longa duração.

O exemplo a seguir mostra a saída gerada por uma operação de realocação:

  done: false
  kind: storage#operation
  metadata:
  '@type': type.googleapis.com/google.storage.control.v2.RelocateBucketMetadata
  commonMetadata:
    createTime: '2024-10-21T04:26:59.666Z
    endTime: '2024-12-29T23:39:53.340Z'
    progressPercent: 99
    requestedCancellation: false
    type: relocate-bucket
    updateTime: '2024-10-21T04:27:03.2892'
  destinationLocation: US-CENTRAL1
  finalizationState: 'READY'
  progress:
    byteProgressPercent: 100
    discoveredBytes: 200
    remainingBytes: 0
    discoveredObjectCount: 10
    remainingObjectCount: 8
    objectProgressPercent: 100
    discoveredSyncCount: 8
    remainingSyncCount: 0
    syncProgressPercent: 100
  relocationState: SYNCING
  sourceLocation: US
  validateOnly: false
  estimatedWriteDowntimeDuration: '7200s'
  writeDowntimeExpireTime: '2024-12-30T10:34:01.786Z'
  name: projects//buckets/my-bucket1/operations/Bar7-1b0khdew@nhenUQRTF_R-Kk4dQ5V1f8fzezkFcPh3XMvlTqJ6xhnqJ1h_QXFIeAirrEqkjgu4zPKSRD6WSSG5UGXil6w
  response:
    '@type': type.googleapis.com/google.storage.control.v2.RelocateBucketResponse
      selfLink: https://storage.googleusercontent.com/storage/v1_ds/b/my-bucket1/operations/Bar7-1b0khdew@nhenUQRTF_R-Kk4dQ5V1f8fzezkFcPh3XMvlTqJ6xhnqJ1h_QXFIeAirrEqkjgu4zPKSRD6WSSG5UGXil6w

A tabela a seguir fornece informações sobre os campos principais na saída gerada pela operação de realocação:

Se você tiver problemas ao interagir com outros recursos do Cloud Storage, consulte Limitações.

Console

Para iniciar a etapa final de sincronização, siga estas etapas:

1. No console do Cloud de Confiance , acesse a página Buckets do Cloud Storage.
   

   Acessar buckets

2. Na lista de buckets, clique no nome do bucket que você está transferindo.

3. Na página Detalhes do bucket, clique na guia Operações.

4. Na lista de operações do bucket, clique na operação de realocação para acessar a página de detalhes dela. Na página de detalhes da operação, quando a cópia de dados estiver pelo menos 99% concluída, uma barra de mensagens vai aparecer indicando que é o momento ideal para iniciar a sincronização final.

5. Opcional: para definir o tempo máximo de inatividade de gravação permitido, clique em Definir o tempo máximo de inatividade permitido (TTL) e especifique a duração máxima do tempo de inatividade.

6. Clique em Iniciar sincronização final.

7. Na caixa de diálogo de confirmação, clique em Iniciar para começar a sincronização final.

A página de detalhes da operação mostra o resumo da realocação, as principais métricas e um resumo de erros.

Linha de comando

Antes de continuar, verifique se o bucket está totalmente preparado conferindo o valor finalizationState na saída da etapa Iniciar a realocação de bucket.

Quando o valor finalizationState for READY, execute o comando gcloud storage buckets relocate para iniciar a sincronização final:

gcloud storage buckets relocate --finalize --operation=projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID

Em que:

• BUCKET_NAME é o nome do bucket que você quer realocar.
• OPERATION_ID é o ID da operação de longa duração de realocação de bucket, que é retornado na resposta dos métodos que você chama. Por exemplo, a resposta a seguir é retornada ao chamar gcloud storage operations list, e o ID da operação de longa duração é AbCJYd8jKT1n-Ciw1LCNXIcubwvij_TdqO-ZFjuF2YntK0r74.

 `name: projects/_/buckets/my-bucket/operations/AbCJYd8jKT1n-Ciw1LCNXIcubwvij_TdqO-ZFjuF2YntK0r74` 

Defina a flag ttl para ter mais controle sobre o processo de realocação. Exemplo:

gcloud storage buckets relocate --finalize --ttl TTL_DURATION --operation=projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID

Em que:

TTL_DURATION é o time to live (TTL) da fase de inatividade de gravação durante um processo de realocação. Ela é expressa como uma string, como 12h para 12 horas. O TTL_DURATION determina a duração máxima permitida para a fase de inatividade de gravação. Se o tempo de inatividade de gravação exceder esse limite, o processo de realocação será revertido automaticamente para a etapa de realocação de bucket, e as operações de gravação no bucket serão reativadas. O valor precisa estar no intervalo de 6h (6 horas) a 48h (48 horas). Se não for especificado, o valor padrão será 12h (12 horas).

API JSON

Antes de continuar, verifique se o bucket está totalmente preparado conferindo o valor finalizationState na saída da etapa de realocação de bucket. O valor de finalizationState precisa ser READY para continuar.

Se você iniciar a etapa de sincronização final antes do tempo, o comando vai retornar uma mensagem de erro The relocate bucket operation isn't ready to advance to finalization running state, mas o processo de realocação vai continuar.

Recomendamos que você aguarde até que o valor de progressPercent seja 99 antes de iniciar a etapa de sincronização final.

1. Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho Authorization.

2. Crie um arquivo JSON com as configurações de realocação de bucket. Consulte a documentação do Buckets: advanceRelocateBucket para ver uma lista completa de configurações. Veja a seguir configurações comuns a serem incluídas:

   {
   "expireTime": "EXPIRE_TIME",
   "ttl": "TTL_DURATION"
   }

   Em que:

   • EXPIRE_TIME é o horário em que o tempo de inatividade na gravação expira.
   • TTL_DURATION é o time to live (TTL) da fase de inatividade de gravação durante um processo de realocação. Ela é expressa como uma string, como 12h para 12 horas. O TTL_DURATION determina a duração máxima permitida para a fase de inatividade na gravação. Se o tempo de inatividade de gravação exceder esse limite, o processo de realocação será revertido automaticamente para a etapa de realocação de bucket, e as operações de gravação no bucket serão reativadas. O valor precisa estar no intervalo de 6h (6 horas) a 48h (48 horas). Se não for especificado, o valor padrão será 12h (12 horas).

3. Use cURL para chamar a API JSON:

   curl -X POST --data-binary @JSON_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
    "https://storage.s3nsapis.fr/storage/v1/b/bucket/BUCKET_NAME/operations/OPERATION_ID/advanceRelocateBucket"

   Em que:

   • JSON_FILE_NAME é o nome do arquivo JSON criado.
   • BUCKET_NAME é o nome do bucket que você quer realocar.
   • OPERATION_ID é o ID da operação de longa duração que iniciou a realocação de bucket. Para ver a lista de IDs de operação de longa duração de um bucket, consulte Operações: lista.