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

במדריך הזה מוסברות המגבלות והמכסות כשעובדים עם Data Manager API.

מגבלות הפרויקטים

כדי להשתמש ב-Data Manager API, צריך שיהיה לכם פרויקט ב-Google Cloud. פרויקט Google Cloud מספק את לקוח OAuth ואת פרטי הכניסה שבהם אתם משתמשים כדי לאמת בקשות API.

‫Data Manager API אוכף הגבלות על קצב יצירת הבקשות בכל פרויקט ב-Google Cloud, בנפרד לפי שירות וסוג פעולה (קריאה לעומת שינוי):

שירות פעולה בקשות ביום בקשות בדקה
IngestionService שינוי (כתיבה) 100,000 300
IngestionService קריאה 100,000 300
כל השירותים האחרים ביחד שינוי (כתיבה) 50,000 300
כל השירותים האחרים ביחד קריאה 50,000 300

בקשות שחורגות מהמגבלות נדחות עם השגיאה RESOURCE_EXHAUSTED וסטטוס HTTP 429 Too Many Requests.

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

שמות של מכסות

כל מגבלה תואמת לשם של מכסה ולמדד ב-Google Cloud. אם בקשה חורגת ממגבלה, Data Manager API מחזיר את שם המגבלה במטען הייעודי (payload) של הפרטים הסטנדרטיים ErrorInfo בקטע metadata.quota_limit:

שם מגבלת המכסה שירות פעולה חלון מגבלה
IngestionMutateRequestsPerDayPerProject IngestionService שינוי יום 100,000
IngestionMutateRequestsPerMinutePerProject IngestionService שינוי דקה 300
IngestionReadRequestsPerDayPerProject IngestionService קריאה יום 100,000
IngestionReadRequestsPerMinutePerProject IngestionService קריאה דקה 300
ManagementMutateRequestsPerDayPerProject כל השירותים האחרים שינוי יום 50,000
ManagementMutateRequestsPerMinutePerProject כל השירותים האחרים שינוי דקה 300
ManagementReadRequestsPerDayPerProject כל השירותים האחרים קריאה יום 50,000
ManagementReadRequestsPerMinutePerProject כל השירותים האחרים קריאה דקה 300

כדי להבחין בין שגיאות שקשורות למכסה היומית לבין שגיאות שקשורות למכסה לדקה, בודקים את metadata.quota_limit במטען הייעודי (payload) של ErrorInfo. כך אפשר להחליט אם להשהות את הפעולה באופן זמני ולנסות שוב עם השהיה הולכת וגדלה, או להשהות אותה עד שהמכסה היומית תתאפס. פרטים נוספים מופיעים במאמר בנושא שגיאות שקשורות למכסות ולהגבלת קצב של יצירת בקשות.

מגבלות על בקשות

אלה המגבלות על בקשות ספציפיות: