Trabaja con cuotas

Google Cloud aplica cuotas sobre el uso de recursos para propietarios de proyectos, lo que establece un límite estricto en relación con qué tanto puede usar tu proyecto un recurso particular de Google Cloud. A continuación, se muestran las cuotas que limitan dos tipos de uso de recursos:

  • Cuota de tarifa, como la cantidad de solicitudes a la API por día. Esta cuota se restablece luego de un tiempo especificado, como un minuto o un día.
  • Cuota de asignación, como el número de máquinas virtuales o balanceadores de cargas que usa tu proyecto. Esta cuota no se restablece con el tiempo y debe retirarse de manera explícita cuando ya no quieras usar el recurso, por ejemplo, mediante el borrado de un clúster de GKE.

Las cuotas se aplican por varias razones: por ejemplo, para proteger a la comunidad de usuarios de Google Cloud mediante la prevención de incrementos de uso imprevistos. Además, las cuotas te ayudan a administrar los recursos: por ejemplo, puedes establecer tus propios límites al uso de servicios dentro de la cuota de Google cuando desarrollas y pruebas tus aplicaciones. Cada límite de cuota se expresa en términos de un recurso contable en particular, desde solicitudes a una API por día hasta el número de balanceadores de cargas que usa tu aplicación.

No todos los proyectos tienen las mismas cuotas para los mismos servicios. Si usas una cuenta de prueba gratuita para explorar la plataforma, por ejemplo, puedes tener cuotas muy limitadas. Las cuotas más altas para algunos servicios se encuentran disponibles una vez que habilitas la facturación en tu proyecto. A medida que tu uso de Google Cloud se amplía con el tiempo, las cuotas pueden aumentar según corresponda. Puedes solicitar un aumento de cuota si lo necesitas y configurar la supervisión y las alertas en Cloud Monitoring para recibir advertencias en caso de comportamiento inusual en el uso de la cuota o si esta está por agotarse.

Los límites de tus cuotas pueden verse afectados por anulaciones de cuota que aplica el propietario del servicio o del proyecto, o el administrador de cuotas. Puedes obtener más información sobre cómo se calculan los límites de cuota en la sección Modelo de cuota de servicio.

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. Puedes obtener información para ver otras métricas en la sección Supervisa el uso de la API.

Visualiza tu cuota

Existen dos formas principales de ver tus límites de cuota actuales en Google Cloud Console:

  • Con la página Cuotas, que muestra una lista del uso y los límites de las cuotas de tu proyecto

  • Con Console, que proporciona información sobre la cuota de una API en particular, incluso el uso de recursos en el tiempo

También se puede acceder a los límites de cuotas de manera programática a través de la API de Service Usage.

Además, algunos servicios ofrecen acceso con 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.

Puedes descubrir cómo supervisar el uso de tus cuotas y cómo establecer alertas de cuotas en la sección sobre cómo supervisar métricas de cuotas.

Visualiza todas las cuotas de proyectos

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

  1. Ve a la página Cuotas en IAM y administración de Cloud Console.
  2. Se mostrará la página Cuotas del proyecto actual con un elemento de una sola línea para cada tipo de cuota disponible en cada servicio. Si quieres ver las cuotas de otro proyecto, selecciónalo de la lista o crea uno nuevo.
  3. Puedes ordenar y filtrar los resultados para encontrar la información que necesitas, como se indica a continuación:

    • Usa los filtros ubicados en la parte superior de la página para ajustar la lista mediante Servicio, Nombre del límite, Estado de la cuota, ID de servicio o Métrica.
    • De forma predeterminada, la lista se ordena según Estado de la cuota (los servicios correspondientes a cada estado aparecen en orden alfabético) para mostrar primero la cuota más usada, lo que te permite ver los límites que están en riesgo de excederse. Selecciona la flecha Estado de la cuota para activar o desactivar la opción que muestra primero la cuota menos usada. También puedes ordenar la lista según el nombre del Servicio y el Nombre del límite en orden alfabético ascendente o descendente.
  4. Selecciona un elemento de la lista para ver sus límites y su uso actuales en el panel de cuota:

    • El valor de Límite corresponde a tu límite actual para esta cuota. Google impone estos límites de forma predeterminada: si quieres especificar un límite menor, consulta cómo limitar el uso. Si Google no impone ningún límite en una cuota, se muestra como Sin límites. Cada uno de los valores de uso que se indica a continuación muestra qué tan cerca estás de alcanzar este límite.
    • El valor Uso actual puede tener significados ligeramente distintos según el tipo de cuota. Para la cuota de asignación, tu uso actual es la cantidad que usas de un recurso en este momento. Para la cuota de tarifa por día, es el uso en el transcurso del día actual. Para la cuota de tarifa por minuto o cada 100 segundos, es el uso promedio en las últimas 24 horas.
    • El valor Máximo de 7 días muestra el uso máximo en los últimos siete días.

    En el caso de las cuotas regionales o zonales, el panel de cuota muestra estos valores para cada región o zona.

Para ver las cuotas regionales o zonales, selecciona All quota en el elemento relevante de la lista para ver una página resumen que muestra la utilización por región o zona. También puedes hacer clic en el nombre de un servicio en la lista para ver información más detallada sobre la cuota específica de la API como se describe a continuación.

Puedes obtener más información sobre las cuotas para un servicio específico y qué significan en su documentación: por ejemplo, la cuota de Compute Engine se encuentra documentada en Cuotas de recursos.

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.

Realiza alguna de estas acciones para ver los límites actuales de una API en particular:

o:

  1. Ve a la página de panel de servicios y API en Cloud Console.
  2. En la lista de proyectos, selecciona un proyecto o crea uno nuevo.
  3. Haz clic en el nombre de la API que te interesa.
  4. Haz clic en Cuotas.

