Batchvorgangsjobs erstellen und verwalten

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 die Objekte enthält, für die Sie Batchvorgänge ausführen möchten.

   Die Seite Bucket-Details wird geöffnet und der Tab Objekte ist ausgewählt.

3. Klicken Sie auf Batchvorgänge erstellen.
4. Wählen Sie im Bereich Vorgang auswählen den Vorgangstyp aus:
   • Objekt-Holds verwalten: Wählen Sie Temporärer Hold oder Ereignisbasierter Hold aus. Weitere Informationen finden Sie unter Objekt-Holds.
   • Objektmetadaten aktualisieren: So fügen Sie Objektmetadaten hinzu:
     • So fügen Sie benutzerdefinierte Metadaten hinzu:
       1. Geben Sie im Feld Schlüssel einen Schlüsselnamen ein.
       2. Geben Sie im Feld Wert einen Wert für diesen Schlüssel ein.
       3. Optional: Klicken Sie auf + Element hinzufügen, um weitere Schlüssel/Wert-Paare hinzuzufügen.
     • So aktualisieren Sie Metadaten mit festen Schlüsseln:
       1. Klicken Sie zum Erweitern des Abschnitts Metadaten mit festen Schlüsseln aktualisieren auf den expand_moreErweiterungspfeil.
       2. Wählen Sie in der Liste Wählen Sie mindestens einen Satz Metadaten aus, der aktualisiert werden soll die Metadatenelemente aus, die Sie bearbeiten möchten.
   • Verschlüsselungsschlüssel aktualisieren/rotieren: So verwenden oder aktualisieren Sie den Verschlüsselungsschlüssel für Objekte:
     1. Wählen Sie in der Liste Cloud KMS-Schlüssel auswählen einen vom Kunden verwalteten Verschlüsselungsschlüssel (CMEK) aus.
     2. Optional: Wählen Sie Projekt wechseln aus, um einen Schlüssel aus einem anderen Projekt auszuwählen, oder wählen Sie Schlüssel manuell eingeben aus, um Details einzugeben.
   • Objekte löschen: So löschen Sie Objekte:
     1. Prüfen, ob die Objektversionsverwaltung aktiviert ist

     2. Wenn die Objektversionsverwaltung aktiviert ist, wählen Sie eine der folgenden Löschoptionen aus:

        • Wählen Sie Alle Versionen der Objekte löschen aus, um sowohl Live- als auch nicht aktuelle Versionen zu entfernen.
        • Wählen Sie Live-Versionen dauerhaft löschen aus, um nur die Live-Version zu entfernen.

        Wenn die Objektversionsverwaltung nicht aktiviert ist, werden alle zum Löschen ausgewählten Objekte dauerhaft gelöscht.

5. Klicken Sie auf Weiter.
6. Führen Sie im Bereich Vorgang benennen und Objekte angeben die folgenden Schritte aus:
   1. Geben Sie im Feld Name einen Namen ein.
   2. Optional: Geben Sie im Feld Beschreibung eine Beschreibung ein.
   3. Definieren Sie im Abschnitt Objekte angeben ein Kriterium für die Verarbeitung von Objekten aus dem Bucket. Wählen Sie eine der folgenden Optionen aus:
      • Alle Objekte auswählen: Schließt alle Objekte im Bucket ein.
      • Objekte mithilfe von Präfixfiltern auswählen: So definieren Sie die Liste der Objekte mithilfe von Präfixfiltern:
        1. Geben Sie im Feld Präfixe der Objekte eingeben, die eingeschlossen werden sollen ein Präfix ein.
        2. Optional: Klicken Sie auf + Präfix hinzufügen, um weitere Präfixe anzugeben.
      • Listen von Objekten mithilfe von CSV-Manifestdateien hochladen: So verwenden Sie eine Manifestdatei, um Objekte auszuwählen:

        1. Laden Sie die CSV-Manifestdatei in einen Bucket hoch. Diese Datei muss Header für Bucket-Name, Objektschlüssel und Generationsnummer enthalten.
        2. Wählen Sie in der Liste Modus für Manifestdatei auswählen eine der folgenden Optionen aus:
           • Wenn Sie Manifestdatei in Cloud Storage auswählen auswählen, klicken Sie im Feld Manifestdatei in Cloud Storage auswählen auf Durchsuchen. Wechseln Sie im Dialogfeld Objekt auswählen zu Ihrer Manifest-CSV-Datei und klicken Sie auf Auswählen.
           • Wenn Sie Mehrere Manifestdateien mit Platzhalter auswählen auswählen, geben Sie den Dateipfad im Feld Speicherort der Manifestdatei mit Platzhalter eingeben ein. Beispiel: bucket-name/folder/manifest_*
7. Klicken Sie auf Erstellen.

Befehlszeile

Wenn Sie die Liste der Objekte für den Batchvorgangsjob definieren möchten, können Sie eine der folgenden Quellkonfigurationen auswählen:

• Projekt als Quelle: Es werden Objekte für ein Projekt mit einer Storage Insights-Dataset-Konfiguration ausgewählt. Anstatt einzelne Buckets oder Präfixe anzugeben, können Sie erweiterte Filterparameter wie --insights-dataset-config, --target-project, --bucket-filters und --object-filters angeben. Weitere Informationen finden Sie unter Job mit erweiterten Filtern erstellen.
• Buckets als Quelle: Zielt auf Objekte in bestimmten Buckets ab. Sie müssen eines der folgenden Flags angeben:
  • --bucket oder --bucket-list, um die Ziel-Buckets zu definieren.
  • Eine Manifest-CSV-Datei (--manifest-location) oder Objektpräfixe (--included-object-prefixes) zum Definieren der Zielobjekte.

1. Aktivieren Sie Cloud Shell in der Cloud de Confiance Console.

   Cloud Shell aktivieren

   Unten in der Cloud de Confiance Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. Verwenden Sie die Google Cloud CLI-Version 516.0.0 oder höher.

3. Führen Sie den Befehl gcloud config set project aus, um das Standardprojekt festzulegen:

   gcloud config set project PROJECT_ID

   Dabei ist PROJECT_ID die ID Ihres Projekts.

4. Optional: Führen Sie einen Probelauf aus. Bevor Sie einen Job ausführen, sollten Sie ihn im Probelaufmodus ausführen, um die Objektauswahlkriterien zu prüfen und nach Fehlern zu suchen. Im Probelauf werden keine Objekte geändert.

   Führen Sie in Ihrer Entwicklungsumgebung den Befehl gcloud storage batch-operations jobs create mit dem Flag --dry-run aus:

   gcloud storage batch-operations jobs create DRY_RUN_JOB_NAME \
   {--bucket=BUCKET | --bucket-list=BUCKET_LIST} OBJECT_SELECTION_FLAG JOB_TYPE_FLAG \
   --dry-run

   Wobei:

   • DRY_RUN_JOB_NAME ist der Name des Probelaufjobs für Storage-Batchvorgänge.

   Die anderen Parameter sind mit denen des eigentlichen Jobs identisch. Weitere Informationen finden Sie unter Parameterbeschreibungen.

   Informationen zum Aufrufen der Ergebnisse des Probelaufs finden Sie unter Details zu Storage-Batchvorgängen abrufen.

5. Führen Sie nach einem erfolgreichen Probelauf den Befehl gcloud storage batch-operations jobs create aus.

   gcloud storage batch-operations jobs create JOB_NAME \
   {--bucket=BUCKET | --bucket-list=BUCKET_LIST} OBJECT_SELECTION_FLAG JOB_TYPE_FLAG

   Die Parameter sind wie folgt:

   • JOB_NAME ist der Name des Jobs für Storage-Batchvorgänge.

   • --bucket: BUCKET ist der Name des Buckets, der die zu verarbeitenden Objekte enthält.

   • --bucket-list: BUCKET_LIST ist eine durch Kommas getrennte Liste mit einem oder mehreren Bucket-Namen, die die zu verarbeitenden Objekte enthalten. Sie können bis zu 1.000 Buckets aus einem beliebigen Projekt angeben, sofern jeder Bucket in einem Storage Intelligence-Tarif registriert ist.

   • OBJECT_SELECTION_FLAG ist eines der folgenden Flags, die Sie angeben müssen:

     • --included-object-prefixes: Geben Sie ein oder mehrere Objektpräfixe an. Beispiel:

       • Wenn Sie ein einzelnes Präfix abgleichen möchten, verwenden Sie --included-object-prefixes='prefix1'.
       • Wenn Sie mehrere Präfixe abgleichen möchten, verwenden Sie eine kommagetrennte Präfixliste: --included-object-prefixes='prefix1,prefix2'.
       • Wenn Sie alle Objekte einschließen möchten, verwenden Sie ein leeres Präfix: --included-object-prefixes=''.

     • --manifest-location: Geben Sie den Speicherort des Manifests an. Beispiel: gs://bucket_name/path/object_name.csv

   • JOB_TYPE_FLAG ist eines der folgenden Flags, die Sie je nach Jobtyp angeben müssen.

     • --delete-object: Ein oder mehrere Objekte löschen.

       • Wenn die Objektversionsverwaltung für den Bucket aktiviert ist, werden aktuelle Objekte in einen nicht aktuellen Zustand überführt und nicht aktuelle Objekte werden übersprungen.

       • Wenn die Objektversionsverwaltung für den Bucket deaktiviert ist, werden Objekte durch den Löschvorgang dauerhaft gelöscht und nicht aktuelle Objekte übersprungen.

     • --enable-permanent-object-deletion: Objekte endgültig löschen. Verwenden Sie dieses Flag zusammen mit dem Flag --delete-object, um sowohl Live- als auch nicht aktuelle Objekte in einem Bucket dauerhaft zu löschen, unabhängig von der Konfiguration der Objektversionsverwaltung des Buckets.

     • --rewrite-object: Aktualisiert die kundenverwalteten Verschlüsselungsschlüssel für ein oder mehrere Objekte. Sie können dieses Flag auch verwenden, um die Speicherklasse des Objekts zu ändern, indem Sie den Schlüssel storage-class angeben. Zu den unterstützten Speicherklassen gehören STANDARD, NEARLINE, COLDLINE und ARCHIVE. Beispiel: --rewrite-object=storage-class=NEARLINE.

     • --set-object-acls-from-file: Patcht Objekt-ACLs (Access Control Lists). Stellen Sie eine JSON- oder YAML-Datei mit Berechtigungen bereit, die für Entitäten wie allUsers oder allAuthenticatedUsers hinzugefügt oder aktualisiert werden sollen. Beispiel: --set-object-acls-from-file=acl-updates.yaml oder --set-object-acls-from-file=acl-updates.json.

       Die Struktur der YAML-Datei für Aktualisierungen sieht so aus:

       grants:
         - entity: allAuthenticatedUsers
           role: READER
         remove_entities:
         - allUsers
       

       Die JSON-Datei für Aktualisierungen hat folgende Struktur:

       {
       "grants": [
         {
           "entity": "allAuthenticatedUsers",
           "role": "READER"
         }
       ],
       "remove_entities": [
         "allUsers"
       ]
       }

     • --put-object-event-based-hold: Ereignisbasierte Objekt-Holds aktivieren.

     • --no-put-object-event-based-hold: Ereignisbasierte Objekt-Holds deaktivieren.

     • --put-object-temporary-hold: Aktiviert temporäre Objekt-Holds.

     • --no-put-object-temporary-hold: Deaktiviert temporäre Objekt-Holds.

       Im folgenden Beispiel wird gezeigt, wie Sie einen Job erstellen, um die Metadaten Content-Language für alle in manifest.csv aufgeführten Objekte auf en zu aktualisieren.

       gcloud storage batch-operations jobs create my-job \
       --bucket=my-bucket \
       --manifest-location=gs://my-bucket/manifest.csv \
       --put-metadata=Content-Language=en

       Im folgenden Beispiel wird gezeigt, wie Sie einen Job für mehrere Buckets erstellen, um Content-Language auf en-us zu aktualisieren:

       gcloud storage batch-operations jobs create my-job \
       --bucket-list=bucket1,bucket2 \
       --included-object-prefixes='' \
       --put-metadata=Content-Language=en-us

     • --put-metadata: Objektmetadaten aktualisieren. Geben Sie das Schlüssel/Wert-Paar für die Objektmetadaten an, die Sie ändern möchten. Sie können ein oder mehrere Schlüssel/Wert-Paare als Liste angeben. Sie können auch Konfigurationen für die Objektaufbewahrung mit dem Flag --put-metadata festlegen. Geben Sie dazu die Aufbewahrungsparameter mit den Feldern Retain-Until und Retention-Mode an. Beispiel:

       gcloud storage batch-operations jobs create my-job \
       --bucket=my-bucket \
       --manifest-location=gs://my-bucket/manifest.csv \
       --put-metadata=Retain-Until=RETAIN_UNTIL_TIME,Retention-Mode=RETENTION_MODE

       Wobei:

       • RETAIN_UNTIL_TIME ist das Datum und die Uhrzeit im RFC 3339-Format, bis zu der das Objekt aufbewahrt wird. Beispiel: 2025-10-09T10:30:00Z. Wenn Sie die Aufbewahrungskonfiguration für ein Objekt festlegen möchten, müssen Sie die Aufbewahrung für den Bucket aktivieren, der das Objekt enthält.

       • RETENTION_MODE ist der Aufbewahrungsmodus, entweder Unlocked oder Locked.

         Wenn Sie eine Anfrage zum Aktualisieren der Felder RETENTION_MODE und RETAIN_UNTIL_TIME senden, beachten Sie Folgendes:

         • Wenn Sie die Konfiguration der Objektaufbewahrung aktualisieren möchten, müssen Sie für die Felder RETENTION_MODE und RETAIN_UNTIL_TIME Werte angeben, die nicht leer sind. Wenn Sie nur ein Feld festlegen, wird der Fehler INVALID_ARGUMENT ausgegeben.
         • Sie können den RETAIN_UNTIL_TIME-Wert für Objekte sowohl im Unlocked- als auch im Locked-Modus verlängern.
         • Die Objektaufbewahrung muss sich im Unlocked-Modus befinden, wenn Sie Folgendes tun möchten:
           • Reduzieren Sie den Wert RETAIN_UNTIL_TIME.
           • Entfernen Sie die Aufbewahrungskonfiguration. Wenn Sie die Konfiguration entfernen möchten, müssen Sie für die Felder RETENTION_MODE und RETAIN_UNTIL_TIME leere Werte angeben.
         • Wenn Sie die Felder RETENTION_MODE und RETAIN_UNTIL_TIME weglassen, bleibt die Aufbewahrungskonfiguration unverändert.

     • --clear-all-object-custom-contexts: Alle vorhandenen Objektkontexte löschen.

       Im folgenden Beispiel wird gezeigt, wie Sie einen Job erstellen, um alle Objektkontexte für Objekte zu löschen, die in manifest.csv aufgeführt sind:

       gcloud storage batch-operations jobs create my-job \
       --bucket=my-bucket \
       --manifest-location=gs://my-bucket/manifest.csv \
       --clear-all-object-custom-contexts

     • --clear-object-custom-contexts: Kontexte mit bestimmten Schlüsseln entfernen. Sie können auch bestimmte Kontexte aktualisieren und gleichzeitig Schlüssel entfernen, indem Sie das Flag --clear-object-custom-contexts und eines der folgenden Flags verwenden:

       • --update-object-custom-contexts: Geben Sie eine Zuordnung von Schlüssel/Wert-Paaren an.

         Im folgenden Beispiel wird gezeigt, wie Sie einen Job erstellen, um den Kontext mit dem Schlüssel temp-id zu entfernen und den Kontext mit den Schlüsseln project-id und cost-center für alle in manifest.csv aufgeführten Objekte zu aktualisieren oder einzufügen:

         gcloud storage batch-operations jobs create my-job \
         --bucket=my-bucket \
         --manifest-location=gs://my-bucket/manifest.csv \
         --clear-object-custom-contexts=temp-id \
         --update-object-custom-contexts=project-id=project-A,cost-center=engineering

       • --update-object-custom-contexts-file: Geben Sie den Pfad zu einer JSON- oder YAML-Datei mit Schlüssel/Wert-Paaren an.

         Im folgenden Beispiel wird gezeigt, wie Sie einen Job zum Verarbeiten von in manifest.csv definierten Objekten erstellen. Der Job führt folgende Schritte aus:

         • Entfernt alle Kontexte mit dem Schlüssel temp-id.

         • Aktualisiert vorhandene Kontexte mit den Schlüsseln project-id und cost-center, die in der Datei /tmp/context_updates.json definiert sind.

         gcloud storage batch-operations jobs create my-job \
         --bucket=my-bucket \
         --manifest-location=gs://my-bucket/manifest.csv \
         --clear-object-custom-contexts=temp-id \
         --update-object-custom-contexts-file=/tmp/context_updates.json

         Dabei enthält /tmp/context_updates.json die folgenden Objektkontexte:

         {
         "project-id": {"value": "project-A"},
         "cost-center": {"value": "engineering"}
         }

Clientbibliotheken

[](google::cloud::storagebatchoperations_v1::StorageBatchOperationsClient
       client,
   std::string const& project_id, std::string const& job_id,
   std::string const& target_bucket_name, std::string const& object_prefix) {
  auto const parent =
      std::string{"projects/"} + project_id + "/locations/global";
  namespace sbo = google::cloud::storagebatchoperations::v1;
  sbo::Job job;
  sbo::BucketList* bucket_list = job.mutable_bucket_list();
  sbo::BucketList::Bucket* bucket_config = bucket_list->add_buckets();
  bucket_config->set_bucket(target_bucket_name);
  sbo::PrefixList* prefix_list_config = bucket_config->mutable_prefix_list();
  prefix_list_config->add_included_object_prefixes(object_prefix);
  sbo::DeleteObject* delete_object_config = job.mutable_delete_object();
  delete_object_config->set_permanent_object_deletion_enabled(false);
  auto result = client.CreateJob(parent, job, job_id).get();
  if (!result) throw result.status();
  std::cout << "Created job: " << result->name() << "\n";
}

use Google\Cloud\StorageBatchOperations\V1\Client\StorageBatchOperationsClient;
use Google\Cloud\StorageBatchOperations\V1\CreateJobRequest;
use Google\Cloud\StorageBatchOperations\V1\Job;
use Google\Cloud\StorageBatchOperations\V1\BucketList;
use Google\Cloud\StorageBatchOperations\V1\BucketList\Bucket;
use Google\Cloud\StorageBatchOperations\V1\PrefixList;
use Google\Cloud\StorageBatchOperations\V1\DeleteObject;

/**
 * Create a new batch job.
 *
 * @param string $projectId Your Google Cloud project ID.
 *        (e.g. 'my-project-id')
 * @param string $jobId A unique identifier for this job.
 *        (e.g. '94d60cc1-2d95-41c5-b6e3-ff66cd3532d5')
 * @param string $bucketName The name of your Cloud Storage bucket to operate on.
 *        (e.g. 'my-bucket')
 * @param string $objectPrefix The prefix of objects to include in the operation.
 *        (e.g. 'prefix1')
 */
function create_job(string $projectId, string $jobId, string $bucketName, string $objectPrefix): void
{
    // Create a client.
    $storageBatchOperationsClient = new StorageBatchOperationsClient();

    $parent = $storageBatchOperationsClient->locationName($projectId, 'global');

    $prefixListConfig = new PrefixList(['included_object_prefixes' => [$objectPrefix]]);
    $bucket = new Bucket(['bucket' => $bucketName, 'prefix_list' => $prefixListConfig]);
    $bucketList = new BucketList(['buckets' => [$bucket]]);

    $deleteObject = new DeleteObject(['permanent_object_deletion_enabled' => false]);

    $job = new Job(['bucket_list' => $bucketList, 'delete_object' => $deleteObject]);

    $request = new CreateJobRequest([
        'parent' => $parent,
        'job_id' => $jobId,
        'job' => $job,
    ]);
    $response = $storageBatchOperationsClient->createJob($request);

    printf('Created job: %s', $response->getName());
}

JSON API

Wenn Sie die Liste der Objekte für den Batchvorgangsjob definieren möchten, können Sie eine der folgenden Quellkonfigurationen auswählen:

• Projekt als Quelle: Zielt mit einer projectSource-Konfiguration auf Objekte im gesamten Projekt ab. Anstatt einzelne Buckets oder Präfixe aufzulisten, geben Sie erweiterte Filterparameter an, um Storage Insights-Metadaten dynamisch abzufragen. Weitere Informationen finden Sie auf dem Tab „JSON API“ unter Job mit erweiterten Filtern erstellen.
• Buckets als Quelle: Zielt mit einer bucketList-Konfiguration auf Objekte in bestimmten Buckets ab. Sie müssen die Ziel-Buckets und entweder eine Manifest-CSV-Datei (manifest_location) oder Objektpräfixe (include_object_prefixes) angeben.

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

