Objektkontexte verwenden

Console

1. Wechseln Sie in der Cloud de Confiance Console unter „Cloud Storage“ zur Seite Buckets.
   

   Buckets aufrufen

2. Objekt hochladen

3. Folgen Sie der Anleitung, um Kontexte an das Objekt anzuhängen.

Befehlszeile

Wenn Sie beim Hochladen von Objekten mit dem Befehl gcloud storage cp Kontexte anhängen möchten, verwenden Sie das Flag --custom-contexts:

gcloud storage cp OBJECT_LOCATION gs://DESTINATION_BUCKET_NAME --custom-contexts=KEY=VALUE,...

Wobei:

• OBJECT_LOCATION ist der lokale Pfad zu Ihrem Objekt. Beispiel: Desktop/employees.txt.
• DESTINATION_BUCKET_NAME ist der Name des Buckets, in den Sie das Objekt hochladen. Beispiel: my-bucket
• KEY ist der Kontextschlüssel, der an ein Objekt angehängt werden soll. Beispiel: Department. Sie können mehrere durch Kommas getrennte Schlüssel/Wert-Paare angeben.
• VALUE ist der Wert, der dem Kontextschlüssel zugeordnet werden soll. Beispiel: Human resources.

Alternativ können Sie eine JSON-Datei mit den Kontexten erstellen, die Sie den Objekten zuweisen möchten, und das Flag --custom-contexts-file verwenden:

  {
    "KEY": {
      "value": "VALUE"
    },
    ...
  }

Wobei:

• KEY ist der Kontextschlüssel, der an ein Objekt angehängt werden soll. Beispiel: Department. Sie können mehrere Schlüssel/Wert-Paare angeben.
• VALUE ist der Wert, der dem Kontextschlüssel zugeordnet werden soll. Beispiel: Human resources.

Wenn Sie Verzeichnisse mit dem Befehl gcloud storage rsync hochladen, können Sie Kontexte mit dem Flag --custom-contexts oder --custom-contexts-file anhängen:

gcloud storage rsync DIRECTORY_LOCATION gs://DESTINATION_BUCKET_NAME --recursive --custom-contexts=KEY=VALUE,...

Wobei:

• DIRECTORY_LOCATION ist der lokale Pfad zu Ihrem Verzeichnis. Beispiel: ~/my_directory.
• DESTINATION_BUCKET_NAME ist der Name des Buckets, in den Sie das Verzeichnis hochladen. Beispiel: my-bucket
• KEY ist der Kontextschlüssel, der an Objekte angehängt werden soll. Beispiel: Department. Sie können mehrere durch Kommas getrennte Schlüssel/Wert-Paare angeben.
• VALUE ist der Wert, der dem Kontextschlüssel zugeordnet werden soll. Beispiel: Human resources.

JSON API

Wenn Sie neue Objekte hochladen, können Sie mit einer der folgenden Methoden Kontexte an Objekte anhängen:

• Mehrteilige Uploads

• Fortsetzbare Uploads

Fügen Sie das Feld contexts in die Objektmetadaten im JSON-Format ein:

  {
    "contexts": {
      "custom": {
        "KEY": {
          "value": "VALUE"
        },
        ...
      }
    }
  }

Wobei:

• KEY ist der Kontextschlüssel, der an ein Objekt angehängt werden soll. Beispiel: Department. Sie können im Objekt custom mehrere Schlüssel/Wert-Paare angeben.
• VALUE ist der Wert, der dem Kontextschlüssel zugeordnet werden soll. Beispiel: Human resources.

Console

1. Wechseln Sie in der Cloud de Confiance Console unter „Cloud Storage“ zur Seite Buckets.
   

   Buckets aufrufen

2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der das Objekt enthält.

3. Rufen Sie das Objekt auf und klicken Sie dann auf more_vert Objekt-Dreipunkt-Menü öffnen.

4. Klicken Sie auf Kontexte bearbeiten.

5. Führen Sie im Bereich Kontexte bearbeiten einen der folgenden Schritte aus:

   • So fügen Sie einen neuen Objektkontext hinzu:

     1. Klicken Sie auf Benutzerdefinierten Kontext hinzufügen.

     2. Geben Sie in die Felder Objektkontextschlüssel und Objektkontextwert ein neues Schlüssel/Wert-Paar ein.

     3. Klicken Sie auf Fertig.

     4. Optional: Wenn Sie weitere Objektkontexte hinzufügen möchten, klicken Sie auf Benutzerdefinierten Kontext hinzufügen, wiederholen Sie die vorherigen Schritte und klicken Sie dann auf Speichern.

   • Objektkontext bearbeiten:

     1. Klicken Sie auf den Objektkontext.

     2. Aktualisieren Sie das Feld Schlüssel des Objektkontexts, das Feld Wert des Objektkontexts oder beide.

     3. Klicken Sie auf Fertig und anschließend auf Speichern.

   • So löschen Sie einen Objektkontext:

     Klicken Sie auf delete Löschen und dann auf Speichern.

