Turboreplikation verwalten

Zu den Konzepten

Auf dieser Seite wird beschrieben, wie Sie das Feature der Turboreplikation für einen dualregionalen Bucket verwalten.

Replikationsstatus eines Buckets prüfen

So prüfen Sie, ob die Turboreplikation eines vorhandenen Buckets aktiviert ist:

Console

  1. Wechseln Sie in der Cloud Console zum Cloud Storage-Browser.

    Browser aufrufen

  2. Klicken Sie in der Bucket-Liste auf den Namen des Buckets, den Sie prüfen möchten.

  3. Klicken Sie auf den Tab Konfiguration.

  4. Wenn die Turboreplikation für den Bucket aktiviert ist, wird die Replikation auf Turbo gesetzt.

gsutil

Führen Sie den Befehl gsutil rpo get aus:

gsutil rpo get gs://BUCKET_NAME/

Hierbei gilt:

  • BUCKET_NAME ist der Name des entsprechenden Buckets. Beispiel: my-bucket.

Wenn der Vorgang erfolgreich war, sieht die Antwort so aus:

gs://my-bucket: ASYNC_TURBO

REST APIs

JSON API

  1. Rufen Sie ein Zugriffstoken für die Autorisierung aus dem OAuth 2.0 Playground ab. Konfigurieren Sie den Playground so, dass Ihre eigenen OAuth-Anmeldedaten verwendet werden.
  2. Rufen Sie mithilfe von cURL die JSON API mit einer GET-Bucket-Anfrage auf:

    curl -X GET \
      -H "Authorization: Bearer OAUTH2_TOKEN" \
      "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"

    Hierbei gilt:

    • OAUTH2_TOKEN ist der Name des Zugriffstokens, das Sie in Schritt 1 generiert haben.
    • BUCKET_NAME ist der Name des entsprechenden Buckets. Beispiel: my-bucket.

    Die Antwort sieht in etwa so aus:

    {
      "name": "my-bucket",
      "projectNumber": "234...",
      ...
      "rpo": "ASYNC_TURBO"
    }

    Beachten Sie den Schlüssel rpo. Der Wert ASYNC_TURBO gibt an, dass die Turboreplikation aktiviert ist. DEFAULT gibt an, dass die Standardreplikation angewendet wird. Das Feld rpo ist immer für dual- und multiregionale Buckets vorhanden, fehlt aber bei Buckets mit nur einer Region.

Schnelle Replikation aktivieren

So aktivieren Sie die Turboreplikation für einen vorhandenen dualregionalen Bucket:

Console

  1. Wechseln Sie in der Cloud Console zum Cloud Storage-Browser.

    Browser aufrufen

  2. Klicken Sie in der Bucket-Liste auf den Namen des Buckets, den Sie aktivieren möchten.

  3. Klicken Sie auf den Tab Konfiguration.

  4. Klicken Sie in der Zeile Replikation neben Standard auf Bearbeiten.

  5. Klicken Sie im Fenster Turboreplikation aktivieren auf Speichern.

gsutil

Führen Sie den Befehl gsutil rpo set ASYNC_TURBO aus:

gsutil rpo set ASYNC_TURBO gs://BUCKET_NAME/

Hierbei gilt:

  • BUCKET_NAME ist der Name des entsprechenden Buckets. Beispiel: my-bucket.

Wenn der Vorgang erfolgreich war, wird keine Antwort zurückgegeben. Die Änderung wird sofort wirksam.

REST APIs

JSON API

  1. Rufen Sie ein Zugriffstoken für die Autorisierung aus dem OAuth 2.0 Playground ab. Konfigurieren Sie den Playground so, dass Ihre eigenen OAuth-Anmeldedaten verwendet werden.
  2. Erstellen Sie eine .json-Datei, die folgende Informationen enthält:

    {
      "rpo": "ASYNC_TURBO"
    }
  3. Verwenden Sie cURL, um die JSON API mit einer PATCH-Bucket-Anfrage aufzurufen:

    curl -X PATCH --data-binary @JSON_FILE_NAME.json \
      -H "Authorization: Bearer OAUTH2_TOKEN" \
      -H "Content-Type: application/json" \
      "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"

    Hierbei gilt:

    • JSON_FILE_NAME ist der Pfad und der Name der JSON-Datei, die Sie in Schritt 2 erstellt haben.
    • OAUTH2_TOKEN ist das Zugriffstoken, das Sie in Schritt 1 generiert haben.
    • BUCKET_NAME ist der Name des entsprechenden Buckets. Beispiel: my-bucket.

    Wenn die Anfrage erfolgreich ist, wird keine Antwort zurückgegeben.

