QuotaFailure

תיאור של כשל בבדיקת מכסת השימוש.

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

אפשר גם לעיין במידע על סוגי RetryInfo ו-Help כדי לקבל פרטים נוספים על טיפול בכשל במכסה.

ייצוג ב-JSON 
{
  "violations": [
    {
      object (Violation)
    }
  ]
}
שדות
violations[]

object (Violation)

מתאר את כל ההפרות של המכסה.

הפרה

סוג הודעה שמשמשת לתיאור של חריגה אחת ממכסת השימוש. לדוגמה, חריגה ממכסה יומית או ממכסה מותאמת אישית.

ייצוג ב-JSON 
{
  "subject": string,
  "description": string,
  "apiService": string,
  "quotaMetric": string,
  "quotaId": string,
  "quotaDimensions": {
    string: string,
    ...
  },
  "quotaValue": string,
  "futureQuotaValue": string
}
שדות
subject

string

הנושא שעליו נכשלה בדיקת המכסה. לדוגמה, clientip:או project:.
description

string

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

לדוגמה: 'השירות מושבת' או 'הייתה חריגה מהמגבלה היומית של פעולות כבר קראתי'.
apiService

string

שירות ה-API שממנו מגיע ה-QuotaFailure.Violation. במקרים מסוימים, בעיות במכסות נובעות משירות API שונה מזה שהופעלה אליו קריאה. במילים אחרות, יכול להיות ששירות API שתלוי בשירות ה-API שנקרא הוא הגורם לשגיאה QuotaFailure, ובשדה הזה יופיע שם שירות ה-API שתלוי בו.

לדוגמה, אם ה-API שנקרא הוא Kubernetes Engine API ‏ (container.googleapis.com), ומתרחשת חריגה ממכסת המכסות ב-Kubernetes Engine API עצמו, הערך של השדה הזה יהיה container.googleapis.com. לעומת זאת, אם חריגה מהמכסה מתרחשת כש-Kubernetes Engine API יוצר מכונות וירטואליות ב-Compute Engine API ‏ (compute.googleapis.com), הערך בשדה הזה יהיה compute.googleapis.com.
quotaMetric

string

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

לדוגמה, compute.googleapis.com/cpus_per_vm_family או storage.googleapis.com/internet_egress_bandwidth.
quotaId

string

המזהה של המכסה שהופרה. המזהה הייחודי של מכסה בהקשר של שירות API. נקרא גם 'שם המגבלה'.

לדוגמה, 'CPUS-PER-VM-FAMILY-per-project-region'.
quotaDimensions

map (key: string, value: string)

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

לדוגמה, המכסה 'מעבדים לכל אזור לכל משפחת מכונות וירטואליות' אוכפת מגבלה על המדד 'compute.googleapis.com/cpus_per_vm_family' במאפיינים 'אזור' ו'משפחת מכונות וירטואליות'. אם ההפרה התרחשה באזור us-central1 ובמשפחת מכונות וירטואליות n1, הערך של quotaDimensions יהיה:

{ "region": "us-central1", "vm_family": "n1", }

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

אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }
quotaValue

string (int64 format)

ערך המכסה שנאכף בזמן QuotaFailure.

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

string (int64 format)

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

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