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

ב-Cloud Vision יש מכסות ומגבלות מערכת כדי לשמור על הקצאת משאבים הוגנת, למנוע עומס יתר על השירות ולעזור לכם לנהל את השימוש במשאבים.

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

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

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

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

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

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

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

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

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

סוגי מכסות

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

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

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

מכסת Vision API סוג המכסה ערך
בקשות לדקה (חוץ מסוגי הבקשות שמפורטים בהמשך) בקשת מכסה 1,800
בקשות לזיהוי סלבריטאים לדקה בקשת מכסה אפס
בקשות לזיהוי תוויות לדקה מכסת התכונות 1,800
בקשות לזיהוי טקסט לדקה מכסת התכונות 1,800
הוספת הערות לתמונות באופן אסינכרוני* מספר התמונות בעיבוד מכסת העיבוד 8,000
זיהוי טקסט אסינכרוני במסמכים† מספר הדפים בעיבוד מכסת העיבוד 10,000
* images:asyncBatchAnnotate בקשות
† ‫files:asyncBatchAnnotate בקשות, תכונה אחת (DOCUMENT_TEXT_DETECTION)
מכסת החיפושים של מוצרים ערך
בקשות לדקה (חוץ מסוגי הבקשות שמפורטים בהמשך) 1,800
בקשות Batch ביום 300
בקשות כתיבה לניהול משאבים לדקה 1,200
בקשות לניהול משאבים בדקה 2,400

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

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

הגדלת המכסות

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

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

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

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

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

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

מגבלות

ב-Vision API נאכפות מגבלות השימוש הבאות:

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

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