2. Erstellen Sie eine JSON-Datei mit den Einstellungen für den Job für Storage-Batchvorgänge. Folgende Einstellungen können verwendet werden:

   {
           "Description": "JOB_DESCRIPTION",
           "BucketList":
           {
           "Buckets":
           [
            {
              "Bucket": "BUCKET_NAME",
              "Manifest": {
                 "manifest_location": "MANIFEST_LOCATION"
                  }
              "PrefixList": {
                 "include_object_prefixes": "OBJECT_PREFIXES"
                  }
            }
           ]
           },
           "DeleteObject":
           {
           "permanent_object_deletion_enabled": OBJECT_DELETION_VALUE
            }
           "RewriteObject": {
             "kms_key":"KMS_KEY_VALUE",
             "storage_class":"STORAGE_CLASS_VALUE"
             }
           "PutMetadata":{
             "METADATA_KEY": "METADATA_VALUE",
             ...,
             "objectRetention": {
                 "retainUntilTime": "RETAIN_UNTIL_TIME",
                 "mode": "RETENTION_MODE"
                }
              }
           "PutObjectHold": {
             "temporary_hold": TEMPORARY_HOLD_VALUE,
             "event_based_hold": EVENT_BASED_HOLD_VALUE
           },
           "updateObjectCustomContext": {
              "customContextUpdates": {
                 "updates": {
                    "CONTEXT_KEY": { "value": "CONTEXT_VALUE" }
                 },
                 "keysToClear": ["CONTEXT_KEY_TO_CLEAR"]
              },
              "clearAll": CLEAR_ALL_VALUE
           },
           "SetObjectAcls": {
              "accessControlsUpdates": {
                 "grants": [
                    { "entity": "allUsers", "role": "READER" }
                 ],
                 "removeEntities": ["allAuthenticatedUsers"]
              }
           },
           "dryRun": DRY_RUN_VALUE
           }
            

   Where:
   

   • JOB_NAME ist der Name des Jobs für Storage-Batchvorgänge.

   • JOB_DESCRIPTION ist die Beschreibung des Jobs für Speicher-Batchvorgänge.

   • BUCKET_NAME ist der Name des Buckets, der ein oder mehrere Objekte enthält, die Sie verarbeiten möchten.

   • Verwenden Sie eines der folgenden Attribute in der JSON-Datei, um die zu verarbeitenden Objekte anzugeben:

     • MANIFEST_LOCATION ist der Speicherort des Manifests. Beispiel: gs://bucket_name/path/object_name.csv

     • OBJECT_PREFIXES ist die durch Kommas getrennte Liste mit einem oder mehreren Objektpräfixen. Wenn Sie alle Objekte abgleichen möchten, verwenden Sie eine leere Liste.

   • Geben Sie je nach zu verarbeitendem Job eine der folgenden Optionen an:

     • Objekte löschen:

       "DeleteObject":
         {
         "permanent_object_deletion_enabled": OBJECT_DELETION_VALUE
         }

       Dabei ist OBJECT_DELETION_VALUE der Wert TRUE, um Objekte zu löschen.

     • Aktualisieren Sie den kundenverwalteten Verschlüsselungsschlüssel für Objekte:

       "RewriteObject":
         {
         "kms_key": KMS_KEY_VALUE
         }

       Dabei ist KMS_KEY_VALUE der Wert des KMS-Schlüssels des Objekts, den Sie aktualisieren möchten.

     • Aktualisieren Sie die Speicherklasse für Objekte:

       "RewriteObject":
         {
         "storage_class": STORAGE_CLASS_VALUE
         }

       Dabei ist STORAGE_CLASS_VALUE die neue Speicherklasse, in die Sie die Objekte umstellen möchten. Zu den unterstützten Speicherklassen gehören STANDARD, NEARLINE, COLDLINE und ARCHIVE.

     • Objektmetadaten aktualisieren:

       "PutMetadata": {
            "METADATA_KEY": "METADATA_VALUE",
            ...,
           "objectRetention": {
              "retainUntilTime": "RETAIN_UNTIL_TIME",
              "mode": "RETENTION_MODE"
            }
          }

       Wobei:

       • METADATA_KEY/VALUE ist das Schlüssel/Wert-Paar für die Metadaten des Objekts. Sie können ein oder mehrere Paare angeben.
       • RETAIN_UNTIL_TIME ist das Datum und die Uhrzeit im RFC 3339-Format, bis zu dem das Objekt aufbewahrt wird. Beispiel: 2025-10-09T10:30:00Z. Wenn Sie die Aufbewahrungskonfiguration für ein Objekt festlegen möchten, müssen Sie die Aufbewahrung für den Bucket aktivieren, der das Objekt enthält.
       • RETENTION_MODE ist der Aufbewahrungsmodus, entweder Unlocked oder Locked.

         Wenn Sie eine Anfrage zum Aktualisieren der Felder RETENTION_MODE und RETAIN_UNTIL_TIME senden, beachten Sie Folgendes:

         • Wenn Sie die Konfiguration der Objektaufbewahrung aktualisieren möchten, müssen Sie für die Felder RETENTION_MODE und RETAIN_UNTIL_TIME Werte angeben, die nicht leer sind. Wenn Sie nur ein Feld festlegen, wird der Fehler INVALID_ARGUMENT ausgegeben.
         • Sie können den RETAIN_UNTIL_TIME-Wert für Objekte sowohl im Unlocked- als auch im Locked-Modus verlängern.
         • Die Objektaufbewahrung muss sich im Unlocked-Modus befinden, wenn Sie Folgendes tun möchten:
           • Reduzieren Sie den Wert RETAIN_UNTIL_TIME.
           • Entfernen Sie die Aufbewahrungskonfiguration. Wenn Sie die Konfiguration entfernen möchten, müssen Sie für die Felder RETENTION_MODE und RETAIN_UNTIL_TIME leere Werte angeben.
         • Wenn Sie die Felder RETENTION_MODE und RETAIN_UNTIL_TIME weglassen, bleibt die Aufbewahrungskonfiguration unverändert.

       • Objekt-Holds aktualisieren:

         "PutObjectHold": {
             "temporary_hold": TEMPORARY_HOLD_VALUE,
             "event_based_hold": EVENT_BASED_HOLD_VALUE
           }

         Wobei:

         • TEMPORARY_HOLD_VALUE wird verwendet, um den temporären Objekt-Hold zu aktivieren oder zu deaktivieren. Der Wert 1 aktiviert den Hold und der Wert 2 deaktiviert ihn.

         • EVENT_BASED_HOLD_VALUE wird verwendet, um den ereignisbasierten Objekt-Hold zu aktivieren oder zu deaktivieren. Der Wert 1 aktiviert den Hold und der Wert 2 deaktiviert ihn.

       • Objektkontexte aktualisieren:

         "updateObjectCustomContext": {
             "customContextUpdates": {
               "updates": {
                 "CONTEXT_KEY": { "value": "CONTEXT_VALUE" }
               },
               "keysToClear": ["CONTEXT_KEY_TO_CLEAR"]
             },
             "clearAll": CLEAR_ALL_VALUE
           }

         Wobei:

         • CONTEXT_KEY ist der Schlüssel des Objektkontexts, der eingefügt oder aktualisiert werden soll.
         • CONTEXT_VALUE ist der Objektkontextwert für den Schlüssel.
         • CONTEXT_KEY_TO_CLEAR ist der zu entfernende Schlüssel.
         • CLEAR_ALL_VALUE ist auf true festgelegt, um alle vorhandenen Objektkontexte zu löschen.

       • Objekt-ACLs (Access Control Lists) aktualisieren:

         "SetObjectAcls": {
             "accessControlsUpdates": {
                "grants": [
                   { "entity": "ENTITY_NAME", "role": "ROLE_NAME" }
                ],
                "removeEntities": ["ENTITY_TO_REMOVE"]
             }
           }

         Wobei:

         • ENTITY_NAME ist die Entität, für die der Zugriff hinzugefügt oder aktualisiert werden soll, z. B. allUsers, allAuthenticatedUsers oder ein bestimmter Nutzer oder eine bestimmte Gruppe.
         • ROLE_NAME ist die Rolle, die zugewiesen werden soll. Beispiele: READER, OWNER
         • ENTITY_TO_REMOVE ist die Entität, deren Anmeldedaten Sie entfernen möchten.

     • DRY_RUN_VALUE ist ein optionaler boolescher Wert. Legen Sie true fest, um den Job im Probelaufmodus auszuführen. Der Standardwert ist false.

     1. Verwenden Sie curl, um die JSON API mit einer Anfrage für einen POST-Storage-Batchvorgangsjob aufzurufen:

        curl -X POST --data-binary @JSON_FILE_NAME \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json" \
         "https://storagebatchoperations.googleapis.com/v1/projects/PROJECT_ID/locations/global/jobs?job_id=JOB_NAME"

        Wobei:

        • JSON_FILE_NAME ist der Name der JSON-Datei.
        • PROJECT_ID ist die ID oder Nummer des Projekts. Beispiel: my-project.

        • JOB_NAME ist der Name des Jobs für Storage-Batchvorgänge.

Console

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

   Buckets aufrufen

2. Klicken Sie in der Bucket-Liste auf den Namen des Buckets, der mit dem Vorgang verknüpft ist.
3. Klicken Sie auf der Seite Bucket-Details auf den Tab Vorgänge.
4. Klicken Sie in der Liste der Vorgänge auf die Vorgangs-ID des Jobs, den Sie sich ansehen möchten.
5. Auf der Detailseite werden auf dem Tab Übersicht Messwerte für Ihren Job angezeigt, z. B. erkannte und verarbeitete Objekte sowie aufgetretene Fehler.
6. In der Tabelle Fehlerübersicht können Sie sich Details zu Ausführungsfehlern ansehen oder auf In Cloud Logging ansehen klicken, um die Einträge aufzurufen.
7. Klicken Sie auf den Tab Konfiguration, um die Konfigurationseinstellungen für den Job aufzurufen.

Befehlszeile

