Trabaja con cuotas

Google Cloud usa cuotas para restringir cuánto de un recurso particular de Google Cloud compartido puedes usar. Cada cuota representa un recurso contable específico, como las llamadas a la API para un servicio en particular, la cantidad de balanceadores de cargas que se usan en simultáneo en tu proyecto o la cantidad de proyectos que puedes crear.

En esta página se describe cómo trabajar con cuotas en tus proyectos, cómo encontrar y modificar los límites actuales, cómo solicitar una cuota mayor y cómo supervisar el uso de cuota.

Muchos servicios también tienen límites que no están relacionados con el sistema de cuotas. Estas son restricciones fijas, como tamaños máximos de archivos o limitaciones de esquema de la base de datos, que no se pueden aumentar ni disminuir. Puedes obtener información sobre estas en la página Cuotas y límites del servicio correspondiente (por ejemplo, Cuotas y límites de Cloud Storage).

Los siguientes vínculos proporcionan información adicional relacionada con el uso de recursos:

Pruébalo tú mismo

Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

Comenzar gratis

Acerca de las cuotas

Antes de aprender a supervisar y administrar tu cuota, es útil comprender los conceptos básicos sobre el funcionamiento del sistema de cuotas de Google Cloud. En esta sección, se presentan algunos conceptos clave de cuota, que incluyen los tipos de cuota, los límites de cuota y las solicitudes de aumento de cuota.

¿Por qué aplicamos cuotas?

Las cuotas se aplican por varias razones, entre ellas se encuentran las siguientes:

  • Para proteger a la comunidad de usuarios de Google Cloud mediante la prevención de aumentos repentinos inesperados del uso y los servicios sobrecargados.
  • Sirven para administrar los recursos. Por ejemplo, puedes establecer tus propios límites de uso del servicio mientras desarrollas y pruebas tus aplicaciones para evitar que las facturas inesperadas usen recursos costosos.

Tipos de cuota

Existen dos categorías para las cuotas:

  • Por lo general, las cuotas de frecuencia se usan para limitar la cantidad de solicitudes que puedes realizar a una API o un servicio. Las cuotas de frecuencia se restablecen después de un intervalo específico del servicio, por ejemplo, la cantidad de solicitudes a la API por día.
  • Las cuotas de asignación se usan para restringir el uso de recursos que no tienen una frecuencia de uso, como la cantidad de VM que usa tu proyecto en un momento determinado. Las cuotas de asignación no se restablecen con el tiempo; en su lugar, debes liberar el recurso de manera explícita cuando ya no quieras usarlo, por ejemplo, mediante el borrado de un clúster de GKE.

Dentro de estas categorías, algunas cuotas son globales y se aplican al uso del recurso en cualquier lugar de Google Cloud, mientras que otras son regionales o zonales y se aplican a tu uso del recurso en una región específica de Google Cloud (ambos tipos de cuota) o zona (solo cuotas de asignación). Por ejemplo, existen límites diferentes para la cantidad de instancias de VM de Compute Engine que puedes crear en cada región de Google Cloud.

Las cuotas se aplican por proyecto, excepto por la cantidad de proyectos que puedes crear, que se aplica por cuenta de usuario y de facturación.

Visualiza la información de la cuota

Existen varias formas de ver y administrar tu cuota de Google Cloud:

Puedes ver los detalles de cómo usar estos enfoques en el resto de este documento. Cada producto o servicio también tiene su propia página de cuotas y límites con información específica sobre las cuotas de ese servicio, por ejemplo, la página de cuotas y límites de GKE.

Información sobre los límites de cuotas

Si bien muchos servicios tienen cuotas predeterminadas para algunos recursos, el conjunto de límites de cuota que se aplica a tus aplicaciones es específico a ti, tu proyecto o tu organización. Por ejemplo, si usas una cuenta de prueba gratuita para explorar la plataforma, es posible que tengas una cuota muy baja para algunos recursos en comparación con las cuotas más bajas para una cuenta facturada. Habilitar la facturación en tu proyecto aumenta las cuotas para la mayoría de los servicios. Las cuotas también pueden aumentar a medida que incrementas el uso de Google Cloud con el tiempo.

