QuotaFailure

할당량 검사가 실패한 방법을 설명합니다.

예를 들어 호출 프로젝트의 일일 한도가 초과된 경우 서비스는 프로젝트 ID와 초과된 할당량 한도의 설명을 포함하는 QuotaFailure 세부정보로 응답할 수 있습니다. 호출 프로젝트에서 개발자 콘솔의 서비스를 사용 설정하지 않은 경우 서비스는 프로젝트 ID로 응답하고 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

QuotaFailure.Violation가 시작되는 API 서비스입니다. 경우에 따라 할당량 문제는 호출된 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)에서 VM을 만들 때 할당량 위반이 발생하면 이 필드는 'compute.googleapis.com'이 됩니다.
quotaMetric

string

위반된 할당량의 측정항목입니다. 할당량 측정항목은 API 요청 또는 CPU와 같은 사용량을 측정하는 명명된 카운터입니다. 가상 머신 할당과 같은 서비스에서 활동이 발생하면 하나 이상의 할당량 측정항목이 영향을 받을 수 있습니다.

예: 'compute.googleapis.com/cpus_per_vm_family', 'storage.googleapis.com/internet_egress_bandwidth'
quotaId

string

위반된 할당량의 ID입니다. '한도 이름'이라고도 하며, API 서비스 컨텍스트에서 할당량의 고유 식별자입니다.

예: 'CPUS-PER-VM-FAMILY-per-project-region'
quotaDimensions

map (key: string, value: string)

위반된 할당량의 측정기준입니다. 전역이 아닌 모든 할당량은 측정기준 집합에 적용됩니다. 할당량 측정항목은 집계할 항목을 정의하는 반면 측정기준은 카운터를 늘려야 하는 측면을 지정합니다.

예를 들어 'VM 제품군별 리전의 CPU' 할당량은 '리전' 및 'vm_family' 측정기준에 대해 'compute.googleapis.com/cpus_per_vm_family' 측정항목의 한도를 적용합니다. 위반이 'us-central1' 리전에서 VM 패밀리 'n1'에 대해 발생한 경우 quotaDimensions는 다음과 같습니다.

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

할당량이 전역적으로 적용되면 quotaDimensions는 항상 비어 있습니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
quotaValue

string (int64 format)

QuotaFailure 시점의 강제 할당량 값입니다.

예를 들어 CPU 수에 적용된 할당량 값이 QuotaFailure 시점에 '10'이면 이 필드의 값은 이 수량을 반영합니다.
futureQuotaValue

string (int64 format)

위반 시점에 출시되는 새 할당량 값입니다. 출시가 완료되면 이 값이 quotaValue 대신 적용됩니다. 위반 시점에 진행 중인 출시가 없으면 이 필드는 설정되지 않습니다.

예를 들어 위반 시점에 CPU 할당량을 10에서 20으로 변경하는 출시가 진행 중인 경우 이 필드의 값은 20이 됩니다.