Befehlszeile

Führen Sie den Befehl gcloud storage objects update aus:

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

Wobei:

• BUCKET_NAME ist der Name des Buckets, der das Objekt enthält, für das Sie den Kontext bearbeiten möchten. Beispiel: my-bucket
• OBJECT_NAME ist der Name des Objekts. Beispiel: employees.txt.

• CUSTOM_CONTEXTS_FLAG ist eines der folgenden Flags:

  • Verwenden Sie --custom-contexts=KEY=VALUE,... oder --custom-contexts-file=CUSTOM_CONTEXTS_FILE, um alle vorhandenen Kontexte zu ersetzen.

    Wobei:

    • KEY ist der Kontextschlüssel, der an ein Objekt angehängt werden soll. Beispiel: Department. Sie können mehrere durch Kommas getrennte Schlüssel/Wert-Paare angeben.
    • VALUE ist der Wert, der dem Kontextschlüssel zugeordnet werden soll. Beispiel: Human resources.
    • CUSTOM_CONTEXTS_FILE ist der Pfad zur JSON- oder YAML-Datei, die die Kontexte enthält, die Sie an das Objekt anhängen möchten.

  • Verwenden Sie zum Löschen aller vorhandenen Kontexte das Flag --clear-custom-contexts.

  • Wenn Sie einzelne Kontexte hinzufügen, ändern oder löschen möchten, verwenden Sie eine Kombination aus --update-custom-contexts=KEY=VALUE,... und --remove-custom-contexts=KEY,....

    Wobei:

    • KEY ist der Kontextschlüssel, den Sie an ein Objekt anhängen oder daraus löschen möchten. Beispiel: Department.
    • VALUE ist der Wert, der dem Kontextschlüssel zugeordnet werden soll, den Sie an ein Objekt anhängen oder daraus löschen möchten. Beispiel: Human resources

Wenn der Vorgang erfolgreich ausgeführt wurde, sieht die Antwort in etwa so aus:

Patching gs://my-bucket/employees.txt#1560574162144861...
  Completed 1

Clientbibliotheken

import com.google.cloud.storage.Blob;
import com.google.cloud.storage.BlobId;
import com.google.cloud.storage.BlobInfo;
import com.google.cloud.storage.BlobInfo.ObjectContexts;
import com.google.cloud.storage.BlobInfo.ObjectCustomContextPayload;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageOptions;
import com.google.common.collect.Maps;
import java.util.Map;

public class SetObjectContexts {
  public static void setObjectContexts(
      String projectId, String bucketName, String objectName, String key, String value)
      throws Exception {
    // The ID of your GCP project
    // String projectId = "your-project-id";

    // The ID of your GCS bucket
    // String bucketName = "your-unique-bucket-name";

    // The ID of your GCS object
    // String objectName = "your-object-name";

    // The context key-value you want to add
    // String key = "your-context-key";
    // String value = "your-context-value";

    try (Storage storage =
        StorageOptions.newBuilder().setProjectId(projectId).build().getService()) {
      BlobId blobId = BlobId.of(bucketName, objectName);
      Blob blob = storage.get(blobId);
      if (blob == null) {
        System.out.println("The object " + objectName + " was not found in " + bucketName);
        return;
      }

      // Recommended: Set a generation-match precondition to avoid potential race
      // conditions and data corruptions. The request to update returns a 412 error if
      // the object's generation number does not match your precondition.
      Storage.BlobTargetOption precondition = Storage.BlobTargetOption.generationMatch();

      // This section demonstrates how to upsert, delete all, and delete a specific context.

      // To upsert a context (if the key already exists, its value is replaced;
      // otherwise, a new key-value pair is added):
      ObjectCustomContextPayload payload =
          ObjectCustomContextPayload.newBuilder().setValue(value).build();
      Map<String, ObjectCustomContextPayload> custom = Maps.newHashMap();
      custom.put(key, payload);
      ObjectContexts contexts = ObjectContexts.newBuilder().setCustom(custom).build();

      /*
       * To delete all existing contexts:
       * ObjectContexts contexts = ObjectContexts.newBuilder().setCustom(null).build();
       */

      /*
       * To delete a specific key from the context:
       * Map<String, ObjectCustomContextPayload> custom = Maps.newHashMap();
       * custom.put(key, null);
       * ObjectContexts contexts = ObjectContexts.newBuilder().setCustom(custom).build();
       */
      BlobInfo pendingUpdate = blob.toBuilder().setContexts(contexts).build();
      storage.update(pendingUpdate, precondition);

      System.out.println(
          "Updated custom contexts for object " + objectName + " in bucket " + bucketName);
    }
  }
}

