Storage Batch Operations API Version v1: Error Catalog

שירות: storagebatchoperations.googleapis.com

אם נתקלים בשגיאות, כדאי לעיין בקטלוג הזה וגם להשתמש בספריות הלקוח שלנו. אם אתם משתמשים בספריות משלכם, כדאי לשמור את המדריך הזה בהישג יד כדי שתוכלו להיעזר בו בניפוי באגים ובפתרון שגיאות. בדף הסקירה הכללית של השגיאות מוסבר על מבנה תגובת השגיאה.

קודי שגיאה

בטבלה הבאה מפורטים קודי מצב של HTTP ושגיאות שמשויכות אליהם, שאולי תיתקלו בהם במהלך אינטראקציה עם ה-API שלנו. כל קוד סטטוס מתאים לסיבה אחת או יותר ולתיאורים שיעזרו לכם לפתור בעיות ולטפל בשגיאות ביעילות באפליקציה. בתיאורים, משתנים שמסומנים בסוגריים מסולסלים ({}) מייצגים placeholders לערכים שספציפיים לבקשה שלכם.

הערה: הרשימה הזו כוללת כמה הודעות שגיאה שקשורות ל-API של המערכת, אבל היא לא רשימה מלאה של ההודעות האלה.

סיבה	קוד סטטוס של HTTP	תיאור
JOB_ID_INVALID	400	הערך של job_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' לא יכול להיות ריק. מציינים לפחות הגדרת דלי אחת. מידע נוסף זמין במאמרי העזרה שלנו בנושא פתרון בעיות.
TOO_MANY_BUCKETS	400	מספר הדליים ב-bucket_list לא יכול לעלות על {max_buckets}. מידע נוסף זמין במאמרי העזרה שלנו בנושא פתרון בעיות.
BUCKET_NAME_REQUIRED	400	חובה לציין את השדה '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_name}' לא עומד בדרישות למתן שמות של קטגוריות ב-Cloud Storage. מידע נוסף זמין במאמרי העזרה שלנו בנושא פתרון בעיות.
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	נמצאה קידומת אובייקט כפולה '{object_prefix}' ב-'included_object_prefixes'. מסירים את הערך הכפול. מידע נוסף זמין במאמרי העזרה שלנו בנושא פתרון בעיות.
TOO_MANY_OBJECT_PREFIXES	400	הערך של 'prefix_list' לא יכול להיות גדול מ-{max_prefixes} תחיליות אובייקטים שכלולות. מידע נוסף זמין במאמרי העזרה שלנו בנושא פתרון בעיות.
PROJECT_SOURCE_DRY_RUN_ID_INVALID	400	הערך של dry_run_job_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', צריך לציין את השדה 'locations' ב-'target_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	צריך לציין לפחות אחת מהאפשרויות 'storage_class' או 'kms_key' עבור 'RewriteObject'. מידע נוסף זמין במאמרי העזרה שלנו בנושא פתרון בעיות.
PUT_OBJECT_HOLD_MISSING_PARAMETERS	400	צריך לציין לפחות אחת מהאפשרויות: temporary_hold או event_based_hold. מידע נוסף זמין במאמרי העזרה שלנו בנושא פתרון בעיות.
PUT_METADATA_MISSING_PARAMETERS	400	צריך לציין לפחות שדה אחד ב-PutMetadata. מידע נוסף זמין במאמרי העזרה שלנו בנושא פתרון בעיות.
RETAIN_UNTIL_TIME_REQUIRED	400	השדה retain_until_time צריך להיות בפורמט RFC 3339 כשמגדירים את retention_mode. מידע נוסף זמין במאמרי העזרה שלנו בנושא פתרון בעיות.
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	צריך לציין לפחות אחת מהאפשרויות 'grants' או 'remove_entities' ב-'SetObjectAcls'. מידע נוסף זמין במאמרי העזרה שלנו בנושא פתרון בעיות.
UNSUPPORTED_ACL_ENTITY	400	הישות '{entity}' לא נתמכת. יש תמיכה רק בערכים allUsers ו-allAuthenticatedUsers. מידע נוסף זמין במאמרי העזרה שלנו בנושא פתרון בעיות.
ACL_ENTITY_CONFLICT	400	אי אפשר לציין את אותה ישות גם ב-'grants' וגם ב-'remove_entities'. מידע נוסף זמין במאמרי העזרה שלנו בנושא פתרון בעיות.
AUTOCLASS_STORAGE_CLASS_TRANSFORMATION_UNSUPPORTED	400	אי אפשר לבצע שינויים בסוג האחסון בקטגוריות שמופעל בהן סיווג אוטומטי. משביתים את הסיווג האוטומטי בקטגוריה או מסירים את השינוי של סוג האחסון. מידע נוסף זמין במאמרי העזרה שלנו בנושא פתרון בעיות.
UBLA_OBJECT_ACL_UPDATE_UNSUPPORTED	400	אי אפשר לעדכן רשימות של בקרת גישה (ACL) לאובייקטים בקטגוריה שמופעלת בה גישה אחידה ברמת הקטגוריה. במקום זאת, כדאי לנהל את הגישה באמצעות הרשאות IAM. מידע נוסף זמין במאמרי העזרה שלנו בנושא פתרון בעיות.
BUCKET_DISCOVERY_INSIGHTS_DATASET_NOT_FOUND	404	החיפוש של קטגוריית האחסון נכשל. לא ניתן למצוא את 'insights_dataset_config'. מוודאים שמערך נתוני התובנות קיים ונגיש. מידע נוסף זמין במאמרי העזרה שלנו בנושא פתרון בעיות.
BUCKET_DISCOVERY_SNAPSHOT_TOO_OLD	400	החיפוש של קטגוריית האחסון נכשל. הזמן של התמונה העדכנית ביותר של מערך הנתונים הוא מלפני יותר מיומיים. מוודאים שהגדרת מערך הנתונים פעילה ויוצרת תמונות מצב, מציינים חריגות של snapshot_time ו-target_locations, או משתמשים במניפסט CSV במקום זאת. מידע נוסף זמין במאמרי העזרה שלנו בנושא פתרון בעיות.
BUCKET_DISCOVERY_TOO_MANY_BUCKETS	400	החיפוש של קטגוריית האחסון נכשל. זוהו יותר מדי דליים. יש תמיכה ב-1,000 דליים בלבד. מידע נוסף זמין במאמרי העזרה שלנו בנושא פתרון בעיות.