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

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

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

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

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

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

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

המאמרים הבאים