Solucionar errores de cuota

Puede recibir errores de cuota por varios motivos, como superar los valores de cuota o no definir la cuota de un proyecto correctamente. Si quieres recibir alertas cuando se produzcan errores, puedes crear alertas personalizadas para errores de cuota específicos, tal como se describe en el artículo Configurar alertas de cuota.

Superar las cuotas de frecuencia

Las cuotas de frecuencia se restablecen tras un intervalo de tiempo predefinido específico de cada servicio. Para obtener más información, consulta la documentación de las cuotas del servicio concreto.

Superar los valores de las cuotas

Si tu proyecto supera el valor máximo de la cuota mientras usas un servicio, Google Cloud devolverá un error en función de cómo hayas accedido al servicio:

• Si superas el valor de una cuota con una solicitud a la API, Google Cloud devuelve un código de estado HTTP 413 REQUEST ENTITY TOO LARGE. Ten en cuenta que, si usas la API de streaming antigua de BigQuery en un entorno de producción, es posible que recibas el código de estado 413 REQUEST ENTITY TOO LARGE si tus solicitudes HTTP superan los 10 MB. También puedes recibir este error si superas los 300 MB por segundo. Para obtener más información, consulta Inserciones de transmisión.
• Si superas el valor de una cuota con una solicitud HTTP/REST, Google Cloud devuelve un código de estado HTTP 429 TOO MANY REQUESTS.
• Si superas una cuota de Compute Engine, Google Cloud normalmente se devuelve un código de estado HTTP 403 QUOTA_EXCEEDED, ya sea desde la API, HTTP/REST o gRPC. Si la cuota es una cuota de frecuencia, se devuelve 403 RATE_LIMIT_EXCEEDED.
• Si superas el valor de una cuota con gRPC, Google Cloud devuelve un error ResourceExhausted. La forma en que se te muestra este error depende del servicio.
• Si se supera el valor de una cuota con un comando de la CLI de Google Cloud, la CLI de gcloud genera un mensaje de error de cuota superada y devuelve el código de salida 1.
• Si has recibido un mensaje QUOTA_EXCEEDED durante el lanzamiento de un servicio, consulta la siguiente sección.

Superar los valores de cuota durante el lanzamiento de un servicio

Google Cloud cambia a veces los valores de cuota predeterminados de los recursos y las APIs. Estos cambios se producen de forma gradual, lo que significa que, durante el lanzamiento de una nueva cuota predeterminada, es posible que el valor de la cuota que aparece en la consola Google Cloud no refleje el nuevo valor de la cuota que tienes disponible.

Si se está implementando una cuota, puede que recibas un mensaje de error que indique lo siguiente: 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 la cuota citado y el valor futuro son correctos, aunque lo que aparezca en la consola Google Cloud sea diferente.

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

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

• Para ver gráficos que muestren el uso actual y máximo, ve a la página IAM y administración > Cuotas y límites del sistema de la consola Google Cloud y, a continuación, haz clic en monitoringMonitorización. Es posible que tengas que ir al final de la tabla.

• Si necesitas más cuota, puedes solicitar un ajuste de cuota.

Superar la cuota del proyecto

Para obtener más información sobre cómo solicitar cuotas de proyectos adicionales, consulta el artículo de asistencia Solicitudes de cuotas de proyectos.

Mensajes de error de la API

Si el proyecto de cuota (también llamado proyecto de facturación) no está configurado correctamente, es posible que las solicitudes a la API devuelvan 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 se pueden solucionar a menudo configurando el proyecto de cuota. Para obtener más información, consulta el artículo Descripción general del proyecto de cuota.

Errores de Google Cloud CLI

En esta sección se describen los problemas habituales que se producen al empezar a usar la CLI de Google Cloud (gcloud CLI).

Instalar e inicializar

Para usar gcloud CLI en Cloud Quotas, asegúrate de instalar e inicializar los componentes:

1. Instala gcloud CLI.

   Si usas Cloud Shell, puedes saltarte este paso porque la CLI de gcloud viene preinstalada.

2. Inicializa gcloud CLI.

3. Instala el componente beta ejecutando el siguiente comando:

   gcloud components install beta
   

Definir el proyecto de cuota

Si no has definido tu proyecto de cuota, es posible que los comandos de gcloud CLI devuelvan 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 solucionar este problema, añada la marca --billing-project al comando de la CLI de gcloud para definir explícitamente el proyecto de cuota o vuelva a ejecutar gcloud config set billing/quota_project CURRENT_PROJECT para definir el proyecto de cuota como el proyecto actual.

Para obtener más información, consulta las siguientes secciones:

• Definir el proyecto de cuota mediante programación.
• Define el proyecto de facturación con gcloud CLI.

Actualizar los componentes de la CLI de gcloud

Si recibes un error que indica que el comando quotas contiene un Invalid choice, es posible que tengas instalada una versión anterior de la CLI de gcloud. Actualiza los componentes de la CLI de gcloud con el siguiente comando:

gcloud components update

Para obtener más información sobre los comandos y las marcas de gcloud beta quotas, consulta la sección gcloud beta quotas de la referencia de Google Cloud CLI.