Schnelle Replikation deaktivieren

So deaktivieren Sie die Turboreplikation für einen vorhandenen dualregionalen Bucket:

Console

  1. Wechseln Sie in der Cloud Console zum Cloud Storage-Browser.

    Browser aufrufen

  2. Klicken Sie in der Bucket-Liste auf den Namen des Buckets, den Sie aktivieren möchten.

  3. Klicken Sie auf den Tab Konfiguration.

  4. Klicken Sie in der Zeile Replikation neben Turbo auf Bearbeiten.

  5. Klicken Sie im Fenster Turboreplikation deaktivieren auf Speichern.

gsutil

Führen Sie den Befehl gsutil rpo set DEFAULT aus:

gsutil rpo set DEFAULT gs://BUCKET_NAME/

Hierbei gilt:

  • BUCKET_NAME ist der Name des entsprechenden Buckets. Beispiel: my-bucket.

Wenn der Vorgang erfolgreich war, wird keine Antwort zurückgegeben. Die Änderung wird sofort wirksam.

REST APIs

JSON API

  1. Rufen Sie ein Zugriffstoken für die Autorisierung aus dem OAuth 2.0 Playground ab. Konfigurieren Sie den Playground so, dass Ihre eigenen OAuth-Anmeldedaten verwendet werden.
  2. Erstellen Sie eine .json-Datei, die folgende Informationen enthält:

    {
      "rpo": "DEFAULT"
    }
  3. Verwenden Sie cURL, um die JSON API mit einer PATCH-Bucket-Anfrage aufzurufen:

    curl -X PATCH --data-binary @JSON_FILE_NAME.json \
      -H "Authorization: Bearer OAUTH2_TOKEN" \
      -H "Content-Type: application/json" \
      "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"

    Hierbei gilt:

    • JSON_FILE_NAME ist der Pfad und der Name der JSON-Datei, die Sie in Schritt 2 erstellt haben.
    • OAUTH2_TOKEN ist das Zugriffstoken, das Sie in Schritt 1 generiert haben.
    • BUCKET_NAME ist der Name des entsprechenden Buckets. Beispiel: my-bucket.

    Wenn die Anfrage erfolgreich ist, wird keine Antwort zurückgegeben.

Dualregionalen Bucket mit Turboreplikation erstellen

Führen Sie die folgenden Schritte aus, um einen neuen dualregionalen Bucket mit aktivierter Turboreplikation zu erstellen:

Console

  1. Wechseln Sie in der Cloud Console zum Cloud Storage-Browser.

    Browser aufrufen

  2. Klicken Sie auf Bucket erstellen.

  3. Geben Sie auf der Seite Bucket erstellen die Bucket-Informationen ein. Klicken Sie auf Weiter, um mit dem nächsten Schritt fortzufahren.

    1. Geben Sie unter Bucket benennen einen Namen ein, der den Anforderungen für Bucket-Namen entspricht.

    2. Wählen Sie unter Speicherort für Daten auswählen neben Positionstyp die Option Dual-Region aus und klicken Sie das Kästchen Turboreplikation hinzufügen an.

    3. Wählen Sie unter Standort eine der verfügbaren Dual-Regionen aus.

    4. Wählen Sie unter Standardspeicherklasse für Ihre Daten auswählen eine Speicherklasse für den Bucket aus. Die Standardspeicherklasse wird standardmäßig allen in den Bucket hochgeladenen Objekten zugewiesen.

    5. Wählen Sie unter Zugriffssteuerung für Objekte auswählen eine Option für die Zugriffssteuerung aus. Mit dem Zugriffssteuerungsmodell wird festgelegt, wie Sie den Zugriff auf die Objekte des Buckets steuern.

    6. Fügen Sie unter Erweiterte Einstellungen (optional) den Wert Bucket-Labels hinzu, legen Sie eine Aufbewahrungsrichtlinie fest und wählen Sie eine Verschlüsselungsmethode aus.

  4. Klicken Sie auf Erstellen.

    Informationen zum Abrufen detaillierter Fehlerinformationen zu fehlgeschlagenen Vorgängen im Cloud Storage-Browser finden Sie unter Fehlerbehebung.