use google_cloud_storage::client::StorageControl;
use google_cloud_storage::model::ObjectContexts;
use google_cloud_wkt::FieldMask;

pub async fn sample(client: &StorageControl, bucket_id: &str) -> anyhow::Result<()> {
    const NAME: &str = "object-with-contexts";
    let object = client
        .get_object()
        .set_bucket(format!("projects/_/buckets/{bucket_id}"))
        .set_object(NAME)
        .send()
        .await?;

    let metageneration = object.metageneration;
    let mut custom = object.contexts.clone().unwrap_or_default().custom;
    custom.entry("example".to_string()).or_default().value = "true".into();

    let updated = client
        .update_object()
        .set_if_metageneration_match(metageneration)
        .set_object(object.set_contexts(ObjectContexts::new().set_custom(custom)))
        .set_update_mask(FieldMask::default().set_paths(["contexts.custom.example"]))
        .send()
        .await?;
    println!(
        "successfully set contexts for object {NAME} in bucket {bucket_id}: {:?}",
        updated.contexts
    );
    Ok(())
}

JSON API

1. Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Authorization-Header zu generieren.

2. Erstellen Sie eine JSON-Datei mit den Einstellungen für das Objekt, die die Konfigurationsfelder contexts für das Objekt enthalten muss.

   Verwenden Sie das folgende Format, um vorhandene Kontexte hinzuzufügen, zu ändern oder zu überschreiben:

     {
       "contexts": {
         "custom": {
           "KEY": {
             "value": "VALUE"
           },
           ...
         }
       }
     }

   Wobei:

   • KEY ist der Kontextschlüssel, der an ein Objekt angehängt werden soll. Beispiel: Department. Sie können mehrere Schlüssel/Wert-Paare im custom-Objekt angeben.
   • VALUE ist der Wert, der dem Kontextschlüssel zugeordnet werden soll. Beispiel: Human resources

   Verwenden Sie das folgende Format, um alle vorhandenen Kontexte zu löschen:

     {
       "contexts": {
         "custom": null
       }
     }

   Verwenden Sie das folgende Format, um einen bestimmten Schlüssel aus dem Kontext zu löschen:

     {
       "contexts": {
         "custom": {
           "KEY": null,
           ...
         }
       }
     }

   Wobei:

   KEY ist der Kontextschlüssel, den Sie aus einem Objekt löschen möchten. Beispiel: Department. Sie können mehrere Schlüssel angeben, die aus dem custom-Objekt gelöscht werden sollen.

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.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"

   Wobei:

   • JSON_FILE_NAME ist der Pfad zur Datei, die die Informationen zu den Objektkontexten enthält.
   • BUCKET_NAME ist der Name des Buckets, der das Objekt enthält, für das Sie den Kontext bearbeiten möchten. Beispiel: my-bucket.
   • OBJECT_NAME ist der URL-codierte Name des Objekts. Beispiel: employees.txt.

Alternativ können Sie den Kontext eines Objekts mit einer PUT-Anfrage ersetzen. Mit der PUT-Objektanfrage werden auch andere Objektmetadaten ersetzt. Daher raten wir von der Verwendung der Objektanfrage PUT ab.

Console

1. Wechseln Sie in der Cloud de Confiance Console unter „Cloud Storage“ zur Seite Buckets.
   

   Buckets aufrufen

2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der das Objekt mit den Kontexten enthält, die Sie sich ansehen möchten.

3. Rufen Sie das Objekt auf und klicken Sie dann auf den Namen des Objekts.

   Auf der Seite Objektdetails werden die Schlüssel/Wert-Paare für alle angehängten Kontexte im Abschnitt Objektkontexte aufgeführt.

Befehlszeile

Führen Sie den Befehl gcloud storage objects describe aus:

gcloud storage objects describe gs://BUCKET_NAME/OBJECT_NAME

Wobei:

• BUCKET_NAME ist der Name des Buckets, der das Objekt enthält. Beispiel: my-bucket.
• OBJECT_NAME ist der Name des Objekts. Beispiel: employees.txt.

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

bucket: my-bucket
contexts:
  custom:
    Department:
      createTime: '2023-01-01T00:00:00.000000+00:00'
      type: CUSTOM
      updateTime: '2023-01-01T00:00:00.000000+00:00'
      value: Human resources
    google:annotation:face-detector-v1:
      createTime: '2025-09-29T17:20:00.000000+00:00'
      extendedDataTypeUrl: type.googleapis.com/google.protobuf.Struct
      type: CUSTOM
      updateTime: '2025-09-29T17:20:00.000000+00:00'
      value: SUCCESS
name: employees.txt

Clientbibliotheken

import com.google.cloud.storage.Blob;
import com.google.cloud.storage.BlobInfo.ObjectContexts;
import com.google.cloud.storage.BlobInfo.ObjectCustomContextPayload;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageOptions;
import java.util.Map;

public class GetObjectContexts {
  public static void getObjectContexts(String projectId, String bucketName, String objectName)
      throws Exception {
    // The ID of your GCP project
    // String projectId = "your-project-id";

    // The ID of your GCS bucket
    // String bucketName = "your-unique-bucket-name";

    // The ID of your GCS object
    // String objectName = "your-object-name";

    try (Storage storage =
        StorageOptions.newBuilder().setProjectId(projectId).build().getService()) {

      Blob blob = storage.get(bucketName, objectName);
      if (blob == null) {
        System.out.println("The object " + objectName + " was not found in " + bucketName);
        return;
      }
      ObjectContexts objectContexts = blob.getContexts();

      if (objectContexts != null) {
        Map<String, ObjectCustomContextPayload> customContexts = objectContexts.getCustom();
        if (customContexts == null) {
          System.out.println("No custom contexts found for object: " + objectName);
          return;
        }
        // Print blob's object contexts
        System.out.println("\nCustom Contexts:");
        for (Map.Entry<String, ObjectCustomContextPayload> custom : customContexts.entrySet()) {
          System.out.println(custom.getKey() + "=" + custom.getValue());
        }
      }
    }
  }
}

use google_cloud_storage::client::StorageControl;

pub async fn sample(client: &StorageControl, bucket_id: &str) -> anyhow::Result<()> {
    const NAME: &str = "object-with-contexts";
    let object = client
        .get_object()
        .set_bucket(format!("projects/_/buckets/{bucket_id}"))
        .set_object(NAME)
        .send()
        .await?;
    println!(
        "The contexts field for object {NAME} in bucket {bucket_id} is: {:?}",
        object.contexts
    );
    Ok(())
}

JSON API

1. Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Authorization-Header 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.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"

   Wobei:

   • BUCKET_NAME ist der Name des Buckets, der das Objekt enthält. Beispiel: my-bucket.
   • OBJECT_NAME ist der URL-codierte Name des Objekts. Beispiel: employees.txt.

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

     {
       "kind": "storage#object",
       "name": "employees.txt",
       "bucket": "my-bucket",
       "contexts": {
         "custom": {
           "Department": {
             "value": "Human resources",
             "createTime": "2023-01-01T00:00:00.000Z",
             "updateTime": "2023-01-01T00:00:00.000Z"
           },
           "google:annotation:face-detector-v1": {
             "value": "SUCCESS",
             "createTime": "2025-09-29T17:20:00.000Z",
             "updateTime": "2025-09-29T17:20:00.000Z",
             "extendedDataTypeUrl": "type.googleapis.com/google.protobuf.Struct"
           }
         }
       }
     }
     

JSON API

So rufen Sie einen einzelnen vollständigen Kontext (einschließlich erweiterter Daten) nach Schlüssel ab:

1. Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Authorization-Header zu generieren.

2. Verwenden Sie cURL, um die JSON API mit einer GET-Anfrage zum Aufrufen des vollständigen Kontexts aufzurufen:

   curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME/viewFullContext?contextKey=KEY"

   Wobei:

   • BUCKET_NAME ist der Name des Buckets, der das Objekt enthält. Beispiel: my-bucket.
   • OBJECT_NAME ist der URL-codierte Name des Objekts. Beispiel: employees.txt.
   • KEY ist der spezifische Kontextschlüssel, der abgerufen werden soll. Beispiel: google:annotation:face-detector-v1.

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

   {
     "kind": "storage#objectFullContext",
     "type": "CUSTOM",
     "key": "google:annotation:face-detector-v1",
     "value": "SUCCESS",
     "createTime": "2025-09-29T17:20:00.000Z",
     "updateTime": "2025-09-29T17:20:00.000Z",
     "extendedData": {
       "@type": "type.googleapis.com/google.protobuf.Struct",
       "value": {
         "modelName": "face-detector",
         "modelVersion": "v1",
         "faceAnnotationGroup": {
           "faceAnnotations": [
             {
               "detectionConfidence": 0.9,
               "landmarkingConfidence": 0.8
             }
           ]
         }
       }
     }
   }

Befehlszeile

Mit den Befehlen gcloud storage cp, gcloud storage rsync und gcloud storage mv werden Kontexte aus dem Quellobjekt standardmäßig beibehalten. Wenn Sie Kontexte während dieser Vorgänge ändern möchten, verwenden Sie eines der folgenden Flags:

• Das Flag --custom-contexts zum Festlegen neuer Kontexte für das Zielobjekt.

• Das Flag --clear-custom-contexts, um zu verhindern, dass Kontexte aus dem Quellobjekt an das Zielobjekt angehängt werden.

• Eine Kombination aus den Flags --update-custom-contexts und --remove-custom-contexts, um einzelne Kontexte des Quellobjekts zu ändern, bevor sie an das Zielobjekt angehängt werden.

Wenn Sie beim Kopieren eines Objekts neue Kontexte festlegen möchten, verwenden Sie den Befehl gcloud storage cp:

gcloud storage cp gs://SOURCE_BUCKET_NAME/SOURCE_OBJECT_NAME gs://DESTINATION_BUCKET_NAME/DESTINATION_OBJECT_NAME --custom-contexts=KEY=VALUE,...

Wobei:

• SOURCE_BUCKET_NAME ist der Name des Buckets, der das zu kopierende Objekt enthält. Beispiel: my-source-bucket.
• SOURCE_OBJECT_NAME ist der Name des Objekts, das kopiert werden soll. Beispiel: employees.txt.
• DESTINATION_BUCKET_NAME ist der Name des Buckets, in den das Objekt kopiert werden soll. Beispiel: my-destination-bucket.
• DESTINATION_OBJECT_NAME ist der Name des Zielobjekts. Beispiel: employees-backup.txt.
• KEY ist der Kontextschlüssel, der an ein Objekt angehängt werden soll. Beispiel: Department. Sie können mehrere durch Kommas getrennte Schlüssel/Wert-Paare angeben.
• VALUE ist der Wert, der dem Kontextschlüssel zugeordnet werden soll. Beispiel: Human resources.

Wenn Sie beim Kopieren eines Objekts alle Kontexte aus dem Quellobjekt entfernen möchten, verwenden Sie den Befehl gcloud storage cp:

gcloud storage cp gs://SOURCE_BUCKET_NAME/SOURCE_OBJECT_NAME gs://DESTINATION_BUCKET_NAME/DESTINATION_OBJECT_NAME --clear-custom-contexts

Wobei:

• SOURCE_BUCKET_NAME ist der Name des Buckets, der das zu kopierende Objekt enthält. Beispiel: my-source-bucket.
• SOURCE_OBJECT_NAME ist der Name des zu kopierenden Objekts. Beispiel: pets/dog.png.
• DESTINATION_BUCKET_NAME ist der Name des Buckets, in den das Objekt kopiert werden soll. Beispiel: my-destination-bucket.
• DESTINATION_OBJECT_NAME ist der Name des Zielobjekts. Beispiel: pets/cat.png.

Wenn Sie beim Kopieren eines Objekts einzelne Kontexte aus dem Quellobjekt ändern möchten, verwenden Sie den Befehl gcloud storage cp mit --update-custom-contexts und --remove-custom-contexts:

gcloud storage cp gs://SOURCE_BUCKET_NAME/SOURCE_OBJECT_NAME gs://DESTINATION_BUCKET_NAME/DESTINATION_OBJECT_NAME --update-custom-contexts=KEY=VALUE,... --remove-custom-contexts=KEY,...

Wobei:

• SOURCE_BUCKET_NAME ist der Name des Buckets, der das zu kopierende Objekt enthält. Beispiel: my-source-bucket.
• SOURCE_OBJECT_NAME ist der Name des zu kopierenden Objekts. Beispiel: pets/dog.png.
• DESTINATION_BUCKET_NAME ist der Name des Buckets, in den das Objekt kopiert werden soll. Beispiel: my-destination-bucket.
• DESTINATION_OBJECT_NAME ist der Name des Zielobjekts. Beispiel: pets/cat.png.
• KEY ist der Kontextschlüssel, der an ein Objekt angehängt werden soll. Beispiel: Department. Sie können mehrere Schlüssel/Wert-Paare oder Schlüssel durch Kommas getrennt angeben.
• VALUE ist der Wert, der dem Kontextschlüssel zugeordnet werden soll. Beispiel: Human resources.

JSON API

Wenn Sie beim Kopieren eines Objekts Kontexte überschreiben möchten, fügen Sie das Attribut contexts.custom in den Anfragetext ein:

1. Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Authorization-Header zu generieren.

2. Erstellen Sie eine JSON-Datei, die die Kontexte enthält, die an das Zielobjekt angehängt werden sollen:

     {
       "contexts": {
         "custom": {
           "KEY": {
             "value": "VALUE"
           }
         }
       }
     }

   Wobei:

   • KEY ist der Kontextschlüssel, der an ein Objekt angehängt werden soll. Beispiel: Department.
   • VALUE ist der Wert, der dem Kontextschlüssel zugeordnet werden soll. Beispiel: Human resources.

