Storage Batch Operations API Version v1: Error Catalog

Servizio: storagebatchoperations.googleapis.com

Quando riscontri errori, consulta questo catalogo insieme alle nostre librerie client. Se utilizzi le tue librerie, tieni a portata di mano questa guida per il debug e la risoluzione degli errori. Per saperne di più sulla struttura della risposta di errore, visita la pagina di panoramica degli errori.

Codici di errore

La tabella seguente elenca i codici di stato HTTP e gli errori associati che potresti riscontrare quando interagisci con la nostra API. Ogni codice di stato corrisponde a uno o più motivi e descrizioni per aiutarti a risolvere e gestire gli errori in modo efficace nella tua applicazione. Nelle descrizioni, le variabili indicate tra parentesi graffe ({}) rappresentano segnaposto per valori specifici della tua richiesta.

Motivo Codice di stato HTTP Descrizione
JOB_ID_INVALID 400 L'ID job non è valido. L'ID job deve corrispondere al pattern [a-z0-9]([-a-z0-9]*[a-z0-9])?. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
RESOURCE_NAME_TOO_LONG 400 Il nome della risorsa supera la lunghezza massima consentita di {max_length} byte. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
DESCRIPTION_TOO_LONG 400 La "descrizione" del job supera la lunghezza massima consentita di {max_length} byte. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
SOURCE_NOT_SPECIFIED 400 Per il job deve essere specificata un'origine ("bucket_list" o "project_source"). Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
TRANSFORMATION_NOT_SPECIFIED 400 Per il job deve essere specificata una trasformazione. Specifica esattamente una trasformazione: "delete_object", "put_object_hold", "put_metadata", "rewrite_object", "update_object_custom_context", "set_object_acls" o "drop_object_google_context". Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
BUCKET_LIST_EMPTY 400 L'elenco "bucket_list" non deve essere vuoto. Specifica almeno una configurazione del bucket. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
TOO_MANY_BUCKETS 400 L'elenco "bucket_list" non deve superare i {max_buckets} bucket. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
BUCKET_NAME_REQUIRED 400 Il campo "bucket" deve essere specificato nella configurazione del bucket. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
OBJECT_CONFIGURATION_REQUIRED 400 Nell'operazione del bucket deve essere specificata una configurazione dell'oggetto ("prefix_list", "manifest" o "project_source"). Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
MANIFEST_LOCATION_REQUIRED 400 Il campo "manifest_location" deve essere specificato. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
MANIFEST_LOCATION_INVALID 400 La posizione del manifest "{manifest_location}" non è valida. La posizione deve seguire il formato gs://<bucket_name>/<path>/<object_name>.csv, dove <path> è facoltativo e <object_name> è seguito da .csv e contiene al massimo un carattere jolly ("*"). Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
BUCKET_NAME_INVALID 400 Il nome del bucket "{bucket_name}" non è conforme ai requisiti di denominazione dei bucket Cloud Storage. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
OBJECT_NAME_INVALID 400 Il nome dell'oggetto "{object_name}" non è conforme ai requisiti di denominazione degli oggetti Cloud Storage. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
OBJECT_PREFIX_INVALID_UTF8 400 Il prefisso dell'oggetto contiene caratteri UTF-8 non validi. Assicurati che il prefisso sia in formato UTF-8 valido. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
OBJECT_PREFIX_TOO_LONG 400 Il prefisso dell'oggetto supera la lunghezza massima consentita di {max_length} byte. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
OBJECT_PREFIX_INVALID_CHARACTER 400 Il prefisso dell'oggetto contiene un carattere di nuova riga o di ritorno a capo non valido. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
OBJECT_PREFIX_OVERLAP 400 Il prefisso dell'oggetto "{prefix_1}" si sovrappone a "{prefix_2}". I prefissi degli oggetti non devono essere prefissi di altri prefissi inclusi. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
DUPLICATE_OBJECT_PREFIX 400 Trovato il prefisso dell'oggetto duplicato "{object_prefix}" in "included_object_prefixes". Rimuovi la voce duplicata. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
TOO_MANY_OBJECT_PREFIXES 400 L'elenco "prefix_list" non deve superare i {max_prefixes} prefissi degli oggetti inclusi. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
PROJECT_SOURCE_DRY_RUN_ID_INVALID 400 L'ID "dry_run_job_id" non è valido. L'ID job deve corrispondere al pattern [a-z0-9]([-a-z0-9]*[a-z0-9])?. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
PROJECT_SOURCE_DRY_RUN_FIELDS_EXCLUSIVE 400 Quando viene specificato "dry_run_job_id", tutti gli altri campi in "ProjectSource" devono essere vuoti. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
PROJECT_SOURCE_PROJECT_INVALID 400 Il progetto "{project}" non è valido. Il progetto deve seguire il formato "projects/{project_number}" o "projects/{project_id}". Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
INSIGHTS_DATASET_CONFIG_INVALID 400 La configurazione del set di dati di Insights "{insights_dataset_config}" non è valida. Il nome della risorsa di configurazione deve seguire il formato "projects/{project}/locations/{location}/datasetConfigs/{dataset_config}". Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
TARGET_LOCATIONS_REQUIRED_FOR_SNAPSHOT_TIME 400 Il campo "locations" in "target_locations" deve essere specificato quando viene fornito "snapshot_time". Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
TOO_MANY_TARGET_LOCATIONS 400 L'elenco "target_locations" non deve superare le {max_locations} località. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
CEL_EXPRESSION_TOO_LONG 400 L'espressione di filtro non deve superare i {max_length} byte. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
KMS_KEY_INVALID 400 La chiave KMS non è valida. La chiave deve seguire il formato "projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}". Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
REWRITE_OBJECT_MISSING_PARAMETERS 400 Per "RewriteObject" deve essere specificato almeno uno tra "storage_class" o "kms_key". Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
PUT_OBJECT_HOLD_MISSING_PARAMETERS 400 Deve essere specificato almeno uno tra "temporary_hold" o "event_based_hold". Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
PUT_METADATA_MISSING_PARAMETERS 400 In "PutMetadata" deve essere specificato almeno un campo. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
RETAIN_UNTIL_TIME_REQUIRED 400 Il campo "retain_until_time" deve essere specificato nel formato RFC 3339 quando è impostato "retention_mode". Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
RETENTION_MODE_REQUIRED 400 Il campo "retention_mode" deve essere impostato su "LOCKED" o "UNLOCKED". Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
RETAIN_UNTIL_TIME_INVALID_FORMAT 400 Il campo "retain_until_time" deve essere nel formato timestamp RFC 3339 (ad esempio "2026-12-31T23:59:59Z"). Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
CUSTOM_CONTEXT_KEY_CONFLICT 400 La stessa chiave non può essere specificata sia in "updates" che in "keys_to_clear". Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
UPDATE_OBJECT_CUSTOM_CONTEXT_MISSING_ACTION 400 In "UpdateObjectCustomContext" deve essere specificata almeno un'azione. Se viene specificato "clear_all", deve essere impostato su true. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
SET_OBJECT_ACLS_MISSING_ACTION 400 In "SetObjectAcls" deve essere specificato almeno uno tra "grants" o "remove_entities". Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
UNSUPPORTED_ACL_ENTITY 400 L'entità "{entity}" non è supportata. Sono supportati solo "allUsers" e "allAuthenticatedUsers". Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
ACL_ENTITY_CONFLICT 400 La stessa entità non può essere specificata sia in "grants" che in "remove_entities". Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
AUTOCLASS_STORAGE_CLASS_TRANSFORMATION_UNSUPPORTED 400 Le trasformazioni della classe di archiviazione non possono essere eseguite sui bucket abilitati per Autoclass. Disattiva Autoclass sul bucket o rimuovi la trasformazione della classe di archiviazione. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
UBLA_OBJECT_ACL_UPDATE_UNSUPPORTED 400 Non è possibile aggiornare gli elenchi di controllo dell'accesso (ACL) per gli oggetti in un bucket con il controllo di accesso uniforme a livello di bucket abilitato. Gestisci l'accesso utilizzando le autorizzazioni IAM. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
BUCKET_DISCOVERY_INSIGHTS_DATASET_NOT_FOUND 404 Impossibile eseguire il rilevamento dei bucket. Impossibile trovare "insights_dataset_config". Verifica che il set di dati di Insights esista e sia accessibile. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
BUCKET_DISCOVERY_SNAPSHOT_TOO_OLD 400 Impossibile eseguire il rilevamento dei bucket. L'ora dell'ultimo snapshot del set di dati è precedente a 2 giorni. Verifica che la configurazione del set di dati sia attiva e generi snapshot, specifica le sostituzioni "snapshot_time" e "target_locations" o utilizza un manifest CSV. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.
BUCKET_DISCOVERY_TOO_MANY_BUCKETS 400 Impossibile eseguire il rilevamento dei bucket. Sono stati rilevati troppi bucket. Sono supportati solo 1000 bucket. Per ulteriori informazioni, consulta la documentazione sulla risoluzione dei problemi.