Auf dieser Seite wird erklärt, wie Sie die Metadaten von Objekten, die in Cloud Storage gespeichert sind, anzeigen und bearbeiten können.
Auf dieser Seite geht es nicht um das Anzeigen oder Bearbeiten von Richtlinien zur Identitäts- und Zugriffsverwaltung (Identity and Access Management – IAM) oder Objektzugriffssteuerungslisten (Access Control Lists – ACLs), die beide steuern, wer Zugriff auf Ihre Daten hat. Anleitungen zu diesen Aufgaben finden Sie unter Cloud IAM-Berechtigungen verwenden und Access Control Lists (ACLs) erstellen und verwalten.
Objektmetadaten ansehen
So rufen Sie die mit einem Objekt verknüpften Metadaten auf:
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 das gewünschte Objekt enthält.
Die Seite Bucket-Details wird geöffnet und der Tab Objekte ist ausgewählt.
Wechseln Sie zu dem Objekt. Dieses befindet sich möglicherweise in einem Ordner.
Bestimmte Objektmetadatenwerte wie Größe und Speicherklasse des Objekts werden zusammen mit dem Objektnamen angezeigt.
Klicken Sie auf das Dreipunkt-Menü
des Objekts.
Klicken Sie auf Metadaten bearbeiten.
Das eingeblendete Fenster enthält die aktuellen Werte für die bearbeitbaren Metadaten des Objekts.
Unter Fehlerbehebung erfahren Sie, wie Sie im Cloud Storage-Browser detaillierte Fehlerinformationen zu fehlgeschlagenen Vorgängen abrufen.
gsutil
Führen Sie folgenden gsutil stat
-Befehl aus:
gsutil stat gs://BUCKET_NAME/OBJECT_NAME
Hierbei gilt:
BUCKET_NAME
ist der Name des Buckets, der das Objekt enthält, dessen Metadaten Sie ansehen möchten. Beispiel:my-awesome-bucket
OBJECT_NAME
ist der Name des Objekts, dessen Metadaten Sie ansehen möchten. Beispiel:cat.jpeg
Wenn der Vorgang erfolgreich war, sieht die Antwort in etwa so aus:
gs://my-awesome-bucket/cat.jpeg: Creation time: Fri, 03 Feb 2017 22:43:31 GMT Update time: Wed, 10 May 2017 18:33:07 GMT Storage class: STANDARD Content-Length: 11012 Content-Type: image/jpeg Metadata: Breed: Tabby Hash (crc32c): HQbzrB== Hash (md5): OBydg25+pPG1Cwawjsl7DA== ETag: CJCh9apA9dECAEs= Generation: 1486161811706000 Metageneration: 11
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
-Objektanfrage aufzurufen:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
Dabei gilt:
OAUTH2_TOKEN
ist das Zugriffstoken, das Sie in Schritt 1 generiert haben.BUCKET_NAME
ist der Name des Buckets, der das Objekt enthält, dessen Metadaten Sie ansehen möchten. Beispiel:my-bucket
OBJECT_NAME
ist der Name des Objekts, dessen Metadaten Sie ansehen möchten. Beispiel:pets/dog.png
XML 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 XML API mit einerHEAD
-Objektanfrage aufzurufen:curl -I HEAD \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Hierbei gilt:
OAUTH2_TOKEN
ist das Zugriffstoken, das Sie in Schritt 1 generiert haben.BUCKET_NAME
ist der Name des Buckets, der das Objekt enthält, dessen Metadaten Sie ansehen möchten. Beispiel:my-bucket
OBJECT_NAME
ist der Name des Objekts, dessen Metadaten Sie ansehen möchten. Beispiel:pets/dog.png
Objektmetadaten bearbeiten
So bearbeiten Sie die mit einem Objekt verknüpften Metadaten:
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 das gewünschte Objekt enthält.
Die Seite Bucket-Details wird geöffnet und der Tab Objekte ist ausgewählt.
Wechseln Sie zu dem Objekt. Dieses befindet sich möglicherweise in einem Ordner.
Klicken Sie auf das Dreipunkt-Menü
des Objekts.
Klicken Sie auf Metadaten bearbeiten.
Nehmen Sie im angezeigten Fenster die gewünschten Änderungen der Metadaten vor.
Bearbeiten Sie bei Standardmetadatenfeldern den Wert
Klicken Sie auf + Element hinzufügen, um benutzerdefinierte Metadaten hinzuzufügen
Sie können sowohl den Schlüssel als auch den Wert Ihrer benutzerdefinierten Metadaten bearbeiten
Klicken Sie auf das zugehörige X, um Ihre benutzerdefinierten Metadaten zu löschen.
Klicken Sie auf Speichern.
Unter Fehlerbehebung erfahren Sie, wie Sie im Cloud Storage-Browser detaillierte Fehlerinformationen zu fehlgeschlagenen Vorgängen abrufen.
gsutil
Führen Sie folgenden gsutil setmeta -h
-Befehl aus:
gsutil setmeta -h "METADATA_KEY:METADATA_VALUE" gs://BUCKET_NAME/OBJECT_NAME
Hierbei gilt:
METADATA_KEY
ist der Schlüssel für die Metadaten, die Sie festlegen möchten. Beispiel:Content-Type
METADATA_VALUE
ist der Wert für die Metadaten, die Sie festlegen möchten. Beispiel:image/png
BUCKET_NAME
ist der Name des Buckets, der das Objekt enthält, dessen Metadaten Sie bearbeiten möchten. Beispiel:my-bucket
OBJECT_NAME
ist der Name des Objekts, dessen Metadaten Sie bearbeiten möchten. Beispiel:pets/dog.png
Wenn der Vorgang erfolgreich war, sieht die Antwort so aus:
Operation completed over 1 objects.
Wenn Sie benutzerdefinierte Metadaten mit gsutil hinzufügen, müssen Sie dem Metadatenschlüssel das Präfix x-goog-meta-
voranstellen, damit gsutil erkennt, dass es sich um ein benutzerdefiniertes Metadatenattribut und nicht um einen Standard-HTTP-Header handelt. Der Metadatenschlüssel selbst wird nicht mit dem Präfix x-goog-meta-
gespeichert. Ein Beispiel für ein benutzerdefiniertes "METADATA_KEY:METADATA_VALUE"
-Paar ist "x-goog-meta-dogbreed:shibainu"
.
Codebeispiele
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Informationen zum Bearbeiten der einem Objekt zugeordneten Metadaten mithilfe von C# finden Sie in der Referenzdokumentation zu PatchObject.Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Informationen zum Bearbeiten der mit einem Objekt verknüpften Metadaten mithilfe von Go finden Sie in der Referenzdokumentation zu ObjectHandle.Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
In der Referenzdokumentation zur Google Cloud-Clientbibliothek erfahren Sie, wie Sie die mit einem Objekt verknüpften Metadaten mithilfe von PHP bearbeiten können.Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
In der Referenzdokumentation zur KlasseGoogle::Cloud::Storage::File
erfahren Sie, wie Sie die mit einem Objekt verknüpften Metadaten mithilfe von Ruby bearbeiten können.
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 mit den Metadaten, die Sie ändern möchten.
Verwenden Sie das folgende Format, um Metadaten mit festem Schlüssel wie
contentType
hinzuzufügen oder zu ändern:{ "STANDARD_METADATA_KEY": "STANDARD_METADATA_VALUE" }
Hierbei gilt:
STANDARD_METADATA_KEY
ist der Schlüssel für die Metadaten, die Sie hinzufügen oder ändern möchten. Beispiel:Content-Type
STANDARD_METADATA_VALUE
ist der Wert für die Metadaten, die Sie hinzufügen oder ändern möchten. Beispiel:image/png
Verwenden Sie das folgende Format, um benutzerdefinierte Metadaten hinzuzufügen oder zu ändern:
{ "metadata": { "CUSTOM_METADATA_KEY": "CUSTOM_METADATA_VALUE" } }
Hierbei gilt:
CUSTOM_METADATA_KEY
ist der benutzerdefinierte Metadatenschlüssel, den Sie hinzufügen oder ändern möchten. Beispiel:dogbreed
CUSTOM_METADATA_VALUE
ist der Wert, der mit dem benutzerdefinierten Metadatenschlüssel verknüpft werden soll. Beispiel:shibainu
Verwenden Sie das folgende Format, um einen benutzerdefinierten Metadateneintrag zu löschen:
{ "metadata": { "CUSTOM_METADATA_KEY": null } }
Hierbei gilt:
CUSTOM_METADATA_KEY
ist der Schlüssel für die benutzerdefinierten Metadaten, die Sie löschen möchten. Beispiel:dogbreed
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"
Hierbei gilt:
JSON_FILE_NAME
ist der Name der JSON-Datei, die Sie in Schritt 2 erstellt haben.OAUTH2_TOKEN
ist der Name des Zugriffstokens, das Sie in Schritt 1 generiert haben.BUCKET_NAME
ist der Name des Buckets, der das Objekt enthält, dessen Metadaten Sie bearbeiten möchten. Beispiel:my-bucket
OBJECT_NAME
ist der Name des Objekts, dessen Metadaten Sie bearbeiten möchten. Beispiel:pets/dog.png
Sie können die Metadaten eines Objekts auch mit einer UPDATE
-Object-Anfrage ändern. Damit werden alle Metadaten, die nicht explizit in der Anfrage angegeben sind, aus den Objektmetadaten gelöscht.
XML API
Mit der XML API können Metadaten nur beim Schreiben eines Objekts, also beim Hochladen, Verschieben oder Ersetzen, festgelegt werden. Folgen Sie der entsprechenden Anleitung, zum Beispiel unter Objekte hochladen, und halten Sie sich an diese Richtlinien:
Fügen Sie für jeden Metadatenwert, den Sie festlegen,
-H "METADATA_KEY:METADATA_VALUE"
zum Anfrageheader hinzu. Beispiel:-H "Content-Type:image/png"
Stellen Sie benutzerdefinierten Metadatenwerten das Präfix
x-goog-meta-
voran. Ein Beispiel für ein benutzerdefiniertes"METADATA_KEY:METADATA_VALUE"
-Paar ist"x-goog-meta-dogbreed:shibainu"
.
Weitere Informationen finden Sie im Artikel zum Hochladen eines Objekts für XML.
Weitere Informationen
- Mehr erfahren über Metadaten, die mit einem Objekt verknüpft sind
- Objektspeicherklassen ändern
- Objekt-Holds anwenden