1. Aktivieren Sie Cloud Shell in der Cloud de Confiance Console.

   Cloud Shell aktivieren

   Unten in der Cloud de Confiance Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. Führen Sie in Ihrer Entwicklungsumgebung den Befehl gcloud storage batch-operations jobs describe aus.

   gcloud storage batch-operations jobs describe JOB_NAME

   Wobei:

   JOB_NAME ist der Name des Jobs für Storage-Batchvorgänge.

   Wenn Sie einen Job im Probelauf ausführen, enthält die Ausgabe die folgenden Felder:

   • totalObjectCount: Zeigt die Anzahl der Objekte an, die Ihren Auswahlkriterien entsprechen.
   • errorSummaries: Listet alle Fehler auf, die während des Probelaufs gefunden wurden, z. B. Berechtigungsprobleme oder ungültige Konfigurationen.
   • totalBytesFound: Zeigt die Gesamtgröße der betroffenen Objekte an. Dieses Feld wird nur angezeigt, wenn Sie Objektpräfixe für die Objektauswahl verwenden.

   Wenn der Vorgang erfolgreich war, sieht die Antwort für den Probelaufjob in etwa so aus:

     bucketList:
       buckets:
       - bucket: my-bucket
         manifest:
           manifestLocation: gs://my-bucket/manifest.csv
     completeTime: '2025-10-27T23:56:32Z'
     counters:
       totalObjectCount: '4'
     createTime: '2025-10-27T23:56:22.243528568Z'
     dryRun: true
     name: projects/my-project/locations/global/jobs/my-job
     putMetadata:
       contentLanguage: en
     state: SUCCEEDED
   

   Bei einer erfolgreichen Jobantwort wird das Feld dryRun weggelassen und die folgenden Messwerte werden im Feld counters zurückgegeben:

   • Gesamtzahl der gefundenen Objekte.
   • Gesamtanzahl der Bytes, die bei Verwendung von Objektpräfixen gefunden wurden.
   • Erfolgreiche Objekttransformationen.
   • Fehlgeschlagene Objekttransformationen, falls zutreffend.
   • Objektkontexte, falls zutreffend.
   • Objektkontexte gelöscht, falls zutreffend.
   • Objektkontexte wurden gegebenenfalls aktualisiert. Dieser Zähler erfasst Aktualisierungen an vorhandenen Kontextschlüsseln.

   Die Antwort für eine tatsächliche Jobausführung sieht in etwa so aus:

     bucketList:
       buckets:
       - bucket: my-bucket
         manifest:
           manifestLocation: gs://my-bucket/manifest.csv
     completeTime: '2025-10-31T20:19:42.357826655Z'
     counters:
       succeededObjectCount: '4'
       totalObjectCount: '4'
     createTime: '2025-10-31T20:19:22.016517077Z'
     name: projects/my-project/locations/global/jobs/my-job
     putMetadata:
       contentLanguage: en
     state: SUCCEEDED
     

Clientbibliotheken

[](google::cloud::storagebatchoperations_v1::StorageBatchOperationsClient
       client,
   std::string const& project_id, std::string const& job_id) {
  auto const parent =
      std::string{"projects/"} + project_id + "/locations/global";
  auto const name = parent + "/jobs/" + job_id;
  auto job = client.GetJob(name);
  if (!job) throw job.status();
  std::cout << "Got job: " << job->name() << "\n";
}

use Google\Cloud\StorageBatchOperations\V1\Client\StorageBatchOperationsClient;
use Google\Cloud\StorageBatchOperations\V1\GetJobRequest;

/**
 * Gets a batch job.
 *
 * @param string $projectId Your Google Cloud project ID.
 *        (e.g. 'my-project-id')
 * @param string $jobId A unique identifier for this job.
 *        (e.g. '94d60cc1-2d95-41c5-b6e3-ff66cd3532d5')
 */
function get_job(string $projectId, string $jobId): void
{
    // Create a client.
    $storageBatchOperationsClient = new StorageBatchOperationsClient();

    $parent = $storageBatchOperationsClient->locationName($projectId, 'global');
    $formattedName = $parent . '/jobs/' . $jobId;

    $request = new GetJobRequest([
        'name' => $formattedName,
    ]);

    $response = $storageBatchOperationsClient->getJob($request);

    printf('Got job: %s', $response->getName());
}

JSON API

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

2. Verwenden Sie cURL, um die JSON API mit einer Anfrage für einen GET-Storage-Batchvorgangsjob aufzurufen:

   curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://storagebatchoperations.googleapis.com/v1/projects/PROJECT_ID/locations/global/jobs/JOB_NAME"

   Wobei:

   • PROJECT_ID ist die ID oder Nummer des Projekts. Beispiel: my-project.
   • JOB_NAME ist der Name des Jobs für Storage-Batchvorgänge.

   Wenn Sie einen Job im Probelauf ausführen, enthält die Ausgabe die folgenden Felder:

   • totalObjectCount: Zeigt die Anzahl der Objekte an, die Ihren Auswahlkriterien entsprechen.
   • errorSummaries: Listet alle Fehler auf, die während des Probelaufs gefunden wurden, z. B. Berechtigungsprobleme oder ungültige Konfigurationen.
   • totalBytesFound: Zeigt die Gesamtgröße der betroffenen Objekte an. Dieses Feld wird nur angezeigt, wenn Sie Objektpräfixe für die Objektauswahl verwenden.

   Wenn der Vorgang erfolgreich war, sieht die Antwort für den Probelauf in etwa so aus:

   {
     "name": "projects/my-project/locations/global/jobs/my-job",
     "description": "dry-run-job",
     "deleteObject": {
       "permanent_object_deletion_enabled": true
        },
     "createTime": "2025-10-28T00:26:53.900882459Z",
     "completeTime": "2025-10-28T00:27:04.101663275Z",
     "counters": {
         "totalObjectCount": "5",
         "totalBytesFound": "203"
       },
     "state": "SUCCEEDED",
     "bucketList": {
       "buckets": [
         {
           "bucket": "my-bucket",
           "prefixList": {
             "includedObjectPrefixes": [
               ""
             ]
           }
         }
       ]
     },
     "dryRun": true
   }
   

   Bei einer erfolgreichen Jobantwort wird das Feld dryRun weggelassen und die folgenden Messwerte werden im Feld counters zurückgegeben:

   • Gesamtzahl der gefundenen Objekte.
   • Gesamtanzahl der Bytes, die bei Verwendung von Objektpräfixen gefunden wurden.
   • Erfolgreiche Objekttransformationen.
   • Fehlgeschlagene Objekttransformationen, falls zutreffend.
   • Objektkontexte, falls zutreffend.
   • Objektkontexte gelöscht, falls zutreffend.

   • Objektkontexte wurden gegebenenfalls aktualisiert. Dieser Zähler erfasst Aktualisierungen an vorhandenen Kontextschlüsseln.

     Die Antwort für eine tatsächliche Jobausführung sieht in etwa so aus:

     {
     "name": "my-job",
     "description": "my-delete-objects-job",
     "deleteObject": {
       "permanent_object_deletion_enabled": true
     },
     "createTime": "2025-10-28T00:26:53.900882459Z",
     "completeTime": "2025-10-28T00:27:04.101663275Z",
     "counters": {
       "succeededObjectCount: "5"
       "totalObjectCount": "5",
       "totalBytesFound": "203"
     },
     "state": "SUCCEEDED",
     "bucketList": {
       "buckets": [
         {
           "bucket": "my-bucket",
           "prefixList": {
             "includedObjectPrefixes": [
               ""
             ]
           }
         }
       ]
     }
     }
     

Console

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

   Buckets aufrufen

2. Klicken Sie in der Bucket-Liste auf den Namen des Buckets, der mit dem Vorgang verknüpft ist.
3. Klicken Sie auf der Seite Bucket-Details auf den Tab Vorgänge. Auf der Seite Vorgänge wird eine Liste der aktiven laufenden Vorgänge angezeigt.

Befehlszeile

1. Aktivieren Sie Cloud Shell in der Cloud de Confiance Console.

   Cloud Shell aktivieren

   Unten in der Cloud de Confiance Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. Führen Sie in Ihrer Entwicklungsumgebung den Befehl gcloud storage batch-operations jobs list aus.

   gcloud storage batch-operations jobs list

Clientbibliotheken

[](google::cloud::storagebatchoperations_v1::StorageBatchOperationsClient
       client,
   std::string const& project_id) {
  auto const parent =
      std::string{"projects/"} + project_id + "/locations/global";
  for (auto const& job : client.ListJobs(parent)) {
    if (!job) throw job.status();
    std::cout << job->name() << "\n";
  }
}

