Soluciona problemas de errores de cuota

Es posible que recibas errores de cuota por varias razones, como exceder los valores de cuota o no configurar la cuota en un proyecto correctamente. Si quieres recibir alertas cuando se producen errores, puedes crear alertas personalizadas para errores de cuota específicos, como se describe en Configura alertas de cuota.

Supere las cuotas de frecuencia

Las cuotas de tarifa se restablecen luego de un intervalo de tiempo predefinido específico de cada servicio. Si deseas obtener más información, consulta la documentación de cuotas para el servicio específico.

Exceso del valor de cuota

Si tu proyecto excede el valor máximo de cuota mientras usas un servicio, en Google Cloud se mostrará un error según la forma en la que accediste al servicio:

  • Si excedes una cuota con una solicitud a la API, en Google Cloud se mostrará un código de estado HTTP 413 REQUEST ENTITY TOO LARGE. Ten en cuenta que, cuando usas la API de transmisión heredada de BigQuery en un entorno de producción, es posible que recibas un código de estado 413 REQUEST ENTITY TOO LARGE si tus solicitudes HTTP son superiores a 10 MB. Es posible que también recibas este error si superas los 300 MB por segundo. Para obtener más información, consulta Inserciones de transmisión.
  • Si superas una cuota con una solicitud HTTP/REST, en Google Cloud se mostrará un código de estado HTTP 429 TOO MANY REQUESTS.
  • Si superas una cuota de Compute Engine, Google Cloud suele mostrar un código de estado HTTP 403 QUOTA_EXCEEDED, ya sea de una API, HTTP/REST o gRPC. Si la cuota es una cuota de frecuencia, se muestra 403 RATE_LIMIT_EXCEEDED.
  • Si superaste un valor de cuota con gRPC, en Google Cloud se mostrará un error ResourceExhausted. El modo en que aparece este error depende del servicio.
  • Si superaste un valor de cuota con un comando de Google Cloud CLI, la CLI de gcloud generará un mensaje de error de cuota excedida y mostrará el código de salida 1.
  • Si recibiste un mensaje QUOTA_EXCEEDED durante la implementación de servicios, consulta la siguiente sección.

Exceso del valor de cuota durante la implementación de servicios

En ocasiones, Google Cloud cambia los valores de cuota predeterminados para los recursos y las APIs. Estos cambios ocurren gradualmente, lo que significa que, durante la implementación de una nueva cuota predeterminada, el valor de cuota que aparece en la consola de Google Cloud podría no reflejar el nuevo valor de cuota disponible para ti.

Si se está realizando un lanzamiento de cuota, es posible que recibas un mensaje de error con el mensaje The future limit is the new default quota that will be available after a service rollout completes.. Si ves este mensaje de error, el valor de cuota citado y el valor futuro son correctos, incluso si lo que aparece en Google la consola de Google Cloud es diferente.

  • Para obtener más información, consulta los registros de auditoría y busca el mensaje QUOTA_EXCEEDED.

        "status": {
          ...
          "message": "QUOTA_EXCEEDED",
          "details": [
            {
              ...
              "value": {
                "quotaExceeded": {
                  ...
                  "futureLimit": FUTUREVALUE
                }
              }
            }
          ]
        },
    
  • Para ver gráficos que muestran el uso actual y máximo, ve a la página Cuotas y límites del sistema y, luego, haz clic en Supervisión. Es posible que debas ir al final de la tabla.

  • Si necesitas aumentar la cuota, puedes solicitar un ajuste de cuota.

Mensajes de error de la API

Si tu proyecto de cuota (también llamado proyecto de facturación) no está configurado correctamente, las solicitudes a la API pueden mostrar mensajes de error similares a los siguientes:

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

Estos y otros errores a menudo se pueden corregir si configuras el proyecto de cuota. Para obtener más información, consulta Descripción general del proyecto de cuota.

Errores de gcloud CLI

Si no configuraste tu proyecto de cuota, es posible que los comandos de Google Cloud CLI (gcloud CLI) muestren un error como el siguiente:

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.

Para resolver este problema, agrega la marca --billing-project a tu comando gcloud CLI para configurar el proyecto de cuota de forma explícita o vuelve a ejecutar gcloud config set billing/quota_project CURRENT_PROJECT para configurar el proyecto de cuota como el proyecto actual.

Para obtener más información, consulta lo siguiente: