Storage Batch Operations API Version v1: Error Catalog

Serviço: storagebatchoperations.googleapis.com

Ao enfrentar erros, consulte este catálogo e use nossas bibliotecas de cliente. Se você estiver usando suas próprias bibliotecas, mantenha este guia à mão para depuração e resolução de erros. Para saber mais sobre a estrutura de resposta de erro, acesse a página de visão geral de erros.

Códigos de erro

A tabela a seguir lista os códigos de status HTTP e os erros associados que podem ocorrer ao interagir com nossa API. Cada código de status corresponde a um ou mais motivos e descrições para ajudar você a resolver e processar erros de maneira eficaz no aplicativo. Nas descrições, as variáveis indicadas por chaves ({}) representam marcadores de posição para valores específicos da sua solicitação.

Motivo Código de status HTTP Descrição
JOB_ID_INVALID 400 O "job_id" é inválido. O ID do job precisa corresponder ao padrão [a-z0-9]([-a-z0-9]*[a-z0-9])?. Para mais informações, consulte nossa documentação de solução de problemas.
RESOURCE_NAME_TOO_LONG 400 O nome do recurso excede o tamanho máximo permitido de {max_length} bytes. Para mais informações, consulte nossa documentação de solução de problemas.
DESCRIPTION_TOO_LONG 400 A "description" do job excede o tamanho máximo permitido de {max_length} bytes. Para mais informações, consulte nossa documentação de solução de problemas.
SOURCE_NOT_SPECIFIED 400 Uma origem ("bucket_list" ou "project_source") precisa ser especificada para o job. Para mais informações, consulte nossa documentação de solução de problemas.
TRANSFORMATION_NOT_SPECIFIED 400 Uma transformação precisa ser especificada para o job. Especifique exatamente uma transformação: "delete_object", "put_object_hold", "put_metadata", "rewrite_object", "update_object_custom_context", "set_object_acls" ou "drop_object_google_context". Para mais informações, consulte nossa documentação de solução de problemas.
BUCKET_LIST_EMPTY 400 A "bucket_list" não pode estar vazia. Especifique pelo menos uma configuração de bucket. Para mais informações, consulte nossa documentação de solução de problemas.
TOO_MANY_BUCKETS 400 A "bucket_list" não pode exceder {max_buckets} buckets. Para mais informações, consulte nossa documentação de solução de problemas.
BUCKET_NAME_REQUIRED 400 O campo "bucket" precisa ser especificado na configuração do bucket. Para mais informações, consulte nossa documentação de solução de problemas.
OBJECT_CONFIGURATION_REQUIRED 400 Uma configuração de objeto ("prefix_list", "manifest" ou "project_source") precisa ser especificada na operação do bucket. Para mais informações, consulte nossa documentação de solução de problemas.
MANIFEST_LOCATION_REQUIRED 400 O campo "manifest_location" precisa ser especificado. Para mais informações, consulte nossa documentação de solução de problemas.
MANIFEST_LOCATION_INVALID 400 O local do manifesto "{manifest_location}" é inválido. O local precisa seguir o formato gs://<bucket_name>/<path>/<object_name>.csv, em que <path> é opcional e <object_name> é seguido por .csv e contém no máximo um caractere curinga ('*'). Para mais informações, consulte nossa documentação de solução de problemas.
BUCKET_NAME_INVALID 400 O nome do bucket "{bucket_name}" não está em conformidade com os requisitos de nomenclatura de bucket do Cloud Storage. Para mais informações, consulte nossa documentação de solução de problemas.
OBJECT_NAME_INVALID 400 O nome do objeto "{object_name}" não está em conformidade com os requisitos de nomenclatura de objeto do Cloud Storage. Para mais informações, consulte nossa documentação de solução de problemas.
OBJECT_PREFIX_INVALID_UTF8 400 O prefixo do objeto contém caracteres UTF-8 inválidos. Verifique se o prefixo é UTF-8 válido. Para mais informações, consulte nossa documentação de solução de problemas.
OBJECT_PREFIX_TOO_LONG 400 O prefixo do objeto excede o tamanho máximo permitido de {max_length} bytes. Para mais informações, consulte nossa documentação de solução de problemas.
OBJECT_PREFIX_INVALID_CHARACTER 400 O prefixo do objeto contém um caractere de nova linha ou retorno de carro inválido. Para mais informações, consulte nossa documentação de solução de problemas.
OBJECT_PREFIX_OVERLAP 400 O prefixo do objeto "{prefix_1}" se sobrepõe a "{prefix_2}". Os prefixos de objeto não podem ser prefixos de outros prefixos incluídos. Para mais informações, consulte nossa documentação de solução de problemas.
DUPLICATE_OBJECT_PREFIX 400 O prefixo de objeto duplicado "{object_prefix}" foi encontrado em "included_object_prefixes". Remova a entrada duplicada. Para mais informações, consulte nossa documentação de solução de problemas.
TOO_MANY_OBJECT_PREFIXES 400 A "prefix_list" não pode exceder {max_prefixes} prefixos de objeto incluídos. Para mais informações, consulte nossa documentação de solução de problemas.
PROJECT_SOURCE_DRY_RUN_ID_INVALID 400 O "dry_run_job_id" é inválido. O ID do job precisa corresponder ao padrão [a-z0-9]([-a-z0-9]*[a-z0-9])?. Para mais informações, consulte nossa documentação de solução de problemas.
PROJECT_SOURCE_DRY_RUN_FIELDS_EXCLUSIVE 400 Quando "dry_run_job_id" é especificado, todos os outros campos em "ProjectSource" precisam estar vazios. Para mais informações, consulte nossa documentação de solução de problemas.
PROJECT_SOURCE_PROJECT_INVALID 400 O projeto "{project}" é inválido. O projeto precisa seguir o formato "projects/{project_number}" ou "projects/{project_id}". Para mais informações, consulte nossa documentação de solução de problemas.
INSIGHTS_DATASET_CONFIG_INVALID 400 A configuração do conjunto de dados de insights "{insights_dataset_config}" é inválida. O nome do recurso de configuração precisa seguir o formato "projects/{project}/locations/{location}/datasetConfigs/{dataset_config}". Para mais informações, consulte nossa documentação de solução de problemas.
TARGET_LOCATIONS_REQUIRED_FOR_SNAPSHOT_TIME 400 O campo "locations" em "target_locations" precisa ser especificado quando "snapshot_time" é fornecido. Para mais informações, consulte nossa documentação de solução de problemas.
TOO_MANY_TARGET_LOCATIONS 400 A lista "target_locations" não pode exceder {max_locations} locais. Para mais informações, consulte nossa documentação de solução de problemas.
CEL_EXPRESSION_TOO_LONG 400 A expressão de filtro não pode exceder {max_length} bytes. Para mais informações, consulte nossa documentação de solução de problemas.
KMS_KEY_INVALID 400 A chave KMS é inválida. A chave precisa seguir o formato "projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}". Para mais informações, consulte nossa documentação de solução de problemas.
REWRITE_OBJECT_MISSING_PARAMETERS 400 Pelo menos um de "storage_class" ou "kms_key" precisa ser especificado para "RewriteObject". Para mais informações, consulte nossa documentação de solução de problemas.
PUT_OBJECT_HOLD_MISSING_PARAMETERS 400 Pelo menos um de "temporary_hold" ou "event_based_hold" precisa ser especificado. Para mais informações, consulte nossa documentação de solução de problemas.
PUT_METADATA_MISSING_PARAMETERS 400 Pelo menos um campo em "PutMetadata" precisa ser especificado. Para mais informações, consulte nossa documentação de solução de problemas.
RETAIN_UNTIL_TIME_REQUIRED 400 O campo "retain_until_time" precisa ser especificado no formato RFC 3339 quando "retention_mode" é definido. Para mais informações, consulte nossa documentação de solução de problemas.
RETENTION_MODE_REQUIRED 400 O campo "retention_mode" precisa ser definido como "LOCKED" ou "UNLOCKED". Para mais informações, consulte nossa documentação de solução de problemas.
RETAIN_UNTIL_TIME_INVALID_FORMAT 400 O campo "retain_until_time" precisa estar no formato de carimbo de data/hora RFC 3339 (por exemplo, "2026-12-31T23:59:59Z"). Para mais informações, consulte nossa documentação de solução de problemas.
CUSTOM_CONTEXT_KEY_CONFLICT 400 A mesma chave não pode ser especificada em "updates" e "keys_to_clear". Para mais informações, consulte nossa documentação de solução de problemas.
UPDATE_OBJECT_CUSTOM_CONTEXT_MISSING_ACTION 400 Pelo menos uma ação em "UpdateObjectCustomContext" precisa ser especificada. Se "clear_all" for especificado, ele precisará ser definido como verdadeiro. Para mais informações, consulte nossa documentação de solução de problemas.
SET_OBJECT_ACLS_MISSING_ACTION 400 Pelo menos um de "grants" ou "remove_entities" precisa ser especificado em "SetObjectAcls". Para mais informações, consulte nossa documentação de solução de problemas.
UNSUPPORTED_ACL_ENTITY 400 A entidade "{entity}" não é compatível. Somente "allUsers" e "allAuthenticatedUsers" são aceitos. Para mais informações, consulte nossa documentação de solução de problemas.
ACL_ENTITY_CONFLICT 400 A mesma entidade não pode ser especificada em "grants" e "remove_entities". Para mais informações, consulte nossa documentação de solução de problemas.
AUTOCLASS_STORAGE_CLASS_TRANSFORMATION_UNSUPPORTED 400 As transformações de classe de armazenamento não podem ser realizadas em buckets ativados pela classe automática. Desative a classe automática no bucket ou remova a transformação da classe de armazenamento. Para mais informações, consulte nossa documentação de solução de problemas.
UBLA_OBJECT_ACL_UPDATE_UNSUPPORTED 400 Não é possível atualizar as listas de controle de acesso (ACLs) para objetos em um bucket com acesso uniforme no nível do bucket ativado. Gerencie o acesso usando as permissões do IAM. Para mais informações, consulte nossa documentação de solução de problemas.
BUCKET_DISCOVERY_INSIGHTS_DATASET_NOT_FOUND 404 Falha ao realizar a descoberta de buckets. Não foi possível encontrar a "insights_dataset_config". Verifique se o conjunto de dados de insights existe e se é acessível. Para mais informações, consulte nossa documentação de solução de problemas.
BUCKET_DISCOVERY_SNAPSHOT_TOO_OLD 400 Falha ao realizar a descoberta de buckets. O horário do snapshot mais recente do conjunto de dados é anterior a dois dias. Verifique se a configuração do conjunto de dados está ativa e gerando snapshots, especifique substituições de "snapshot_time" e "target_locations" ou use um manifesto CSV. Para mais informações, consulte nossa documentação de solução de problemas.
BUCKET_DISCOVERY_TOO_MANY_BUCKETS 400 Falha ao realizar a descoberta de buckets. Muitos buckets descobertos. Há suporte apenas para 1.000 buckets. Para mais informações, consulte nossa documentação de solução de problemas.