3. Verwenden Sie cURL, um die JSON API mit einer POST-Objektanfrage aufzurufen:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://storage.s3nsapis.fr/storage/v1/b/SOURCE_BUCKET_NAME/o/SOURCE_OBJECT_NAME/copyTo/b/DESTINATION_BUCKET_NAME/o/DESTINATION_OBJECT_NAME"

   Wobei:

   • JSON_FILE_NAME ist der Pfad zur JSON-Datei, die die Informationen zu den Objektkontexten enthält.
   • SOURCE_BUCKET_NAME ist der Name des Buckets, der das zu kopierende Objekt enthält. Beispiel: my-source-bucket
   • SOURCE_OBJECT_NAME ist der URL-codierte Name des Objekts, das kopiert werden soll. Beispiel: employees.txt.
   • DESTINATION_BUCKET_NAME ist der Name des Buckets, in den das Objekt kopiert werden soll. Beispiel: my-destination-bucket
   • DESTINATION_OBJECT_NAME ist der URL-codierte Name des Zielobjekts. Beispiel: employees-backup.txt.

Wenn Sie Quellkontexte während eines Kopiervorgangs verwerfen möchten, verwenden Sie den Suchparameter dropContextGroups=custom in Ihrer Anfrage:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.s3nsapis.fr/storage/v1/b/SOURCE_BUCKET_NAME/o/SOURCE_OBJECT_NAME/copyTo/b/DESTINATION_BUCKET_NAME/o/DESTINATION_OBJECT_NAME?dropContextGroups=custom"

Wenn der Anfragetext Kontexte mit dem Präfix google: enthält, können Sie vorhandene Schlüssel und Werte aus dem Quellobjekt beibehalten. Cloud Storage lehnt jedoch neue google:-Schlüssel oder geänderte Werte ab.

Wenn Sie den Kontext beibehalten möchten, lassen Sie das Attribut contexts im Anfragetext weg und schließen Sie den Abfrageparameter dropContextGroups aus.

Befehlszeile

Die Befehle gcloud storage cp, gcloud storage rsync und gcloud storage mv führen bei Bedarf automatisch Neuschreibungen durch, z. B. beim Kopieren von Objekten zwischen verschiedenen Standorten oder Speicherklassen. gcloud storage cp und gcloud storage rsync führen zu einem Quell- und einem Zielobjekt, während mit gcloud storage mv das Zielobjekt erstellt und das Quellobjekt entfernt wird. Da diese Vorgänge ein neues Objekt erstellen, können Sie Kontexte auch im Rahmen desselben Befehls ändern oder anhängen. Verwenden Sie dazu eines der folgenden Flags:

• Das Flag --custom-contexts, um neue Kontexte für das Zielobjekt festzulegen.

• Das Flag --clear-custom-contexts, um zu verhindern, dass Kontexte aus dem Quellobjekt an das Zielobjekt angehängt werden.

• Eine Kombination aus den Flags --update-custom-contexts und --remove-custom-contexts, um einzelne Kontexte aus dem Quellobjekt zu ändern, bevor sie an das Zielobjekt angehängt werden.

Wenn Sie beim Kopieren eines Objekts neue Kontexte festlegen möchten, verwenden Sie den Befehl gcloud storage cp:

gcloud storage cp gs://SOURCE_BUCKET_NAME/SOURCE_OBJECT_NAME gs://DESTINATION_BUCKET_NAME/DESTINATION_OBJECT_NAME --custom-contexts=KEY=VALUE,...

Wobei:

• SOURCE_BUCKET_NAME ist der Name des Buckets, der das zu kopierende Objekt enthält. Beispiel: my-source-bucket.
• SOURCE_OBJECT_NAME ist der Name des Objekts, das kopiert werden soll. Beispiel: employees.txt.
• DESTINATION_BUCKET_NAME ist der Name des Buckets, in den das Objekt kopiert werden soll. Beispiel: my-destination-bucket.
• DESTINATION_OBJECT_NAME ist der Name des Zielobjekts. Beispiel: employees-backup.txt.
• KEY ist der Kontextschlüssel, der an ein Objekt angehängt werden soll. Beispiel: Department. Sie können mehrere durch Kommas getrennte Schlüssel/Wert-Paare angeben.
• VALUE ist der Wert, der dem Kontextschlüssel zugeordnet werden soll. Beispiel: Human resources.

Wenn Sie beim Kopieren eines Objekts alle Kontexte aus dem Quellobjekt entfernen möchten, verwenden Sie den Befehl gcloud storage cp:

gcloud storage cp gs://SOURCE_BUCKET_NAME/SOURCE_OBJECT_NAME gs://DESTINATION_BUCKET_NAME/DESTINATION_OBJECT_NAME --clear-custom-contexts

Wobei:

