מכסות ומגבלות

במאמר הזה מפורטות המכסות ומגבלות המערכת שחלות על Cloud Vision.

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

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

מערכת המכסות ב-Cloud:

• עוקבת אחרי השימוש במוצרים ובשירותים של Google Cloud
• מגבילה את השימוש במשאבים האלה
• כוללת כלי שבאמצעותו אפשר לשלוח בקשות לשינוי המכסות ולשנות אותן אוטומטית

ברוב המקרים, כשאתם מנסים להשתמש ביותר משאבים מהמכסה, הגישה למשאב נחסמת ומה שאתם מנסים לעשות נכשל.

בדרך כלל, המכסות ב- Google Cloud הן ברמת הפרויקט. כלומר, השימוש במשאב מסוים בפרויקט כלשהו לא משפיע על המכסה שלכם בפרויקטים אחרים. ברמת הפרויקט ב- Google Cloud , המכסות משותפות לכל האפליקציות וכתובות ה-IP.

לסקירה כללית על מכסות ב-Cloud

כדי לשנות את רוב המכסות, משתמשים במסוף Google Cloud . מידע נוסף זמין במאמר בנושא שליחת בקשה לשינוי המכסות.

יש גם מגבלות מערכת על משאבי Vision. שאי אפשר לשנות.

סוגי מכסות

יש 3 סוגים של מכסות:

1. בקשת מכסה
   • ספירת המכסות לכל בקשה שנשלחת לנקודת קצה ל-API של Vision.
2. מכסת התכונות
   • הספירה של המכסות היא לכל תמונה או דף שנשלחים לנקודת קצה ל-API של Vision.
   • אלא אם צוין במפורש, מכסת נפח עם שם התכונה כקידומת היא בדרך כלל מכסת נפח של תכונה.
   • בבקשות files:annotate, אם השדה pages לא מצוין במפורש, המכסה תספור 5 דפים לכל קובץ. עם זאת, המשתמשים יחויבו רק על מספר הדפים שעברו עיבוד בפועל.
3. במכסת העיבוד
   • ספירת המכסות היא לכל תמונה או דף שעוברים עיבוד על ידי Vision API, אלא אם מצוין אחרת.
   • אפשר להסיק את זה מהמילים in processing (במהלך עיבוד) בשם המכסה.
   • המכסה הזו קובעת את המספר המקסימלי של תמונות או דפים ש-Vision API מעבד בכל פעם עבור השיטות האסינכרוניות. המשתמשים יכולים לשלוח יותר מהמכסה הזו לשיטות האסינכרוניות, אבל התמונות או הדפים שחורגים מהמכסה לא יעברו עיבוד באופן מיידי. הקבצים שמעבר למכסה מתווספים לתור לעיבוד מאוחר יותר.

המכסות הנוכחיות של השימוש ב-Vision API הן כדלקמן (ויכולות להשתנות):

מכסה ל-Vision API	סוג המכסה	ערך
בקשות לדקה (למעט סוגי הבקשות שמפורטים בהמשך)	בקשת מכסה	‫1,800
בקשות לזיהוי מפורסמים לדקה	בקשת מכסה	אפס
בקשות לזיהוי תוויות לדקה	מכסת התכונות	‫1,800
בקשות לזיהוי טקסט לדקה	מכסת התכונות	‫1,800
הערות לתמונות אסינכרוניות* מספר התמונות בתהליך	במכסת העיבוד	8,000
זיהוי אסינכרוני של טקסט במסמך^† מספר הדפים בתהליך	במכסת העיבוד	10,000

*	images:asyncBatchAnnotate בקשות
†	files:asyncBatchAnnotate בקשות, DOCUMENT_TEXT_DETECTION תכונה

מכסת Google Product Search	ערך
בקשות לדקה (למעט סוגי הבקשות שמפורטים בהמשך)	‫1,800
בקשות באצווה ביום	300
בקשות כתיבה לניהול משאבים לדקה	1,200
בקשות לניהול משאבים לדקה	2,400

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

המגבלות האלה חלות על כל פרויקט במסוף Google Cloud ומשותפות לכל האפליקציות וכתובות ה-IP שמשתמשות בפרויקט הזה.

אפשר להגדיר מכסות נמוכות יותר לכל משתמש בGoogle Cloud מסוף.

הגדלת מכסות

כדי לערוך את המכסות עד לערכים המקסימליים שלהן, בוחרים באפשרות EDIT QUOTAS (עריכת מכסות) בדף Quotas (מכסות) של Google Cloud console (מסוף). כדי לבקש הגדלה מעבר למכסה המקסימלית, עורכים את המכסה עם ההגדלה המבוקשת וההצדקה ושולחים את העדכון. תקבלו הודעה כשהבקשה תתקבל. יכול להיות שניצור איתך קשר כדי לקבל מידע נוסף לגבי הבקשה. אחרי שהבקשה תיבדק, תקבלו הודעה אם היא אושרה או נדחתה.

בדרך כלל לכל מכסה יש וריאציות של 'לכל פרויקט לכל משתמש' ו'לכל פרויקט'. צריך לשנות אותן בהתאם להגדרה שלכם.

כשמבקשים להגדיל את המכסה של תכונה מסוימת, חשוב לקחת בחשבון את מכסת הבקשות הכוללת ואת גודל האצווה המיועד כדי לוודא את הדברים הבאים:

• מכסת הבקשות הכוללת (בקשות לדקה) * גודל האצווה >= מכסת התכונות המוגדלת

אם לא תעמדו בדרישה הזו, עדיין תוגבלו על ידי מכסת הבקשות הכוללת.

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

מגבלות

ב-Vision API יש את מכסות השימוש הבאות:

מכסת תוכן	ערך
גודל קובץ התמונה	‫20 MB
גודל אובייקט בקשת JSON	‫10 MB
גודל קובץ PDF	‫1 GB
תמונות לכל בקשת images:annotate	16
תמונות לכל בקשת images:asyncBatchAnnotate	2000
דפים לכל בקשת files:annotate	5
דפים לכל בקשת files:asyncBatchAnnotate	2000

תמונות בקידוד Base64 עשויות לחרוג ממגבלת הגודל של JSON, גם אם הן לא חורגות ממגבלת הגודל של קובץ התמונה. תמונות גדולות יותר צריכות להתארח ב-Cloud Storage או בכתובת URL שנגישה לכולם. שימו לב: תמונות בקידוד base64 יכולות להיות גדולות יותר מקובץ התמונה המקורי (בדרך כלל ב-37% יותר).