Auf dieser Seite wird beschrieben, wie Sie das Feature "Bucket-Sperre" verwenden. Sie erhalten unter anderem Informationen zum Arbeiten mit Aufbewahrungsrichtlinien und zum dauerhaften Sperren dieser Richtlinien für Buckets.
Hinweise
Bevor Sie die Funktion „Bucket Lock“ verwenden können, müssen Sie die Schritte in den folgenden Abschnitten ausführen.
Erforderliche Rollen abrufen
Bitten Sie Ihren Administrator, Ihnen die Rolle „Storage-Administrator“ (roles/storage.admin
) für den Bucket zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Verwenden der Bucket-Sperre benötigen. Diese vordefinierte Rolle enthält die Berechtigungen, die zum Verwenden der Bucket-Sperre erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
storage.buckets.get
storage.buckets.list
- Diese Berechtigung ist nur erforderlich, wenn Sie die Google Cloud Console zum Ausführen der Anleitung auf dieser Seite verwenden möchten.
storage.buckets.update
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen erhalten.
Informationen zum Zuweisen von Rollen für Buckets finden Sie unter IAM mit Buckets verwenden.
Aufbewahrungsrichtlinie für einen Bucket festlegen
So fügen Sie eine Aufbewahrungsrichtlinie für einen Bucket hinzu oder ändern oder entfernen sie:
Console
- Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.
Klicken Sie in der Liste der Buckets auf den Namen des Buckets, dessen Aufbewahrungsrichtlinie Sie ändern möchten.
Wählen Sie oben auf der Seite den Tab Schutz aus.
Legen Sie im Abschnitt Aufbewahrungsrichtlinie Ihre Aufbewahrungsrichtlinie fest:
Wenn derzeit keine Aufbewahrungsrichtlinie für den Bucket gilt, klicken Sie auf den Link add_box Aufbewahrungsrichtlinie festlegen. Wählen Sie eine Zeiteinheit und eine Zeitdauer für die Aufbewahrungsdauer aus.
Wenn eine Aufbewahrungsrichtlinie derzeit für einen Bucket gilt, wird sie im Abschnitt angezeigt. Klicken Sie auf Bearbeiten, um die Aufbewahrungsdauer zu ändern, oder auf Löschen, um die Aufbewahrungsrichtlinie vollständig zu entfernen.
Unter Aufbewahrungsdauer erfahren Sie, wie die Google Cloud Console Zeiteinheiten umrechnet.
Unter Fehlerbehebung erfahren Sie, wie Sie detaillierte Fehlerinformationen zu fehlgeschlagenen Cloud Storage-Vorgängen in der Google Cloud Console abrufen.
Befehlszeile
Führen Sie den gcloud storage buckets update
-Befehl mit dem geeigneten Flag aus.
gcloud storage buckets update gs://BUCKET_NAME FLAG
Dabei gilt:
BUCKET_NAME
ist der Name des entsprechenden Buckets. Beispiel:my-bucket
.FLAG
ist die gewünschte Einstellung für die Aufbewahrungsdauer des Buckets. Verwenden Sie eines der folgenden Formate:--retention-period
und eine Aufbewahrungsdauer, wenn Sie eine Aufbewahrungsrichtlinie hinzufügen oder ändern möchten. Beispiel:--retention-period=1d43200s
.--clear-retention-period
, wenn Sie die Aufbewahrungsrichtlinie für den Bucket entfernen möchten.
Wenn der Vorgang erfolgreich war, sieht die Antwort so aus:
Updating gs://my-bucket/... Completed 1
Clientbibliotheken
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird eine Aufbewahrungsrichtlinie für einen Bucket festgelegt:
Im folgenden Beispiel wird die Aufbewahrungsrichtlinie für einen Bucket entfernt:
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird eine Aufbewahrungsrichtlinie für einen Bucket festgelegt:
Im folgenden Beispiel wird die Aufbewahrungsrichtlinie für einen Bucket entfernt:
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird eine Aufbewahrungsrichtlinie für einen Bucket festgelegt:
Im folgenden Beispiel wird die Aufbewahrungsrichtlinie für einen Bucket entfernt:
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird eine Aufbewahrungsrichtlinie für einen Bucket festgelegt:
Im folgenden Beispiel wird die Aufbewahrungsrichtlinie für einen Bucket entfernt:
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird eine Aufbewahrungsrichtlinie für einen Bucket festgelegt:
Im folgenden Beispiel wird die Aufbewahrungsrichtlinie für einen Bucket entfernt:
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird eine Aufbewahrungsrichtlinie für einen Bucket festgelegt:
Im folgenden Beispiel wird die Aufbewahrungsrichtlinie für einen Bucket entfernt:
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird eine Aufbewahrungsrichtlinie für einen Bucket festgelegt:
Im folgenden Beispiel wird die Aufbewahrungsrichtlinie für einen Bucket entfernt:
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird eine Aufbewahrungsrichtlinie für einen Bucket festgelegt:
Im folgenden Beispiel wird die Aufbewahrungsrichtlinie für einen Bucket entfernt:
REST APIs
JSON API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Erstellen Sie eine JSON-Datei, die folgende Informationen enthält:
{ "retentionPolicy": { "retentionPeriod": "TIME_IN_SECONDS" } }
Dabei ist
TIME_IN_SECONDS
der Zeitraum in Sekunden, in dem die Objekte im Bucket vorhanden sein müssen. Beispiel:2678400
. Unter Aufbewahrungsdauer erfahren Sie, wie verschiedene Zeiteinheiten in Sekunden gemessen werden.Entfernen Sie die Aufbewahrungsrichtlinie für einen Bucket mithilfe des folgenden Codes in der JSON-Datei:
{ "retentionPolicy": null }
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=retentionPolicy"
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
.
XML API
Die XML API kann nicht zum Festlegen oder Entfernen einer Aufbewahrungsrichtlinie für einen vorhandenen Bucket verwendet werden. Mit ihr kann lediglich eine Aufbewahrungsrichtlinie für einen neuen Bucket angegeben werden.
Bucket sperren
So sperren Sie einen Bucket und verhindern dauerhaft das Ändern der Aufbewahrungsrichtlinie des Buckets:
Console
- Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.
Klicken Sie in der Liste der Buckets auf den Namen des Buckets, für den Sie die Aufbewahrungsrichtlinie sperren möchten.
Wählen Sie oben auf der Seite den Tab Schutz aus.
Klicken Sie im Eintrag Aufbewahrungsrichtlinie auf die Schaltfläche Sperren.
Das Dialogfeld Aufbewahrungsrichtlinie sperren? wird angezeigt.
Lesen Sie die Benachrichtigung bezüglich der dauerhaften Änderung.
Geben Sie im Textfeld Bucket-Name den Namen des Buckets ein.
Klicken Sie auf Richtlinie sperren.
Unter Fehlerbehebung erfahren Sie, wie Sie detaillierte Fehlerinformationen zu fehlgeschlagenen Cloud Storage-Vorgängen in der Google Cloud Console abrufen.
Befehlszeile
Führen Sie den Befehl gcloud storage buckets update
mit dem Flag --lock-retention-period
aus.
gcloud storage buckets update gs://BUCKET_NAME --lock-retention-period
Dabei ist BUCKET_NAME
der Name des entsprechenden Buckets. Beispiel: my-bucket
.
Wenn der Vorgang erfolgreich war, sieht die Antwort in etwa so aus:
Updating gs://my-bucket/... Completed 1
Clientbibliotheken
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
REST APIs
JSON API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Verwenden Sie
cURL
, um die JSON API mit einerPOST
-Bucket-Anfrage aufzurufen:curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/lockRetentionPolicy?ifMetagenerationMatch=BUCKET_METAGENERATION_NUMBER"
Dabei gilt:
BUCKET_NAME
ist der Name des entsprechenden Buckets. Beispiel:my-bucket
BUCKET_METAGENERATION_NUMBER
ist der Metagenerationswert für den Bucket. Beispiel:8
. Sie finden den Metagenerationswert für Ihren Bucket durch Aufrufen der JSON API mit einerGET
-Bucket-Anfrage.
XML API
Die XML API kann nicht zum Sperren eines Buckets verwendet werden. Verwenden Sie stattdessen eines der anderen Cloud Storage-Tools, z. B. die Google Cloud Console.
Aufbewahrungsrichtlinie und Sperrstatus eines Buckets ansehen
So sehen Sie, welche Aufbewahrungsrichtlinie gegebenenfalls für einen Bucket festgelegt ist und ob diese Aufbewahrungsrichtlinie gesperrt ist:
Console
- Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.
Klicken Sie auf den Namen des Buckets, dessen Status Sie prüfen möchten.
Wenn ein Bucket eine Aufbewahrungsrichtlinie hat, wird die Aufbewahrungsdauer im Feld Schutz für den Bucket angezeigt. Wenn die Aufbewahrungsrichtlinie nicht gesperrt ist, wird neben der Aufbewahrungsdauer ein entsperrtes Schlosssymbol angezeigt. Wenn die Aufbewahrungsrichtlinie gesperrt ist, wird neben der Aufbewahrungsdauer ein Schlosssymbol angezeigt.
Befehlszeile
Führen Sie den Befehl gcloud storage buckets describe
mit dem Flag --format
aus.
gcloud storage buckets describe gs://BUCKET_NAME --format="default(retention_policy)"
Dabei ist BUCKET_NAME
der Name des Buckets, dessen Aufbewahrungsrichtlinie Sie aufrufen möchten. Beispiel: my-bucket
.
Wenn der Befehl erfolgreich ausgeführt wird und eine Aufbewahrungsrichtlinie für den Bucket vorhanden ist, sieht die Antwort in etwa so aus:
retention_policy: effectiveTime: '2022-10-04T18:51:22.161000+00:00' retentionPeriod: '129600'
Wenn der Befehl erfolgreich ausgeführt wird und keine Aufbewahrungsrichtlinie für den Bucket vorhanden sind, sieht die Antwort in etwa so aus:
null
Clientbibliotheken
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
REST APIs
JSON API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Verwenden Sie
cURL
, um die JSON API mit einerGET
-Bucket-Anfrage aufzurufen, die die gewünschtenfields
enthält:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=retentionPolicy"
Dabei ist
BUCKET_NAME
der Name des entsprechenden Buckets. Beispiel:my-bucket
.Wenn für den Bucket eine Aufbewahrungsrichtlinie festgelegt ist, sieht die Antwort so aus:
{ "retentionPolicy": { "retentionPeriod": "TIME_IN_SECONDS", "effectiveTime": "DATETIME", "isLocked": "BOOLEAN" }, }
XML API
Die XML API kann nicht zum Aufrufen der Aufbewahrungsrichtlinie für einen Bucket verwendet werden. Verwenden Sie stattdessen eines der anderen Cloud Storage-Tools, z. B. die Google Cloud Console.
Nächste Schritte
- Weitere Informationen zu Aufbewahrungsrichtlinien
- Objekt-Holds verwenden
- Informationen zur Verwaltung des Objektlebenszyklus, mit der Dateien automatisch gelöscht werden können, sobald ihre Aufbewahrungsdauer abgelaufen ist