Storage Batch Operations API Version v1: Error Catalog

Dienst: storagebatchoperations.googleapis.com

Bei Fehlern können Sie diesen Katalog zusammen mit unseren Clientbibliotheken verwenden. Wenn Sie eigene Bibliotheken verwenden, sollten Sie diese Anleitung für die Fehlerbehebung und Fehlerlösung zur Hand haben. Weitere Informationen zur Struktur der Fehlerantwort finden Sie auf der Seite Fehlerübersicht.

Fehlercodes

In der folgenden Tabelle sind HTTP-Statuscodes und zugehörige Fehler aufgeführt, die bei der Interaktion mit unserer API auftreten können. Jeder Statuscode entspricht einem oder mehreren Gründen und Beschreibungen, die Ihnen bei der Fehlerbehebung und der effektiven Behandlung von Fehlern in Ihrer Anwendung helfen. In den Beschreibungen stellen Variablen, die durch geschweifte Klammern ({}) gekennzeichnet sind, Platzhalter für Werte dar, die für Ihre Anfrage spezifisch sind.

Grund HTTP-Statuscode Beschreibung
JOB_ID_INVALID 400 Die „job_id“ ist ungültig. Die Job-ID muss dem Muster [a-z0-9]([-a-z0-9]*[a-z0-9])? entsprechen. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
RESOURCE_NAME_TOO_LONG 400 Der Ressourcenname überschreitet die maximal zulässige Länge von {max_length} Byte. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
DESCRIPTION_TOO_LONG 400 Die „description“ des Jobs überschreitet die maximal zulässige Länge von {max_length} Byte. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
SOURCE_NOT_SPECIFIED 400 Für den Job muss eine Quelle („bucket_list“ oder „project_source“) angegeben werden. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
TRANSFORMATION_NOT_SPECIFIED 400 Für den Job muss eine Transformation angegeben werden. Geben Sie genau eine Transformation an: „delete_object“, „put_object_hold“, „put_metadata“, „rewrite_object“, „update_object_custom_context“, „set_object_acls“ oder „drop_object_google_context“. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
BUCKET_LIST_EMPTY 400 Die „bucket_list“ darf nicht leer sein. Geben Sie mindestens eine Bucket-Konfiguration an. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
TOO_MANY_BUCKETS 400 Die „bucket_list“ darf nicht mehr als {max_buckets} Buckets enthalten. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
BUCKET_NAME_REQUIRED 400 Das Feld „bucket“ muss in der Bucket-Konfiguration angegeben werden. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
OBJECT_CONFIGURATION_REQUIRED 400 In der Bucket-Operation muss eine Objektkonfiguration („prefix_list“, „manifest“ oder „project_source“) angegeben werden. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
MANIFEST_LOCATION_REQUIRED 400 Das Feld „manifest_location“ muss angegeben werden. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
MANIFEST_LOCATION_INVALID 400 Der Manifest-Speicherort „{manifest_location}“ ist ungültig. Der Speicherort muss dem Format gs://<bucket_name>/<path>/<object_name>.csv entsprechen, wobei <path> optional ist und auf <object_name> .csv folgt und höchstens ein Platzhalterzeichen („*“) enthält. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
BUCKET_NAME_INVALID 400 Der Bucket-Name „{bucket_name}“ entspricht nicht den Anforderungen für Cloud Storage-Bucket-Namen. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
OBJECT_NAME_INVALID 400 Der Objektname „{object_name}“ entspricht nicht den Anforderungen für die Benennung von Cloud Storage-Objekten. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
OBJECT_PREFIX_INVALID_UTF8 400 Das Objektpräfix enthält ungültige UTF-8-Zeichen. Achten Sie darauf, dass das Präfix gültiges UTF-8 ist. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
OBJECT_PREFIX_TOO_LONG 400 Das Objektpräfix überschreitet die maximal zulässige Länge von {max_length} Byte. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
OBJECT_PREFIX_INVALID_CHARACTER 400 Das Objektpräfix enthält ein ungültiges Zeilenumbruch- oder Zeilenvorschubzeichen. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
OBJECT_PREFIX_OVERLAP 400 Das Objektpräfix „{prefix_1}“ überschneidet sich mit „{prefix_2}“. Objektpräfixe dürfen keine Präfixe anderer eingeschlossener Präfixe sein. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
DUPLICATE_OBJECT_PREFIX 400 Doppeltes Objektpräfix „{object_prefix}“ in „included_object_prefixes“ gefunden. Entfernen Sie den doppelten Eintrag. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
TOO_MANY_OBJECT_PREFIXES 400 Die „prefix_list“ darf nicht mehr als {max_prefixes} eingeschlossene Objektpräfixe enthalten. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
PROJECT_SOURCE_DRY_RUN_ID_INVALID 400 Die „dry_run_job_id“ ist ungültig. Die Job-ID muss dem Muster [a-z0-9]([-a-z0-9]*[a-z0-9])? entsprechen. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
PROJECT_SOURCE_DRY_RUN_FIELDS_EXCLUSIVE 400 Wenn „dry_run_job_id“ angegeben ist, müssen alle anderen Felder in „ProjectSource“ leer sein. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
PROJECT_SOURCE_PROJECT_INVALID 400 Das Projekt „{project}“ ist ungültig. Das Projekt muss dem Format „projects/{project_number}“ oder „projects/{project_id}“ entsprechen. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
INSIGHTS_DATASET_CONFIG_INVALID 400 Die Konfiguration des Insights-Datasets „{insights_dataset_config}“ ist ungültig. Der Ressourcenname der Konfiguration muss dem Format „projects/{project}/locations/{location}/datasetConfigs/{dataset_config}“ entsprechen. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
TARGET_LOCATIONS_REQUIRED_FOR_SNAPSHOT_TIME 400 Das Feld „locations“ in „target_locations“ muss angegeben werden, wenn „snapshot_time“ angegeben ist. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
TOO_MANY_TARGET_LOCATIONS 400 Die Liste „target_locations“ darf nicht mehr als {max_locations} Speicherorte enthalten. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
CEL_EXPRESSION_TOO_LONG 400 Der Filterausdruck darf nicht länger als {max_length} Byte sein. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
KMS_KEY_INVALID 400 Der KMS-Schlüssel ist ungültig. Der Schlüssel muss dem Format „projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}“ entsprechen. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
REWRITE_OBJECT_MISSING_PARAMETERS 400 Für „RewriteObject“ muss mindestens „storage_class“ oder „kms_key“ angegeben werden. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
PUT_OBJECT_HOLD_MISSING_PARAMETERS 400 Es muss mindestens „temporary_hold“ oder „event_based_hold“ angegeben werden. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
PUT_METADATA_MISSING_PARAMETERS 400 In „PutMetadata“ muss mindestens ein Feld angegeben werden. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
RETAIN_UNTIL_TIME_REQUIRED 400 Das Feld „retain_until_time“ muss im RFC 3339-Format angegeben werden, wenn „retention_mode“ festgelegt ist. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
RETENTION_MODE_REQUIRED 400 Das Feld „retention_mode“ muss auf „LOCKED“ oder „UNLOCKED“ gesetzt sein. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
RETAIN_UNTIL_TIME_INVALID_FORMAT 400 Das Feld „retain_until_time“ muss das Zeitstempelformat RFC 3339 haben (z. B. „2026-12-31T23:59:59Z“). Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
CUSTOM_CONTEXT_KEY_CONFLICT 400 Derselbe Schlüssel kann nicht sowohl in „updates“ als auch in „keys_to_clear“ angegeben werden. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
UPDATE_OBJECT_CUSTOM_CONTEXT_MISSING_ACTION 400 In „UpdateObjectCustomContext“ muss mindestens eine Aktion angegeben werden. Wenn „clear_all“ angegeben ist, muss es auf „true“ gesetzt sein. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
SET_OBJECT_ACLS_MISSING_ACTION 400 In „SetObjectAcls“ muss mindestens „grants“ oder „remove_entities“ angegeben werden. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
UNSUPPORTED_ACL_ENTITY 400 Die Entität „{entity}“ wird nicht unterstützt. Es werden nur „allUsers“ und „allAuthenticatedUsers“ unterstützt. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
ACL_ENTITY_CONFLICT 400 Dieselbe Entität kann nicht sowohl in „grants“ als auch in „remove_entities“ angegeben werden. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
AUTOCLASS_STORAGE_CLASS_TRANSFORMATION_UNSUPPORTED 400 Speicherklassen-Transformationen können nicht für Buckets mit aktivierter Autoclass-Funktion ausgeführt werden. Deaktivieren Sie Autoclass für den Bucket oder entfernen Sie die Speicherklassen-Transformation. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
UBLA_OBJECT_ACL_UPDATE_UNSUPPORTED 400 Access Control Lists (ACLs) für Objekte in einem Bucket mit aktiviertem einheitlichen Zugriff auf Bucket-Ebene können nicht aktualisiert werden. Verwalten Sie den Zugriff stattdessen mit IAM-Berechtigungen. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
BUCKET_DISCOVERY_INSIGHTS_DATASET_NOT_FOUND 404 Bucket-Erkennung konnte nicht ausgeführt werden. Die „insights_dataset_config“ wurde nicht gefunden. Prüfen Sie, ob das Insights-Dataset vorhanden ist und darauf zugegriffen werden kann. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
BUCKET_DISCOVERY_SNAPSHOT_TOO_OLD 400 Bucket-Erkennung konnte nicht ausgeführt werden. Der Zeitpunkt des letzten Dataset-Snapshots liegt mehr als zwei Tage zurück. Prüfen Sie, ob die Dataset-Konfiguration aktiv ist und Snapshots generiert, geben Sie Überschreibungen für „snapshot_time“ und „target_locations“ an oder verwenden Sie stattdessen ein CSV-Manifest. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.
BUCKET_DISCOVERY_TOO_MANY_BUCKETS 400 Bucket-Erkennung konnte nicht ausgeführt werden. Zu viele Buckets gefunden. Es werden nur 1.000 Buckets unterstützt. Weitere Informationen finden Sie in unserer Dokumentation zur Fehlerbehebung.