Trabajar con cuotas

En Google Cloud, el uso de recursos está limitado por cuotas que los propietarios de proyectos deben cumplir. Estas cuotas restringen el uso que se puede hacer de los recursos en los proyectos de Google Cloud. Las cuotas se utilizan para limitar el uso de los recursos de dos formas distintas:

  • Cuotas de frecuencia; por ejemplo, las solicitudes a API diarias. Estas cuotas se restablecen transcurrido el tiempo especificado, como un minuto o un día.
  • Cuotas de asignación, como el número de máquinas virtuales o balanceadores de carga que utiliza tu proyecto. Aunque estas cuotas no se restablecen con el tiempo, debes liberarlas expresamente cuando ya no quieras usar el recurso; por ejemplo, eliminando cualquier clúster de GKE.

Las cuotas se aplican por diversos motivos; por ejemplo, para evitar que se produzcan picos de uso imprevistos y proteger así a la comunidad de usuarios de Google Cloud. Además, estas cuotas te ayudan a la hora de gestionar recursos. Por ejemplo, te permiten fijar tus propios límites de uso del servicio dentro de las cuotas que ofrece Google mientras desarrollas y pruebas tus aplicaciones. El límite de cada cuota viene expresado en recursos contabilizables, desde solicitudes diarias enviadas a una API al número de balanceadores de carga que utilice tu aplicación.

No todos los proyectos presentan las mismas cuotas para los mismos servicios. Si, por ejemplo, utilizas una cuenta de prueba gratuita en la plataforma, es posible que tengas una cuota muy limitada. Dispondrás de cuotas más elevadas para determinados servicios únicamente si habilitas la facturación en el proyecto en el que trabajes, y podrán ir aumentando conforme se amplíe el uso que haces de Google Cloud. Además, si lo necesitas, podrás solicitar un aumento de cuota y configurar la monitorización y las alertas en Cloud Monitoring. De esta forma, recibirás avisos si se producen comportamientos irregulares en el uso de las cuotas o si estas se agotan.

Es posible que las anulaciones de cuota que apliquen el propietario del servicio o del proyecto, o el administrador de la cuota, afecten a los límites correspondientes que se han establecido en tu cuenta. Consulta este artículo sobre el modelo de cuota de servicio para informarte sobre cómo se calculan los límites de cuota.

En esta página se detalla cómo trabajar con cuotas en tus proyectos; por ejemplo, para encontrar y modificar tus límites de cuota, solicitar un aumento de cuotas y monitorizar su uso. Encontrarás información sobre cómo visualizar otras métricas de uso de API en la sección que explica la monitorización del uso de las API.

Visualizar la cuota

La consola de Google Cloud te permite ver los límites de cuota actuales de dos maneras:

  • A través de la página Cuotas, que ofrece una lista del uso y los límites de las cuotas correspondientes a todo tu proyecto

  • A través de la consola, que ofrece información sobre las cuotas relativa a una API en concreto e incluye el uso de los recursos en el tiempo

Puedes consultar los límites de cuota de manera programática a través de la API de Service Usage.

Además, algunos servicios ofrecen acceso a información sobre las cuotas y el uso de recursos a través de una línea de comandos. Por ejemplo, Compute Engine permite acceder a información de las cuotas a través de gcloud compute.

Encontrarás información sobre cómo monitorizar el uso de cuotas y configurar alertas relacionadas con ellas en la sección que explica la monitorización de métricas de cuotas.

Ver las cuotas de todos los proyectos

Para consultar las cuotas (el uso y los límites de cuotas) de todos los recursos de tu proyecto, haz lo siguiente:

  1. Ve a la página Cuotas de la consola de Cloud en IAM y administración.
  2. En la lista de proyectos, selecciona o crea un proyecto. Cuando lo hagas, se mostrará la página Cuotas del proyecto en cuestión, en la que se recoge un elemento de línea para cada tipo de cuota que hay disponible en cada servicio.
  3. Puedes ordenar y filtrar los resultados para encontrar la información que necesitas:

    • Con los filtros Tipo de cuota, Servicio, Métrica o Ubicación, situados en la parte superior de la página, puedes acotar la lista según esos criterios.
    • De forma predeterminada, la lista se ordena de manera que muestra en primera posición la cuota más utilizada (en términos de pico de uso en los últimos siete días) para que te sea más fácil ver qué límites están cerca de superarse. Para cambiar el orden y que se muestre la cuota menos utilizada en primer lugar, selecciona la flecha Pico de uso en 7 días.

