פתרון בעיות שקשורות למכסות

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

חריגה ממכסות קצב

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

חריגה מערכי המכסה

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

  • אם תחרגו ממכסת ערך עם בקשת API, Google Cloud יוחזר קוד סטטוס HTTP 413 REQUEST ENTITY TOO LARGE. שימו לב: כשמשתמשים ב-BigQuery legacy streaming API בסביבת ייצור, יכול להיות שיוחזר קוד סטטוס 413 REQUEST ENTITY TOO LARGE אם בקשות ה-HTTP גדולות מ-10MB. השגיאה הזו יכולה להופיע גם אם חורגים מ-300MB לשנייה. מידע נוסף זמין במאמר בנושא הוספת נתונים בסטרימינג.
  • אם תחרגו ממכסת ערך עם בקשת HTTP/REST, Google Cloud יוחזר קוד הסטטוס 429 TOO MANY REQUESTS‏ HTTP.
  • אם תחרגו ממכסה של Compute Engine, בדרך כלל יופיע קוד הסטטוס 403 QUOTA_EXCEEDED‏ HTTP, בין אם זה קרה ב-API, ב-HTTP/REST או ב-gRPC. Google Cloud אם המכסה הוא מכסה לקצב הגשת בקשות, הפונקציה מחזירה את הערך 403 RATE_LIMIT_EXCEEDED.
  • אם תחרגו ממכסת ערך במהלך השימוש ב-gRPC,הפונקציה Google Cloud תחזיר את השגיאה ResourceExhausted. האופן שבו השגיאה מופיעה תלוי בשירות.
  • אם תחרגו ממכסה במהלך השימוש בפקודת Google Cloud CLI, פלט ה-CLI של gcloud יהיה הודעת שגיאה על חריגה מהמכסה, עם קוד היציאה 1.
  • אם קיבלתם הודעה על QUOTA_EXCEEDED במהלך השקת שירות, אפשר לעיין בקטע הבא.

חריגה מערכי מכסה במהלך השקת שירות

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

אם מתבצעת השקה של מכסה, יכול להיות שתקבלו הודעת שגיאה שבה מצוין The future limit is the new default quota that will be available after a service rollout completes. אם אתם רואים את הודעת השגיאה הזו, ערך המכסה שמופיע בהודעה והערך העתידי נכונים, גם אם הם שונים ממה שמופיע במסוף Google Cloud .

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

        "status": {
      ...
      "message": "QUOTA_EXCEEDED",
      "details": [
        {
          ...
          "value": {
            "quotaExceeded": {
              ...
              "futureLimit": FUTUREVALUE
            }
          }
        }
      ]
    },

  • כדי לראות תרשימים שמציגים את השימוש הנוכחי ואת השימוש בשיא, במסוף Google Cloud , עוברים לדף IAM & Admin > Quotas & System Limits ולוחצים על Monitoring. יכול להיות שתצטרכו לעבור לסוף הטבלה.

  • אם אתם צריכים מכסה גדולה יותר, אתם יכולים לבקש שינוי במכסה.

חריגה מהמכסה של הפרויקט

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

הודעות שגיאה ב-API

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

  • User credentials not supported by this API
  • API not enabled in the project
  • No quota project set

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

שגיאות ב-Google Cloud CLI

בקטע הזה מתוארות בעיות נפוצות שנתקלים בהן כשמתחילים להשתמש ב-Google Cloud CLI (ה-CLI של gcloud).

התקנה והפעלה

כדי להשתמש ב-CLI של gcloud בשביל מכסות של Cloud, צריך להתקין ולאתחל רכיבים:

  1. להתקין את ה-CLI של gcloud.

    אם אתם משתמשים ב-Cloud Shell, אתם יכולים לדלג על השלב הזה כי ה-CLI של gcloud מותקן מראש.

  2. לאתחל את ה-CLI של gcloud.

  3. מריצים את הפקודה הבאה כדי להתקין את רכיב הבטא:

    gcloud components install beta

הגדרת פרויקט לצורכי מכסה

אם לא הגדרתם את פרויקט המכסה, יכול להיות שפקודות ב-CLI של gcloud יחזירו שגיאה כמו השגיאה הבאה:

PERMISSION_DENIED: Your application is authenticating by using local Application Default Credentials.
The cloudquotas.googleapis.com API requires a quota project, which is not set by default.

כדי לפתור את הבעיה, מוסיפים את הדגל --billing-project לפקודה ב-CLI של gcloud כדי להגדיר במפורש את פרויקט המכסה, או מריצים מחדש את הפקודה gcloud config set billing/quota_project CURRENT_PROJECT כדי להגדיר את פרויקט המכסה כפרויקט הנוכחי.

למידע נוסף, קראו את המאמרים הבאים:

עדכון רכיבים ב-CLI של gcloud

אם מקבלים שגיאה שהפקודה quotas מכילה Invalid choice, יכול להיות שמותקנת גרסה ישנה יותר של ה-CLI של gcloud. מעדכנים את הרכיבים של ה-CLI של gcloud באמצעות הפקודה הבאה:

gcloud components update

בקטע gcloud beta quotas במאמרי העזרה של Google Cloud CLI יש פרטים נוספים על פקודות gcloud beta quotas ודגלים.