הצגה וניהול של מכסות

במאמר הזה מוסבר איך לראות את ערכי המכסה במסוףGoogle Cloud . אפשר גם לנהל את המכסות באמצעותGoogle Cloud המסוף, Cloud Quotas API וה-CLI של gcloud.

מגבלות

אלו המגבלות שחלות על מכסות ב-Cloud:

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

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

לפני שמתחילים

כדי לבצע את המשימות שמתוארות במסמך הזה, צריך תפקידים בניהול הזהויות והרשאות הגישה (IAM).

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות לבקשת שינויים במכסות, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט, בתיקייה או בארגון:

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

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

ההרשאות הנדרשות

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

  • serviceusage.quotas.update
  • cloudquotas.quotas.update

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

הצגת מכסות במסוף Google Cloud

הערכים הנוכחיים של המכסות שלכם מפורטים בשני אזורים שונים בGoogle Cloud מסוף:

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

בדף IAM & Admin > Quotas & System Limits מוצגת טבלה עם עמודות שניתנות להגדרה. העמודות Service ו-Quota מספקות מידע כללי על המכסה שמתוארת. לדוגמה, בעמודה Service עשוי להופיע Cloud Logging API ובעמודה Quota עשוי להופיע Log ingestion requests per minute. בעמודה Quota מופיע גם תיאור של אופן חישוב המכסה. המכסות לקצב שליחת בקשות מחושבות לדקה, ל-100 שניות או ליום. למכסות הקצאה לא יופיע אף אחד מהערכים האלה.

כדי לראות מה המגבלות ומכסות השימוש לכל המשאבים בפרויקט:

המסוף

  1. במסוף Google Cloud , נכנסים לדף IAM & Admin > Quotas & System Limits:

    כניסה לדף Quotas & System Limits

  2. כדי להתמקד רק במידע שדרוש לכם תוכלו לסנן ולמיין את הרשימה בדרכים הבאות:

    • כדי לסנן את הרשימה, מזינים את המאפיינים והערכים בשדה. לדוגמה, כדי לראות מה המכסות של BigQuery API, בוחרים באפשרות Service ואז ב-BigQuery API.

    • כדי למיין את הרשימה, לוחצים על הכותרת של העמודה שלפיה רוצים למיין. לדוגמה, כדי למיין לפי סדר אלפביתי לפי שם המכסה, לוחצים על כותרת העמודה Quota.

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

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

מידע נוסף לגבי המכסה מופיע בעמודות Metric, ‏Limit name ו-Monitored resources. באמצעות המידע המפורט שמוצג בעמודות האלה תוכלו ליצור תרשים של מכסה.

בעמודות Current usage percentage ו-Current usage מוצג מידע על ניצול המכסות. אלה הקריטריונים לחישוב השימוש הנוכחי:

  • במכסות לקצב שליחת בקשות לדקה:

    • השימוש הממוצע לדקה ב-10 הדקות האחרונות

  • במכסות לקצב שליחת בקשות ליום:

    • השימוש הכולל עד אותו רגע ביום הנוכחי, לפי שעון החוף המערבי של ארה"ב.

  • במכסות הקצאה:

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

  • במכסות בו-זמניות (concurrent):

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

במאמרי העזרה של השירותים השונים תוכלו לקרוא מידע נוסף על המכסות שלהם. לדוגמה, משתמשי Compute Engine יכולים לקרוא את סקירת המכסות וההגבלות של Compute Engine.

צפייה בנתוני השימוש במכסה וייצוא שלהם לאורך זמן

אתם יכולים לראות את נפח האחסון שנוצל מתוך המכסה לאורך זמן באמצעות תרשימים. בדף Quotas & System Limits במסוף מוצגים תרשימים לכל מכסה או מגבלה בטבלה Quotas & System Limits. אחרי שצופים בתרשים, אפשר לייצא אותו. כדי להציג ולייצא תרשים, פועלים לפי השלבים הבאים:

המסוף

  1. במסוף Google Cloud , נכנסים לדף IAM & Admin > Quotas & System Limits:

    כניסה לדף Quotas & System Limits

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

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

  4. כדי לייצא את התרשים, לוחצים על אפשרויות נוספות של התרשים, בוחרים באפשרות הורדה > הורדת PNG. התרשים יורד כקובץ PNG.

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

הצגה של מכסות על API ספציפי

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

אם אין ערך למכסה מסוימת, הערך יופיע כ-Unlimited.

המגבלות הקיימות של API מסוים מפורטות בשני אזורים שונים במסוף Google Cloud : בדף Quotas & System Limits או בדף APIs & Services במסוף Google Cloud . משתמשים בתצוגת המסוף המועדפת:

