할당량 오류 문제 해결

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

비율 할당량 초과

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

할당량 값 초과

프로젝트에서 서비스 사용 중에 최대 할당량 값을 초과하는 경우 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의 할당량을 초과하면 Google Cloud는 일반적으로 API, HTTP/REST 또는 gRPC의 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 콘솔에서 monitoring 모니터링 아이콘을 클릭합니다. 이 아이콘을 보려면 오른쪽으로 스크롤해야 할 수도 있습니다.
액세스할 수 있는 것보다 많은 할당량이 필요하고 서비스 출시가 완료될 때까지 기다릴 수 없는 경우 할당량 조정을 요청하세요.

API 오류 메시지

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

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

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