QuotaFailure

توضیح می‌دهد که چگونه یک بررسی سهمیه‌بندی ناموفق بود.

برای مثال، اگر از محدودیت روزانه برای پروژه فراخوانی شده تجاوز شده باشد، یک سرویس می‌تواند با جزئیات QuotaFailure حاوی شناسه پروژه و شرح محدودیت سهمیه‌ای که از آن تجاوز شده است، پاسخ دهد. اگر پروژه فراخوانی شده سرویس را در کنسول توسعه‌دهنده فعال نکرده باشد، یک سرویس می‌تواند با شناسه پروژه پاسخ دهد و service_disabled روی true تنظیم کند.

همچنین برای جزئیات بیشتر در مورد مدیریت خطای سهمیه‌بندی، به RetryInfo و انواع راهنما مراجعه کنید.

نمایش 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:" یا "پروژه: «. (یا: "باورم نمی‌شود که آدم‌ها اشتباه می‌کنند.")

description

string

توضیحی در مورد چگونگی عدم موفقیت بررسی سهمیه. مشتریان می‌توانند از این توضیح برای کسب اطلاعات بیشتر در مورد پیکربندی سهمیه در مستندات عمومی سرویس استفاده کنند، یا محدودیت سهمیه مربوطه را برای تنظیم از طریق کنسول توسعه‌دهنده پیدا کنند.

برای مثال: «سرویس غیرفعال شده» یا «محدودیت روزانه برای عملیات خواندن از حد مجاز فراتر رفته است».

apiService

string

سرویس API که QuotaFailure.Violation از آن سرچشمه می‌گیرد. در برخی موارد، مشکلات Quota از یک سرویس 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 یا CPUها است. هنگامی که فعالیتی در یک سرویس رخ می‌دهد، مانند تخصیص ماشین مجازی، ممکن است یک یا چند معیار سهمیه تحت تأثیر قرار گیرند.

برای مثال، "compute.googleapis.com/cpus_per_vm_family"، "storage.googleapis.com/internet_egress_bandwidth".

quotaId

string

شناسه سهمیه نقض‌شده. همچنین با عنوان "نام محدودیت" شناخته می‌شود، این شناسه منحصر به فرد سهمیه در چارچوب یک سرویس API است.

برای مثال، "تعداد پردازنده در هر ماشین مجازی به ازای هر منطقه".

quotaDimensions

map (key: string, value: string)

ابعاد سهمیه نقض‌شده. هر سهمیه غیر سراسری بر روی مجموعه‌ای از ابعاد اعمال می‌شود. در حالی که معیار سهمیه مشخص می‌کند چه چیزی شمارش شود، ابعاد مشخص می‌کنند که شمارنده برای چه جنبه‌هایی باید افزایش یابد.

برای مثال، سهمیه «CPUها به ازای هر منطقه به ازای هر خانواده ماشین مجازی» محدودیتی را بر روی معیار «compute.googleapis.com/cpus_per_vm_family» روی ابعاد «region» و «vm_family» اعمال می‌کند. و اگر این تخلف در منطقه «us-central1» و برای خانواده ماشین مجازی «n1» رخ داده باشد، quotaDimensions به صورت زیر خواهد بود:

{"منطقه": "us-central1", "vm_family": "n1", }

وقتی یک سهمیه به صورت سراسری اعمال می‌شود، quotaDimensions همیشه خالی خواهد بود.

یک شیء شامل لیستی از جفت‌های "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

quotaValue

string ( int64 format)

مقدار سهمیه اجباری در زمان QuotaFailure .

برای مثال، اگر مقدار سهمیه‌ی اعمال‌شده در زمان QuotaFailure روی تعداد CPUها "10" باشد، مقدار این فیلد این کمیت را منعکس می‌کند.

futureQuotaValue

string ( int64 format)

مقدار سهمیه جدید در زمان تخلف اعمال می‌شود. پس از اتمام اعمال، این مقدار به جای quotaValue اعمال خواهد شد. اگر در زمان تخلف هیچ اعمال سهمیه‌ای در حال انجام نباشد، این فیلد تنظیم نمی‌شود.

برای مثال، اگر در زمان تخلف، یک به‌روزرسانی در حال انجام باشد که تعداد سهمیه پردازنده‌ها را از ۱۰ به ۲۰ تغییر می‌دهد، مقدار این فیلد ۲۰ خواهد بود.