Auf dieser Seite wird die Verwendung von Objekt-Holds erläutert. Dazu gehört die standardmäßige Festlegung von Holds für neue Objekte und die Festlegung von Holds für einzelne Objekte.
Voraussetzungen
Gehen Sie vor der Verwendung dieser Funktion in Cloud Storage so vor:
Achten Sie darauf, dass Sie ausreichende Berechtigungen zum Ansehen und Aktualisieren von Buckets und Objekten in Cloud Storage haben:
Wenn Sie der Inhaber des Projekts sind, zu dem der Bucket gehört, haben Sie wahrscheinlich die erforderlichen Berechtigungen.
Wenn Sie IAM verwenden, benötigen Sie die Berechtigungen
storage.buckets.update
,storage.buckets.get
,storage.objects.update
undstorage.objects.get
für den entsprechenden Bucket. Unter Cloud IAM-Berechtigungen verwenden wird gezeigt, wie eine Rolle wie z. B. Storage Admin zugewiesen wird, die diese Berechtigungen enthält.Wenn Sie ACLs (Zugriffssteuerungslisten) verwenden, sollten Sie die Berechtigung INHABER für den betreffenden Bucket und die darin enthaltenen Objekte haben. Weitere Informationen dazu finden Sie unter Zugriffssteuerungslisten festlegen.
Standardmäßiges ereignisbasiertes Hold-Attribut anwenden
Mit den folgenden Aufgaben wird gezeigt, wie Sie das standardmäßige ereignisbasierte Hold-Attribut für einen Bucket aktivieren, anzeigen lassen und deaktivieren. Wenn dieses Attribut aktiviert ist, erhalten neue Objekte, die dem Bucket hinzugefügt werden, automatisch einen ereignisbasierten Hold.
Standardmäßiges ereignisbasiertes Hold-Attribut aktivieren
So wird für jedes neue Objekt, das einem Bucket hinzugefügt wird, automatisch ein ereignisbasierter Hold festgelegt:
Console
- Öffnen Sie den Cloud Storage-Browser in der Google Cloud Console.
Zum Cloud Storage-Browser Klicken Sie in der Liste der Buckets auf den Namen des Buckets, für den Sie das standardmäßige ereignisbasierte Hold-Attribut aktivieren möchten.
Wählen Sie oben auf der Seite den Tab Aufbewahrung aus.
Klicken Sie im Abschnitt Option für standardmäßige ereignisbasierte Holds auf Deaktiviert.
Wenn der Vorgang erfolgreich durchgeführt wurde, ändert sich die Schaltfläche in Aktiviert.
Unter Fehlerbehebung erfahren Sie, wie Sie im Cloud Storage-Browser detaillierte Fehlerinformationen zu fehlgeschlagenen Vorgängen abrufen.
gsutil
Führen Sie den Befehl gsutil retention event-default set
aus:
gsutil retention event-default set gs://BUCKET_NAME
Dabei ist BUCKET_NAME
der Name des entsprechenden Buckets. Beispiel: my-bucket
.
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.
Erstellen Sie eine JSON-Datei, die die folgenden Informationen enthält:
{ "defaultEventBasedHold": true }
Verwenden Sie
cURL
, um die JSON API mit einerPATCH
-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=defaultEventBasedHold"
Dabei gilt:
JSON_FILE_NAME
ist der Name der 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
.
XML API
Die XML API kann nicht für Objekt-Holds angewendet werden. Verwenden Sie stattdessen ein anderes Cloud Storage-Tool, z. B. "gsutil".
Status des Standard-Holds eines Buckets abrufen
So stellen Sie fest, ob in einem Bucket standardmäßig ereignisbasierte Holds für jedes neue Objekt festgelegt werden:
Console
- Öffnen Sie den Cloud Storage-Browser in der Google Cloud Console.
Zum Cloud Storage-Browser Klicken Sie in der Liste der Buckets auf den Namen des Buckets, für den Sie den Status standardmäßiger ereignisbasierter Holds prüfen möchten.
Wählen Sie oben auf der Seite den Tab Aufbewahrung aus.
Der Status wird im Abschnitt Option für standardmäßige ereignisbasierte Holds angezeigt.
Unter Fehlerbehebung erfahren Sie, wie Sie im Cloud Storage-Browser detaillierte Fehlerinformationen zu fehlgeschlagenen Vorgängen abrufen.
gsutil
Verwenden Sie den folgenden gsutil ls
-Befehl:
gsutil ls -L -b gs://BUCKET_NAME
Dabei ist BUCKET_NAME
der Name des entsprechenden Buckets. Beispiel: my-bucket
.
Die Antwort sieht in etwa so aus:
gs://my-bucket/ : Storage class: STANDARD ... ... Default Event-Based Hold: True ...
Wenn für den Bucket standardmäßig keine ereignisbasierten Holds für neue Objekte festgelegt werden, lässt gsutil Default Event-Based Hold
in der Ausgabe vollständig weg.
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.
Verwenden Sie
cURL
, um die JSON API mit einerGET
-Bucket-Anfrage aufzurufen, die den gewünschtenfields
enthält:curl -X GET -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=defaultEventBasedHold"
Dabei gilt:
OAUTH2_TOKEN
ist das Zugriffstoken, das Sie in Schritt 1 generiert haben.BUCKET_NAME
ist der Name des entsprechenden Buckets. Beispiel:my-bucket
Wenn für den Bucket ein standardmäßiger ereignisbasierter Hold aktiviert ist, sieht die Antwort in etwa so aus:
{ "retentionPolicy": true }
XML API
Die XML API kann nicht für Objekt-Holds angewendet werden. Verwenden Sie stattdessen ein anderes Cloud Storage-Tool, z. B. "gsutil".
Standardmäßigen ereignisbasierten Hold deaktivieren
So deaktivieren Sie einen standardmäßigen ereignisbasierten Hold für einen Bucket:
Console
- Öffnen Sie den Cloud Storage-Browser in der Google Cloud Console.
Zum Cloud Storage-Browser Klicken Sie in der Liste der Buckets auf den Namen des Buckets, für den Sie den standardmäßigen ereignisbasierten Hold deaktivieren möchten.
Wählen Sie oben auf der Seite den Tab Aufbewahrung aus.
Klicken Sie im Abschnitt Option für standardmäßige ereignisbasierte Holds auf Aktiviert.
Wenn der Vorgang erfolgreich durchgeführt wurde, ändert sich die Schaltfläche in Deaktiviert.
Unter Fehlerbehebung erfahren Sie, wie Sie im Cloud Storage-Browser detaillierte Fehlerinformationen zu fehlgeschlagenen Vorgängen abrufen.
gsutil
Führen Sie den Befehl gsutil retention event-default release
aus:
gsutil retention event-default release gs://BUCKET_NAME
Dabei ist BUCKET_NAME
der Name des entsprechenden Buckets. Beispiel: my-bucket
.
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.
Erstellen Sie eine JSON-Datei, die die folgenden Informationen enthält:
{ "defaultEventBasedHold": false }
Verwenden Sie
cURL
, um die JSON API mit einerPATCH
-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=defaultEventBasedHold"
Dabei gilt:
JSON_FILE_NAME
ist der Name der 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
.
XML API
Die XML API kann nicht für Objekt-Holds angewendet werden. Verwenden Sie stattdessen ein anderes Cloud Storage-Tool, z. B. "gsutil".
Objekt-Holds anwenden
Mit den folgenden Aufgaben wird gezeigt, wie Sie Holds für Objekte festlegen, anzeigen lassen und freigeben können.
Objekt-Hold festlegen
So legen Sie einen Hold für ein Objekt in Ihrem Bucket fest:
Console
- Öffnen Sie den Cloud Storage-Browser in der Google Cloud Console.
Zum Cloud Storage-Browser Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der die Objekte enthält, für die Sie Holds festlegen möchten.
Wählen Sie das Kästchen neben den Namen der Objekte aus, für die Sie Holds festlegen möchten.
Klicken Sie auf die Schaltfläche Holds verwalten.
Das Fenster Holds verwalten wird angezeigt.
Wählen Sie das Kästchen für die Hold-Typen aus, die Sie für die ausgewählten Objekte festlegen möchten.
Klicken Sie auf Hold-Einstellungen speichern.
Unter Fehlerbehebung erfahren Sie, wie Sie im Cloud Storage-Browser detaillierte Fehlerinformationen zu fehlgeschlagenen Vorgängen abrufen.
gsutil
Führen Sie den Befehl gsutil retention
aus:
gsutil retention HOLD_TYPE set gs://BUCKET_NAME/OBJECT_NAME
Wobei:
HOLD_TYPE
ist der Typ des Holds, den Sie auf Ihr Objekt anwenden möchten. Beispiel:temp
oderevent
. Weitere Informationen zu den verschiedenen Hold-Typen finden Sie unter Objekt-Holds.BUCKET_NAME
ist der Name des entsprechenden Buckets. Beispiel:my-bucket
.OBJECT_NAME
ist der Name des entsprechenden Objekts. Beispiel:pets/dog.png
.
Codebeispiele
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
Im folgenden Beispiel wird ein ereignisbasierter Hold für ein Objekt festgelegt:
Im folgenden Beispiel wird ein temporärer Hold für ein Objekt festgelegt:
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Im folgenden Beispiel wird ein ereignisbasierter Hold für ein Objekt festgelegt:
Im folgenden Beispiel wird ein temporärer Hold für ein Objekt festgelegt:
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Im folgenden Beispiel wird ein ereignisbasierter Hold für ein Objekt festgelegt:
Im folgenden Beispiel wird ein temporärer Hold für ein Objekt festgelegt:
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Im folgenden Beispiel wird ein ereignisbasierter Hold für ein Objekt festgelegt:
Im folgenden Beispiel wird ein temporärer Hold für ein Objekt festgelegt:
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
Im folgenden Beispiel wird ein ereignisbasierter Hold für ein Objekt festgelegt:
Im folgenden Beispiel wird ein temporärer Hold für ein Objekt festgelegt:
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Im folgenden Beispiel wird ein ereignisbasierter Hold für ein Objekt festgelegt:
Im folgenden Beispiel wird ein temporärer Hold für ein Objekt festgelegt:
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Im folgenden Beispiel wird ein ereignisbasierter Hold für ein Objekt festgelegt:
Im folgenden Beispiel wird ein temporärer Hold für ein Objekt festgelegt:
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
Im folgenden Beispiel wird ein ereignisbasierter Hold für ein Objekt festgelegt:
Im folgenden Beispiel wird ein temporärer Hold für ein Objekt festgelegt:
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.
Erstellen Sie eine JSON-Datei, die die folgenden Informationen enthält:
{ "HOLD_TYPE": true }
Dabei ist
HOLD_TYPE
der Typ des Holds, den Sie auf Ihr Objekt anwenden möchten. Beispiel:temporaryHold
odereventBasedHold
. Weitere Informationen zu Hold-Typen finden Sie unter Objekt-Holds.Verwenden Sie
cURL
, um die JSON API mit einerPATCH
-Objektanfrage 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/o/OBJECT_NAME"
Dabei gilt:
JSON_FILE_NAME
ist der Name der 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
OBJECT_NAME
ist der Name des entsprechenden Objekts. Beispiel:pets/dog.png
XML API
Die XML API kann nicht für Objekt-Holds angewendet werden. Verwenden Sie stattdessen ein anderes Cloud Storage-Tool, z. B. "gsutil".
Hold-Status für ein Objekt abrufen
Wenn Sie feststellen möchten, ob und welche Holds für ein Objekt vorhanden sind, folgen Sie der Anleitung unter Objektmetadaten ansehen.
Objekt-Hold freigeben
So geben Sie einen Hold von einem Objekt in Ihrem Bucket frei:
Console
- Öffnen Sie den Cloud Storage-Browser in der Google Cloud Console.
Zum Cloud Storage-Browser Klicken Sie in der Liste der Buckets auf den Namen des Buckets mit den Objekten, von denen Sie Holds freigeben möchten.
Wählen Sie das Kästchen neben den Namen der Objekte aus, von denen Sie Holds freigeben möchten.
Klicken Sie auf die Schaltfläche Holds verwalten.
Das Fenster Holds verwalten wird angezeigt.
Heben Sie die Auswahl der Kästchen für die Holds auf, die Sie freigeben möchten.
Klicken Sie auf Hold-Einstellungen speichern.
Unter Fehlerbehebung erfahren Sie, wie Sie im Cloud Storage-Browser detaillierte Fehlerinformationen zu fehlgeschlagenen Vorgängen abrufen.
gsutil
Führen Sie den Befehl gsutil retention
aus:
gsutil retention HOLD_TYPE release gs://BUCKET_NAME/OBJECT_NAME
Wobei:
HOLD_TYPE
ist der Typ des Holds, den Sie von Ihrem Objekt freigeben möchten. Beispiel:temp
oderevent
. Weitere Informationen zu den verschiedenen Hold-Typen finden Sie unter Objekt-Holds.BUCKET_NAME
ist der Name des entsprechenden Buckets. Beispiel:my-bucket
.OBJECT_NAME
ist der Name des entsprechenden Objekts. Beispiel:pets/dog.png
.
Codebeispiele
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
Im folgenden Beispiel wird ein ereignisbasierter Hold für ein Objekt festgelegt:
Im folgenden Beispiel wird ein temporärer Hold für ein Objekt festgelegt:
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Im folgenden Beispiel wird ein ereignisbasierter Hold für ein Objekt freigegeben:
Im folgenden Beispiel wird ein temporärer Hold für ein Objekt freigegeben:
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Im folgenden Beispiel wird ein ereignisbasierter Hold für ein Objekt freigegeben:
Im folgenden Beispiel wird ein temporärer Hold für ein Objekt freigegeben:
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Im folgenden Beispiel wird ein ereignisbasierter Hold für ein Objekt freigegeben:
Im folgenden Beispiel wird ein temporärer Hold für ein Objekt freigegeben:
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
Im folgenden Beispiel wird ein ereignisbasierter Hold für ein Objekt freigegeben:
Im folgenden Beispiel wird ein temporärer Hold für ein Objekt freigegeben:
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Im folgenden Beispiel wird ein ereignisbasierter Hold für ein Objekt freigegeben:
Im folgenden Beispiel wird ein temporärer Hold für ein Objekt freigegeben:
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Im folgenden Beispiel wird ein ereignisbasierter Hold für ein Objekt freigegeben:
Im folgenden Beispiel wird ein temporärer Hold für ein Objekt freigegeben:
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
Im folgenden Beispiel wird ein ereignisbasierter Hold für ein Objekt freigegeben:
Im folgenden Beispiel wird ein temporärer Hold für ein Objekt freigegeben:
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.
Erstellen Sie eine JSON-Datei, die die folgenden Informationen enthält:
{ "HOLD_TYPE": false }
Dabei ist
HOLD_TYPE
der Typ des Holds, den Sie von Ihrem Objekt freigeben möchten. Beispiel:temporaryHold
odereventBasedHold
. Weitere Informationen zu Hold-Typen finden Sie unter Objekt-Holds.Verwenden Sie
cURL
, um die JSON API mit einerPATCH
-Objektanfrage 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/o/OBJECT_NAME"
Dabei gilt:
JSON_FILE_NAME
ist der Name der 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
OBJECT_NAME
ist der Name des entsprechenden Objekts. Beispiel:pets/dog.png
XML API
Die XML API kann nicht für Objekt-Holds angewendet werden. Verwenden Sie stattdessen ein anderes Cloud Storage-Tool, z. B. "gsutil".
Weitere Informationen
- Mehr über Objekt-Holds erfahren, einschließlich der verschiedenen Typen von Holds, die ein Objekt haben kann
- Aufbewahrungsrichtlinien