Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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 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.
A movimentação de dados entre locais incorre em custos de uso da rede. Além
disso, a movimentação de dados pode gerar cobranças adicionais, dependendo das
classes de armazenamento dos dados de origem e do local do bucket
de destino. Para mais informações, consulte Preços do Cloud Storage.
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 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 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.
Siga as instruções detalhadas e clique em Próxima etapa ao concluir cada etapa:
Escolha uma origem: use o bucket do Google Cloud Storage como o tipo de origem e insira o nome do bucket desejado diretamente ou clique em Procurar para encontrar. e selecione o bucket que você quer.
Escolha um destino: insira diretamente o nome do bucket pretendido ou clique em Procurar para localizar e selecionar o bucket desejado.
Escolha as configurações: selecione a opção Excluir arquivos da origem após a transferência.
Opções de programação: ignore esta seção.
Depois de concluir as instruções, clique em Criar.
Isso inicia o processo de cópia dos objetos do bucket antigo
para o novo. Esse processo pode levar algum tempo. No entanto, depois de clicar em
Criar, será possível sair do Console do Google Cloud.
Para ver o andamento da transferência:
Abra a página "Transferir" no Console do Google Cloud.
Para saber como acessar informações detalhadas de erro sobre operações do Cloud Storage
com falha no console do Google Cloud, consulte
Solução de problemas.
Após a conclusão da transferência, não será necessário fazer nada para excluir os
objetos do bucket antigo se a caixa de seleção Excluir objetos de origem
após a conclusão da transferência estiver selecionada durante a configuração. No entanto, você também pode
excluir o bucket antigo, o que precisa ser feito separadamente.
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:
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 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:
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:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-12-09 UTC."],[],[],null,["# Move data between buckets\n\nThis page describes how to move the contents of a bucket by copying objects from\na source bucket to a destination bucket.\n\nOverview\n--------\n\nWhen you create a bucket, some of the properties you set are permanent and\ncannot be changed, including the bucket's name and its parent project.\n\nIf you want to use a new name for your bucket, you can *effectively* do so by\n[creating a new bucket](/storage/docs/creating-buckets) with the name you want to use, and then copying your\nobjects from the old bucket to the new bucket. You can then [delete](/storage/docs/deleting-buckets) the\nold bucket. Note the following:\n\n- When you delete a bucket, the [bucket's name can be reused](/storage/docs/buckets#considerations).\n\n | **Important:** If you create a new bucket with the same name as the original bucket but in a different location, requests made to the new bucket might fail with a `404-Bucket Not Found` error for up to 10 minutes after the deletion of the original bucket. For the [XML API](/storage/docs/xml-api), this behavior includes attempts to create the new bucket.\n- If your primary goal of moving objects from one bucket to another is to\n store your data in a different [bucket location](/storage/docs/locations), we recommend\n [directly relocating your bucket](/storage/docs/bucket-relocation/overview).\n\n- Moving data between locations incurs [network usage costs](/storage/pricing#network-buckets). In\n addition, moving data might incur additional charges, depending on the\n storage classes of the source data and on the location of the destination\n bucket. For more information, see [Cloud Storage pricing](/storage/pricing).\n\nRequired permissions\n--------------------\n\n### Console\n\nIn order to complete this guide using the [Google Cloud console](/storage/docs/cloud-console), you must\nhave the proper IAM permissions. If the buckets you want to\naccess exist in a project that you did not create, you might need the\nproject owner to give you a role that contains the necessary permissions.\n\nFor a list of permissions required for specific actions, see\n[IAM\npermissions for the Google Cloud console](/storage/docs/access-control/iam-console).\n\nFor a list of relevant roles, see\n[Cloud Storage roles](/storage/docs/access-control/iam-roles).\nAlternatively, you can\n[create a custom role](/iam/docs/creating-custom-roles) that has\nspecific, limited permissions.\n\n### Command line\n\nIn order to complete this guide using a command-line utility, you must\nhave the proper IAM permissions. If the buckets you want to\naccess exist in a project that you did not create, you might need the\nproject owner to give you a role that contains the necessary permissions.\n\nFor a list of permissions required for specific actions, see\n[IAM\npermissions for `gcloud storage` commands](/storage/docs/access-control/iam-gcloud).\n\nFor a list of relevant roles, see\n[Cloud Storage roles](/storage/docs/access-control/iam-roles).\nAlternatively, you can\n[create a custom role](/iam/docs/creating-custom-roles) that has\nspecific, limited permissions.\n\n### REST APIs\n\n### JSON API\n\nIn order to complete this guide using the [JSON API](/storage/docs/json_api), you must have\nthe proper IAM permissions. If the buckets you want to\naccess exist in a project that you did not create, you might need\nthe project owner to give you a role that contains the necessary\npermissions.\n\nFor a list of permissions required for specific actions, see\n[IAM\npermissions for JSON methods](/storage/docs/access-control/iam-json).\n\nFor a list of relevant roles, see\n[Cloud Storage roles](/storage/docs/access-control/iam-roles).\nAlternatively, you can\n[create a custom role](/iam/docs/creating-custom-roles) that has\nspecific, limited permissions.\n\nMove data from one bucket to another\n------------------------------------\n\n### Console\n\nUse the [Storage Transfer Service](/storage-transfer) from within Google Cloud console:\n\n1. If you don't have a destination bucket yet, [create the bucket](/storage/docs/creating-buckets).\n2. Open the Transfer page in the Google Cloud console.\n\n\n [Open\n the **Transfer** page](https://console.cloud.google.com/transfer/jobs)\n3. Click **Create transfer job**.\n4. Follow the step-by-step walkthrough, clicking **Next step** as you\n complete each step:\n\n - Choose a source: Use **Google Cloud Storage bucket** as your source\n type, and either enter the name of the wanted bucket directly, or\n click **Browse** to find and select the bucket you want.\n\n - Choose a destination: Either enter the name of the wanted bucket\n directly, or click **Browse** to find and select the bucket you want.\n\n - Choose settings: Select the option **Delete files from source after\n they're transferred**.\n\n - Scheduling options: You can ignore this section.\n\n5. After you complete the step-by-step walkthrough, click **Create**.\n\n This begins the process of copying objects from your old bucket into\n your new one. This process may take some time; however, after you click\n **Create**, you can navigate away from the Google Cloud console.\n\n To view the transfer's progress:\n\n Open the Transfer page in the Google Cloud console.\n\n\n [Open\n the **Transfer** page](https://console.cloud.google.com/transfer/jobs)\n\n \u003cbr /\u003e\n\n To learn how to get detailed error information about failed Cloud Storage\n operations in the Google Cloud console, see\n [Troubleshooting](/storage/docs/troubleshooting#trouble-console).\n6. Once the transfer completes, you don't need to do anything to delete the\n objects from your old bucket if you selected the **Delete source objects\n after the transfer completes** checkbox during setup. You may, however,\n want to also [delete your old bucket](/storage/docs/deleting-buckets), which you must do separately.\n\n### Command line\n\n1. If you don't have one yet, [create a destination bucket](/storage/docs/creating-buckets).\n\n2. To recursively copy the contents of your source bucket to your\n destination bucket, use the [`gcloud storage cp`](/sdk/gcloud/reference/storage/cp) command with\n the `--recursive` option:\n\n ```\n gcloud storage cp --recursive gs://SOURCE_BUCKET/* gs://DESTINATION_BUCKET\n ```\n\n Where:\n - \u003cvar translate=\"no\"\u003eSOURCE_BUCKET\u003c/var\u003e is the name of your original\n bucket. For example, `old-bucket`.\n\n - \u003cvar translate=\"no\"\u003eDESTINATION_BUCKET\u003c/var\u003e is the name of the\n bucket you are moving your data to. For example, `my-bucket`.\n\n If your bucket uses [managed folders](/storage/docs/managed-folders) and a [flat namespace](/storage/docs/objects#namespace),\n you must include the flag `--include-managed-folders` in the command\n for the managed folders to be copied.\n3. To recursively delete the contents from the source bucket, along with\n the source bucket itself, use the [`gcloud storage rm`](/sdk/gcloud/reference/storage/rm) command\n with the `--recursive` option:\n\n ```\n gcloud storage rm --recursive gs://SOURCE_BUCKET\n ```\n\n Where \u003cvar translate=\"no\"\u003eSOURCE_BUCKET\u003c/var\u003e is the name of your\n original bucket. For example, `old-bucket`.\n\n Alternatively, to delete the contents from the source bucket without\n deleting the source bucket itself, use the `gcloud storage rm` command\n with the `--all-versions` flag and `**` wildcard: \n\n ```\n gcloud storage rm --all-versions gs://SOURCE_BUCKET/**\n ```\n\n Where \u003cvar translate=\"no\"\u003eSOURCE_BUCKET\u003c/var\u003e is the name of your\n original bucket. For example, `old-bucket`.\n\n### REST APIs\n\n### JSON API\n\n1. If you don't have a destination bucket yet, [create the bucket](/storage/docs/creating-buckets).\n\n2. [Copy each object](/storage/docs/copying-renaming-moving-objects#copy) from your source bucket to the destination\n bucket.\n\n3. [Delete each object](/storage/docs/deleting-objects) in your source bucket.\n\n4. [Delete your source bucket](/storage/docs/deleting-buckets).\n\n### XML API\n\n1. If you don't have a destination bucket yet, [create the bucket](/storage/docs/creating-buckets).\n\n2. [Copy each object](/storage/docs/copying-renaming-moving-objects#copy) from your source bucket to the destination\n bucket.\n\n3. [Delete each object](/storage/docs/deleting-objects) in your source bucket.\n\n4. [Delete your source bucket](/storage/docs/deleting-buckets).\n\nWhat's next\n-----------\n\n- [Copy, rename, or move individual objects](/storage/docs/copying-renaming-moving-objects).\n\n- Learn about [available bucket locations](/storage/docs/locations) and\n [bucket naming guidelines](/storage/docs/buckets#considerations).\n\n- Learn more about [creating and managing data transfers with the Google Cloud console](/storage-transfer/docs/create-manage-transfer-console#configure)."]]