use Google\Cloud\StorageBatchOperations\V1\Client\StorageBatchOperationsClient;
use Google\Cloud\StorageBatchOperations\V1\ListJobsRequest;

/**
 * List Jobs in a given project.
 *
 * @param string $projectId Your Google Cloud project ID.
 *        (e.g. 'my-project-id')
 */
function list_jobs(string $projectId): void
{
    // Create a client.
    $storageBatchOperationsClient = new StorageBatchOperationsClient();

    $parent = $storageBatchOperationsClient->locationName($projectId, 'global');

    $request = new ListJobsRequest([
        'parent' => $parent,
    ]);

    $jobs = $storageBatchOperationsClient->listJobs($request);

    foreach ($jobs as $job) {
        printf('Job name: %s' . PHP_EOL, $job->getName());
    }
}

JSON API

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

2. Verwenden Sie cURL, um die JSON API mit einer LIST-Anfrage für Storage-Batchvorgänge aufzurufen:

   curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://storagebatchoperations.googleapis.com/v1/projects/PROJECT_ID/locations/global/jobs"

   Wobei:

   PROJECT_ID ist die ID oder Nummer des Projekts. Beispiel: my-project.

Console

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

   Buckets aufrufen

2. Klicken Sie in der Bucket-Liste auf den Namen des Buckets, der mit dem Storage-Batchvorgang verknüpft ist, den Sie abbrechen möchten.

3. Klicken Sie auf den Tab Vorgänge. Auf diesem Tab wird eine Liste der Batchvorgangsjobs angezeigt. Sie können nur Jobs abbrechen, die gerade ausgeführt werden.

4. Wählen Sie in der Liste der Vorgänge einen oder mehrere Jobs aus, die Sie abbrechen möchten, und klicken Sie dann auf Abbrechen.

Befehlszeile

1. Aktivieren Sie Cloud Shell in der Cloud de Confiance Console.

   Cloud Shell aktivieren

   Unten in der Cloud de Confiance Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. Führen Sie in Ihrer Entwicklungsumgebung den Befehl gcloud storage batch-operations jobs cancel aus.

   gcloud storage batch-operations jobs cancel JOB_NAME

   Wobei:

   JOB_NAME ist der Name des Jobs für Storage-Batchvorgänge.

Clientbibliotheken

[](google::cloud::storagebatchoperations_v1::StorageBatchOperationsClient
       client,
   std::string const& project_id, std::string const& job_id) {
  auto const parent =
      std::string{"projects/"} + project_id + "/locations/global";
  auto const name = parent + "/jobs/" + job_id;
  auto response = client.CancelJob(name);
  if (!response) throw response.status();
  std::cout << "Cancelled job: " << name << "\n";
}

use Google\Cloud\StorageBatchOperations\V1\Client\StorageBatchOperationsClient;
use Google\Cloud\StorageBatchOperations\V1\CancelJobRequest;

/**
 * Cancel a batch job.
 *
 * @param string $projectId Your Google Cloud project ID.
 *        (e.g. 'my-project-id')
 * @param string $jobId A unique identifier for this job.
 *        (e.g. '94d60cc1-2d95-41c5-b6e3-ff66cd3532d5')
 */
function cancel_job(string $projectId, string $jobId): void
{
    // Create a client.
    $storageBatchOperationsClient = new StorageBatchOperationsClient();

    $parent = $storageBatchOperationsClient->locationName($projectId, 'global');
    $formattedName = $parent . '/jobs/' . $jobId;

    $request = new CancelJobRequest([
        'name' => $formattedName,
    ]);

    $storageBatchOperationsClient->cancelJob($request);

    printf('Cancelled job: %s', $formattedName);
}

JSON API

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

2. Verwenden Sie cURL, um die JSON API mit einer Anfrage zum CANCEL-Storage-Batchvorgangsjob aufzurufen:

   curl -X CANCEL \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://storagebatchoperations.googleapis.com/v1/projects/PROJECT_ID/locations/global/jobs/JOB_NAME"

   Wobei:

   • PROJECT_ID ist die ID oder Nummer des Projekts. Beispiel: my-project.

   • JOB_NAME ist der Name des Jobs für Storage-Batchvorgänge.

Console

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

   Buckets aufrufen

2. Klicken Sie in der Bucket-Liste auf den Namen des Buckets, der mit dem Storage-Batchvorgang verknüpft ist, den Sie löschen möchten.

3. Klicken Sie auf den Tab Vorgänge. Auf diesem Tab wird eine Liste der Batchvorgangsjobs angezeigt. Sie können nur Jobs löschen, die nicht ausgeführt werden, z. B. Jobs, die erfolgreich waren, fehlgeschlagen sind oder abgebrochen wurden.

4. Wählen Sie in der Liste der Vorgänge einen oder mehrere Jobs aus, die Sie löschen möchten, und klicken Sie dann auf Löschen.

Befehlszeile

1. Aktivieren Sie Cloud Shell in der Cloud de Confiance Console.

   Cloud Shell aktivieren

   Unten in der Cloud de Confiance Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. Führen Sie in Ihrer Entwicklungsumgebung den Befehl gcloud storage batch-operations jobs delete aus.

   gcloud storage batch-operations jobs delete JOB_NAME

   Wobei:

   JOB_NAME ist der Name des Jobs für Speicher-Batchvorgänge.

Clientbibliotheken

[](google::cloud::storagebatchoperations_v1::StorageBatchOperationsClient
       client,
   std::string const& project_id, std::string const& job_id) {
  auto const parent =
      std::string{"projects/"} + project_id + "/locations/global";
  auto const name = parent + "/jobs/" + job_id;
  auto status = client.DeleteJob(name);
  if (!status.ok()) throw status;
  std::cout << "Deleted job: " << name << "\n";
}

use Google\Cloud\StorageBatchOperations\V1\Client\StorageBatchOperationsClient;
use Google\Cloud\StorageBatchOperations\V1\DeleteJobRequest;

/**
 * Delete a batch job.
 *
 * @param string $projectId Your Google Cloud project ID.
 *        (e.g. 'my-project-id')
 * @param string $jobId A unique identifier for this job.
 *        (e.g. '94d60cc1-2d95-41c5-b6e3-ff66cd3532d5')
 */
function delete_job(string $projectId, string $jobId): void
{
    // Create a client.
    $storageBatchOperationsClient = new StorageBatchOperationsClient();

    $parent = $storageBatchOperationsClient->locationName($projectId, 'global');
    $formattedName = $parent . '/jobs/' . $jobId;

    $request = new DeleteJobRequest([
        'name' => $formattedName,
    ]);

    $storageBatchOperationsClient->deleteJob($request);

    printf('Deleted job: %s', $formattedName);
}

JSON API

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

2. Verwenden Sie cURL, um die JSON API mit einer Anfrage zum DELETE-Storage-Batchvorgangsjob aufzurufen:

   curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://storagebatchoperations.googleapis.com/v1/projects/PROJECT_ID/locations/global/jobs/JOB_NAME"

   Wobei:

   • PROJECT_ID ist die ID oder Nummer des Projekts. Beispiel: my-project.

   • JOB_NAME ist der Name des Jobs für Storage-Batchvorgänge.

Befehlszeile

