QuotaFailure

يصف هذا الحقل سبب تعذُّر التحقّق من الحصة.

على سبيل المثال، إذا تم تجاوز الحدّ اليومي لمشروع الاتصال، يمكن أن تردّ الخدمة بتفاصيل QuotaFailure تتضمّن معرّف المشروع ووصف حدّ الحصة الذي تم تجاوزه. إذا لم يفعّل مشروع الاتصال الخدمة في "وحدة تحكّم المطوّرين"، يمكن أن تستجيب الخدمة بمعرّف المشروع وتضبط قيمة service_disabled على "صحيح".

راجِع أيضًا نوعَي 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

خدمة واجهة برمجة التطبيقات التي ينشأ منها QuotaFailure.Violation في بعض الحالات، تنشأ مشاكل الحصة من خدمة واجهة برمجة تطبيقات أخرى غير تلك التي تم استدعاؤها. بعبارة أخرى، قد يكون أحد العناصر التابعة لخدمة واجهة برمجة التطبيقات التي تم استدعاؤها هو سبب ظهور QuotaFailure، وسيتضمّن هذا الحقل اسم خدمة واجهة برمجة التطبيقات التابعة.

على سبيل المثال، إذا كانت واجهة برمجة التطبيقات التي تم استدعاؤها هي Kubernetes Engine API (container.googleapis.com)، وحدث انتهاك للحصة في Kubernetes Engine API نفسها، سيكون هذا الحقل هو "container.googleapis.com". من ناحية أخرى، إذا حدث انتهاك الحصة عند إنشاء واجهة برمجة التطبيقات Kubernetes Engine API لأجهزة VM في واجهة برمجة التطبيقات Compute Engine API (compute.googleapis.com)، سيكون هذا الحقل هو "compute.googleapis.com".
quotaMetric

string

مقياس الحصة التي تم انتهاكها. مقياس الحصة هو عدّاد مسمّى لقياس الاستخدام، مثل طلبات واجهة برمجة التطبيقات أو وحدات المعالجة المركزية. عند حدوث نشاط في إحدى الخدمات، مثل تخصيص جهاز افتراضي، قد يتأثر مقياس واحد أو أكثر من مقاييس الحصة.

على سبيل المثال، "compute.googleapis.com/cpus_per_vm_family" و"storage.googleapis.com/internet_egress_bandwidth".
quotaId

string

معرّف الحصة المخالِفة. يُعرف هذا الحقل أيضًا باسم "اسم الحدّ"، وهو المعرّف الفريد لحصة ضمن سياق خدمة واجهة برمجة التطبيقات.

على سبيل المثال، "CPUS-PER-VM-FAMILY-per-project-region".
quotaDimensions

map (key: string, value: string)

سمات الحصة التي تمّ انتهاكها. يتم فرض كل حصة غير عالمية على مجموعة من السمات. في حين يحدّد مقياس الحصة ما يجب احتسابه، تحدّد السمات الجوانب التي يجب زيادة العداد من أجلها.

على سبيل المثال، تفرض الحصة "وحدات المعالجة المركزية لكل منطقة لكل فئة من الأجهزة الافتراضية" حدًا على المقياس "compute.googleapis.com/cpus_per_vm_family" في السمتَين "المنطقة" و "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. إذا لم يكن هناك طرح قيد التقدّم في وقت حدوث المخالفة، لن يتم ضبط هذا الحقل.

على سبيل المثال، إذا كان هناك طرح قيد التقدّم في وقت حدوث الانتهاك لتغيير حصة عدد وحدات المعالجة المركزية من 10 إلى 20، ستكون القيمة 20.