• SOURCE_BUCKET_NAME ist der Name des Buckets, der das zu kopierende Objekt enthält. Beispiel: my-source-bucket.
• SOURCE_OBJECT_NAME ist der Name des zu kopierenden Objekts. Beispiel: pets/dog.png.
• DESTINATION_BUCKET_NAME ist der Name des Buckets, in den das Objekt kopiert werden soll. Beispiel: my-destination-bucket.
• DESTINATION_OBJECT_NAME ist der Name des Zielobjekts. Beispiel: pets/cat.png.

Wenn Sie beim Kopieren eines Objekts einzelne Kontexte aus dem Quellobjekt ändern möchten, verwenden Sie den Befehl gcloud storage cp mit --update-custom-contexts und --remove-custom-contexts:

gcloud storage cp gs://SOURCE_BUCKET_NAME/SOURCE_OBJECT_NAME gs://DESTINATION_BUCKET_NAME/DESTINATION_OBJECT_NAME --update-custom-contexts=KEY=VALUE,... --remove-custom-contexts=KEY,...

Wobei:

• SOURCE_BUCKET_NAME ist der Name des Buckets, der das zu kopierende Objekt enthält. Beispiel: my-source-bucket.
• SOURCE_OBJECT_NAME ist der Name des zu kopierenden Objekts. Beispiel: pets/dog.png.
• DESTINATION_BUCKET_NAME ist der Name des Buckets, in den das Objekt kopiert werden soll. Beispiel: my-destination-bucket.
• DESTINATION_OBJECT_NAME ist der Name des Zielobjekts. Beispiel: pets/cat.png.
• KEY ist der Kontextschlüssel, der an ein Objekt angehängt werden soll. Beispiel: Department. Sie können mehrere Schlüssel/Wert-Paare oder Schlüssel durch Kommas getrennt angeben.
• VALUE ist der Wert, der dem Kontextschlüssel zugeordnet werden soll. Beispiel: Human resources.

JSON API

Wenn Sie Kontexte beim Umschreiben eines Objekts überschreiben möchten, fügen Sie das Attribut contexts.custom in den Anfragetext ein:

1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Authorization-Header zu generieren.

2. Erstellen Sie eine JSON-Datei, die die Kontexte enthält, die an das Zielobjekt angehängt werden sollen:

     {
       "contexts": {
         "custom": {
           "KEY": {
             "value": "VALUE"
           }
         }
       }
     }

   Wobei:

   • KEY ist der Kontextschlüssel, der an ein Objekt angehängt werden soll. Beispiel: Department.
   • VALUE ist der Wert, der dem Kontextschlüssel zugeordnet werden soll. Beispiel: Human resources.

3. Verwenden Sie cURL, um die JSON API mit einer POST-Objektanfrage aufzurufen:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://storage.s3nsapis.fr/storage/v1/b/SOURCE_BUCKET_NAME/o/SOURCE_OBJECT_NAME/rewriteTo/b/DESTINATION_BUCKET_NAME/o/DESTINATION_OBJECT_NAME"

   Wobei:

   • JSON_FILE_NAME ist der Pfad zur JSON-Datei, die die Informationen zu den Objektkontexten enthält.
   • SOURCE_BUCKET_NAME ist der Name des Buckets, der das umzuschreibende Objekt enthält. Beispiel: my-source-bucket.
   • SOURCE_OBJECT_NAME ist der URL-codierte Name des Objekts, das umgeschrieben werden soll. Beispiel: employees.txt.
   • DESTINATION_BUCKET_NAME ist der Name des Buckets, in den das Objekt umgeschrieben werden soll. Beispiel: my-destination-bucket.
   • DESTINATION_OBJECT_NAME ist der URL-codierte Name des Zielobjekts. Beispiel: employees-backup.txt.

Wenn Sie Quellkontexte während eines Umschreibevorgangs verwerfen möchten, verwenden Sie den Suchparameter dropContextGroups=custom in Ihrer Anfrage:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.s3nsapis.fr/storage/v1/b/SOURCE_BUCKET_NAME/o/SOURCE_OBJECT_NAME/rewriteTo/b/DESTINATION_BUCKET_NAME/o/DESTINATION_OBJECT_NAME?dropContextGroups=custom"

Wenn der Anfragetext Kontexte mit dem Präfix google: enthält, können Sie vorhandene Schlüssel und Werte aus dem Quellobjekt beibehalten. Cloud Storage lehnt jedoch neue google:-Schlüssel oder geänderte Werte ab.

Wenn Sie Kontexte beibehalten möchten, lassen Sie das Attribut contexts im Anfragetext weg und schließen Sie den Abfrageparameter dropContextGroups aus.

Befehlszeile

Wenn Sie beim Zusammensetzen von Objekten neue Kontexte für das Zielobjekt angeben möchten, verwenden Sie das Flag --contexts:

