Auf dieser Seite wird beschrieben, wie Sie das Feature der Turboreplikation für einen dualregionalen Bucket verwalten.
Vorbereitung
Die Voraussetzungen können je nach verwendetem Tool variieren:
Console
Sie benötigen die entsprechenden IAM-Berechtigungen, um diesen Leitfaden mit der Google Cloud Console abzuschließen. Damit Sie dieses Feature verwenden können, müssen Sie einen Bucket an einem Standort mit zwei Regionen haben oder erstellen. Wenn sich der Bucket, auf den Sie zugreifen möchten, in einem Projekt befindet, das nicht Sie erstellt haben, muss Ihnen der Projektinhaber möglicherweise erst eine Rolle zuweisen, die die erforderlichen Berechtigungen enthält.
Eine Liste der erforderlichen Berechtigungen für bestimmte Aktionen finden Sie unter IAM-Berechtigungen für die Google Cloud Console.
Eine Liste der relevanten Rollen finden Sie unter Cloud Storage-Rollen. Alternativ können Sie eine benutzerdefinierte Rolle erstellen, die spezifische, eingeschränkte Berechtigungen hat.
Befehlszeile
Damit Sie diese Anleitung mit einem Befehlszeilen-Dienstprogramm ausführen können, benötigen Sie die entsprechenden IAM-Berechtigungen. Damit Sie dieses Feature verwenden können, müssen Sie einen Bucket an einem Standort mit zwei Regionen haben oder erstellen. Wenn sich der Bucket, auf den Sie zugreifen möchten, in einem Projekt befindet, das nicht Sie erstellt haben, muss Ihnen der Projektinhaber möglicherweise erst eine Rolle zuweisen, die die erforderlichen Berechtigungen enthält.
Eine Liste der erforderlichen Berechtigungen für bestimmte Aktionen finden Sie unter IAM-Berechtigungen für gsutil-Befehle.
Eine Liste der relevanten Rollen finden Sie unter Cloud Storage-Rollen. Alternativ können Sie eine benutzerdefinierte Rolle erstellen, die spezifische, eingeschränkte Berechtigungen hat.
Codebeispiele
Sie benötigen die entsprechenden IAM-Berechtigungen, um diesen Leitfaden mit den Cloud Storage-Clientbibliotheken abzuschließen. Damit Sie dieses Feature verwenden können, müssen Sie einen Bucket an einem Standort mit zwei Regionen haben oder einen solchen erstellen. Wenn sich der Bucket, auf den Sie zugreifen möchten, in einem Projekt befindet, das nicht Sie erstellt haben, muss Ihnen der Projektinhaber möglicherweise erst eine Rolle zuweisen, die die erforderlichen Berechtigungen enthält. Sofern nicht anders angegeben, werden Clientbibliotheksanfragen über die JSON API gestellt.
Eine Liste der für bestimmte Aktionen erforderlichen Berechtigungen finden Sie unter IAM-Berechtigungen für JSON-Methoden.
Eine Liste der relevanten Rollen finden Sie unter Cloud Storage-Rollen. Alternativ können Sie eine benutzerdefinierte Rolle erstellen, die spezifische, eingeschränkte Berechtigungen hat.
REST APIs
JSON API
Sie benötigen die entsprechenden IAM-Berechtigungen, um diese Anleitung mit der JSON API abzuschließen. Damit Sie dieses Feature verwenden können, müssen Sie einen Bucket an einem Standort mit zwei Regionen haben oder erstellen. Wenn sich der Bucket, auf den Sie zugreifen möchten, in einem Projekt befindet, das nicht Sie erstellt haben, muss Ihnen der Projektinhaber möglicherweise erst eine Rolle zuweisen, die die erforderlichen Berechtigungen enthält.
Eine Liste der für bestimmte Aktionen erforderlichen Berechtigungen finden Sie unter IAM-Berechtigungen für JSON-Methoden.
Eine Liste der relevanten Rollen finden Sie unter Cloud Storage-Rollen. Alternativ können Sie eine benutzerdefinierte Rolle erstellen, die spezifische, eingeschränkte Berechtigungen hat.
XML API
Dieses Feature kann nicht über die XML API verwaltet werden. Verwenden Sie stattdessen die JSON API.
Replikationsstatus eines Buckets prüfen
Führen Sie die folgenden Schritte aus, um das Recovery Point Objective (RPO) oder den Replikationsstatus eines Buckets zu prüfen:
Console
- Wechseln Sie in der Cloud Console zum Cloud Storage-Browser.
Klicken Sie in der Bucket-Liste auf den Namen des Buckets, den Sie prüfen möchten.
Klicken Sie auf den Tab Konfiguration.
Wenn die Turboreplikation für den Bucket aktiviert ist, wird die Replikation auf Turbo gesetzt.
Befehlszeile
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 ausgeführt wurde, sieht die Antwort in etwa so aus:
gs://my-bucket: ASYNC_TURBO
Codebeispiele
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
REST APIs
JSON API
- 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. Eine Anleitung finden Sie unter API-Authentifizierung.
Rufen Sie mithilfe von
cURL
die JSON API mit einerGET
-Bucket-Anfrage auf:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
Dabei 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 WertASYNC_TURBO
gibt an, dass die Turboreplikation aktiviert ist.DEFAULT
gibt an, dass die Standardreplikation angewendet wird. Das Feldrpo
ist immer für dual- 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.
Turboreplikation festlegen
Führen Sie die folgenden Anweisungen aus, um die Turboreplikation für einen vorhandenen Bucket zu aktivieren oder zu deaktivieren:
Console
- Wechseln Sie in der Cloud Console zum Cloud Storage-Browser.
Klicken Sie in der Bucket-Liste auf den Namen des gewünschten Buckets.
Klicken Sie auf den Tab Konfiguration.
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.
Klicken Sie auf Speichern, um die neue Einstellung zu bestätigen.
Befehlszeile
Führen Sie den Befehl gsutil rpo set
aus:
gsutil rpo set STATE gs://BUCKET_NAME/
Wobei:
STATE
istASYNC_TURBO
zum Aktivieren der Turboreplikation oderDEFAULT
zum Deaktivieren der Turboreplikation.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.
Codebeispiele
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
Im folgenden Beispiel wird die Turboreplikation für einen Bucket aktiviert:
Im folgenden Beispiel wird die Standardreplikation für einen Bucket aktiviert:
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Im folgenden Beispiel wird die Turboreplikation für einen Bucket aktiviert:
Im folgenden Beispiel wird die Standardreplikation für einen Bucket aktiviert:
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Im folgenden Beispiel wird die Turboreplikation für einen Bucket aktiviert:
Im folgenden Beispiel wird die Standardreplikation für einen Bucket aktiviert:
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Im folgenden Beispiel wird die Turboreplikation für einen Bucket aktiviert:
Im folgenden Beispiel wird die Standardreplikation für einen Bucket aktiviert:
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
Im folgenden Beispiel wird die Turboreplikation für einen Bucket aktiviert:
Im folgenden Beispiel wird die Standardreplikation für einen Bucket aktiviert:
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Im folgenden Beispiel wird die Turboreplikation für einen Bucket aktiviert:
Im folgenden Beispiel wird die Standardreplikation für einen Bucket aktiviert:
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Im folgenden Beispiel wird die Turboreplikation für einen Bucket aktiviert:
Im folgenden Beispiel wird die Standardreplikation für einen Bucket aktiviert:
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
Im folgenden Beispiel wird die Turboreplikation für einen Bucket aktiviert:
Im folgenden Beispiel wird die Standardreplikation für einen Bucket aktiviert:
REST APIs
JSON API
- 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. Eine Anleitung finden Sie unter API-Authentifizierung.
Erstellen Sie eine JSON-Datei, die folgende Informationen enthält:
{ "rpo": "STATE" }
Dabei ist
STATE
ASYNC_TURBO
zum Aktivieren der Turbo-Replikation oderDEFAULT
zum Deaktivieren der Turbo-Replikation.Verwenden Sie
cURL
, um die JSON API mit einerPATCH
-Bucket-Anfrage aufzurufen:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer OAUTH2_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.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.
XML API
Dieses Feature kann nicht über die XML API verwaltet werden. Verwenden Sie stattdessen die JSON API.
Dualregionalen Bucket mit Turboreplikation erstellen
Führen Sie die folgenden Anweisungen aus, um einen neuen Bucket mit zwei Regionen mit aktivierter Turboreplikation zu erstellen:
Console
- Wechseln Sie in der Cloud Console zum Cloud Storage-Browser.
Klicken Sie auf Bucket erstellen.
Geben Sie auf der Seite Bucket erstellen die Bucket-Informationen ein. Klicken Sie auf Weiter, um mit dem nächsten Schritt fortzufahren.
Geben Sie unter Bucket benennen einen Namen ein, der den Anforderungen für Bucket-Namen entspricht.
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.
Wählen Sie unter Standort eine der verfügbaren Dual-Regionen aus.
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.
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.
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.
Klicken Sie auf Erstellen.
Informationen zum Abrufen detaillierter Fehlerinformationen zu fehlgeschlagenen Vorgängen im Cloud Storage-Browser finden Sie unter Fehlerbehebung.
Befehlszeile
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, ist der multiregionale StandortUS
die 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 WertDEFAULT
steht für die Standardreplikation und ist eine gültige Option für Buckets mit zwei oder mehreren Regionen.ASYNC_TURBO
steht für die Turboreplikation und ist eine gültige Option für viele Buckets mit zwei Regionen. Wenn keine Angabe erfolgt, ist die Standardreplikation die Standardeinstellung für die Replikation. Verwenden Sie für dieses BeispielASYNC_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/...
Codebeispiele
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
REST APIs
JSON API
- 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. Eine Anleitung finden Sie unter API-Authentifizierung.
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 WertDEFAULT
steht für die Standardreplikation und ist eine gültige Option für Buckets mit zwei oder mehreren Regionen.ASYNC_TURBO
steht für die Turboreplikation und ist eine gültige Option für viele Buckets mit zwei Regionen. Wenn keine Angabe erfolgt, ist die Standardreplikation die Standardeinstellung für die Replikation. Verwenden Sie für dieses BeispielASYNC_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
Verwenden Sie
cURL
zum Aufrufen der JSON API:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b?project=PROJECT_ID"
Wobei:
JSON_FILE_NAME
ist der Pfad für die 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
.
XML API
Dieses Feature kann nicht über die XML API verwaltet werden. Verwenden Sie stattdessen die JSON API.
Turboreplikationsleistung eines Buckets überwachen
- Wechseln Sie in der Cloud Console zum Cloud Storage-Browser.
Klicken Sie in der Bucket-Liste auf den Namen des gewünschten Buckets.
Klicken Sie auf den Tab Konfiguration.
Klicken Sie in der Zeile Replikation auf Replikationsmesswerte anzeigen.
Wenn die Replikation eines Objekts länger als 15 Minuten dauerte, werden die zusätzlichen Minuten zusammengefasst und in der Cloud Console als Anzahl der fehlenden Minuten RPO angezeigt. Die Cloud Console verfolgt auch die Anzahl der abgeschlossenen Objektreplikationen, die als Objektreplikationen mit Turbo angezeigt werden.
Weitere Informationen finden Sie unter Informationen zu RTO und RPO.
Nächste Schritte
- Weitere Informationen zur Turboreplikation.
- Weitere Informationen zu Preisen für Turboreplikation oder sehen Sie sich ein Preisbeispiel an.