Mover e renomear buckets

Ao criar um bucket, algumas das propriedades definidas são permanentes e não podem ser alteradas, incluindo o nome, a localização geográfica e o projeto de que o bucket faz parte. No entanto, é possível mover ou renomear seu bucket:

  • Se não houver dados no bucket antigo, exclua o bucket e crie outro bucket com as propriedades desejadas

  • Se houver dados no bucket antigo, crie um novo com as propriedades desejadas, copie os dados do bucket antigo para o novo e exclua o antigo e o conteúdo dele. As etapas nesta página descrevem esse processo.

    • Se você quiser que o novo bucket tenha o mesmo nome do antigo, mova temporariamente os dados para um bucket com um nome diferente. This lets you delete the original bucket so that you can reuse the bucket name.

Permissões necessárias

Console

Para concluir este guia usando o Console do Google Cloud, é preciso ter as permissões de IAM adequadas. Se os buckets que você quer acessar existirem em um projeto que você não criou, talvez seja necessário que o proprietário do projeto conceda a você um papel que contenha as permissões necessárias.

Para uma lista de permissões necessárias para ações específicas, consulte Permissões do IAM para o Console do Google Cloud.

Para ver a lista de papéis relevantes, consulte Papéis do Cloud Storage. Como alternativa, é possível criar um papel personalizado que tenha permissões mais limitadas.

Linha de comando

Para concluir este guia usando um utilitário de linha de comando, você precisa ter as permissões de IAM adequadas. Se os buckets que você quer acessar existirem em um projeto que você não criou, talvez seja necessário que o proprietário do projeto conceda a você um papel que contenha as permissões necessárias.

Para uma lista de permissões necessárias para ações específicas, consulte Permissões do IAM para comandos gcloud storage.

Para ver a lista de papéis relevantes, consulte Papéis do Cloud Storage. Como alternativa, é possível criar um papel personalizado que tenha permissões mais limitadas.

APIs REST

API JSON

Para concluir este guia usando a API JSON, é preciso ter as permissões do IAM adequadas. Se os buckets que você quer acessar existirem em um projeto que você não criou, talvez seja necessário que o proprietário do projeto conceda a você um papel que contenha as permissões necessárias.

Para uma lista de permissões necessárias para ações específicas, consulte Permissões do IAM para métodos JSON.

Para ver a lista de papéis relevantes, consulte Papéis do Cloud Storage. Como alternativa, é possível criar um papel personalizado que tenha permissões mais limitadas.

Mover dados de um bucket para outro

Console

  1. Se você ainda não tiver um bucket de destino, crie o bucket.

  2. Copie cada objeto do bucket de origem para o bucket de destino.

  3. Exclua o bucket de origem e o conteúdo dele.

Linha de comando

  1. Crie um bucket de destino se você ainda não tiver um.

  2. Para copiar o conteúdo do bucket de origem para o bucket de destino, use um dos seguintes métodos:

    • Para copiar recursivamente todos os objetos do bucket de origem para o de destino, use o comando gcloud storage cp com a opção --recursive:

      gcloud storage cp --recursive gs://SOURCE_BUCKET/* gs://DESTINATION_BUCKET

      Em que:

      • SOURCE_BUCKET é o nome do bucket original. Por exemplo, old-bucket.

      • DESTINATION_BUCKET é o nome do bucket para o qual você está movendo os dados. Por exemplo, my-bucket.

    • Para copiar recursivamente todos os objetos e pastas gerenciadas do bucket de origem para o bucket de destino, use o comando gcloud alpha storage cp com as opções --include-managed-folders e --recursive:

      gcloud alpha storage cp --include-managed-folders --recursive gs://SOURCE_BUCKET/* gs://DESTINATION_BUCKET

      Em que:

      • SOURCE_BUCKET é o nome do bucket original. Por exemplo, old-bucket.

      • DESTINATION_BUCKET é o nome do bucket para o qual você está movendo os dados. Por exemplo, my-bucket.

  3. Para excluir o bucket de origem, use um dos seguintes métodos:

    • Para excluir recursivamente todos os objetos do bucket de origem, junto do próprio bucket de origem, use o comando gcloud storage rm com a opção --recursive:

      gcloud storage rm --recursive gs://SOURCE_BUCKET

      Em que SOURCE_BUCKET é o nome do bucket original. Por exemplo, old-bucket.

    • Para excluir todos os objetos e pastas gerenciadas do bucket de origem, junto com o próprio bucket de origem, use o comando gcloud alpha storage rm com a opção --recursive:

      gcloud alpha storage rm --recursive gs://SOURCE_BUCKET

      Em que SOURCE_BUCKET é o nome do bucket original. Por exemplo, old-bucket.

    • Para excluir os objetos e as pastas gerenciadas do bucket de origem sem excluir o próprio bucket, use o comando gcloud alpha storage rm sem a sinalização --recursive:

      gcloud alpha storage rm --all-versions gs://SOURCE_BUCKET/**

      Em que SOURCE_BUCKET é o nome do bucket original. Por exemplo, old-bucket.

APIs REST

API JSON

  1. Se você ainda não tiver um bucket de destino, crie o bucket.

  2. Copie cada objeto do bucket de origem para o bucket de destino.

  3. Exclua cada objeto no bucket de origem.

  4. Exclua o bucket de origem.

API XML

  1. Se você ainda não tiver um bucket de destino, crie o bucket.

  2. Copie cada objeto do bucket de origem para o bucket de destino.

  3. Exclua cada objeto no bucket de origem.

  4. Exclua o bucket de origem.

A seguir