gsutil

Führen Sie den Befehl gsutil mb --rpo aus:

gsutil mb -l LOCATION -c CLASS --rpo REPLICATION_TYPE gs://BUCKET_NAME/

Hierbei gilt:

  • LOCATION gibt den geografischen Standort des Buckets an. Wenn kein Standort angegeben ist, gilt die Multiregion US als Standardeinstellung. Geben Sie für dieses Beispiel eine Dual-Region an. Beispiel: nam4

  • CLASS gibt die Speicherklasse an. Beispiel: NEARLINE

  • REPLICATION_TYPE gibt die Replikationseinstellung für dual- und multiregionale Buckets an. Der Wert DEFAULT steht für die Standardreplikation und ist eine gültige Option für dual- und multiregionale Buckets. ASYNC_TURBO steht für die Turboreplikation und ist eine gültige Option für viele dualregionale Buckets. Wenn keine Angabe erfolgt, gilt die Standardreplikation als Standardeinstellung für die Replikation. Verwenden Sie für dieses Beispiel ASYNC_TURBO.

  • BUCKET_NAME ist der Name des entsprechenden Buckets. Beispiel: my-bucket.

    Wenn die Anfrage erfolgreich ist, gibt der Befehl die folgende Meldung zurück:

    Creating gs://BUCKET_NAME/...

REST APIs

JSON API

  1. Rufen Sie ein Zugriffstoken für die Autorisierung aus dem OAuth 2.0 Playground ab. Konfigurieren Sie den Playground so, dass Ihre eigenen OAuth-Anmeldedaten verwendet werden.
  2. Erstellen Sie eine JSON-Datei mit den Einstellungen für den Bucket, darunter auch ein name für den Bucket. Eine vollständige Liste der Einstellungen finden Sie in der Dokumentation zu Buckets:Insert. Folgende Einstellungen können verwendet werden:

    {
      "name": "BUCKET_NAME",
      "rpo": "REPLICATION_TYPE",
      "location": "BUCKET_LOCATION",
      "storageClass": "STORAGE_CLASS",
      "iamConfiguration": {
        "uniformBucketLevelAccess": {
          "enabled": true
        },
      }
    }

    Hierbei gilt:

    • BUCKET_NAME ist der Name, den Sie Ihrem Bucket zuweisen möchten. Beachten Sie dabei die Anforderungen für Bucket-Namen. Beispiel: my-bucket.
    • REPLICATION_TYPE gibt die Replikationseinstellung für dual- und multiregionale Buckets an. Der Wert DEFAULT stellt die Standardreplikation dar und ist eine gültige Option für dual- und multiregionale Buckets. ASYNC_TURBO steht für die Turboreplikation und ist für die meisten dualregionalen Buckets eine gültige Option. Wenn keine Angabe erfolgt, gilt die Standardreplikation als Standardeinstellung für die Replikation. Verwenden Sie für dieses Beispiel ASYNC_TURBO.
    • BUCKET_LOCATION ist der Standort, an dem Sie die Objektdaten Ihres Buckets speichern möchten. Da Sie einen Bucket mit aktivierter Turboreplikation erstellen und der geografische Standort eines Buckets nach der Erstellung nicht mehr veränderbar ist, geben Sie eine Dual-Region an. Beispiel: NAM4
    • STORAGE_CLASS ist die Standardspeicherklasse Ihres Buckets. Beispiel: NEARLINE
  3. Verwenden Sie cURL zum Aufrufen der JSON API:

    curl -X POST --data-binary @JSON_FILE_NAME.json \
     -H "Authorization: Bearer OAUTH2_TOKEN" \
     -H "Content-Type: application/json" \
     "https://storage.googleapis.com/storage/v1/b?project=PROJECT_ID"

    Hierbei gilt:

    • JSON_FILE_NAME ist der Name der JSON-Datei, die Sie in Schritt 2 erstellt haben.
    • OAUTH2_TOKEN ist das Zugriffstoken, das Sie in Schritt 1 generiert haben.
    • PROJECT_ID ist die ID des Projekts, mit dem Ihr Bucket verknüpft wird. Beispiel: my-project.

Nächste Schritte