1. Aktivieren Sie Cloud Shell in der Cloud de Confiance Console.

   Cloud Shell aktivieren

   Unten in der Cloud de Confiance Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. Führen Sie den Befehl gcloud storage batch-operations jobs create aus:

   gcloud storage batch-operations jobs create JOB_NAME \
   {--insights-dataset-config=INSIGHTS_DATASET_CONFIG_RESOURCE_NAME --target-project=TARGET_PROJECT [--bucket-filters=BUCKET_FILTER_CEL] [--object-filters=OBJECT_FILTER_CEL] [--target-locations=TARGET_LOCATIONS] [--target-snapshot-time=TARGET_SNAPSHOT_TIME] | --dry-run-job-id=DRY_RUN_JOB_ID} \
   --JOB_TYPE_FLAG

   Wobei:

   • JOB_NAME ist der Name des Jobs für Storage-Batchvorgänge.
   • INSIGHTS_DATASET_CONFIG_RESOURCE_NAME: Der Ressourcenname der Dataset-Konfiguration. Beispiel: projects/{project-id}/locations/{location-id}/datasetConfigs/{dataset_config_id} Sie müssen diesen Parameter angeben, bevor Sie die Flags --bucket-filters und --object-filters verwenden.
   • TARGET_PROJECT: Die Projekt-ID oder Projektnummer, die mit den Zielressourcen verknüpft ist.
   • BUCKET_FILTER_CEL und OBJECT_FILTER_CEL (optional): Die CEL-Filterausdrücke, die zum Auswählen von Objekten verwendet werden. Hier einige Beispiele:
     • --bucket-filters="name in ['bucket-1', 'bucket-2']"
     • --object-filters="size >= 5000 && name.endsWith('.pdf')" Informationen zu unterstützten Feldern, Operatoren und Funktionen finden Sie in der Referenz zu CEL-Filtern.
   • TARGET_LOCATIONS (optional): Eine Liste von Cloud Storage-Standorten, mit denen der Jobumfang eingegrenzt wird. Beispiel: us,us-central1,us-east4 Mit diesem Parameter können Sie Standorte ausschließen, an denen ein Dienstausfall vorliegt. Wenn nur TARGET_LOCATIONS angegeben und TARGET_SNAPSHOT_TIME weggelassen wird, wählt der Job automatisch den neuesten Snapshot-Zeitstempel aus, der in den Attributansichten für Objekte und Buckets an allen angegebenen Standorten erfolgreich ausgefüllt wurde.
   • TARGET_SNAPSHOT_TIME (optional): Der UTC-Zeitstempel des zu verwendenden Dataset-Snapshots im RFC 3339-Format. Beispiel: 2026-05-03T16:00:00Z. Dieser Snapshot muss in Ihren Bucket- und Objektattributansichten vorhanden sein. Wenn Sie diesen Parameter angeben, müssen Sie auch den Parameter TARGET_LOCATIONS angeben.
   • DRY_RUN_JOB_ID: Die Kennung eines zuvor ausgeführten Probelaufjobs. Wenn Sie diesen Parameter angeben, können Sie keine anderen Parameter für die Objektauswahl angeben, einschließlich --insights-dataset-config, --target-project, --bucket-filters, --object-filters, --target-locations und --target-snapshot-time. Der aktive Job ruft alle Auswahlkriterien direkt aus dem Probelaufjob ab.
   • JOB_TYPE_FLAG: Das Flag, das dem Bulk-Vorgang entspricht, den Sie ausführen möchten, z. B. --put-metadata oder --delete-object.

JSON API

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

2. Erstellen Sie eine JSON-Konfigurationsdatei, in der die Dataset-Filter und die Einstellungen für Bulk-Vorgänge angegeben sind. Beispiel:

   {
       "description": "JOB_DESCRIPTION",
       "projectSource": {
           "project": "projects/TARGET_PROJECT",
           "insightsDatasetConfig": "INSIGHTS_DATASET_CONFIG_RESOURCE_NAME",
           "bucketFilters": {
               "expression": "BUCKET_FILTER_CEL"
           },
           "objectFilters": {
               "expression": "OBJECT_FILTER_CEL"
           },
           "snapshotTime": "SNAPSHOT_TIME",
           "targetLocations": {
               "locations": ["LOCATION_1", "LOCATION_2"]
           }
       },
       "deleteObject": {
           "permanentObjectDeletionEnabled": OBJECT_DELETION_VALUE
       }
    }

   Wobei:

   • JOB_DESCRIPTION ist die Beschreibung des Jobs.
     • TARGET_PROJECT ist die Projekt-ID oder Projektnummer, die mit den Zielobjekten verknüpft ist.
   • INSIGHTS_DATASET_CONFIG_RESOURCE_NAME ist der voll qualifizierte Ressourcenname der Dataset-Konfiguration (z. B. projects/{project-id}/locations/{location-id}/datasetConfigs/{dataset_config_id}).
   • BUCKET_FILTER_CEL ist der CEL-Filterausdruck für Buckets. Beispiel: name in ['bucket-1', 'bucket-2']. Weitere Informationen zu unterstützten Schlüsselwörtern, Feldern und Operatoren finden Sie in der Referenz zu CEL-Filtern.
   • OBJECT_FILTER_CEL ist der CEL-Filterausdruck für Objekte. Beispiel: size >= 5000 && name.endsWith('.pdf').
   • snapshotTime (optional): Ein bestimmter UTC-Zeitstempel im RFC 3339-Format (z. B. "2026-05-03T16:00:00Z"), der angibt, welcher Dataset-Snapshot verwendet werden soll. Dieser Snapshot muss in allen Zielregionen sowohl in der Bucket- als auch in der Objekt-Dataset-Ansicht vorhanden sein. Wenn Sie dieses Feld angeben, müssen Sie auch das Feld targetLocations angeben.
   • targetLocations (optional): Ein JSON-Objekt, das eine Liste von Cloud Storage-Speicherorten (z. B. ["us", "us-central1", "us-east4"]) angibt, um den Umfang des Jobs zu filtern. Wenn bei Abhängigkeiten an bestimmten Standorten ein Ausfall auftritt, können Sie den Job auf bestimmte Standorte beschränken. Wenn nur targetLocations angegeben und snapshotTime weggelassen wird, wählt der Job automatisch den neuesten Snapshot-Zeitstempel aus, der in den Attributansichten für Objekte und Buckets an allen angegebenen Standorten erfolgreich ausgefüllt wurde.
   • OBJECT_DELETION_VALUE ist der boolesche Wert, mit dem das endgültige Löschen aktiviert oder deaktiviert wird. Beispiel: true oder false

3. Senden Sie eine POST-Anfrage mit cURL, um den Job auszuführen:

   curl -X POST \
        -H "Authorization: Bearer OAUTH2_TOKEN" \
        -H "Content-Type: application/json" \
        -d @JSON_FILE_NAME \
        "https://storagebatchoperations.googleapis.com/v1/projects/PROJECT_ID/locations/global/jobs?job_id=JOB_NAME"

   Wobei:

   • JSON_FILE_NAME ist der Name der JSON-Datei.
   • PROJECT_ID ist die ID oder Nummer des Projekts. Beispiel: my-project.
   • JOB_NAME ist der Name des Jobs für Storage-Batchvorgänge.

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 die Objekte enthält, für die Sie Batchvorgänge ausführen möchten.

   Die Seite Bucket-Details wird geöffnet und der Tab Objekte ist ausgewählt.

3. Klicken Sie auf Batchvorgänge erstellen.
4. Wählen Sie im Bereich Vorgang auswählen den Vorgangstyp aus:
   • Objekt-Holds verwalten: Wählen Sie Temporärer Hold oder Ereignisbasierter Hold aus. Weitere Informationen finden Sie unter Objekt-Holds.
   • Objektmetadaten aktualisieren: So fügen Sie Objektmetadaten hinzu:
     • So fügen Sie benutzerdefinierte Metadaten hinzu:
       1. Geben Sie im Feld Schlüssel einen Schlüsselnamen ein.
       2. Geben Sie im Feld Wert einen Wert für diesen Schlüssel ein.
       3. Optional: Klicken Sie auf + Element hinzufügen, um weitere Schlüssel/Wert-Paare hinzuzufügen.
     • So aktualisieren Sie Metadaten mit festen Schlüsseln:
       1. Klicken Sie zum Erweitern des Abschnitts Metadaten mit festen Schlüsseln aktualisieren auf den expand_moreErweiterungspfeil.
       2. Wählen Sie in der Liste Wählen Sie mindestens einen Satz Metadaten aus, der aktualisiert werden soll die Metadatenelemente aus, die Sie bearbeiten möchten.
   • Verschlüsselungsschlüssel aktualisieren/rotieren: So verwenden oder aktualisieren Sie den Verschlüsselungsschlüssel für Objekte:
     1. Wählen Sie in der Liste Cloud KMS-Schlüssel auswählen einen vom Kunden verwalteten Verschlüsselungsschlüssel (CMEK) aus.
     2. Optional: Wählen Sie Projekt wechseln aus, um einen Schlüssel aus einem anderen Projekt auszuwählen, oder wählen Sie Schlüssel manuell eingeben aus, um Details einzugeben.
   • Objekte löschen: So löschen Sie Objekte:
     1. Prüfen, ob die Objektversionsverwaltung aktiviert ist

     2. Wenn die Objektversionsverwaltung aktiviert ist, wählen Sie eine der folgenden Löschoptionen aus:

        • Wählen Sie Alle Versionen der Objekte löschen aus, um sowohl Live- als auch nicht aktuelle Versionen zu entfernen.
        • Wählen Sie Live-Versionen dauerhaft löschen aus, um nur die Live-Version zu entfernen.

        Wenn die Objektversionsverwaltung nicht aktiviert ist, werden alle zum Löschen ausgewählten Objekte dauerhaft gelöscht.