Si tu proyecto necesita más de un recurso en particular de lo que permiten tus cuotas, puedes solicitar un aumento de cuota para un servicio específico. Puedes obtener más información sobre cómo funcionan las solicitudes de aumento de cuota en Acerca de las solicitudes de aumento de cuota. También puedes agregar tus propios límites a ciertas cuotas si deseas imponer límites de gasto, en especial cuando desarrollas o pruebas una aplicación que usa recursos costosos.

Algunas cuotas son ilimitadas para usuarios específicos. En este caso, puedes usar todo lo que quieras de ese recurso.

Por último, una cantidad pequeña de cuotas no se puede aumentar a partir de sus valores predeterminados, por ejemplo, cuando un uso más alto constituye un antipatrón o cuando los recursos son muy limitados. Por lo general, están documentados en la página Cuotas y límites del servicio relevante, como en este ejemplo de Cloud Functions.

Se agota la cuota

En la mayoría de los casos, si te quedas sin cuota, la tarea que intentas realizar, como implementar una aplicación, crear un proyecto nuevo o llamar a una API, falla y recibes un error de cuota. La tarea seguirá fallando hasta que liberes recursos (para la cuota de asignación), el período se restablezca (para la cuota de frecuencia) o solicites y se te otorgue un aumento de cuota.

La forma en que aparece el error de cuota depende de la herramienta o el cliente que uses para interactuar con Google Cloud. Puedes ver los detalles de los errores de cuota en Errores de cuota.

Puedes evitar obtener errores de cuota si configuras la supervisión para recibir alertas cuando te acerques a los límites de cuota. Puedes obtener más información sobre la supervisión de tus cuotas en Supervisa y alerta sobre métricas de cuotas, más adelante en este documento.

Acerca de las solicitudes de aumento de cuota

Los sistemas automatizados evalúan la mayoría de las solicitudes de aumento de la cuota según criterios estrictos, incluida la disponibilidad de los recursos, el tiempo que has usado Google Cloud y otros factores. Se rechazan las solicitudes que no cumplen con criterios específicos. No se divulgan los criterios de evaluación para las revisiones automáticas a fin de garantizar la equidad de todos los clientes y evitar los intentos de manipular el proceso. En algunos casos, las solicitudes de aumento de cuota se derivan a revisores manuales, que también siguen criterios estrictos, pero pueden considerar tus circunstancias únicas.

Es posible que debas pagar por adelantado para obtener aumentos de algunas cuotas. Por ejemplo, es posible que se te solicite realizar un pago si solicitas más proyectos que usarán servicios de nube pagados. El pago se puede aplicar a cualquier cargo que incurras en el futuro y será visible como un crédito en tu cuenta.

Las solicitudes de aumento de cuota se encuentran a cargo de Atención al cliente de Cloud (no de Facturación), quienes suelen procesar la solicitud en un plazo de 2 a 3 días hábiles. Cuando se recibe tu solicitud, se te envía un correo electrónico al que puedes responder si tienes preguntas o deseas proporcionar información adicional sobre la solicitud (por ejemplo, si la solicitud de aumento es urgente). Luego de recibir la solicitud, recibes otro correo electrónico en el que se te notifica si se aprobó o rechazó el aumento de cuota. En el correo electrónico, se proporciona la fecha de entrada en vigencia del aumento, si corresponde.

Puedes obtener más información para solicitar más cuota en Solicita un límite de cuota más alto.

Permisos

Permisos para ver la cuota de proyecto

Para ver la cuota de tu proyecto en la consola de Google Cloud o acceder a la cuota del proyecto de manera programática, debes tener los siguientes permisos de Identity and Access Management (IAM):

Si deseas saber qué funciones incluyen estos permisos de forma predeterminada, consulta la referencia de permisos de IAM.

Permisos para cambiar la cuota del proyecto

Para cambiar tu cuota a nivel de proyecto, organización o carpeta, debes tener el siguiente permiso:

Este se incluye de forma predeterminada para las siguientes funciones: propietario, editor, administrador de cuotas y administrador de Service Usage.

Permisos para ver las solicitudes de aumento de cuota

Para ver las solicitudes de aumento de cuota en la consola de Google Cloud, debes tener los siguientes permisos de IAM:

Visualiza tu cuota en la consola

Puedes ver los límites de cuota actuales en dos áreas diferentes de la consola de Google Cloud:

  • En la página Cuotas, se muestra una lista de todos los usos y límites de la cuota para tu proyecto.
  • En el panel de la API de la consola, que muestra información sobre la cuota de una API en particular, incluso el uso de recursos en el tiempo.

Visualiza todas las cuotas de proyectos

Para ver el uso de la cuota y los límites de todos los recursos de tu proyecto, sigue estos pasos:

  1. En Google Cloud Console, ve a la página Cuotas.

    Ir a Cuotas

  2. Para enfocarte en la información que necesitas, puedes filtrar y ordenar la lista de la siguiente manera:

    • Para filtrar la lista, ingresa las propiedades y los valores deseados en el campo Filtro . Por ejemplo, para ver las cuotas de la API de BigQuery, selecciona Servicio y, luego, selecciona API de BigQuery.
    • Para ordenar la lista, haz clic en el encabezado de la columna que deseas ordenar. Por ejemplo, para ordenar alfabéticamente por el nombre de la cuota, haz clic en el encabezado de la columna Cuota.

      De forma predeterminada, la lista se ordena para mostrar primero las cuotas más usadas, lo que te ayuda a ver los límites que están en riesgo de excederse.

En la página Cuotas, se muestra una tabla con columnas configurables. Las columnas Servicio y Cuota proporcionan información general sobre la cuota que se describe. Por ejemplo, el Servicio puede ser API de Cloud Logging y la Cuota puede ser Solicitudes de transferencia de registros por minuto. En el campo Cuota, también se describe cómo se evalúa la cuota. Las cuotas de tarifas se evalúan por minuto, cada 100 segundos o por día. Las cuotas que no cumplen con ninguna de estas declaraciones son cuotas de asignación.

Puedes encontrar información adicional sobre la cuota mediante las columnas Métrica, Nombre del límite y Recurso supervisado. Estas columnas proporcionan la información detallada necesaria para graficar una cuota.

Para obtener información sobre el uso de la cuota, consulta las columnas Uso actual y Uso máximo de 7 días. Los valores que se muestran en estos campos se calculan de la siguiente manera:

  • Para cuotas de minutos por minuto:

    • El Uso actual corresponde al uso total en los últimos 10 minutos.
    • El uso máximo de 7 días es el uso máximo promedio en intervalos de 1 hora promedio para los 7 días anteriores.
  • Para cuotas de frecuencia por 100 segundos:

    • El Uso actual corresponde al uso total en los últimos 10 minutos.
    • El uso máximo de 7 días es el pico del uso total, calculado en intervalos de 1 hora, para los 7 días anteriores.
  • Para las cuotas de tarifa por día:

    • El Uso actual es el uso total durante el período actual de 2  horas para las cuotas de límite diario.
    • El uso máximo de 7 días es el pico del uso total, calculado en intervalos de 1 hora, para los 7 días anteriores.
  • Para las cuotas de asignación:

    • El uso actual es el valor más reciente. Por ejemplo, puede que esta cantidad muestre la cantidad de balanceadores de cargas que usa tu proyecto en la actualidad.
    • El uso máximo de 7 días es una estimación del uso máximo. La estimación se calcula dividiendo los datos de los intervalos de 7 días anteriores a intervalos de 1 hora, seleccionando los datos de cada intervalo con la marca de tiempo más reciente y, luego, seleccionando el máximo de ese conjunto. Debido a cómo se estima el uso máximo, el valor del campo podría subestimar el uso máximo real.

