Turboreplikation verwalten (original) (raw)

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

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Storage-Administrator“ (roles/storage.admin) für den Bucket zuzuweisen, um die erforderlichen Berechtigungen für die Verwendung der Turbo-Replikation zu erhalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die für die Verwendung der Turbo-Replikation erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Führen Sie die folgenden Anweisungen aus, um die Turboreplikation für einen vorhandenen Bucket zu aktivieren oder zu deaktivieren:

Console

  1. Wechseln Sie in der Google Cloud Console unter „Cloud Storage“ zur Seite Buckets.
    Buckets aufrufen
  2. Klicken Sie in der Bucket-Liste auf den Namen des gewünschten Buckets.
  3. Klicken Sie auf den Tab Konfiguration.
  4. Klicken Sie in der Zeile Replikation auf Bearbeiten.
    Das angezeigte Fenster gibt an, ob Sie im Begriff sind, die Turboreplikation zu aktivieren oder die Turboreplikation zu deaktivieren.
  5. Klicken Sie auf Speichern, um die neue Einstellung zu bestätigen.

Befehlszeile

Führen Sie den Befehl gcloud storage buckets update mit dem Flag --rpo aus:

gcloud storage buckets update gs://BUCKET_NAME --rpo=STATE

Wobei:

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

Updating gs://my-bucket/... Completed 1

Clientbibliotheken

REST APIs

JSON-API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Authorization-Header zu generieren.
  2. Erstellen Sie eine JSON-Datei, die folgende Informationen enthält:
    {
    "rpo": "STATE"
    }
    Dabei ist STATE ASYNC_TURBO zum Aktivieren der Turbo-Replikation oder DEFAULT zum Deaktivieren der Turbo-Replikation.
  3. Verwenden Sie cURL, um die JSON API mit einerPATCH-Bucket-Anfrage aufzurufen:
    curl -X PATCH --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
    Dabei gilt:
    • JSON_FILE_NAME ist der Pfad für die JSON-Datei, die Sie in Schritt 2 erstellt haben.
    • BUCKET_NAME ist der Name des entsprechenden Buckets. Beispiel: my-bucket.
      Wenn die Anfrage erfolgreich ist, wird keine Antwort zurückgegeben.

XML API

Dieses Feature kann nicht über die XML API verwaltet werden. Verwenden Sie stattdessen die JSON API.

Führen Sie die folgenden Schritte aus, um das Recovery Point Objective (RPO) oder den Replikationsstatus eines Buckets zu prüfen:

Console

  1. Wechseln Sie in der Google Cloud Console unter „Cloud Storage“ zur Seite Buckets.
    Buckets 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.

Befehlszeile

Führen Sie den Befehl gcloud storage buckets describe mit dem Flag --format aus.

gcloud storage buckets describe gs://BUCKET_NAME --format="default(rpo)"

Dabei gilt:

Wenn der Vorgang erfolgreich ausgeführt wurde, sieht die Antwort in etwa so aus:

rpo: ASYNC_TURBO

Clientbibliotheken

REST APIs

JSON-API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Authorization-Header zu generieren.
  2. Verwenden Sie cURL, um die JSON API mit einer GET-Bucket-Anfrage aufzurufen:
    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
    Dabei ist BUCKET_NAME 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 bi- und multiregionale Buckets vorhanden, fehlt aber bei Buckets mit nur einer Region.

XML API

Dieses Feature kann nicht über die XML API verwaltet werden. Verwenden Sie stattdessen die JSON API.