Auf dieser Seite wird beschrieben, wie Sie das Feature der Turboreplikation für einen biregionalen Bucket verwalten.
Erforderliche Berechtigungen
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 biregionalen Standort 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 biregionalen Standort 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.
Clientbibliotheken
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 biregionalen Standort 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 und benötigen die unter IAM-Berechtigungen für JSON-Methoden aufgeführten Berechtigungen. Um zu erfahren, welche JSON API-Methoden aufgerufen werden, wenn Sie Anfragen über eine Clientbibliothek stellen, können Sie die Rohanfragen protokollieren.
Eine Liste der relevanten IAM-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 biregionalen Standort 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.
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 zur Seite Cloud Storage-Buckets.
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
gcloud
Führen Sie den Befehl gcloud storage buckets update
mit dem Flag --rpo
aus:
gcloud storage buckets update gs://BUCKET_NAME --rpo=STATE
Wobei:
BUCKET_NAME
ist der Name des entsprechenden Buckets. Beispiel:my-bucket
.STATE
istASYNC_TURBO
zum Aktivieren der Turboreplikation oderDEFAULT
zum Deaktivieren der Turboreplikation.
Wenn der Vorgang erfolgreich war, sieht die Antwort so aus:
Updating gs://my-bucket/... Completed 1
gsutil
Führen Sie den Befehl gsutil rpo set
aus:
gsutil rpo set STATE gs://BUCKET_NAME/
Dabei gilt:
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.
Clientbibliotheken
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.
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 zur Seite Cloud Storage-Buckets.
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
gcloud
Führen Sie den Befehl gcloud storage buckets describe
mit dem Flag --format
aus.
gcloud storage buckets describe gs://BUCKET_NAME --format="default(rpo)"
Wobei:
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:
rpo: ASYNC_TURBO
gsutil
Führen Sie den Befehl gsutil rpo get
aus:
gsutil rpo get gs://BUCKET_NAME/
Wobei:
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
Clientbibliotheken
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 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.
Turboreplikationsleistung eines Buckets überwachen
- Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.
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 Google Cloud Console als Anzahl der fehlenden Minuten RPO angezeigt. Die Google Cloud Console verfolgt auch die Anzahl der abgeschlossenen Objektreplikationen, die als Objektreplikationen mit Turbo angezeigt werden.
Weitere Informationen finden Sie unter Überwachung der Turbo-Replikationsleistung.
Nächste Schritte
- Weitere Informationen zur Turboreplikation.
- Weitere Informationen zu Preisen für Turboreplikation oder sehen Sie sich ein Preisbeispiel an.