QuotaFailure

Описывает причину сбоя проверки квоты.

Например, если для вызывающего проекта был превышен дневной лимит, служба может ответить сообщением QuotaFailure, содержащим идентификатор проекта и описание превышенного лимита квоты. Если вызывающий проект не включил службу в консоли разработчика, служба может ответить идентификатором проекта и установить service_disabled в значение true.

Дополнительные сведения об обработке сбоя квоты см. в разделах RetryInfo и Help types.

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 . В некоторых случаях проблемы с квотами возникают из-за API-сервиса, отличного от того, который был вызван. Другими словами, зависимость вызываемого API-сервиса может быть причиной QuotaFailure , и в этом поле будет указано имя зависимого API-сервиса.

Например, если вызываемый API — это API Kubernetes Engine (container.googleapis.com), и в самом API Kubernetes Engine происходит нарушение квоты, то это поле будет иметь значение "container.googleapis.com". С другой стороны, если нарушение квоты происходит при создании виртуальных машин API Kubernetes Engine в API Compute Engine (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" по параметрам "region" и "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.