Storage Batch Operations API Version v1: Error Catalog

Layanan: storagebatchoperations.googleapis.com

Saat menghadapi error, lihat katalog ini bersama dengan penggunaan library klien kami. Jika Anda menggunakan library sendiri, simpan panduan ini untuk proses debug dan penyelesaian error. Untuk mengetahui struktur respons error, buka halaman ringkasan error.

Kode error

Tabel berikut mencantumkan kode status HTTP dan error terkait yang mungkin Anda temui saat berinteraksi dengan API kami. Setiap kode status sesuai dengan satu atau beberapa alasan dan deskripsi untuk membantu Anda memecahkan masalah dan menangani error secara efektif di aplikasi Anda. Dalam deskripsi, variabel yang ditandai dengan tanda kurung kurawal ({}) mewakili placeholder untuk nilai yang khusus untuk permintaan Anda.

Alasan Kode Status HTTP Deskripsi
JOB_ID_INVALID 400 'job_id' tidak valid. ID tugas harus sesuai dengan pola [a-z0-9]([-a-z0-9]*[a-z0-9])?. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
RESOURCE_NAME_TOO_LONG 400 Nama resource melebihi panjang maksimum yang diizinkan, yaitu {max_length} byte. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
DESCRIPTION_TOO_LONG 400 'description' tugas melebihi panjang maksimum yang diizinkan, yaitu {max_length} byte. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
SOURCE_NOT_SPECIFIED 400 Sumber ('bucket_list' atau 'project_source') harus ditentukan untuk tugas. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
TRANSFORMATION_NOT_SPECIFIED 400 Transformasi harus ditentukan untuk tugas. Tentukan tepat satu transformasi: 'delete_object', 'put_object_hold', 'put_metadata', 'rewrite_object', 'update_object_custom_context', 'set_object_acls', atau 'drop_object_google_context'. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
BUCKET_LIST_EMPTY 400 'bucket_list' tidak boleh kosong. Tentukan minimal satu konfigurasi bucket. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
TOO_MANY_BUCKETS 400 'bucket_list' tidak boleh melebihi {max_buckets} bucket. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
BUCKET_NAME_REQUIRED 400 Kolom 'bucket' harus ditentukan dalam konfigurasi bucket. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
OBJECT_CONFIGURATION_REQUIRED 400 Konfigurasi objek ('prefix_list', 'manifest', atau 'project_source') harus ditentukan dalam operasi bucket. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
MANIFEST_LOCATION_REQUIRED 400 Kolom 'manifest_location' harus ditentukan. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
MANIFEST_LOCATION_INVALID 400 Lokasi manifes '{manifest_location}' tidak valid. Lokasi harus mengikuti format gs://<bucket_name>/<path>/<object_name>.csv dengan <path> bersifat opsional dan <object_name> diikuti oleh .csv dan berisi maksimal satu karakter pengganti ('*'). Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
BUCKET_NAME_INVALID 400 Nama bucket '{bucket_name}' tidak sesuai dengan persyaratan penamaan bucket Cloud Storage. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
OBJECT_NAME_INVALID 400 Nama objek '{object_name}' tidak sesuai dengan persyaratan penamaan objek Cloud Storage. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
OBJECT_PREFIX_INVALID_UTF8 400 Awalan objek berisi karakter UTF-8 yang tidak valid. Pastikan awalan adalah UTF-8 yang valid. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
OBJECT_PREFIX_TOO_LONG 400 Awalan objek melebihi panjang maksimum yang diizinkan, yaitu {max_length} byte. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
OBJECT_PREFIX_INVALID_CHARACTER 400 Awalan objek berisi karakter baris baru atau carriage return yang tidak valid. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
OBJECT_PREFIX_OVERLAP 400 Awalan objek '{prefix_1}' tumpang-tindih dengan '{prefix_2}'. Awalan objek tidak boleh menjadi awalan dari awalan lain yang disertakan. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
DUPLICATE_OBJECT_PREFIX 400 Awalan objek duplikat '{object_prefix}' ditemukan di 'included_object_prefixes'. Hapus entri duplikat. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
TOO_MANY_OBJECT_PREFIXES 400 'prefix_list' tidak boleh melebihi {max_prefixes} awalan objek yang disertakan. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
PROJECT_SOURCE_DRY_RUN_ID_INVALID 400 'dry_run_job_id' tidak valid. ID tugas harus sesuai dengan pola [a-z0-9]([-a-z0-9]*[a-z0-9])?. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
PROJECT_SOURCE_DRY_RUN_FIELDS_EXCLUSIVE 400 Jika 'dry_run_job_id' ditentukan, semua kolom lain di 'ProjectSource' harus kosong. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
PROJECT_SOURCE_PROJECT_INVALID 400 Project '{project}' tidak valid. Project harus mengikuti format 'projects/{project_number}' atau 'projects/{project_id}'. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
INSIGHTS_DATASET_CONFIG_INVALID 400 Konfigurasi set data insight '{insights_dataset_config}' tidak valid. Nama resource konfigurasi harus mengikuti format 'projects/{project}/locations/{location}/datasetConfigs/{dataset_config}'. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
TARGET_LOCATIONS_REQUIRED_FOR_SNAPSHOT_TIME 400 Kolom 'locations' di 'target_locations' harus ditentukan saat 'snapshot_time' diberikan. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
TOO_MANY_TARGET_LOCATIONS 400 Daftar 'target_locations' tidak boleh melebihi {max_locations} lokasi. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
CEL_EXPRESSION_TOO_LONG 400 Ekspresi filter tidak boleh melebihi {max_length} byte. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
KMS_KEY_INVALID 400 Kunci KMS tidak valid. Kunci harus mengikuti format 'projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}'. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
REWRITE_OBJECT_MISSING_PARAMETERS 400 Setidaknya salah satu dari 'storage_class' atau 'kms_key' harus ditentukan untuk 'RewriteObject'. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
PUT_OBJECT_HOLD_MISSING_PARAMETERS 400 Setidaknya salah satu dari 'temporary_hold' atau 'event_based_hold' harus ditentukan. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
PUT_METADATA_MISSING_PARAMETERS 400 Setidaknya satu kolom di 'PutMetadata' harus ditentukan. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
RETAIN_UNTIL_TIME_REQUIRED 400 Kolom 'retain_until_time' harus ditentukan dalam format RFC 3339 saat 'retention_mode' ditetapkan. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
RETENTION_MODE_REQUIRED 400 Kolom 'retention_mode' harus ditetapkan ke 'LOCKED' atau 'UNLOCKED'. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
RETAIN_UNTIL_TIME_INVALID_FORMAT 400 Kolom 'retain_until_time' harus dalam format stempel waktu RFC 3339 (misalnya, '2026-12-31T23:59:59Z'). Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
CUSTOM_CONTEXT_KEY_CONFLICT 400 Kunci yang sama tidak dapat ditentukan di 'updates' dan 'keys_to_clear'. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
UPDATE_OBJECT_CUSTOM_CONTEXT_MISSING_ACTION 400 Setidaknya satu tindakan di 'UpdateObjectCustomContext' harus ditentukan. Jika 'clear_all' ditentukan, tindakan tersebut harus ditetapkan ke benar (true). Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
SET_OBJECT_ACLS_MISSING_ACTION 400 Setidaknya salah satu dari 'grants' atau 'remove_entities' harus ditentukan di 'SetObjectAcls'. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
UNSUPPORTED_ACL_ENTITY 400 Entitas '{entity}' tidak didukung. Hanya 'allUsers' dan 'allAuthenticatedUsers' yang didukung. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
ACL_ENTITY_CONFLICT 400 Entitas yang sama tidak dapat ditentukan di 'grants' dan 'remove_entities'. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
AUTOCLASS_STORAGE_CLASS_TRANSFORMATION_UNSUPPORTED 400 Transformasi kelas penyimpanan tidak dapat dilakukan pada bucket yang mengaktifkan Autoclass. Nonaktifkan Autoclass di bucket atau hapus transformasi kelas penyimpanan. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
UBLA_OBJECT_ACL_UPDATE_UNSUPPORTED 400 Tidak dapat memperbarui daftar kontrol akses (ACL) untuk objek di bucket dengan akses level bucket yang seragam diaktifkan. Kelola akses menggunakan izin IAM. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
BUCKET_DISCOVERY_INSIGHTS_DATASET_NOT_FOUND 404 Gagal melakukan penemuan bucket. 'insights_dataset_config' tidak dapat ditemukan. Pastikan set data insight ada dan dapat diakses. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
BUCKET_DISCOVERY_SNAPSHOT_TOO_OLD 400 Gagal melakukan penemuan bucket. Waktu snapshot set data terbaru lebih dari 2 hari. Pastikan konfigurasi set data aktif dan menghasilkan snapshot, tentukan penggantian 'snapshot_time' dan 'target_locations', atau gunakan manifes CSV. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.
BUCKET_DISCOVERY_TOO_MANY_BUCKETS 400 Gagal melakukan penemuan bucket. Terlalu banyak bucket yang ditemukan. Hanya 1.000 bucket yang didukung. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pemecahan Masalah.