Storage Batch Operations API Version v1: Error Catalog

Service: storagebatchoperations.googleapis.com

En cas d'erreur, consultez ce catalogue en plus d'utiliser nos bibliothèques clientes. Si vous utilisez vos propres bibliothèques, gardez ce guide à portée de main pour le débogage et la résolution des erreurs. Pour en savoir plus sur la structure des réponses d'erreur, consultez la page Présentation des erreurs.

Codes d'erreur

Le tableau suivant répertorie les codes d'état HTTP et les erreurs associées que vous pouvez rencontrer lorsque vous interagissez avec notre API. Chaque code d'état correspond à un ou plusieurs motifs et descriptions pour vous aider à résoudre et à gérer efficacement les erreurs dans votre application. Dans les descriptions, les variables indiquées par des accolades ({}) représentent des espaces réservés pour les valeurs spécifiques à votre requête.

Motif HTTP Status Code Description
JOB_ID_INVALID 400 L'élément 'job_id' n'est pas valide. L'ID de l'offre d'emploi doit correspondre au format [a-z0-9]([-a-z0-9]*[a-z0-9])?. Pour en savoir plus, consultez notre documentation sur le dépannage.
RESOURCE_NAME_TOO_LONG 400 Le nom de la ressource dépasse la longueur maximale autorisée de {max_length} octets. Pour en savoir plus, consultez notre documentation sur le dépannage.
DESCRIPTION_TOO_LONG 400 La 'description' de l'offre d'emploi dépasse la longueur maximale autorisée de {max_length} octets. Pour en savoir plus, consultez notre documentation sur le dépannage.
SOURCE_NOT_SPECIFIED 400 Une source ('bucket_list' ou 'project_source') doit être spécifiée pour l'offre d'emploi. Pour en savoir plus, consultez notre documentation sur le dépannage.
TRANSFORMATION_NOT_SPECIFIED 400 Une transformation doit être spécifiée pour l'offre d'emploi. Spécifiez exactement une transformation : 'delete_object', 'put_object_hold', 'put_metadata', 'rewrite_object', 'update_object_custom_context', 'set_object_acls' ou 'drop_object_google_context'. Pour en savoir plus, consultez notre documentation sur le dépannage.
BUCKET_LIST_EMPTY 400 L'élément 'bucket_list' ne doit pas être vide. Spécifiez au moins une configuration de bucket. Pour en savoir plus, consultez notre documentation sur le dépannage.
TOO_MANY_BUCKETS 400 L'élément 'bucket_list' ne doit pas dépasser {max_buckets} buckets. Pour en savoir plus, consultez notre documentation sur le dépannage.
BUCKET_NAME_REQUIRED 400 Le champ 'bucket' doit être spécifié dans la configuration du bucket. Pour en savoir plus, consultez notre documentation sur le dépannage.
OBJECT_CONFIGURATION_REQUIRED 400 Une configuration d'objet ('prefix_list', 'manifest' ou 'project_source') doit être spécifiée dans l'opération de bucket. Pour en savoir plus, consultez notre documentation sur le dépannage.
MANIFEST_LOCATION_REQUIRED 400 Le champ 'manifest_location' doit être spécifié. Pour en savoir plus, consultez notre documentation sur le dépannage.
MANIFEST_LOCATION_INVALID 400 L'emplacement du fichier manifeste '{manifest_location}' n'est pas valide. L'emplacement doit respecter le format gs://<bucket_name>/<path>/<object_name>.csv, où <path> est facultatif et <object_name> est suivi de .csv et contient au maximum un caractère générique ('*'). Pour en savoir plus, consultez notre documentation sur le dépannage.
BUCKET_NAME_INVALID 400 Le nom du bucket '{bucket_name}' n'est pas conforme aux exigences de dénomination des bucket Cloud Storage. Pour en savoir plus, consultez notre documentation sur le dépannage.
OBJECT_NAME_INVALID 400 Le nom de l'objet '{object_name}' n'est pas conforme aux exigences de dénomination des objets Cloud Storage. Pour en savoir plus, consultez notre documentation sur le dépannage.
OBJECT_PREFIX_INVALID_UTF8 400 Le préfixe d'objet contient des caractères UTF-8 non valides. Assurez-vous que le préfixe est au format UTF-8 valide. Pour en savoir plus, consultez notre documentation sur le dépannage.
OBJECT_PREFIX_TOO_LONG 400 Le préfixe d'objet dépasse la longueur maximale autorisée de {max_length} octets. Pour en savoir plus, consultez notre documentation sur le dépannage.
OBJECT_PREFIX_INVALID_CHARACTER 400 Le préfixe d'objet contient un caractère de saut de ligne ou de retour chariot non valide. Pour en savoir plus, consultez notre documentation sur le dépannage.
OBJECT_PREFIX_OVERLAP 400 Le préfixe d'objet '{prefix_1}' chevauche '{prefix_2}'. Les préfixes d'objet ne doivent pas être des préfixes d'autres préfixes inclus. Pour en savoir plus, consultez notre documentation sur le dépannage.
DUPLICATE_OBJECT_PREFIX 400 Le préfixe d'objet '{object_prefix}' en double a été trouvé dans 'included_object_prefixes'. Supprimez l'entrée en double. Pour en savoir plus, consultez notre documentation sur le dépannage.
TOO_MANY_OBJECT_PREFIXES 400 L'élément 'prefix_list' ne doit pas dépasser {max_prefixes} préfixes d'objet inclus. Pour en savoir plus, consultez notre documentation sur le dépannage.
PROJECT_SOURCE_DRY_RUN_ID_INVALID 400 L'élément 'dry_run_job_id' n'est pas valide. L'ID de l'offre d'emploi doit correspondre au format [a-z0-9]([-a-z0-9]*[a-z0-9])?. Pour en savoir plus, consultez notre documentation sur le dépannage.
PROJECT_SOURCE_DRY_RUN_FIELDS_EXCLUSIVE 400 Lorsque 'dry_run_job_id' est spécifié, tous les autres champs de 'ProjectSource' doivent être vides. Pour en savoir plus, consultez notre documentation sur le dépannage.
PROJECT_SOURCE_PROJECT_INVALID 400 Le projet '{project}' n'est pas valide. Le projet doit respecter le format 'projects/{project_number}' ou 'projects/{project_id}'. Pour en savoir plus, consultez notre documentation sur le dépannage.
INSIGHTS_DATASET_CONFIG_INVALID 400 La configuration de l'ensemble de données Insights '{insights_dataset_config}' n'est pas valide. Le nom de la ressource de configuration doit respecter le format 'projects/{project}/locations/{location}/datasetConfigs/{dataset_config}'. Pour en savoir plus, consultez notre documentation sur le dépannage.
TARGET_LOCATIONS_REQUIRED_FOR_SNAPSHOT_TIME 400 Le champ 'locations' de 'target_locations' doit être spécifié lorsque 'snapshot_time' est fourni. Pour en savoir plus, consultez notre documentation sur le dépannage.
TOO_MANY_TARGET_LOCATIONS 400 La liste 'target_locations' ne doit pas dépasser {max_locations} emplacements. Pour en savoir plus, consultez notre documentation sur le dépannage.
CEL_EXPRESSION_TOO_LONG 400 L'expression de filtre ne doit pas dépasser {max_length} octets. Pour en savoir plus, consultez notre documentation sur le dépannage.
KMS_KEY_INVALID 400 La clé KMS n'est pas valide. La clé doit respecter le format 'projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}'. Pour en savoir plus, consultez notre documentation sur le dépannage.
REWRITE_OBJECT_MISSING_PARAMETERS 400 Au moins l'un des éléments 'storage_class' ou 'kms_key' doit être spécifié pour 'RewriteObject'. Pour en savoir plus, consultez notre documentation sur le dépannage.
PUT_OBJECT_HOLD_MISSING_PARAMETERS 400 Au moins l'un des éléments 'temporary_hold' ou 'event_based_hold' doit être spécifié. Pour en savoir plus, consultez notre documentation sur le dépannage.
PUT_METADATA_MISSING_PARAMETERS 400 Au moins un champ de 'PutMetadata' doit être spécifié. Pour en savoir plus, consultez notre documentation sur le dépannage.
RETAIN_UNTIL_TIME_REQUIRED 400 Le champ 'retain_until_time' doit être spécifié au format RFC 3339 lorsque 'retention_mode' est défini. Pour en savoir plus, consultez notre documentation sur le dépannage.
RETENTION_MODE_REQUIRED 400 Le champ 'retention_mode' doit être défini sur 'LOCKED' ou 'UNLOCKED'. Pour en savoir plus, consultez notre documentation sur le dépannage.
RETAIN_UNTIL_TIME_INVALID_FORMAT 400 Le champ 'retain_until_time' doit être au format d'horodatage RFC 3339 (par exemple, '2026-12-31T23:59:59Z'). Pour en savoir plus, consultez notre documentation sur le dépannage.
CUSTOM_CONTEXT_KEY_CONFLICT 400 La même clé ne peut pas être spécifiée à la fois dans 'updates' et 'keys_to_clear'. Pour en savoir plus, consultez notre documentation sur le dépannage.
UPDATE_OBJECT_CUSTOM_CONTEXT_MISSING_ACTION 400 Au moins une action de 'UpdateObjectCustomContext' doit être spécifiée. Si 'clear_all' est spécifié, il doit être défini sur "true". Pour en savoir plus, consultez notre documentation sur le dépannage.
SET_OBJECT_ACLS_MISSING_ACTION 400 Au moins l'un des éléments 'grants' ou 'remove_entities' doit être spécifié dans 'SetObjectAcls'. Pour en savoir plus, consultez notre documentation sur le dépannage.
UNSUPPORTED_ACL_ENTITY 400 L'entité '{entity}' n'est pas compatible. Seuls 'allUsers' et 'allAuthenticatedUsers' sont compatibles. Pour en savoir plus, consultez notre documentation sur le dépannage.
ACL_ENTITY_CONFLICT 400 La même entité ne peut pas être spécifiée à la fois dans 'grants' et 'remove_entities'. Pour en savoir plus, consultez notre documentation sur le dépannage.
AUTOCLASS_STORAGE_CLASS_TRANSFORMATION_UNSUPPORTED 400 Les transformations de classe de stockage ne peuvent pas être effectuées sur les buckets pour lesquels la classe automatique est activée. Désactivez la classe automatique sur le bucket ou supprimez la transformation de classe de stockage. Pour en savoir plus, consultez notre documentation sur le dépannage.
UBLA_OBJECT_ACL_UPDATE_UNSUPPORTED 400 Vous ne pouvez pas mettre à jour les listes de contrôle des accès (LCA) pour les objets d'un bucket pour lequel l'accès uniforme au niveau du bucket est activé. Gérez plutôt l'accès à l'aide des autorisations IAM. Pour en savoir plus, consultez notre documentation sur le dépannage.
BUCKET_DISCOVERY_INSIGHTS_DATASET_NOT_FOUND 404 Échec de l'opération de découverte de bucket. L'élément 'insights_dataset_config' est introuvable. Vérifiez que l'ensemble de données Insights existe et qu'il est accessible. Pour en savoir plus, consultez notre documentation sur le dépannage.
BUCKET_DISCOVERY_SNAPSHOT_TOO_OLD 400 Échec de l'opération de découverte de bucket. L'heure du dernier instantané de l'ensemble de données remonte à plus de deux jours. Vérifiez que la configuration de l'ensemble de données est active et génère des instantanés, spécifiez des remplacements pour 'snapshot_time' et 'target_locations', ou utilisez plutôt un fichier manifeste CSV. Pour en savoir plus, consultez notre documentation sur le dépannage.
BUCKET_DISCOVERY_TOO_MANY_BUCKETS 400 Échec de l'opération de découverte de bucket. Trop de buckets ont été découverts. Seuls 1 000 buckets sont compatibles. Pour en savoir plus, consultez notre documentation sur le dépannage.