Para obtener más información sobre las cuotas de un servicio específico, lee la documentación de ese servicio. Por ejemplo, la cuota de Compute Engine se encuentra documentada en Cuotas de recursos.

Visualiza la cuota específica de la API

Si deseas ver información más detallada sobre las cuotas de una API en particular, incluido el uso en el tiempo, ve a la página de cuotas de la API en la consola. En función de la API, estos límites pueden incluir solicitudes por día, solicitudes por minuto y solicitudes por minuto por usuario. Algunas API establecen límites muy bajos hasta que habilitas la facturación en tu proyecto.

Puedes ver los límites actuales de una API en particular en dos áreas diferentes de la consola:

  • En la página Cuotas de la consola, como se describe en la sección Visualiza todas las cuotas de proyectos.

  • En la página Panel de API y servicios en la consola. En esa página, selecciona tu proyecto, haz clic en el nombre de la API y, luego, en Cuotas. En la página Cuotas, se muestran los nombres de las cuotas de la API. Puedes hacer clic en Mostrar gráfico de uso para cada cuota a fin de ver el uso detallado en el tiempo. De forma predeterminada, los límites que se muestran son los que impone Google. Puedes limitar el uso como se describe en la sección Limita el uso. Si Google no impone ningún límite en una cuota, se muestra como Sin límites.

Visualiza la cantidad de proyectos que puedes crear

Cada cuenta de usuario (incluidas las cuentas de servicio) y de facturación tiene un límite en cuanto a la cantidad de proyectos que pueden crear. Si quedan menos de 30 proyectos en tu cuota, la cantidad de proyectos restantes en tu cuota se mostrará en una notificación en la página Nuevo proyecto. Puedes obtener más información para administrar esta cuota en Administra cuotas de proyectos y Solicitudes de cuotas de proyectos.

Administra la cuota con la consola

Según el uso que hagas de los recursos, es posible que desees aumentar o reducir los límites de cuota de tu proyecto. En esta sección se describe cómo cambiar los límites de cuota establecidos. Para ver los límites de cuota, en la columna Detalles, haz clic en Todas las cuotas.

Filtra cuotas

Para filtrar la lista de cuotas según propiedades específicas, haz lo siguiente:

  1. Dirígete a la página Cuotas en Google Cloud Console:

    Ir a Cuotas

  2. Haz clic en Filtrar para consultar tu cuota por una propiedad específica.

Solicita un límite de cuota mayor

Puedes solicitar un aumento de la mayoría de las cuotas en Google Cloud Console.


Para obtener una guía paso a paso sobre esta tarea directamente en Google Cloud Console, haz clic en Guiarme:

GUIARME


En el resto de esta sección, se te guiará por el mismo proceso que con los pasos en Guiarme.

Para solicitar un límite de cuota más alto con Google Cloud Console, sigue estos pasos:

  1. Ir a la página de cuotas

    Ir a Cuotas

  2. En la página Cuotas, busca la cuota que deseas aumentar en la columna Cuota.

    Puedes usar el cuadro de búsqueda Filtrar para buscar tu cuota.

  3. Selecciona la casilla de verificación a la izquierda de tu cuota.

  4. Haz clic en Editar cuotas. Aparecerá el formulario Cambios en la cuota.

  5. En el formulario Cambios en la cuota, ingresa la cuota aumentada que deseas para tu proyecto en el campo Nuevo límite.

  6. Completa los campos adicionales del formulario y, luego, haz clic en LISTO.

  7. Haz clic en ENVIAR SOLICITUD.

Si bien el procedimiento anterior se aplica a la mayoría de las solicitudes de aumento de cuota, puedes encontrar una de las siguientes excepciones:

  • En algunos casos, Google Cloud Console te redirecciona a formulario independiente para solicitar un aumento de límite. Después de enviar el formulario, Google Cloud confirma tu solicitud por correo electrónico.
  • Algunas cuotas no se pueden actualizar con Google Cloud Console. Si notas que no puedes cambiar una cuota desde la consola, solicita un aumento desde Atención al cliente de Cloud. El equipo de Facturación no maneja los aumentos de límite de cuota.

