할당량 오류 문제 해결

할당량 값을 초과하거나 할당량 프로젝트를 올바르게 설정하지 않는 등의 여러 가지 이유로 할당량 오류가 발생할 수 있습니다. 오류가 발생할 때 알림을 받으려면 할당량 알림 설정에 설명된 대로 특정 할당량 오류에 대한 커스텀 알림을 만들 수 있습니다.

비율 할당량 초과

비율 할당량은 각 서비스에 맞는 사전 정의된 시간 간격이 지나면 재설정됩니다. 자세한 내용은 특정 서비스의 할당량 문서를 참조하세요.

할당량 값 초과

프로젝트에서 서비스 사용 중에 최대 할당량 값을 초과하는 경우 Google Cloud는 서비스에 액세스한 방법에 따라 오류를 반환합니다.

API 요청 시 할당량 값을 초과하면 Google Cloud에서 HTTP 413 REQUEST ENTITY TOO LARGE 상태 코드를 반환합니다. 프로덕션 환경에서 BigQuery 기존 스트리밍 API를 사용할 때 HTTP 요청이 10MB보다 크면 413 REQUEST ENTITY TOO LARGE 상태 코드가 수신될 수 있습니다. 초당 300MB를 초과하는 경우에도 이 오류가 발생할 수 있습니다. 자세한 내용은 스트리밍 삽입을 참조하세요.
HTTP/REST 요청 시 할당량 값을 초과하면 Google Cloud에서 HTTP 429 TOO MANY REQUESTS 상태 코드를 반환합니다.
Compute Engine 할당량을 초과하면 요청이 API, HTTP/REST, gRPC에서 시작되었는지 여부에 관계없이 Google Cloud가 일반적으로 HTTP 403 QUOTA_EXCEEDED 상태 코드를 반환합니다. 할당량이 비율 할당량이면 403 RATE_LIMIT_EXCEEDED가 반환됩니다.
gRPC를 사용 시 할당량 값을 초과하면 Google Cloud에서 ResourceExhausted 오류를 반환합니다. 이 오류가 표시되는 방식은 서비스에 따라 다릅니다.
Google Cloud CLI 명령어를 사용하여 할당량 값을 초과하면 gcloud CLI가 할당량 초과 오류 메시지를 출력하고 종료 코드 1을 반환합니다.
서비스 출시 중 QUOTA_EXCEEDED 메시지가 표시되면 다음 섹션을 참조하세요.

서비스 출시 중 할당량 값 초과

Google Cloud에서는 경우에 따라 리소스 및 API의 기본 할당량 값이 변경됩니다. 이러한 변경사항은 점진적으로 발생합니다. 따라서 새 기본 할당량이 출시되었을 때 Google Cloud 콘솔에 표시되는 할당량 값은 사용자에게 제공되는 새 할당량 값을 반영하지 않을 수 있습니다.

할당량 적용이 진행 중인 경우 The future limit is the new default quota that will be available after a service rollout completes.라는 오류 메시지가 표시될 수 있습니다. 이 오류 메시지가 표시되면 인용된 할당량 값과 향후 값은, Google Cloud 콘솔에 표시되는 내용이 다르더라도 올바르다는 의미입니다.

자세한 내용을 보려면 감사 로그를 확인하고 QUOTA_EXCEEDED 메시지를 확인합니다.

    "status": {
      ...
      "message": "QUOTA_EXCEEDED",
      "details": [
        {
          ...
          "value": {
            "quotaExceeded": {
              ...
              "futureLimit": FUTUREVALUE
            }
          }
        }
      ]
    },

현재 및 최대 사용량을 표시하는 그래프를 보려면 Google Cloud 콘솔에서 모니터링 아이콘을 클릭합니다. 이 아이콘을 보려면 오른쪽 끝까지 스크롤해야 할 수 있습니다.
액세스 권한보다 많은 할당량이 필요하고 서비스 출시가 완료될 때까지 기다릴 수 없을 때는 할당량 조정을 요청합니다.

API 오류 메시지

할당량 프로젝트(결제 프로젝트라고도 함)가 올바르게 설정되지 않은 경우 API 요청이 다음 오류 메시지를 반환할 수 있습니다.

user credentials not supported by this API
API not enabled in the project
- no quota project set

이러한 오류와 기타 오류는 할당량 프로젝트를 설정하여 해결되는 경우가 많습니다. 자세한 내용은 할당량 프로젝트 개요를 참조하세요.

동적 공유 할당량 오류 메시지

요청 수가 이러한 요청을 처리하도록 할당된 용량을 초과할 경우 다음 제품을 사용할 때 동적 공유 할당량에 따라 오류 코드 429가 표시될 수 있습니다.

제품	메시지
사용한 만큼만 지불(paygo)	`Resource exhausted, please try again later.`
프로비저닝된 처리량	`Too many requests. Exceeded the provisioned throughput.`

문제를 해결하려면 다음을 수행합니다.

지수 백오프를 사용하여 요청을 다시 전송합니다.
비용 제어 수단으로 또는 예산 초과를 방지하기 위해 소비자 재정의를 설정했으면 한도를 늘립니다. 자세한 내용은 동적 공유 할당량을 참조하세요.
보다 일관적인 서비스 수준을 얻기 위해서는 프로비저닝된 처리량 사용을 고려합니다. 자세한 내용은 Google Cloud 영업팀에 문의하세요.