5. Klicken Sie auf Weiter.
6. Führen Sie im Bereich Vorgang benennen und Objekte angeben die folgenden Schritte aus:
   1. Geben Sie im Feld Name einen Namen ein.
   2. Optional: Geben Sie im Feld Beschreibung eine Beschreibung ein.
   3. Wählen Sie im Abschnitt Objekte angeben die Option Listen von Objekten mithilfe von CSV-Manifestdateien hochladen aus und gehen Sie dann so vor:

      1. Laden Sie die CSV-Manifestdatei in einen Bucket hoch. Diese Datei muss Header für Bucket-Name, Objektschlüssel und Generationsnummer enthalten.
      2. Wählen Sie in der Liste Modus für Manifestdatei auswählen eine der folgenden Optionen aus:
         • Wenn Sie Manifestdatei in Cloud Storage auswählen auswählen, klicken Sie im Feld Manifestdatei in Cloud Storage auswählen auf Durchsuchen. Wechseln Sie im Dialogfeld Objekt auswählen zu Ihrer Manifest-CSV-Datei und klicken Sie auf Auswählen.
         • Wenn Sie Mehrere Manifestdateien mit Platzhalter auswählen auswählen, geben Sie den Dateipfad im Feld Speicherort der Manifestdatei mit Platzhalter eingeben ein. Beispiel: bucket-name/folder/manifest_*
7. Klicken Sie auf Erstellen.

Befehlszeile

1. Aktivieren Sie Cloud Shell in der Cloud de Confiance Console.

   Cloud Shell aktivieren

   Unten in der Cloud de Confiance Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. Führen Sie in Ihrer Entwicklungsumgebung den Befehl gcloud storage batch-operations jobs create aus:

   gcloud storage batch-operations jobs create \
   JOB_NAME \
   {--bucket=SOURCE_BUCKET | --bucket-list=SOURCE_BUCKET_LIST} \
   --manifest-location=URI \
   JOB_TYPE_FLAG

   Wobei:

   • JOB_NAME ist der Name des Jobs für Storage-Batchvorgänge.

   • SOURCE_BUCKET ist der Name des Buckets, der die Objekte enthält, die Sie verarbeiten möchten. Beispiel: my-bucket.

   • SOURCE_BUCKET_LIST ist eine durch Kommas getrennte Liste mit einem oder mehreren Bucket-Namen, die die zu verarbeitenden Objekte enthalten. Beispiel: bucket1,bucket2.

   • URI ist der URI des Buckets, der das Manifest enthält. Beispiel: gs://bucket_name/path_to_csv_file/*.csv. Wenn Sie den Platzhalter *.csv verwenden, exportiert BigQuery das Ergebnis in mehrere CSV-Dateien.

   • JOB_TYPE_FLAG ist eines der folgenden Flags, je nach Jobtyp.

     • --delete-object: Ein oder mehrere Objekte löschen.

     • --put-metadata: Objektmetadaten aktualisieren. Objektmetadaten werden als Schlüssel/Wert-Paare gespeichert. Geben Sie das Schlüssel/Wert-Paar für die Metadaten an, die Sie ändern möchten. Sie können ein oder mehrere Schlüssel/Wert-Paare als Liste angeben. Sie können auch Konfigurationen für die Objektaufbewahrung mit dem Flag --put-metadata angeben.

     • --rewrite-object: Aktualisiert die kundenverwalteten Verschlüsselungsschlüssel für ein oder mehrere Objekte. Sie können dieses Flag auch verwenden, um die Speicherklasse des Objekts zu ändern, indem Sie den Schlüssel storage-class angeben. Zu den unterstützten Speicherklassen gehören STANDARD, NEARLINE, COLDLINE und ARCHIVE. Beispiel: --rewrite-object=storage-class=NEARLINE.

     • --set-object-acls-from-file: Patcht Objekt-ACLs (Access Control Lists). Geben Sie den Pfad zu einer JSON- oder YAML-Datei mit Berechtigungen an, die für Entitäten wie allUsers oder allAuthenticatedUsers hinzugefügt oder aktualisiert werden sollen. Beispiel: --set-object-acls-from-file=acl-updates.yaml.

     • --put-object-event-based-hold: Ereignisbasierte Objekt-Holds aktivieren.

     • --no-put-object-event-based-hold: Ereignisbasierte Objekt-Holds deaktivieren.

     • --put-object-temporary-hold: Aktiviert temporäre Objekt-Holds.

     • --no-put-object-temporary-hold: Deaktiviert temporäre Objekt-Holds.

     • --clear-all-object-custom-contexts: Alle vorhandenen Objektkontexte löschen.

       Im folgenden Beispiel wird gezeigt, wie Sie einen Job erstellen, um alle Objektkontexte für Objekte zu löschen, die in manifest.csv aufgeführt sind:

       gcloud storage batch-operations jobs create my-job \
       --bucket=my-bucket \
       --manifest-location=gs://my-bucket/manifest.csv \
       --clear-all-object-custom-contexts

     • --clear-object-custom-contexts: Kontexte mit bestimmten Schlüsseln entfernen. Sie können auch bestimmte Kontexte aktualisieren und gleichzeitig Schlüssel entfernen, indem Sie das Flag --clear-object-custom-contexts und eines der folgenden Flags verwenden:

       • --update-object-custom-contexts: Geben Sie eine Zuordnung von Schlüssel/Wert-Paaren an.

         Im folgenden Beispiel wird gezeigt, wie Sie einen Job erstellen, um den Kontext mit dem Schlüssel temp-id zu entfernen und den Kontext mit den Schlüsseln project-id und cost-center für alle in manifest.csv aufgeführten Objekte zu aktualisieren oder einzufügen:

         gcloud storage batch-operations jobs create my-job \
         --bucket=my-bucket \
         --manifest-location=gs://my-bucket/manifest.csv \
         --clear-object-custom-contexts=temp-id \
         --update-object-custom-contexts=project-id=project-A,cost-center=engineering

       • --update-object-custom-contexts-file: Geben Sie den Pfad zu einer JSON- oder YAML-Datei mit Schlüssel/Wert-Paaren an.

         Im folgenden Beispiel wird gezeigt, wie Sie einen Job zum Verarbeiten von in manifest.csv definierten Objekten erstellen. Der Job führt folgende Schritte aus:

         • Entfernt alle Kontexte mit dem Schlüssel temp-id.

         • Aktualisiert vorhandene Kontexte mit den Schlüsseln project-id und cost-center, die in der Datei /tmp/context_updates.json definiert sind.

         gcloud storage batch-operations jobs create my-job \
         --bucket=my-bucket \
         --manifest-location=gs://my-bucket/manifest.csv \
         --clear-object-custom-contexts=temp-id \
         --update-object-custom-contexts-file=/tmp/context_updates.json

         Dabei enthält /tmp/context_updates.json die folgenden Objektkontexte:

         {
         "project-id": {"value": "project-A"},
         "cost-center": {"value": "engineering"}
         }