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 aplican a tus aplicaciones es específico para 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 Google Cloud Console o acceder a la cuota de este de manera programática, debes tener los siguientes permisos de IAM:

  • resourcemanager.projects.get
  • resourcemanager.folders.get (si deseas ver la cuota de una carpeta completa)
  • resourcemanager.organizations.get (si deseas ver la cuota de una organización completa)
  • serviceusage.quotas.get

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.

Visualiza tu cuota en Cloud Console

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

  • 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 Cloud Console, 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

    La lista incluye un elemento de una sola línea para cada tipo de cuota disponible en cada servicio.

  2. Ordena y filtra los resultados para enfocarte en la información que necesitas:

    • Para ver una propiedad específica, haz clic en Filtrar tabla.
    • Para ordenar las listas alfabéticamente, mantén el puntero sobre Servicio, Nombre del límite, Estado de la cuota oDetalles.
    • Según la configuración predeterminada, la lista se ordena para mostrar primero tu cuota más usada (en términos de uso máximo en los últimos siete días) a fin de ayudarte a ver los límites que corres el riesgo de exceder. Para ver la cuota menos usada primero, activa o desactiva la flecha Estado de cuota.
    • Para obtener más información sobre tu Uso actual de una cuota en particular, en la columna Detalles, haz clic en Todas las cuotas.

Las métricas de uso de cuota que se muestran en la página Cuotas se calculan de la siguiente manera:

  • Cuotas de límite:
    • En el caso de las cuotas de límite diario, la cantidad que aparece representa el uso total hasta el momento en el intervalo de 24 horas actual.
    • Para la cuota por minuto o por 100 segundos, la cantidad que se muestra representa el uso promedio en las últimas 24 horas.
  • Cuotas de asignación: Es la cantidad que se muestra y representa la cantidad de recursos (como la cantidad de balanceadores de cargas) que se usan actualmente en tu proyecto.

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 Cloud Console. 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 Cloud Console:

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

  • En la página de Panel de API y servicios en Cloud Console. 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 expandir cada cuota para obtener detalles del uso en el tiempo, así como tu límite actual. 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.

    Algunas cuotas no aparecen en las páginas de cuotas específicas de API. Por ejemplo, las solicitudes a la API de Compute Engine tienen una página de cuota específica, pero esta no incluye el uso de recursos de Compute Engine (cuota de asignación). Además, si usas un servicio en múltiples ubicaciones, la página de cuota específica de la API no muestra los límites de cuota zonales o regionales ni su uso. Para obtener una lista completa del uso de cuotas del proyecto que puedes filtrar por ubicación, consulta la página Cuotas del proyecto.

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 Cloud Console

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 tabla 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 directamente en Google Cloud Console mediante los pasos que se indican a continuación. Es posible 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.

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.

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

  1. Ir a la página de cuotas

    Ir a Cuotas

  2. Selecciona la cuota que deseas cambiar de la siguiente manera:

    1. Haz clic en TODAS LAS CUOTAS en la fila de la cuota que deseas cambiar. En el PANEL DE CUOTAS, haz clic en la casilla de verificación Global.
    2. Como alternativa, puedes hacer clic en advertencia si aparece en la columna Estado de la cuota. En el PANEL DE CUOTAS, haz clic en la casilla de verificación ubicada junto a la cuota que deseas cambiar.
  3. En la página principal Cuotas, haz clic en EDITAR CUOTAS.

  4. Completa el formulario de solicitud que se muestra a la derecha como sigue:

    1. En el campo Límite nuevo, ingresa la cuota que deseas solicitar.
    2. En el campo Descripción de la solicitud, ingresa el motivo de la solicitud. Es útil incluir información como planes de crecimiento futuro, expansión de regiones o zonas, y cualquier requisito o dependencia adicional.
    3. Haga clic en SIGUIENTE.
    4. En el panel Detalles de contacto, ingresa tu número de teléfono en el campo Teléfono.
    5. Haz clic en LISTO.
  5. Haz clic en ENVIAR SOLICITUD.

Después de enviar la solicitud a Google Cloud Console, se te enviará un correo electrónico para confirmarla. 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.

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. Para limitar la cuota, edita los límites en la página de cuota específica de la API.

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

    Ir a Cuotas

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

  3. Haz clic en TODAS LAS CUOTAS para ver el uso que quieres limitar.

  4. Haz clic en la casilla de verificación para seleccionar la propiedad que deseas editar.

  5. Haz clic en EDITAR CUOTAS.

  6. Completa el formulario de solicitud.

  7. Ingresa el límite de cuota revisado y, de forma opcional, una descripción.

  8. Haz clic en LISTO.

  9. Haz clic en ENVIAR SOLICITUD.

Si deseas limitar una cuota que no aparece en esta página o establecer un límite superior al máximo proporcionado, deberás editar los límites como se describe en la sección Solicita una cuota mayor.

Administra la cuota con la herramienta de línea de comandos de gcloud (alfa)

Puedes usar la herramienta de línea de comandos de gcloud para obtener cuotas actuales y limitar el uso de cuotas para algunas API y servicios de Google Cloud, como cuotas a nivel de projecto, 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 del SDK de Cloud, incluidos los componentes de los comandos alfa. Si usas Cloud Shell para interactuar con Google Cloud, se instala el SDK de Cloud.

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 las marcas y comandos gcloud quota, consulta la referencia del SDK de Cloud.

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 Cloud Console.

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 Supervisión.

    Ir a Monitoring

  2. En el panel de navegación de Monitoring, haz clic en  Explorador de métricas.
  3. Selecciona la pestaña Configuración y, luego, ingresa o selecciona un Tipo de recurso y una Métrica. Usa la siguiente información para completar los campos:
    1. En el campo Recurso, selecciona o ingresa la cuota de consumidor en Consumer Quota.
    2. En Métrica, selecciona o ingresa Uso de la cuota de asignación o Uso de cuotas de tarifa, según el tipo de cuota que quieras supervisar.
  4. Para configurar la forma en que se ven los datos, usa los menús Filtro, Agrupar por y Agregador (opcional). Por ejemplo, puedes agrupar por etiquetas de recursos o métricas. Para obtener más información, consulta cómo seleccionar métricas.

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 la herramienta de línea de comandos de gcloud, la herramienta de línea de comandos de gcloud generará un mensaje de error de cuota excedida y muestra 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.