המסוף

  • כדי לראות את המכסות ל-API ספציפי בדף Quotas & System Limits באמצעות מסנן:

    1. במסוף Google Cloud , נכנסים לדף IAM & Admin > Quotas & System Limits:

      כניסה לדף Quotas & System Limits

    2. לוחצים על מסנן ובוחרים באפשרות שירות בתפריט שמופיע.

    3. בוחרים או מזינים את שם השירות שרוצים לראות.

      בדף מוצג מידע על המכסות והמגבלות של המערכת עבור ה-API שצוין. המספרים שמופיעים בעמודה Value הם ערכי ברירת המחדל של המכסה, אלא אם ביצעתם התאמה של המכסה.

  • כדי לראות את המכסות ל-API ספציפי מהדף APIs & Services:

    1. עוברים לדף APIs & Services:

      כניסה אל APIs & Services

    2. בוחרים את הפרויקט הרצוי.

    3. לוחצים על שם ה-API של השירות שרוצים לראות.

    4. לוחצים על הכרטיסייה Quotas & System Limits (מכסות ומגבלות מערכת).

      בדף מוצג מידע על המכסות והמגבלות של המערכת עבור ה-API שצוין. המספרים שמופיעים בעמודה Value הם ערכי ברירת המחדל של המכסה, אלא אם ביצעתם התאמה של המכסה.

כדי לראות את השימוש לאורך זמן, לוחצים על Show usage chart.

סינון המכסות

אתם יכולים לסנן את רשימת המכסות לפי מאפיינים ספציפיים:

המסוף

  1. במסוף Google Cloud , נכנסים לדף IAM & Admin > Quotas & System Limits:

    כניסה לדף Quotas & System Limits

  2. לוחצים על Filter כדי לסנן את רשימת המכסות לפי שם או ערך של מאפיין ספציפי.

ניהול המכסות באמצעות המסוף

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

איך שולחים בקשה לשינוי המכסות

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

המסוף

כדי לבקש שינוי במכסה, פועלים לפי השלבים הבאים:

  1. במסוף Google Cloud , נכנסים לדף IAM & Admin > Quotas & System Limits:

    כניסה לדף Quotas & System Limits

    אם מתבקשים לבחור פרויקט, בוחרים את הפרויקט שרוצים לשנות.

  2. מחפשים את המכסה שרוצים לשנות ופותחים את תיבת הדו-שיח Quota changes (שינויים במכסה):

    • מיכסות שלא מופיעות בטבלה:

      • מחפשים את המכסה בתיבת החיפוש Filter. לא מציינים את האזור או האזור (אם רלוונטי) כי מכסות שלא נעשה בהן שימוש או שלא הותאמו לא מוצגות בטבלה.
      • מחפשים בטבלה את הערך של המכסה. זה יכול להיות הערך שמוגדר כברירת מחדל או כל ערך עם היסטוריה, בלי קשר לאזור או לאזור הזמן.
      • בשורה של הרשומה, לוחצים על סמל האפשרויות הנוספות > הגדרת אזורים נוספים.
      • בוחרים את האזור או את האזור שרוצים לשנות. לוחצים על Edit.

    • כל שאר המכסות:

      • מחפשים את המכסה בתיבת החיפוש Filter.
      • בשורה של הרשומה, מסמנים את התיבה של המכסה.
      • לוחצים על עריכה.

    תיבת הדו-שיח Quota changes מופיעה.

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

  4. בשדה New value, מזינים את ערך המכסה המוגדל שרוצים. אם מופיע השדה Request description, מזינים תיאור. לוחצים על סיום.

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

    אם מופיע לחצן הבא, לוחצים עליו וממלאים את הפרטים ליצירת קשר במסך הבא.

  5. לוחצים על Submit request.

אם אי אפשר לבקש לשנות מכסה במסוף, תוכלו לשלוח את הבקשה ל-Cloud Customer Care.

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

קיבוץ בקשות לשינוי מכסות

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

כדי לקצר את זמן הבדיקה, כדאי לקבץ את הבקשות לשינוי מכסות לפי מוצר ותחום. לדוגמה, אם רוצים לבקש שינויים במכסות של רשתות ובמכסות של מכונות וירטואליות ב-Compute Engine, צריך ליצור בקשה אחת למכסות של רשתות ובקשה נוספת למכסות של מכונות וירטואליות ב-Compute Engine.

REST

כדי לבקש שינוי במכסות דרך Cloud Quotas API, משתמשים בדוגמת הקוד הבאה. ממלאים את ה-placeholders שניתנים לעריכה בערכים שלכם. כדי לקבל מידע על שדות placeholder, אפשר לעיין בתיאורים שמופיעים אחרי דוגמת הקוד.

