할당량 오류 문제 해결

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

비율 할당량 초과

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

할당량 값 초과

프로젝트에서 서비스 사용 중에 최대 할당량 값을 초과하는 경우 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
            }
          }
        }
      ]
    },

  • 현재 및 최대 사용량을 표시하는 차트를 보려면 할당량 및 시스템 한도 페이지로 이동한 다음 모니터링을 클릭합니다. 테이블 끝으로 이동해야 할 수도 있습니다.

  • 할당량이 더 필요한 경우 할당량 조정을 요청할 수 있습니다.

API 오류 메시지

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

  • User credentials not supported by this API
  • API not enabled in the project
  • No quota project set

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

gcloud CLI 오류

할당량 프로젝트를 설정하지 않으면 Google Cloud CLI(gcloud CLI) 명령어에서 다음과 같은 오류가 반환될 수 있습니다.

PERMISSION_DENIED: Your application is authenticating by using local Application Default Credentials.
The cloudquotas.googleapis.com API requires a quota project, which is not set by default.

이 문제를 해결하려면 gcloud CLI 명령어에 --billing-project 플래그를 추가하여 할당량 프로젝트를 명시적으로 설정하거나 gcloud config set billing/quota_project CURRENT_PROJECT를 다시 실행하여 할당량 프로젝트를 현재 프로젝트로 설정합니다.

자세한 내용은 다음을 참조하세요.