Objektmetadaten aufrufen und bearbeiten (original) (raw)

Zum Hauptinhalt springen

Objektmetadaten aufrufen und bearbeiten

Konzepte

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 IAM-Richtlinien (Identity and Access Management) oder Objektzugriffssteuerungslisten (Access Control Lists, ACLs), die beide steuern, wer Zugriff auf Ihre Daten hat. Anleitungen zu diesen Aufgaben finden Sie unter Identity and Access Management und Access Control Lists (ACLs) erstellen und verwalten.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die Rolle „Storage Object User“ (roles/storage.objectUser) für den Bucket zuzuweisen, um die erforderlichen Berechtigungen zum Ansehen und Bearbeiten der Metadaten von Objekten zu erhalten.

Diese Rolle enthält die Berechtigungen, die zum Ansehen und Bearbeiten der Metadaten von Objekten erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen im Detail anzuzeigen:

Erforderliche Berechtigungen

Möglicherweise erhalten Sie auch diese Berechtigungen im Rahmen anderer vordefinierter Rollen oder benutzerdefinierter Rollen.

Eine Anleitung zum Zuweisen von Rollen für Buckets finden Sie unter IAM-Richtlinien für Buckets festlegen und verwalten.

Objektmetadaten ansehen

Führen Sie die folgende Anleitung aus, um die mit einem Objekt verknüpften Metadaten aufzurufen:

Console

  1. Wechseln Sie in der Google Cloud Console unter „Cloud Storage“ zur Seite Buckets.
    Buckets aufrufen
  2. Klicken Sie in der Bucket-Liste auf den Namen des Buckets, der das Objekt enthält, für das Sie Metadaten aufrufen möchten.
    Die Seite Bucket-Details wird geöffnet und der Tab Objekte ist ausgewählt.
  3. 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.
  4. Klicken Sie auf den Namen des Objekts.
    Die Seite Objektdetails wird geöffnet und zeigt zusätzliche Objektmetadaten an.
  5. Klicken Sie auf Metadaten bearbeiten.
    Das eingeblendete Fenster enthält die aktuellen Werte für mehrere weitere Metadatenschlüssel des Objekts, einschließlich benutzerdefinierter Metadaten.

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 objects describe aus:

gcloud storage objects describe gs://BUCKET_NAME/OBJECT_NAME

Dabei gilt:

Wenn der Vorgang erfolgreich war, sieht die Antwort in etwa so aus:

bucket: my-awesome-bucket content_type: image/png crc32c_hash: pNKjPQ== creation_time: 2024-01-26T21:33:04+0000 custom_fields: Animal: Cat Type: Cute custom_time: 1970-01-01T00:00:00+0000 etag: CMXyydSA/IMDEAE= generation: '1706304784726341' md5_hash: KCbI3PYk1aHfekIvf/osrw== metageneration: 1 name: kitten.png size: 168276 storage_class: STANDARD storage_class_update_time: 2024-01-26T21:33:04+0000 storage_url: gs://my-awesome-bucket/kitten.png#1706304784726341 update_time: 2024-01-26T21:33:04+0000

Clientbibliotheken

Terraform

Sie können eine Terraform-Ressource verwenden, um die Metadaten eines Objekts aufzurufen.

REST APIs

JSON-API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Header Authorization zu generieren.
  2. Verwenden Sie cURL, um die JSON-API mit einer GET-Objektanfrage aufzurufen:
    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
    Dabei gilt:
    • 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 URL-codierte Name des Objekts, dessen Metadaten Sie ansehen möchten. Beispiel: pets/dog.png, URL-codiert als pets%2Fdog.png.

XML-API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Header Authorization zu generieren.
  2. Verwenden Sie cURL, um die XML-API mit einer HEAD-Objektanfrage aufzurufen:
    curl -I HEAD \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
    Dabei gilt:
    • 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 URL-codierte Name des Objekts, dessen Metadaten Sie ansehen möchten. Beispiel: pets/dog.png, URL-codiert als pets%2Fdog.png.

Führen Sie die folgenden Schritte aus, um die mit einem Objekt verknüpften Metadaten zu bearbeiten:

Console

  1. Wechseln Sie in der Google Cloud Console unter „Cloud Storage“ zur Seite Buckets.
    Buckets aufrufen
  2. Klicken Sie in der Bucket-Liste auf den Namen des Buckets, der das Objekt enthält, für das Sie Metadaten bearbeiten möchten.
    Die Seite Bucket-Details wird geöffnet und der Tab Objekte ist ausgewählt.
  3. Wechseln Sie zu dem Objekt. Dieses befindet sich möglicherweise in einem Ordner.
  4. Klicken Sie auf den Namen des Objekts.
    Die Seite Objektdetails wird geöffnet und zeigt Objektmetadaten an.
  5. Klicken Sie auf das Stiftsymbol für die Metadaten, die Sie bearbeiten möchten, sofern es auf der Seite angezeigt wird.
  6. Klicken Sie andernfalls auf Metadaten bearbeiten, um auf weitere bearbeitbare Metadaten zuzugreifen.
    Bearbeiten Sie im eingeblendeten Fenster die Metadaten nach Bedarf.
    • 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.
      Wenn Sie die Metadaten im eingeblendeten Fenster bearbeitet haben, klicken Sie auf Speichern.

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 objects update aus:

gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME METADATA_FLAG

Dabei gilt:

Wenn der Vorgang erfolgreich war, sieht die Antwort so aus:

Patching gs://my-bucket/pets/dog.png#1560574162144861... Completed 1

Eine vollständige Liste der Metadaten, die Sie mit diesem Befehl aktualisieren können, finden Sie auf der Befehlsreferenzseite.

Clientbibliotheken

REST APIs

JSON-API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Header Authorization zu generieren.
  2. Erstellen Sie eine JSON-Datei mit den Metadaten, die Sie ändern möchten. Weitere Informationen zu Metadaten, die einem Objekt zugeordnet sind, finden Sie in der Cloud Storage-Objektressource.
    Verwenden Sie das folgende Format, um die Metadaten mit festem Schlüssel wie contentType hinzuzufügen oder zu ändern:
    {
    "STANDARD_METADATA_KEY": "STANDARD_METADATA_VALUE"
    }
    Dabei gilt:
    • STANDARD_METADATA_KEY ist der Schlüssel für die Metadaten, die Sie hinzufügen oder ändern möchten. Beispiel: contentType
    • 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.
  3. Verwenden Sie cURL, um die JSON API mit einer PATCH-Objektanfrage 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/o/OBJECT_NAME"
    Dabei gilt:
    • JSON_FILE_NAME ist der Pfad für die Datei, die Sie in Schritt 2 erstellt 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 URL-codierte Name des Objekts, dessen Metadaten Sie bearbeiten möchten. Beispiel: pets/dog.png, URL-codiert als pets%2Fdog.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:

Weitere Informationen finden Sie im Artikel zum Hochladen eines Objekts für XML.

Nächste Schritte

Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.

Zuletzt aktualisiert: 2025-11-25 (UTC).