Si tu solicitud de aumento de cuota requiere aprobación, puedes recibir un correo electrónico de Google Cloud en el que se confirme la recepción de tu solicitud. Puedes responder a este correo electrónico si necesitas más ayuda. Atención al cliente de Cloud procesa tu solicitud, por lo general, en un plazo de 2 a 3 días hábiles y, luego, te envía un segundo correo electrónico para notificarte si el aumento de la cuota se aprobó o rechazó. En el correo electrónico, se proporciona la fecha de entrada en vigencia del aumento, si corresponde.

Para obtener más información sobre cómo funciona el proceso de aumento de cuota, consulta Acerca de las solicitudes de aumento de cuota.

Consulta las solicitudes de aumento de cuota

Puedes ver las solicitudes de aumento de cuota pendientes y anteriores en la consola de Google Cloud.

Para ver las solicitudes pendientes de aumento de cuota, sigue estos pasos:

  1. Asegúrate de tener permiso para ver las solicitudes de aumento de cuota.

  2. Ir a la página de cuotas

    Ir a Cuotas

  3. En la página Cuotas, Pendiente se muestra junto a los límites de cuota que están pendientes de decisión en las solicitudes de aumento enviadas antes. Puedes hacer clic en Pendiente para ver los detalles de las solicitudes pendientes.

Las solicitudes pendientes también se muestran en el formulario Cambios en la cuota cuando una solicitud de aumento de cuota nueva está por enviarse.

Para ver todas las solicitudes de aumento de cuota (actualmente pendientes y anteriores), sigue estos pasos:

  1. Ir a la página de cuotas

    Ir a Cuotas

  2. Haz clic en la pestaña Solicitudes de aumento

  3. Haz clic en Filtrar para consultar las solicitudes de aumento de cuota por una propiedad específica.

Limita el uso

Si deseas limitar el uso de un recurso en particular, configura tus propios límites de cuota. Por ejemplo, para evitar que se te siga facturando por el uso luego de agotar los límites de uso de cortesía, puedes establecer un límite de solicitudes por día.

A fin de limitar una cuota, sigue los mismos pasos que para solicitar un límite de cuota más alto.

El límite de uso con cuotas no se aplica a todos los servicios. Consulta la página de cuota del servicio específico para obtener más información.

Administra tu cuota con la CLI de Google Cloud (Alfa)

Puedes usar Google Cloud CLI para obtener las cuotas actuales y limitar el uso de cuotas para algunos servicios y API de Google Cloud, incluidas las cuotas a nivel de proyecto, carpeta y organización cuando estén disponibles.

Para usar este enfoque, primero asegúrate de haber instalado y de inicializar la versión más reciente de Google Cloud CLI, incluidos los componentes de los comandos alfa. Si usas Cloud Shell para interactuar con Google Cloud, se instala Google Cloud CLI.

Para ver la cuota de un proyecto de un servicio en particular, ejecuta el siguiente comando, sustituye el ID del proyecto y el nombre del servicio:

gcloud alpha services quota list \
    --service=SERVICE_NAME.googleapis.com \
    --consumer=projects/PROJECT_ID

Para ver los detalles de cuota del mismo servicio de una organización, haz lo siguiente:

gcloud alpha services quota list \
    --service=SERVICE_NAME.googleapis.com \
    --consumer=organizations/ORG_ID

Para obtener una lista completa de los comandos y las marcas gcloud quota, consulta la referencia de Google Cloud CLI.

Además de gcloud quota, algunos servicios tienen su propio acceso a la línea de comandos a la información de la cuota y el uso de recursos. Por ejemplo, Compute Engine te permite acceder a la información de la cuota a través de gcloud compute.

Administra la cuota con la API de Service Usage

Puedes usar estas API a fin de obtener las cuotas actuales y limitar el uso de cuotas para algunas API y algunos servicios de Google Cloud. Para obtener más información sobre Service Usage, consulta lo siguiente:

No puedes usar la API de Service Usage para solicitar una cuota mayor. Para esta actividad, debes usar la consola.

Supervisa métricas de cuotas y genera alertas sobre ellas

La API y la IU de Cloud Monitoring te permiten supervisar el uso de cuota, los límites y los errores en mayor profundidad. Puedes usar estas métricas para crear paneles y alertas personalizados que te permiten supervisar el uso de las cuotas en el tiempo y recibir alertas cuando, por ejemplo, te acercas a un límite de cuota.

Cloud Monitoring es compatible con una amplia variedad de métricas que puedes combinar con filtros y demás para obtener vistas nuevas y detalladas de tu uso de cuota. Por ejemplo, puedes combinar una métrica para el uso de cuota de asignación con un filtro quota_metric en los nombres de las Cloud TPU.

Si quieres usar el Explorador de métricas para ver las métricas de un recurso supervisado, sigue estos pasos:

  1. En Google Cloud Console, ve a la página Explorador de métricas en Monitoring.
  2. Ir al Explorador de métricas

  3. En la barra de herramientas, selecciona la pestaña Explorador.
  4. Selecciona la pestaña Configuración.
  5. Expande el menú Seleccionar una métrica, ingresa quota usage en la barra de filtros y, luego, usa los submenús para seleccionar una métrica y un tipo de recurso específicos:
    1. En el menú Recursos activos, selecciona Cuota del consumidor.
    2. En el menú Categorías de métricas activas, selecciona Cuota.
    3. En el menú Métricas activas, selecciona Uso de la cuota de asignación o Uso de la cuota de frecuencia.
    4. Haga clic en Apply.
  6. Opcional: Para configurar cómo se visualizan los datos, agrega filtros y usa los menús Agrupar por, Agregador y tipo de gráfico. Por ejemplo, puedes agrupar por etiquetas de recursos o métricas. Para obtener más información, consulta Selecciona métricas cuando uses el Explorador de métricas.
  7. Opcional: Cambia la configuración del gráfico:
    • Para obtener cuotas y otras métricas que informen una muestra por día, establece el período en al menos una semana y el tipo de trazado en Gráfico de barras apiladas.
    • Para las métricas con valor de distribución, establece el tipo de trazado en Gráfico de mapa de calor.

De manera similar, para ver límites de cuota o errores de cuota excedida, primero selecciona Consumer Quota como el tipo de recurso y, luego, selecciona Límite de cuota o Quota exceeded error.

Luego de encontrar la información sobre el uso de cuotas que deseas, puedes usar Cloud Monitoring para crear alertas y paneles personalizados que te ayudarán a supervisar y mantener una aplicación sólida. Para obtener más información, consulta los siguientes documentos:

Para ver ejemplos de políticas de alertas comunes específicas de cuotas, consulta Usa métricas de cuota.

La guía de referencia de Cloud Monitoring incluye una referencia detallada sobre las métricas de cuota.

Comprueba la compatibilidad de las métricas de cuota

No todos los servicios admiten métricas de cuotas en Cloud Monitoring. Para ver las métricas de cuota aplicables a los servicios compatibles, selecciona Cuota del consumidor como el tipo de recurso cuando crees un gráfico o una política de alertas. No se muestran los servicios que no admiten métricas de cuotas:

  • Entre los servicios comunes que admiten las métricas de cuotas, se incluyen Compute Engine, Dataflow, Cloud Spanner, Pub/Sub, Cloud Vision, Speech-to-Text, Cloud Monitoring y Cloud Logging.

  • Los servicios comunes que no son compatibles con las métricas de cuota incluyen App Engine, Cloud Storage y Cloud SQL.

Errores de cuota

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

  • 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 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.
  • Si superaste una cuota con gRPC, en Google Cloud se mostrará un error ResourceExhausted. El modo en que aparece este error depende del servicio.
  • Si superaste una 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.

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.

Si deseas recibir alertas cuando se produzcan errores en el futuro, puedes crear alertas personalizadas para errores de cuota específicos, como se describe en Supervisa métricas de cuotas.