Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite wird beschrieben, wie Sie den Inhalt eines Buckets verschieben, indem Sie Objekte aus einem Quell- in einen Zielbucket kopieren.
Übersicht
Wenn Sie einen Bucket erstellen, sind einige der Attribute, die Sie festlegen, dauerhaft und können nicht geändert werden, einschließlich des Namens des Buckets und des Projekts, zu dem er gehört.
Sie können Buckets jedoch effektiv verschieben oder umbenennen:
Enthält der alte Bucket Daten, erstellen Sie einen neuen Bucket mit den gewünschten Attributen, kopieren die Daten aus dem alten Bucket in den neuen und löschen den alten Bucket und dessen Inhalt. Die Schritte auf dieser Seite beschreiben diesen Vorgang.
Wenn der neue Bucket den Namen Ihres alten Buckets übernehmen soll, müssen Sie die Daten vorübergehend in einen Bucket mit einem anderen Namen verschieben. Sie können dann den ursprünglichen Bucket löschen, sodass Sie den Bucket-Namen wiederverwenden können.
Das Verschieben von Daten zwischen Standorten verursacht Kosten für die Netzwerknutzung. Außerdem können durch das Verschieben von Daten zusätzliche Kosten anfallen, je nach Speicherklassen der Quelldaten und Standort des Ziel-Buckets. Weitere Informationen finden Sie unter Cloud Storage – Preise.
Erforderliche Berechtigungen
Console
Sie benötigen die entsprechenden IAM-Berechtigungen, um diesen Leitfaden mit der Google Cloud -Konsole abzuschließen. Wenn die sich Buckets, auf die Sie zugreifen möchten, in einem Projekt befinden, das nicht Sie erstellt haben, muss Ihnen der Projektinhaber möglicherweise erst eine Rolle zuweisen, die die erforderlichen Berechtigungen enthält.
Damit Sie diese Anleitung mit einem Befehlszeilen-Dienstprogramm ausführen können, benötigen Sie die entsprechenden IAM-Berechtigungen. Wenn die sich Buckets, auf die Sie zugreifen möchten, in einem Projekt befinden, das nicht Sie erstellt haben, muss Ihnen der Projektinhaber möglicherweise erst eine Rolle zuweisen, die die erforderlichen Berechtigungen enthält.
Sie benötigen die entsprechenden IAM-Berechtigungen, um diese Anleitung mit der JSON API abzuschließen. Wenn die sich Buckets, auf die Sie zugreifen möchten, in einem Projekt befinden, das nicht Sie erstellt haben, muss Ihnen der Projektinhaber möglicherweise erst eine Rolle zuweisen, die die erforderlichen Berechtigungen enthält.
Führen Sie die folgenden Schritte aus und klicken Sie dabei nach jedem Schritt auf Nächster Schritt:
Quelle auswählen: Verwenden Sie Google Cloud Storage-Bucket als Quelltyp und geben Sie entweder direkt den Namen des gewünschten Buckets ein oder klicken Sie auf Durchsuchen, um die Suche zu starten und wählen Sie den gewünschten Bucket aus.
Ziel auswählen: Geben Sie entweder den Namen des gewünschten Buckets direkt ein oder klicken Sie auf Durchsuchen, um den gewünschten Bucket zu suchen und auszuwählen.
Einstellungen auswählen: Wählen Sie die Option Dateien nach der Übertragung aus der Quelle löschen aus.
Planungsoptionen: Diesen Abschnitt können Sie ignorieren.
Nachdem Sie alle Schritte ausgeführt haben, klicken Sie auf Erstellen.
Damit beginnt das Kopieren der Objekte aus dem alten Bucket in den neuen. Der Vorgang kann einige Zeit in Anspruch nehmen. Nachdem Sie auf Erstellen geklickt haben, können Sie die Google Cloud Console aber verlassen.
So sehen Sie den Fortschritt der Übertragung:
Öffnen Sie in der Google Cloud Console die Seite „Übertragen“.
Unter Fehlerbehebung erfahren Sie, wie Sie detaillierte Fehlerinformationen zu fehlgeschlagenen Cloud Storage-Vorgängen in der Google Cloud Console abrufen.
Sie müssen nichts unternehmen, um die Objekte aus dem alten Bucket zu löschen, sobald die Übertragung abgeschlossen ist. Dazu müssen Sie bei der Einrichtung das Kästchen Quellobjekte nach Übertragung löschen ausgewählt haben. Sie können jedoch auch Ihren alten Bucket löschen, was Sie separat machen müssen.
SOURCE_BUCKET ist der Name des ursprünglichen Buckets. Beispiel: old-bucket.
DESTINATION_BUCKET ist der Name des Buckets, in den Sie Ihre Daten verschieben. Beispiel: my-bucket.
Wenn in Ihrem Bucket verwaltete Ordner und ein flacher Namespace verwendet werden, müssen Sie das Flag --include-managed-folders in den Befehl einfügen, damit die verwalteten Ordner kopiert werden.
Wenn Sie den Inhalt des Quell-Buckets zusammen mit dem Quell-Bucket selbst rekursiv löschen möchten, verwenden Sie den Befehl gcloud storage rm mit der Option --recursive:
gcloud storage rm --recursive gs://SOURCE_BUCKET
Dabei ist SOURCE_BUCKET der Name des ursprünglichen Buckets. Beispiel: old-bucket.
Wenn Sie den Inhalt des Quell-Buckets löschen möchten, ohne den Quell-Bucket selbst zu löschen, verwenden Sie den Befehl gcloud storage rm mit dem Flag --all-versions und dem Platzhalter **:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-18 (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)."]]