gcloud storage objects compose gs://BUCKET_NAME/SOURCE_OBJECT_1 gs://BUCKET_NAME/SOURCE_OBJECT_2 gs://BUCKET_NAME/DESTINATION_OBJECT_NAME --contexts=KEY=VALUE,...

Wobei:

• BUCKET_NAME ist der Name des Buckets, der die Quellobjekte enthält und in dem das Zielobjekt erstellt wird. Beispiel: my-bucket.
• SOURCE_OBJECT_1 und SOURCE_OBJECT_2 sind Quellobjekte, die zusammengesetzt werden sollen.
• DESTINATION_OBJECT_NAME ist der Name des zu erstellenden Zielobjekts. Beispiel: my-composite-object.
• KEY ist der Kontextschlüssel, der an ein Objekt angehängt werden soll. Beispiel: Department. Sie können mehrere durch Kommas getrennte Schlüssel/Wert-Paare angeben.
• VALUE ist der Wert, der dem Kontextschlüssel zugeordnet werden soll. Beispiel: Human resources.

Wenn Sie verhindern möchten, dass Quellkontexte an zusammengesetzte Objekte angehängt werden, verwenden Sie das Flag --clear-custom-contexts:

gcloud storage objects compose gs://BUCKET_NAME/SOURCE_OBJECT_1 gs://BUCKET_NAME/SOURCE_OBJECT_2 gs://BUCKET_NAME/DESTINATION_OBJECT_NAME --clear-custom-contexts

Wobei:

• BUCKET_NAME ist der Name des Buckets, der die Quellobjekte enthält und in dem das Zielobjekt erstellt wird. Beispiel: my-bucket.
• SOURCE_OBJECT_1 und SOURCE_OBJECT_2 sind die Quellobjekte, die zusammengesetzt werden sollen.
• DESTINATION_OBJECT_NAME ist der Name des zu erstellenden Zielobjekts. Beispiel: my-composite-object.

JSON API

Wenn Sie beim Erstellen von Objekten neue Kontexte für das Zielobjekt angeben möchten, fügen Sie Kontexte in das Attribut destination des Anfragetexts ein.

1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Authorization-Header zu generieren.

2. Erstellen Sie eine JSON-Datei, die den Anfragetext enthält:

   {
     "sourceObjects": [
       {"name": "SOURCE_OBJECT_1"},
       {"name": "SOURCE_OBJECT_2"}
     ],
     "destination": {
       "contentType": "text/plain",
       "contexts": {
         "custom": {
           "KEY": {
             "value": "VALUE"
           }
         }
       }
     }
   }

   Wobei:

   • SOURCE_OBJECT_1 und SOURCE_OBJECT_2 sind Quellobjekte, die zusammengesetzt werden sollen.
   • KEY ist der Kontextschlüssel, der an ein Objekt angehängt werden soll. Beispiel: Department.
   • VALUE ist der Wert, der dem Kontextschlüssel zugeordnet werden soll. Beispiel: Human resources

3. Verwenden Sie cURL, um die JSON API mit einer POST-Objektanfrage aufzurufen:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/DESTINATION_OBJECT_NAME/compose"

   Wobei:

   • JSON_FILE_NAME ist der Pfad zur JSON-Datei, die den Anfragetext enthält.
   • BUCKET_NAME ist der Name des Buckets, der die Quellobjekte enthält und in dem das Zielobjekt erstellt wird. Beispiel: my-bucket.
   • DESTINATION_OBJECT_NAME ist der Name des zu erstellenden Zielobjekts. Beispiel: my-composite-object.

Wenn Sie verhindern möchten, dass Quellkontexte an zusammengesetzte Objekte angehängt werden, verwenden Sie in Ihrer Anfrage den Suchparameter dropContextGroups=custom:

1. Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Authorization-Header zu generieren.

2. Erstellen Sie eine JSON-Datei, die den Anfragetext enthält:

   {
     "sourceObjects": [
       {"name": "SOURCE_OBJECT_1"},
       {"name": "SOURCE_OBJECT_2"}
     ],
     "destination": {
       "contentType": "text/plain"
   }
   }

   Wobei:

   • SOURCE_OBJECT_1 und SOURCE_OBJECT_2 sind Quellobjekte, die zusammengesetzt werden sollen.

3. Verwenden Sie cURL, um die JSON API mit einer POST-Objektanfrage aufzurufen:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/DESTINATION_OBJECT_NAME/compose?dropContextGroups=custom"

   Wobei:

   • JSON_FILE_NAME ist der Pfad zur JSON-Datei, die den Anfragetext enthält.
   • BUCKET_NAME ist der Name des Buckets, der die Quellobjekte enthält und in dem das Zielobjekt erstellt wird. Beispiel: my-bucket.
   • DESTINATION_OBJECT_NAME ist der Name des zu erstellenden Zielobjekts. Beispiel: my-composite-object.