Los nombres de las cuotas correspondientes a la API que seleccionaste se muestran en la página Cuotas. Puedes expandir cada cuota para obtener detalles del uso en el tiempo, así como tu límite actual. Google impone los límites señalados de forma predeterminada: si quieres especificar un límite menor, consulta cómo limitar el uso. Si Google no impone ningún límite en una cuota, se muestra como Sin límites.

No todas las cuotas se muestran en la página de cuota específica de una 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 procesamiento de Compute Engine (cuota de asignación). Además, si usas el 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 de las cuotas de tu proyecto (que también te permite filtrar por ubicación), consulta la página Cuotas del proyecto.

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.

Solicita una cuota mayor

Puedes solicitar una cuota mayor para la mayoría de los servicios facturables con un límite de cuota de la siguiente manera:

  1. En la página Cuotas, usa las casillas de verificación a fin de seleccionar una o más cuotas para editar y, luego, haz clic en EDITAR CUOTAS. Las casillas de verificación solo pueden usarse cuando el proyecto tiene habilitada la facturación.
  2. A la derecha, en el panel Editar cuotas, completa el formulario con tu Nombre, Correo electrónico y Teléfono. Luego, haz clic en Siguiente.
  3. En el panel Editar cuotas, selecciona el servicio para expandir la vista y, luego, edita las cuotas según el límite que desees solicitar para ese servicio. Haz clic en Listo.
  4. Repite los pasos para editar las cuotas en cada uno de los servicios seleccionados.
    • Los servicios con un ícono de alerta () aún no se editaron o tienen un campo incompleto.
    • Puedes editar más cuotas si las seleccionas en la lista de la izquierda.
    • Haz clic en el ícono de borrar () para quitar un servicio del panel Editar cuotas.
  5. Cuando termines de editar las cuotas, haz clic en Enviar solicitud.

En general, las solicitudes de cuota de Google Cloud se procesan con rapidez dentro de dos días hábiles. Deberías recibir un correo electrónico de confirmación de tu solicitud de parte del equipo de asistencia de Google Cloud. Si necesitas ayuda, puedes responder a ese correo electrónico. Ten en cuenta que los incrementos de cuota de mayor tamaño pueden tardar más tiempo en aprobarse.

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. La forma más simple de limitar una cuota es mediante la edición de los límites en la página de cuota específica de la API.

  1. Ve a la página de cuotas en Cloud Console para limitar el uso de la API.
  2. Haz clic en el ícono de editar () de la cuota que deseas cambiar y, luego, ingresa el total de cuota que prefieres dentro del límite que especifica Google.
  3. Haz clic en Guardar para guardar los cambios.

Si quieres limitar una cuota que no aparece en esta página o quieres establecer un límite más alto que el máximo proporcionado, debes editar los límites. Sigue el proceso que se describe en Solicita una cuota mayor.

Administra la cuota con la API de Service Usage

Puedes usar estas API a fin de limitar el uso de la cuota o consultar los límites de cuota actuales para las API y los servicios de Google Cloud que administra Service Usage. 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

Además de poder ver la información básica de la cuota en Cloud Console, Google Cloud te permite supervisar el uso de la cuota y ver en más detalle los límites y errores con la IU y la API de Cloud Monitoring, ya que las métricas de cuotas aparecen en el Explorador de métricas. Puedes usar estas métricas para crear paneles y alertas personalizados que te permitan supervisar el uso de las cuotas en el tiempo y recibir alertas cuando, por ejemplo, te acercas al límite de una 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 de recuento de uso de cuota de asignación con un filtro quota_metric en los nombres de las Cloud TPU.

Para consultar las métricas de un recurso supervisado mediante el Explorador de métricas, haz lo siguiente:

  1. En Google Cloud Console, ve a Monitoring o usa el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación de Monitoring, haz clic en  Explorador de métricas.
  3. Asegúrate de que esté seleccionada la pestaña Métrica.
  4. Haz clic en el cuadro que tiene la etiqueta Find resource type and metric y, a continuación, selecciona el recurso y la métrica en el menú o ingresa sus nombres. Usa la siguiente información para completar los campos de este cuadro de texto:
    1. En el campo Recurso, selecciona o ingresa la cuota de consumidor en Consumer Quota.
    2. En el campo Métricas, selecciona o ingresa el uso de cuotas de asignación en Allocation quota usage para realizar la supervisión. Selecciona o ingresa el uso de la cuota de tarifa en Rate quota usage para supervisar la cuota.
  5. Para modificar la forma en que se muestran los datos, usa los menús Filtrar, Agrupar por y Aggregator. 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 haber encontrado 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 continuar supervisando y manteniendo una aplicación sólida. Puedes obtener información sobre cómo hacer esto en las siguientes páginas:

Revisa la sección Usa métricas de cuota en la documentación de Cloud Monitoring a fin de obtener más información y ejemplos de políticas de alertas comunes específicas para cuotas.

En la guía de referencia de Cloud Monitoring, encontrarás información detallada de las métricas de cuotas.

Errores de cuota

Si tu proyecto excede una cuota en particular cuando usa un servicio, la plataforma mostrará un error.

En general, Google Cloud mostrará un código de error 429 de HTTP si usas HTTP/REST para acceder al servicio o ResourceExhausted si usas gRPC. El modo en que se muestra este error depende del servicio.

Si usas Cloud Monitoring, puedes identificar la cuota asociada con el error y, luego, crear alertas personalizadas para cuando se genere un error de cuota, como se describe en la sección sobre cómo supervisar métricas de cuotas.