Servicio: storagebatchoperations.googleapis.com
Cuando te enfrentes a errores, consulta este catálogo junto con el uso de nuestras bibliotecas cliente. Si usas tus propias bibliotecas, ten a mano esta guía para la depuración y la resolución de errores. Para obtener más información sobre la estructura de respuesta de errores, visita la página de descripción general de errores.
Códigos de error
En la siguiente tabla, se enumeran los códigos de estado HTTP y los errores asociados que puedes encontrar cuando interactúas con nuestra API. Cada código de estado corresponde a uno o más motivos y descripciones para ayudarte a solucionar problemas y controlar errores de manera eficaz en tu aplicación. En las descripciones, las variables que se indican con llaves ({}) representan marcadores de posición para valores que son específicos de tu solicitud.
| Motivo | Código de estado HTTP | Descripción |
|---|---|---|
JOB_ID_INVALID |
400 |
El "job_id" no es válido. El ID de trabajo debe coincidir con el patrón [a-z0-9]([-a-z0-9]*[a-z0-9])?. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
RESOURCE_NAME_TOO_LONG |
400 |
El nombre del recurso supera la longitud máxima permitida de {max_length} bytes. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
DESCRIPTION_TOO_LONG |
400 |
La "description" del trabajo supera la longitud máxima permitida de {max_length} bytes. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
SOURCE_NOT_SPECIFIED |
400 |
Se debe especificar una fuente ("bucket_list" o "project_source") para el trabajo. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
TRANSFORMATION_NOT_SPECIFIED |
400 |
Se debe especificar una transformación para el trabajo. Especifica exactamente una transformación: "delete_object", "put_object_hold", "put_metadata", "rewrite_object", "update_object_custom_context", "set_object_acls" o "drop_object_google_context". Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
BUCKET_LIST_EMPTY |
400 |
La "bucket_list" no debe estar vacía. Especifica al menos una configuración de bucket. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
TOO_MANY_BUCKETS |
400 |
La "bucket_list" no debe superar los {max_buckets} buckets. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
BUCKET_NAME_REQUIRED |
400 |
Se debe especificar el campo "bucket" en la configuración del bucket. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
OBJECT_CONFIGURATION_REQUIRED |
400 |
Se debe especificar una configuración de objeto ("prefix_list", "manifest" o "project_source") en la operación del bucket. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
MANIFEST_LOCATION_REQUIRED |
400 |
Se debe especificar el campo "manifest_location". Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
MANIFEST_LOCATION_INVALID |
400 |
La ubicación del manifiesto "{manifest_location}" no es válida. La ubicación debe seguir el formato gs://<bucket_name>/<path>/<object_name>.csv, en el que <path> es opcional y <object_name> está seguido de .csv y contiene como máximo un carácter comodín ("*"). Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
BUCKET_NAME_INVALID |
400 |
El nombre del bucket "{bucket_name}" no cumple con los requisitos de nombres de bucket de Cloud Storage. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
OBJECT_NAME_INVALID |
400 |
El nombre del objeto "{object_name}" no cumple con los requisitos de nombres de objetos de Cloud Storage. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
OBJECT_PREFIX_INVALID_UTF8 |
400 |
El prefijo del objeto contiene caracteres UTF-8 no válidos. Asegúrate de que el prefijo sea UTF-8 válido. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
OBJECT_PREFIX_TOO_LONG |
400 |
El prefijo del objeto supera la longitud máxima permitida de {max_length} bytes. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
OBJECT_PREFIX_INVALID_CHARACTER |
400 |
El prefijo del objeto contiene un carácter de salto de línea o retorno de carro no válido. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
OBJECT_PREFIX_OVERLAP |
400 |
El prefijo del objeto "{prefix_1}" se superpone con "{prefix_2}". Los prefijos de objeto no deben ser prefijos de otros prefijos incluidos. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
DUPLICATE_OBJECT_PREFIX |
400 |
Se encontró el prefijo de objeto duplicado "{object_prefix}" en "included_object_prefixes". Quita la entrada duplicada. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
TOO_MANY_OBJECT_PREFIXES |
400 |
La "prefix_list" no debe superar los {max_prefixes} prefijos de objeto incluidos. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
PROJECT_SOURCE_DRY_RUN_ID_INVALID |
400 |
El "dry_run_job_id" no es válido. El ID de trabajo debe coincidir con el patrón [a-z0-9]([-a-z0-9]*[a-z0-9])?. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
PROJECT_SOURCE_DRY_RUN_FIELDS_EXCLUSIVE |
400 |
Cuando se especifica "dry_run_job_id", todos los demás campos de "ProjectSource" deben estar vacíos. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
PROJECT_SOURCE_PROJECT_INVALID |
400 |
El proyecto "{project}" no es válido. El proyecto debe seguir el formato "projects/{project_number}" o "projects/{project_id}". Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
INSIGHTS_DATASET_CONFIG_INVALID |
400 |
La configuración del conjunto de datos de estadísticas "{insights_dataset_config}" no es válida. El nombre del recurso de configuración debe seguir el formato "projects/{project}/locations/{location}/datasetConfigs/{dataset_config}". Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
TARGET_LOCATIONS_REQUIRED_FOR_SNAPSHOT_TIME |
400 |
Se debe especificar el campo "locations" en "target_locations" cuando se proporciona "snapshot_time". Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
TOO_MANY_TARGET_LOCATIONS |
400 |
La lista "target_locations" no debe superar las {max_locations} ubicaciones. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
CEL_EXPRESSION_TOO_LONG |
400 |
La expresión de filtro no debe superar los {max_length} bytes. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
KMS_KEY_INVALID |
400 |
La clave KMS no es válida. La clave debe seguir el formato "projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}". Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
REWRITE_OBJECT_MISSING_PARAMETERS |
400 |
Se debe especificar al menos uno de "storage_class" o "kms_key" para "RewriteObject". Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
PUT_OBJECT_HOLD_MISSING_PARAMETERS |
400 |
Se debe especificar al menos uno de "temporary_hold" o "event_based_hold". Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
PUT_METADATA_MISSING_PARAMETERS |
400 |
Se debe especificar al menos un campo en "PutMetadata". Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
RETAIN_UNTIL_TIME_REQUIRED |
400 |
Se debe especificar el campo "retain_until_time" en formato RFC 3339 cuando se establece "retention_mode". Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
RETENTION_MODE_REQUIRED |
400 |
El campo "retention_mode" debe establecerse en "LOCKED" o "UNLOCKED". Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
RETAIN_UNTIL_TIME_INVALID_FORMAT |
400 |
El campo "retain_until_time" debe estar en formato de marca de tiempo RFC 3339 (por ejemplo, "2026-12-31T23:59:59Z"). Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
CUSTOM_CONTEXT_KEY_CONFLICT |
400 |
No se puede especificar la misma clave en "updates" y "keys_to_clear". Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
UPDATE_OBJECT_CUSTOM_CONTEXT_MISSING_ACTION |
400 |
Se debe especificar al menos una acción en "UpdateObjectCustomContext". Si se especifica "clear_all", se debe establecer en verdadero. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
SET_OBJECT_ACLS_MISSING_ACTION |
400 |
Se debe especificar al menos uno de "grants" o "remove_entities" en "SetObjectAcls". Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
UNSUPPORTED_ACL_ENTITY |
400 |
La entidad "{entity}" no es compatible. Solo se admiten "allUsers" y "allAuthenticatedUsers". Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
ACL_ENTITY_CONFLICT |
400 |
No se puede especificar la misma entidad en "grants" y "remove_entities". Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
AUTOCLASS_STORAGE_CLASS_TRANSFORMATION_UNSUPPORTED |
400 |
Las transformaciones de clase de almacenamiento no se pueden realizar en buckets habilitados para Autoclass. Inhabilita Autoclass en el bucket o quita la transformación de clase de almacenamiento. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
UBLA_OBJECT_ACL_UPDATE_UNSUPPORTED |
400 |
No se pueden actualizar las listas de control de acceso (LCA) para objetos en un bucket con el control de acceso uniforme a nivel de bucket habilitado. En su lugar, administra el acceso con permisos de IAM. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
BUCKET_DISCOVERY_INSIGHTS_DATASET_NOT_FOUND |
404 |
No se pudo realizar la detección de bucket. No se puede encontrar el "insights_dataset_config". Verifica que el conjunto de datos de estadísticas exista y sea accesible. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
BUCKET_DISCOVERY_SNAPSHOT_TOO_OLD |
400 |
No se pudo realizar la detección de bucket. La hora de la instantánea del conjunto de datos más reciente es anterior a 2 días. Verifica que la configuración del conjunto de datos esté activa y genere instantáneas, especifica anulaciones de "snapshot_time" y "target_locations", o usa un manifiesto CSV en su lugar. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |
BUCKET_DISCOVERY_TOO_MANY_BUCKETS |
400 |
No se pudo realizar la detección de bucket. Se detectaron demasiados buckets. Solo se admiten 1,000 buckets. Para obtener más información, consulta nuestra documentación sobre solución de problemas. |