POST projects/PROJECT_NUMBER/locations/global/quotaPreferences?quotaPreferenceId=QUOTA_PREFERENCE_ID {
    "service": "SERVICE_ID",
    "quotaId": "QUOTA_ID",
    "quotaConfig": { "preferredValue": "NEW_QUOTA_VALUE" },
    "dimensions": { "DIMENSION_1": "VALUE_1", "DIMENSION_2": "VALUE_2" },
    "justification": "JUSTIFICATION",
    "contactEmail": "EMAIL"
}

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud . אפשר לראות את מספר הפרויקט בדף Welcome במסוף Google Cloud או להריץ את הפקודה הבאה ב-CLI של gcloud:

    PROJECT=$(gcloud info --format='value(config.project)')
gcloud projects describe ${PROJECT} --format="value(projectNumber)"

  • ‫QUOTA_PREFERENCE_ID: המזהה של העדפת הקוֹטָה שאתם רוצים לעדכן.

  • ‫QUOTA_ID: המזהה של המכסה שרוצים לעדכן.

  • ‫SERVICE_ID: המזהה של Google Cloud שאליו שייכת המכסה שרוצים לשנות. בדרך כלל זהו שם מהצורה SERVICE_NAME.googleapis.com. לדוגמה, שם השירות של Compute Engine הוא compute.googleapis.com.

  • ‫DIMENSION_1: סוג המאפיין שרוצים לשנות – לדוגמה, region או zone. אפשר לכלול כמה מאפיינים. מפרידים בין כל מאפיין באמצעות פסיק אחרי הערך שלו – לדוגמה, VALUE_1. כדי לשנות את כל המאפיינים של המכסה, משמיטים את השורה הזו.

  • ‫VALUE_1: הערך של המאפיין הקודם. לדוגמה, אם המאפיין הקודם הוא region, מזינים אזור כמו us-central1.

  • JUSTIFICATION: הסיבה לבקשה.

  • ‫EMAIL: כתובת אימייל שאפשר להשתמש בה ככתובת ליצירת קשר, למקרה ש Google Cloud יצטרך מידע נוסף כדי לקבל החלטה לפני אישור מכסת שימוש נוספת.

דוגמה לבקשה

הדוגמה הבאה מציגה בקשה להגדלת ערך המכסה של Compute Engine‏ PUS-PER-GPU-FAMILY-per-project-region. הבקשה היא להקצאת ערך מכסה של 100 למכונות ממשפחת ה-GPU‏ NVIDIA_H100 שנמצאות באזור us-central1.

POST projects/123/locations/global/quotaPreferences?quotaPreferenceId=my_quota_preference_ID {
    "service": "compute.googleapis.com",
    "quotaId": "GPUS-PER-GPU-FAMILY-per-project-region",
    "quotaConfig": { "preferredValue": 100 },
    "dimensions": { "region": "us-central1", "gpu_family": "NVIDIA_H100" },
    "justification": "My justification.",
    "contactEmail": "222larabrown@gmail.com"
}

הצגה של בקשות להגדלת מכסות

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

כדי לראות את הבקשות הפתוחות:

המסוף

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

  2. במסוף Google Cloud , נכנסים לדף IAM & Admin > Quotas & System Limits:

    כניסה לדף Quotas & System Limits

  3. לצד ערכי המכסות שיש לגביהן בקשה פתוחה יופיע הסמל Pending. בלחיצה על Pending תוכלו לראות פרטי הבקשות הפתוחות.

הבקשות הפתוחות מופיעות גם בטופס Quota changes כששולחים בקשה חדשה לשינוי מכסה.

כדי לראות את כל הבקשות להגדלת מכסות, כולל בקשות פתוחות וסגורות:

המסוף

  1. במסוף Google Cloud , נכנסים לדף IAM & Admin > Quotas & System Limits:

    כניסה לדף Quotas & System Limits

  2. לוחצים על הכרטיסייה Increase Requests (בקשות להגדלת המכסה).

  3. לוחצים על Filter כדי לסנן את רשימת המכסות לפי מאפיין ספציפי.

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

יצירת חריגה ממכסה

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

כדי ליצור חריגה ממכסה, פועלים לפי השלבים לעדכון ערך מכסה.

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

איפוס ערך של מכסה

כדי לאפס את ערך המכסה אחרי החלת שינוי, פועלים לפי השלבים הבאים:

המסוף

  1. במסוף Google Cloud , נכנסים לדף IAM & Admin > Quotas & System Limits:

    כניסה לדף Quotas & System Limits

  2. מזינים טקסט בתיבת החיפוש Filter כדי לחפש את המכסה. מגדירים את Has override: True כדי להציג רק מכסות שיש להן שינוי.

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

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

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

ניהול מכסות באמצעות Cloud Quotas API

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

ניהול מכסות באמצעות ה-CLI של gcloud

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

מידע נוסף זמין בקטעים הבאים:

בקשה למכסת פרויקט

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

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