服務：storagebatchoperations.googleapis.com
發生錯誤時，請參考這個目錄，並使用我們的用戶端程式庫。如果您使用自己的程式庫，請隨時參閱本指南，以便進行偵錯及解決錯誤。如要進一步瞭解錯誤回應結構，請前往錯誤總覽頁面。
錯誤代碼
下表列出與 API 互動時可能遇到的 HTTP 狀態碼和相關錯誤。每個狀態碼都對應一或多個原因和說明，有助於您在應用程式中有效排解及處理錯誤。在說明中，以大括號 ({}) 表示的變數代表預留位置，用於填入要求專屬的值。
| 原因 | HTTP 狀態碼 | 說明 |
|---|---|---|
JOB_ID_INVALID |
400 |
「job_id」無效。工作 ID 必須符合 [a-z0-9]([-a-z0-9]*[a-z0-9])? 格式。詳情請參閱疑難排解說明文件。 |
RESOURCE_NAME_TOO_LONG |
400 |
資源名稱長度超過上限 ({max_length} 個位元組)。詳情請參閱疑難排解說明文件。 |
DESCRIPTION_TOO_LONG |
400 |
作業「說明」超過允許的長度上限 ({max_length} 個位元組)。詳情請參閱疑難排解說明文件。 |
SOURCE_NOT_SPECIFIED |
400 |
必須為作業指定來源 (「bucket_list」或「project_source」)。詳情請參閱疑難排解說明文件。 |
TRANSFORMATION_NOT_SPECIFIED |
400 |
您必須為工作指定轉換。請指定一項轉換：「delete_object」、「put_object_hold」、「put_metadata」、「rewrite_object」、「update_object_custom_context」、「set_object_acls」或「drop_object_google_context」。詳情請參閱疑難排解說明文件。 |
BUCKET_LIST_EMPTY |
400 |
「bucket_list」不得為空白。至少指定一個 bucket 設定。詳情請參閱疑難排解說明文件。 |
TOO_MANY_BUCKETS |
400 |
「bucket_list」不得超過 {max_buckets} 個 bucket。詳情請參閱疑難排解說明文件。 |
BUCKET_NAME_REQUIRED |
400 |
您必須在 bucket 設定中指定「bucket」欄位。詳情請參閱疑難排解說明文件。 |
OBJECT_CONFIGURATION_REQUIRED |
400 |
值區作業必須指定物件設定 (「prefix_list」、「manifest」或「project_source」)。詳情請參閱疑難排解說明文件。 |
MANIFEST_LOCATION_REQUIRED |
400 |
必須指定「manifest_location」欄位。詳情請參閱疑難排解說明文件。 |
MANIFEST_LOCATION_INVALID |
400 |
資訊清單位置「{manifest_location}」無效。位置必須採用 gs://<bucket_name>/<path>/<object_name>.csv 格式，其中 <path> 為選用項目，<object_name> 後方接著 .csv，且最多包含一個萬用字元 (「*」)。詳情請參閱疑難排解說明文件。 |
BUCKET_NAME_INVALID |
400 |
bucket 名稱「{bucket_name}」不符合 Cloud Storage bucket 命名規定。詳情請參閱疑難排解說明文件。 |
OBJECT_NAME_INVALID |
400 |
物件名稱「{object_name}」不符合 Cloud Storage 物件命名規定。詳情請參閱疑難排解說明文件。 |
OBJECT_PREFIX_INVALID_UTF8 |
400 |
物件前置字元含有無效的 UTF-8 字元。確認前置字串為有效的 UTF-8。詳情請參閱疑難排解說明文件。 |
OBJECT_PREFIX_TOO_LONG |
400 |
物件前置字元超過允許的長度上限 ({max_length} 個位元組)。詳情請參閱疑難排解說明文件。 |
OBJECT_PREFIX_INVALID_CHARACTER |
400 |
物件前置字元含有無效的換行或回車字元。詳情請參閱疑難排解說明文件。 |
OBJECT_PREFIX_OVERLAP |
400 |
物件前置字串「{prefix_1}」與「{prefix_2}」重疊。物件前置字串不得是其他所含前置字串的前置字串。詳情請參閱疑難排解說明文件。 |
DUPLICATE_OBJECT_PREFIX |
400 |
在「included_object_prefixes」中找到重複的物件前置字串「{object_prefix}」。移除重複項目。詳情請參閱疑難排解說明文件。 |
TOO_MANY_OBJECT_PREFIXES |
400 |
「prefix_list」不得超過 {max_prefixes} 個包含的物件前置字元。詳情請參閱疑難排解說明文件。 |
PROJECT_SOURCE_DRY_RUN_ID_INVALID |
400 |
「dry_run_job_id」無效。工作 ID 必須符合 [a-z0-9]([-a-z0-9]*[a-z0-9])? 格式。詳情請參閱疑難排解說明文件。 |
PROJECT_SOURCE_DRY_RUN_FIELDS_EXCLUSIVE |
400 |
指定「dry_run_job_id」時，「ProjectSource」中的所有其他欄位都必須留空。詳情請參閱疑難排解說明文件。 |
PROJECT_SOURCE_PROJECT_INVALID |
400 |
專案「{project}」無效。專案格式必須為「projects/{project_number}」或「projects/{project_id}」。詳情請參閱疑難排解說明文件。 |
INSIGHTS_DATASET_CONFIG_INVALID |
400 |
洞察資料集設定「{insights_dataset_config}」無效。設定資源名稱的格式必須為「projects/{project}/locations/{location}/datasetConfigs/{dataset_config}」。詳情請參閱疑難排解說明文件。 |
TARGET_LOCATIONS_REQUIRED_FOR_SNAPSHOT_TIME |
400 |
提供「snapshot_time」時，必須指定「target_locations」中的「locations」欄位。詳情請參閱疑難排解說明文件。 |
TOO_MANY_TARGET_LOCATIONS |
400 |
「target_locations」清單不得超過 {max_locations} 個地點。詳情請參閱疑難排解說明文件。 |
CEL_EXPRESSION_TOO_LONG |
400 |
篩選運算式不得超過 {max_length} 個位元組。詳情請參閱疑難排解說明文件。 |
KMS_KEY_INVALID |
400 |
KMS 金鑰無效。金鑰格式必須為「projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}」。詳情請參閱疑難排解說明文件。 |
REWRITE_OBJECT_MISSING_PARAMETERS |
400 |
至少須為「RewriteObject」指定「storage_class」或「kms_key」。詳情請參閱疑難排解說明文件。 |
PUT_OBJECT_HOLD_MISSING_PARAMETERS |
400 |
至少須指定「temporary_hold」或「event_based_hold」其中一個。詳情請參閱疑難排解說明文件。 |
PUT_METADATA_MISSING_PARAMETERS |
400 |
必須在「PutMetadata」中指定至少一個欄位。詳情請參閱疑難排解說明文件。 |
RETAIN_UNTIL_TIME_REQUIRED |
400 |
設定「retention_mode」時，必須以 RFC 3339 格式指定「retain_until_time」欄位。詳情請參閱疑難排解說明文件。 |
RETENTION_MODE_REQUIRED |
400 |
「retention_mode」欄位必須設為「LOCKED」或「UNLOCKED」。詳情請參閱疑難排解說明文件。 |
RETAIN_UNTIL_TIME_INVALID_FORMAT |
400 |
「retain_until_time」欄位必須採用 RFC 3339 時間戳記格式 (例如「2026-12-31T23:59:59Z」)。詳情請參閱疑難排解說明文件。 |
CUSTOM_CONTEXT_KEY_CONFLICT |
400 |
「updates」和「keys_to_clear」中不能指定相同的鍵。詳情請參閱疑難排解說明文件。 |
UPDATE_OBJECT_CUSTOM_CONTEXT_MISSING_ACTION |
400 |
「UpdateObjectCustomContext」中至少須指定一項動作。如果指定「clear_all」，則必須設為 true。詳情請參閱疑難排解說明文件。 |
SET_OBJECT_ACLS_MISSING_ACTION |
400 |
您必須在「SetObjectAcls」中指定「grants」或「remove_entities」至少一項。詳情請參閱疑難排解說明文件。 |
UNSUPPORTED_ACL_ENTITY |
400 |
系統不支援實體「{entity}」。系統僅支援「allUsers」和「allAuthenticatedUsers」。詳情請參閱疑難排解說明文件。 |
ACL_ENTITY_CONFLICT |
400 |
同一個實體不得同時指定在「grants」和「remove_entities」。詳情請參閱疑難排解說明文件。 |
AUTOCLASS_STORAGE_CLASS_TRANSFORMATION_UNSUPPORTED |
400 |
無法對啟用自動調整級別功能的值區執行儲存空間級別轉換。在 bucket 上停用自動調整級別功能，或移除儲存空間級別轉換。詳情請參閱疑難排解說明文件。 |
UBLA_OBJECT_ACL_UPDATE_UNSUPPORTED |
400 |
如果值區已啟用統一值區層級存取權，就無法更新物件的存取控制清單 (ACL)。請改用 IAM 權限管理存取權。詳情請參閱疑難排解說明文件。 |
BUCKET_DISCOVERY_INSIGHTS_DATASET_NOT_FOUND |
404 |
無法執行 Bucket 探索。找不到「insights_dataset_config」。請確認洞察資料集存在且可存取。詳情請參閱疑難排解說明文件。 |
BUCKET_DISCOVERY_SNAPSHOT_TOO_OLD |
400 |
無法執行 Bucket 探索。最新的資料集快照時間已超過 2 天。確認資料集設定已啟用並產生快照，指定「snapshot_time」和「target_locations」覆寫，或改用 CSV 資訊清單。詳情請參閱疑難排解說明文件。 |
BUCKET_DISCOVERY_TOO_MANY_BUCKETS |
400 |
無法執行 Bucket 探索。發現的 bucket 數量過多，系統僅支援 1000 個值區。詳情請參閱疑難排解說明文件。 |