En la lista también se muestra tu valor de Uso actual de cualquier cuota determinada. En cuanto a la cuota de asignación, tu uso actual es la parte del recurso que estás utilizando en la actualidad. En cuanto a la cuota de frecuencia diaria, se trata del uso realizado hasta el momento en el día actual. En cuanto a la cuota de frecuencia por minuto o por 100 segundos, se trata del uso medio durante las últimas 24 horas.

Encontrarás más información sobre cuotas de un servicio específico y su significado en la documentación correspondiente. Por ejemplo, puedes consultar la documentación de la cuota de Compute Engine en la página Cuotas de recursos.

Cuota específica de una API

Para visualizar datos más detallados sobre cuotas de una API en concreto, incluido el uso en el tiempo, visita la página de cuotas de la API de la consola de Cloud. Dependiendo de la API en cuestión, estos límites podrían incluir solicitudes por día, por minuto y por minuto y usuario. Algunas API definen límites muy bajos hasta que la facturación se habilite en tu proyecto.

Para visualizar los límites actuales de una API en concreto, haz lo siguiente:

  1. Ve a la página de APIs y panel de control de servicios de la consola de Cloud.
  2. En la lista de proyectos, selecciona o crea un proyecto.
  3. Haz clic en el nombre de la API que te interese.
  4. Haz clic en Cuotas. Los nombres de las cuotas y los límites correspondientes de la API que hayas elegido se muestran en la página Cuotas. De manera predeterminada, estos límites son los que impone Google. Si quieres definir un límite más bajo, consulta el procedimiento pertinente en la sección Limitar el uso. Si una cuota concreta no está sujeta a los límites predeterminados de Google, el límite se muestra con el estado Ilimitado.

No todas las cuotas se muestran en la página de cuotas específica de una API. Por ejemplo, las solicitudes destinadas a la API de Compute Engine tienen una página de cuotas específica de la API, pero en ella no se recoge el uso de recursos de computación de Compute Engine (cuota de asignación). Además, si utilizas el servicio en varias ubicaciones, la página de cuotas específica de la API no muestra límites de cuotas regionales o zonales ni su uso. Para acceder a una lista exhaustiva de las cuotas de tu proyecto (donde también puedes filtrar los resultados por ubicación), ve a la página Cuotas del proyecto en cuestión.

Gestionar la cuota con la consola de Cloud

En función del uso que hagas de los recursos, puedes ajustar al alza o a la baja los límites de cuotas de tu proyecto. En esta sección se describe cómo cambiar los límites de cuota.

Solicitar un aumento de cuota

Podrás solicitar el cambio de cuota de la mayoría de los servicios facturables que tengan un límite de cuota de la siguiente manera:

  1. En la página Cuotas, utiliza las casillas para seleccionar una o varias cuotas que editar y, a continuación, haz clic en Editar cuotas. Para poder hacer clic en las casillas, la facturación debe estar habilitada en el proyecto.
  2. En el panel Editar cuotas de la derecha, rellena los campos Nombre, Correo electrónico y Teléfono del formulario con tus datos y, a continuación, haz clic en Siguiente.
  3. En el mismo panel, selecciona el servicio en cuestión para desplegar la vista y, a continuación, modifica sus cuotas según el límite que quieras solicitar. Por último, haz clic en Listo.
  4. Repite este procedimiento para modificar las cuotas de todos los servicios seleccionados.
    • Los servicios que muestran un icono de alerta () no se han modificado aún o tienen algún campo vacío.
    • Si quieres añadir más cuotas para editarlas, selecciónalas en la lista situada a la izquierda.
    • Haz clic en el icono de eliminación () para quitar servicios del panel Editar cuotas.
  5. Cuando hayas terminado de modificar las cuotas, haz clic en Enviar solicitud.

Las solicitudes de cuotas de Google Cloud se suelen procesar con rapidez; concretamente, en un plazo de 2 días laborables. El equipo de asistencia de Google Cloud te enviará una confirmación por correo electrónico. Si necesitas más asistencia, responde a ese correo. Sin embargo, se puede tardar más en aprobar los grandes aumentos de cuotas.

Limitar el uso

Quizás te interese limitar el uso de un recurso en concreto definiendo tus propios límites de cuotas. Por ejemplo, puedes fijar límites de solicitudes diarias para evitar cobros por sobrepasar los límites de uso gratuito. La forma más sencilla de limitar las cuotas es modificar los límites en la página de cuotas específica de la API.

  1. Ve a la página de cuotas de la consola de Cloud correspondiente a la API cuyo uso quieras limitar.
  2. Cuando estés en la línea de la cuota que quieras cambiar, haz clic en el icono de edición () y, a continuación, escribe el total que prefieras para la cuota, respetando el límite que Google haya especificado.
  3. Haz clic en Guardar para guardar los cambios.

Si quieres limitar una cuota que no aparece en esta página o fijar un límite superior al máximo, debes modificar tus límites siguiendo el proceso de edición de cuotas que se describe en la sección Solicitar un aumento de cuota.

Gestionar la cuota a través de la API de Service Usage

Con la API de Service Usage, puedes limitar el uso de cuota y consultar tus límites de cuota (siempre y cuando pertenezcan a APIs y servicios de Google Cloud gestionados a través de Service Usage). Si necesitas más información sobre Service Usage, consulta los siguientes recursos:

La API de Service Usage no puede usarse para solicitar un aumento de cuota. Para ello, debes usar la consola de Cloud.

Monitorizar y recibir alertas sobre métricas de cuotas

Además de consultar información básica de las cuotas en la consola de Cloud, en Google Cloud puedes monitorizar el uso, los límites y los errores de cuotas con mayor profundidad mediante la API y la interfaz de Cloud Monitoring, así como visualizar métricas de las cuotas mediante el explorador de métricas. Estas métricas sirven para crear paneles de control y alertas personalizados que te permitan monitorizar el uso de cuotas en el tiempo y recibir alertas cuando, por ejemplo, estés a punto de alcanzar el límite de una cuota.

Cloud Monitoring admite una gama amplia de métricas, que podrás combinar con filtros y agregaciones para obtener perspectivas nuevas y útiles del uso que haces de las cuotas. Por ejemplo, puedes combinar una métrica del número de usos de una cuota de asignación con un filtro quota_metric en nombres de TPU de Cloud.

Para visualizar las métricas de un recurso monitorizado con el explorador de métricas, haz lo siguiente:

  1. En la consola de Google Cloud, ve a Monitoring, o bien haz clic en el siguiente botón:
    Ir a Monitoring.
  2. En el panel de navegación de Monitoring, haz clic en  Explorador de métricas.
  3. Comprueba que Metric (Métrica) sea la pestaña seleccionada.
  4. Haz clic en el cuadro Find resource type and metric (Buscar tipo de recurso y métrica) y, a continuación, selecciona los nombres del recurso y de la métrica en el menú o escríbelos. Utiliza la siguiente información para rellenar los campos de este cuadro de texto:
    1. En Resource (Recurso), selecciona o introduce un valor para Consumer Quota (Cuota de consumidor).
    2. En Metric (Métrica), selecciona o introduce un valor para Allocation quota usage (Uso de la cuota de asignación) de modo que se monitorice ese tipo de cuota. Selecciona o introduce un valor para Rate quota usage (Uso de la cuota de frecuencia) de modo que se monitorice ese tipo de cuota.
  5. Utiliza los menús Filter (Filtrar), Group By (Agrupar por) y Aggregation (Agregación) para modificar cómo se muestran los datos. Por ejemplo, puedes agrupar por etiquetas de recurso o métrica. Para obtener más información, consulta cómo seleccionar métricas.

Una vez que hayas encontrado la información de uso de cuotas que buscabas, otra utilidad de Cloud Monitoring es crear paneles de control y alertas personalizados que te ayuden a seguir monitorizando la aplicación y manteniendo su solidez. Del mismo modo, si quieres comprobar límites de cuotas o errores de cuotas superadas, selecciona Consumer Quota (Cuota de consumidor) como tipo de recurso y, a continuación, selecciona Quota limit (Límite de cuota) o Quota exceeded error (Error de cuota superada). Encontrarás información sobre cómo hacer esto en las páginas siguientes:

Encontrarás una referencia detallada de las métricas de cuotas en la documentación de Cloud Monitoring.

Errores de cuota

Si tu proyecto supera una cuota determinada durante el uso de un servicio, la plataforma suele devolver un error.

Por lo general, Google Cloud devuelve un código de error HTTP 429 si utilizas HTTP/REST para acceder al servicio o un código de error ResourceExhausted si utilizas gRPC. La forma en que se te muestra este error depende del servicio.

A través de Cloud Monitoring, puedes identificar la cuota relacionada con el error y, posteriormente, crear alertas personalizadas que se activen al recibir errores de cuotas, tal y como se describe en el apartado sobre cómo monitorizar las métricas de cuotas.