ב-Cloud Quotas API, המאפיינים מיוצגים כצמדי מפתח/ערך. key הוא שם המאפיין (לדוגמה, region). value הוא הערך שהוקצה למאפיין (לדוגמה, אזור כמו us-central1). המפתחות והערכים הם תלויי-רישיות.
לדוגמה, ב-Compute Engine, השימוש במכונות וירטואליות נמדד באמצעות מאפיינים שונים. במאפיין region נמדד מספר המכונות הווירטואליות שיש לכם באזור נתון.
ל-Compute Engine יש גם מספר מאפייני מוצר, כולל gpu_family. במדד gpu_family נמדד מספר מעבדי ה-GPU של משפחה מסוימת בפרויקט ב- Google Cloud .
הצגת מאפיינים
אפשר לראות את המאפיינים של המכסות ומגבלות המערכת במסוףGoogle Cloud , באמצעות Google Cloud CLI, על ידי שליחת שאילתה ל-API בארכיטקטורת REST או באמצעות ספריות לקוח. כדי לראות מימדים שלא ציינתם להם ערך, משתמשים ב-CLI של gcloud. אפשר גם להשתמש ב-CLI של gcloud כדי להציג מימדים של מכסות ומגבלות מערכת שאין להן מימדים אזוריים או מימדים של אזורי זמינות, אם הפרויקט שלכם עדיין לא משתמש במשאב המשויך. בקטע הזה מוסבר איך לצפות במאפיינים באמצעות המסוף ו-CLI של gcloud.
המסוף
במסוף Google Cloud , נכנסים לדף IAM & Admin > Quotas & System Limits:
כניסה לדף Quotas & System Limits
בטבלה שבדף הזה מוצגים מאפיינים בעמודה מאפיינים.
אם העמודה מאפיינים לא מופיעה, צריך לבצע את הפעולות הבאות. אם לא, מדלגים על השלב הזה.
- לוחצים על Column display options (אפשרויות להצגת עמודות).
- בוחרים באפשרות מאפיינים.
- לוחצים על OK. העמודה מאפיינים מופיעה בטבלה.
כדי לסנן את התוצאות, מזינים שם של מאפיין או ערך בשדה שליד Filter.
- כדי לסנן לפי מוצר, מתחילים להזין את שם המוצר ובוחרים אותו מהרשימה שמופיעה.
- כדי לסנן לפי מאפיין, מזינים את המאפיין בפורמט הבא:
dimension_name:dimension_value. לדוגמה, כדי לראות את המכסות והמגבלות של המערכת שמוגדרות לאזור us-central1, מזינים:region:us-central.
הסבר על מידות ריקות
לפעמים העמודה מאפיינים ריקה. יכולות להיות לכך כמה סיבות:
ערך ברירת המחדל הוא ערך המכסה או מגבלת המערכת, והוא חל על כל המאפיינים. במכסות מסוימות ובמגבלות מערכת מסוימות, במסוף מוצגת שורה עם ערך ברירת המחדל של המכסה או מגבלת המערכת, כהפניה. מכיוון שהגדרת ברירת המחדל חלה על כל ערכי המאפיינים, העמודה מאפיינים ריקה. כדי לזהות את הרשומות האלה, בודקים את העמודה שם. בעמודה Name (שם) מצוין שהערכים האלה הם ברירת מחדל. המילה default (ברירת מחדל) מופיעה בסוגריים בסוף השם של המכסה או של מגבלת המערכת.
לדוגמה, המכסה
SetIamPolicyRequestsPerMinutePerProjectמוגדרת במאפייןregion. במסוף מוצגת רשומת הפניה ורשומה לכל אזור. בעמודה Name, רשומת ההפניה מופיעה כ-"SetIAMPolicy requests per minute per region (default)." בעמודה Dimensions של הרשומה הזו אין ערך.לא חלים מאפיינים. לדוגמה, המכסה של Compute Engine
NETWORKS-per-projectלא משויכת לאזור, לתחום או למאפיין מוצר, ולכן אין מאפיינים להצגה.
gcloud
אפשר להשתמש ב-CLI של gcloud כדי להציג את המימדים של מכסת יחידה או מגבלה של המערכת, או של כל המכסות והמגבלות של המערכת שמשויכות למוצר נתון. בדרך כלל, הצגת המאפיינים של מכסה אחת או מגבלת מערכת אחת מהירה יותר מהצגת המאפיינים של כל המכסות ומגבלות המערכת שמשויכות למוצר. התשובה לשאילתה לגבי מכסת שימוש יחידה היא בדרך כלל כ-200 שורות. התשובה לשאילתה לגבי מוצר יכולה להיות ארוכה מ-2,000 שורות.
הצגת מאפיינים של מכסת שימוש אחת או מגבלת מערכת באמצעות gcloud
כדי לראות את המאפיינים של מכסה אחת או מגבלת מערכת אחת באמצעות ה-CLI של gcloud, מריצים את הפקודה הבאה במסוף:
gcloud beta quotas info describe QUOTA_ID --project=PROJECT_ID --service=SERVICE_ID
מחליפים את מה שכתוב בשדות הבאים:
QUOTA_ID: המזהה של המכסה או של מגבלת המערכת. אם אתם לא יודעים מהו מזהה המכסה, אתם יכולים לבחור באחת מהאפשרויות הבאות:- כדי למצוא אותו, משתמשים במסוף כמו שמתואר במאמר בנושא איך מוצאים את מזהה המכסה.
- צריך להציג את כל המאפיינים של המוצר שמשויך למכסה או למגבלת המערכת שמעניינת אתכם. הפקודה הזו לא דורשת את מזהה המכסה. אפשר לעיין בקטע הצגת מידות של מוצר באמצעות ה-CLI של gcloud.
PROJECT_ID: מזהה הפרויקט ב- Google Cloud. כדי למצוא את מזהה הפרויקט, בוחרים באחת מהאפשרויות הבאות:- כדי למצוא את מזהה הפרויקט באמצעות הקונסולה, אפשר לעיין במאמר בנושא זיהוי פרויקטים.
- אם הגדרתם את הפרויקט הנוכחי כפרויקט ברירת המחדל בהגדרות של ה-CLI של gcloud, תוכלו למצוא את מזהה הפרויקט על ידי הפעלת הפקודה הבאה של gcloud בטרמינל:
gcloud config get-value project
SERVICE_ID: מזהה השירות של המוצר שמשויך למכסה או למגבלת המערכת. לדוגמה, אם המכסה היא למעבדי A2 ב-Compute Engine, מזהה השירות הואcompute.googleapis.com.
הצגת מידות של מוצר באמצעות ה-CLI של gcloud
כדי לראות את המאפיינים של מכסה אחת או מגבלת מערכת אחת באמצעות ה-CLI של gcloud, מריצים את הפקודה הבאה במסוף:
gcloud beta quotas info list --project=PROJECT_ID --service=SERVICE_ID
מחליפים את מה שכתוב בשדות הבאים:
PROJECT_ID: מזהה הפרויקט ב- Google Cloud. כדי למצוא את מזהה הפרויקט, בוחרים באחת מהאפשרויות הבאות:- כדי למצוא את מזהה הפרויקט באמצעות הקונסולה, אפשר לעיין במאמר בנושא זיהוי פרויקטים.
- אם הגדרתם את הפרויקט הנוכחי כפרויקט ברירת המחדל בהגדרות של ה-CLI של gcloud, תוכלו למצוא את מזהה הפרויקט על ידי הפעלת הפקודה הבאה של gcloud בטרמינל:
gcloud config get-value project
SERVICE_ID: מזהה השירות של המוצר שמשויך למכסה או למגבלת המערכת. לדוגמה, אם המכסה היא למעבדי A2 ב-Compute Engine, מזהה השירות הואcompute.googleapis.com.
קדימות של מאפיינים
חלק מתרחישי השימוש ב-Cloud Quotas API כוללים הגדרות מורכבות של מאפיינים.
אפשר להגדיר מכסות ברמה מפורטת יותר מאשר רק אזורים ואזורים.
כדי להשיג את רמת הפירוט הזו, צריך להשתמש במאפיינים ספציפיים לשירות.
לדוגמה, gpu_family ו-network_id הם מאפיינים ספציפיים לשירות ב-Compute Engine. כל שירות מגדיר את המאפיינים שלו, ולכל שירות יכול להיות סט שונה של מאפיינים ספציפיים.
כשעובדים עם מאפייני מיקום או עם מאפיינים שספציפיים לשירות, סדר העדיפות הבא חל:
הגדרת העדפות מכסה עם כל המימדים הספציפיים למיקום ולשירות מקבלת עדיפות על פני כל הגדרה אחרת.
הגדרות שמציינות מאפייני מיקום בלבד קודמות להגדרות שמכילות רק מאפיינים ספציפיים לשירות.
שילוב מאפיינים
בהגדרת העדפות לגבי מכסת נפח, אפשר לשלב בין מאפיינים בדרכים הבאות:
התצורה יכולה להכיל גם מאפייני מיקום וגם מאפיינים ספציפיים לשירות. זו העדיפות הכי גבוהה.
ההגדרה יכולה להכיל רק מאפייני מיקום. הגדרת התצורה הזו חלה על כל המאפיינים הספציפיים לשירות, למעט אלה שהוגדרו באופן מפורש בשיטה 1.
יכול להיות שההגדרה תכיל רק מאפיינים שספציפיים לשירות. ההגדרה הזו חלה על כל המיקומים, למעט אלה שהוגדרו במפורש בשיטה 1 או 2.
אם ההגדרה מכילה ממדים ספציפיים לשירות, היא חייבת להכיל את כל הממדים הספציפיים לשירות.
אפשר להגדיר הגדרות בלי מאפיינים. ההגדרות האלה חלות על כל המיקומים ועל כל המאפיינים שספציפיים לשירות, למעט אלה שהוגדרו במפורש.