Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite wird beschrieben, wie Sie die Bucket-übergreifende Replikation verwenden, bei der mit Storage Transfer Service neue und aktualisierte Objekte asynchron aus einem Quell-Bucket in einen Ziel-Bucket kopiert werden. Bei der Bucket-übergreifenden Replikation erstellen und verwalten Sie Replikationsjobs, eine Art von Job in Storage Transfer Service.
Vorbereitung
Wenn Sie die Bucket-übergreifende Replikation verwenden möchten, müssen Sie bestimmte erforderliche Schritte ausführen. Eine Anleitung dazu finden Sie in der Storage Transfer Service-Dokumentation unter Vorbereitung.
Replikationsjob erstellen
Console
Wenn Sie einen Bucket-übergreifenden Replikationsjob über dieGoogle Cloud Console erstellen, erhält der Storage Transfer Service-Dienst-Agent automatisch die Rolle storage.legacyBucketOwner für den Quell-Bucket und die Rolle storage.legacyBucketWriter für den Ziel-Bucket.
In der Google Cloud Console können Sie Replikationsjobs für vorhandene oder neue Buckets erstellen.
Wenn Sie einen Replikationsjob für einen neuen Bucket erstellen möchten, folgen Sie der Anleitung unter Neuen Bucket erstellen.
So erstellen Sie einen Replikationsjob für einen vorhandenen Bucket:
Wechseln Sie in der Google Cloud Console unter „Cloud Storage“ zur Seite Buckets.
Klicken Sie in der Liste der Buckets auf den Namen des Quell-Buckets, dessen Objekte Sie replizieren möchten.
Klicken Sie auf der Seite Bucket-Details auf den Tab Konfiguration.
Suchen Sie die Option Bucket-übergreifende Replikation und klicken Sie auf editBearbeiten.
Klicken Sie im nun geöffneten Bereich Bucket-übergreifende Replikation bearbeiten auf Ziel hinzufügen.
Wählen Sie im Bereich Ziel auswählen einen Ziel-Bucket aus und klicken Sie auf Weiter.
Führen Sie im Abschnitt Replikationseinstellungen auswählen die folgenden Schritte aus:
Optional: Sollen die zu replizierenden Objekte nach dem Objektnamenspräfix gefiltert werden, wählen Sie im Abschnitt Auswählen, welche Objekte repliziert werden sollen das Kästchen Objekte anhand des Präfixes replizieren aus.
Wenn Sie Objekte nach Präfix einschließen möchten, geben Sie im Abschnitt Objekte mit Präfix einschließen ein Präfix ein und klicken Sie dann auf addPräfix hinzufügen.
Wenn Sie Objekte nach Präfix ausschließen möchten, geben Sie im Bereich Objekte mit Präfix ausschließen ein Präfix ein und klicken Sie dann auf addPräfix hinzufügen.
Optional: Wenn Sie eine Speicherklasse für replizierte Objekte festlegen möchten, wählen Sie im Abschnitt Speicherklasse für replizierte Objekte festlegen eine Speicherklasse aus dem Menü aus.
Wenn Sie diesen Schritt überspringen, wird für replizierte Objekte standardmäßig die Speicherklasse des Ziel-Buckets verwendet.
Mit der Google Cloud Console können Sie keine Replikationsjobs auflisten. Unter Replikationsjob ansehen finden Sie eine Anleitung zum Anzeigen eines einzelnen Replikationsjobs.
Klicken Sie in der Liste der Buckets auf den Namen des Quell-Buckets, dessen Bucket-übergreifenden Replikationsjob Sie ansehen möchten.
Klicken Sie auf der Seite Bucket-Details auf den Tab Konfiguration.
Suchen Sie die Option Bucket-übergreifende Replikation und klicken Sie auf editBearbeiten.
Der Bereich Bucket-übergreifende Replikation bearbeiten wird angezeigt. Darin ist der Replikationsjob für jeden Ziel-Bucket zu sehen.
Auf der Seite Buckets sehen Sie die Spalte Replikation, in der angezeigt wird, ob für einen Bucket ein Turboreplikationsjob oder ein Bucket-übergreifender Replikationsjob ausgeführt wird. Eine Anleitung zum Anzeigen der Spalte Replikation finden Sie unter Spalten ein- und ausblenden.
Klicken Sie in der Liste der Buckets auf den Namen des Quell-Buckets, für den Sie die Replikation pausieren oder fortsetzen möchten.
Klicken Sie auf der Seite Bucket-Details auf den Tab Konfiguration.
Suchen Sie die Option Bucket-übergreifende Replikation und klicken Sie auf editBearbeiten.
Klicken Sie im angezeigten Bereich Bucket-übergreifende Replikation bearbeiten neben dem Replikationsjob, den Sie aktualisieren möchten, auf pausePausieren oder play_arrowFortsetzen.
Klicken Sie in der Liste der Buckets auf den Namen des Quell-Buckets, dessen Replikation Sie beenden möchten.
Klicken Sie auf der Seite Bucket-Details auf den Tab Konfiguration.
Suchen Sie die Option Bucket-übergreifende Replikation und klicken Sie auf editBearbeiten.
Klicken Sie im angezeigten Bereich Bucket-übergreifende Replikation bearbeiten neben dem Replikationsjob, den Sie aktualisieren möchten, auf deleteLöschen.
Klicken Sie im angezeigten Dialogfeld auf Bestätigen.
[[["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-09-05 (UTC)."],[],[],null,["# Use cross-bucket replication\n\nThis page describes how to use [cross-bucket replication](/storage/docs/availability-durability#cross-bucket-replication), which uses\n[Storage Transfer Service](/storage-transfer/docs/overview) to copy new and updated objects asynchronously from a\nsource bucket to a destination bucket. When you use cross-bucket replication,\nyou create and manage replication jobs, which are a type of job in\nStorage Transfer Service.\n\nBefore you begin\n----------------\n\nTo use cross-bucket replication, you must complete prerequisite steps. For\ninstructions, refer to [Before you begin](/storage-transfer/docs/cross-bucket-replication#before-you-begin) in the Storage Transfer Service\ndocumentation.\n\nCreate a replication job\n------------------------\n\n### Console\n\nWhen you create a cross-bucket replication job using the\nGoogle Cloud console, the Storage Transfer Service service agent is\nautomatically granted the `storage.legacyBucketOwner` role on the source\nbucket and the `storage.legacyBucketWriter` role on the destination\nbucket.\n\nWhen using the Google Cloud console, you can create a replication job for\nexisting buckets or for new buckets during the bucket creation process.\n\nTo create a replication job for a new bucket, follow the instructions for\n[creating a new bucket](/storage/docs/creating-buckets#create-bucket).\n\nTo create a replication job for an existing bucket, complete the following\nsteps:\n\n1. In the Google Cloud console, go to the Cloud Storage **Buckets** page. \n\n [Go to Buckets](https://console.cloud.google.com/storage/browser)\n2. In the list of buckets, click the name of the source bucket whose objects\n you want to replicate.\n\n3. On the **Bucket details** page, click the **Configuration** tab.\n\n4. Locate the **Cross-bucket replication** option and click\n edit **Edit**.\n\n5. In the **Edit cross-bucket replication** pane that opens, click\n **Add a destination**.\n\n6. In the **Choose a destination** section, select a destination bucket,\n then click **Next**.\n\n7. In the **Choose replication settings** section, do the following:\n\n - Optional: To filter objects to replicate by object name prefix,\n select the **Replicate objects based on prefix** checkbox in the\n **Choose which objects to replicate** section.\n\n - To include objects by prefix, enter a prefix in the\n **Include objects with prefix** section, then\n click add **Add a prefix**.\n\n - To exclude objects by prefix, enter a prefix in the\n **Exclude objects with prefix** section, then click\n add **Add a prefix**.\n\n - Optional: To set a storage class for replicated objects, select a\n storage class from the menu in the\n **Set storage class for replicated objects** section.\n\n If you skip this step, replicated objects use the destination bucket's\n storage class by default.\n\n 1. Click **Save**.\n\n### Command line\n\nFor Google Cloud CLI instructions on how to create a replication job,\nrefer to [Create a replication job using the Google Cloud CLI](/storage-transfer/docs/cross-bucket-replication#create-replication-job).\n\n### REST APIs\n\n### JSON API\n\nFor JSON API instructions on how to create a replication job,\nrefer to [Create a replication job using the JSON API](/storage-transfer/docs/cross-bucket-replication#create-replication-job).\n\nTo check the status of the replication job,\n[view Cloud Logging for Storage Transfer Service logs](/storage-transfer/docs/transfer-logs#view-logs).\n\nList replication jobs\n---------------------\n\n### Console\n\nYou cannot list replication jobs using the Google Cloud console. See\n[View replication job](#view-replication-job) for instructions on how to view a single\nreplication job at a time.\n\n### Command line\n\nFor Google Cloud CLI instructions on how to list replication jobs,\nrefer to [List replication jobs using the Google Cloud CLI](/storage-transfer/docs/cross-bucket-replication#list-replication-jobs).\n\n### REST APIs\n\n### JSON API\n\nFor JSON API instructions on how to list replication jobs,\nrefer to [List replication jobs using the JSON API](/storage-transfer/docs/cross-bucket-replication#list-replication-jobs).\n\nView a replication job\n----------------------\n\n### Console\n\n1. In the Google Cloud console, go to the Cloud Storage **Buckets** page. \n\n [Go to Buckets](https://console.cloud.google.com/storage/browser)\n2. In the list of buckets, click the name of the source bucket whose\n cross-bucket replication job you want to view.\n\n3. On the **Bucket details** page, click the **Configuration** tab.\n\n4. Locate the **Cross-bucket replication** option and click\n edit **Edit**.\n\n The **Edit cross-bucket replication** pane appears, which displays\n the replication job for each destination bucket.\n\nOn the **Buckets** page, you can view the **Replication** column, which\ndisplays whether a bucket has a Turbo replication job or a cross-bucket\nreplication job running. For instructions on displaying the **Replication**\ncolumn, see [Show columns](/storage/docs/cloud-console#show-columns).\n\n### Command line\n\nFor Google Cloud CLI instructions on how to view a replication job,\nrefer to [View a replication job using the Google Cloud CLI](/storage-transfer/docs/cross-bucket-replication#view-replication-job).\n\n### REST APIs\n\n### JSON API\n\nFor JSON API instructions on how to view a replication job,\nrefer to [View a replication job using the JSON API](/storage-transfer/docs/cross-bucket-replication#view-replication-job).\n\nUpdate a replication job\n------------------------\n\nYou can update the following fields of a replication job:\n\n- The description of the replication job\n\n- The configuration for running a replication job\n\n- The configuration of notifications published to Pub/Sub\n\n- The logging behavior for replication job operations\n\n- The status of the replication job (whether it's enabled, disabled, or deleted)\n\n### Console\n\nWhen using the Google Cloud console, you can only update a replication\njob by pausing or unpausing the job.\n\n1. In the Google Cloud console, go to the Cloud Storage **Buckets** page. \n\n [Go to Buckets](https://console.cloud.google.com/storage/browser)\n2. In the list of buckets, click the name of the source bucket that\n you want to pause or unpause replicating.\n\n3. On the **Bucket details** page, click the **Configuration** tab.\n\n4. Locate the **Cross-bucket replication** option and click\n edit **Edit**.\n\n5. In the **Edit cross-bucket replication** pane that appears, click\n pause **Pause** or\n play_arrow **Unpause** next to the\n replication job you want to update.\n\n### Command line\n\nFor Google Cloud CLI instructions on how to update a replication job,\nrefer to [Update a replication job using the Google Cloud CLI](/storage-transfer/docs/cross-bucket-replication#update-replication-job).\n\n### REST APIs\n\n### JSON API\n\nFor JSON API instructions on how to update a replication job,\nrefer to [Update a replication job using the JSON API](/storage-transfer/docs/cross-bucket-replication#update-replication-job).\n\nDelete a replication job\n------------------------\n\n### Console\n\n1. In the Google Cloud console, go to the Cloud Storage **Buckets** page. \n\n [Go to Buckets](https://console.cloud.google.com/storage/browser)\n2. In the list of buckets, click the name of the source bucket you\n want to stop replicating.\n\n3. On the **Bucket details** page, click the **Configuration** tab.\n\n4. Locate the **Cross-bucket replication** option and click\n edit **Edit**.\n\n5. In the **Edit cross-bucket replication** pane that appears, click\n delete **Delete** next to the\n replication job you want to delete.\n\n6. In the dialogue that appears, click **Confirm**.\n\n### Command line\n\nFor Google Cloud CLI instructions on how to delete a replication job,\nrefer to [Delete a replication job using the Google Cloud CLI](/storage-transfer/docs/cross-bucket-replication#delete-replication-job).\n\n### REST APIs\n\n### JSON API\n\nFor JSON API instructions on how to delete a replication job,\nrefer to [Delete a replication job using the JSON API](/storage-transfer/docs/cross-bucket-replication#delete-replication-job).\n\nWhat's next\n-----------\n\n[Monitor your replicated objects](/storage/docs/monitoring#cross-bucket_replication_graphs)."]]
