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

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

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

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

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

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

  • אם תחרגו מערך מכסה עם בקשת API, Google Cloud יוחזר קוד הסטטוס 413 REQUEST ENTITY TOO LARGE‏ HTTP. שימו לב: כשמשתמשים ב-API מדור קודם להוספה בסטרימינג של BigQuery בסביבת ייצור, יכול להיות שיוחזר קוד הסטטוס 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 beta quotas, אפשר לעיין בקטע מכסות של gcloud beta במדריך העזר של Google Cloud CLI.

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