Trabaja con cuotas

Google Cloud aplica cuotas sobre el uso de recursos para propietarios de proyectos, lo que establece un límite en relación con qué tanto puede usar tu proyecto un recurso particular de Google Cloud. Las cuotas se dividen en las siguientes dos categorías:

  • Cuotas de límites, como la cantidad máxima de solicitudes a la API por día. Esta cuota se restablece luego de un tiempo específico del servicio, como un minuto o un día.
  • Cuotas de asignación, como la cantidad de instancias de máquina virtual (VM) o los balanceadores de cargas que usa tu proyecto en un momento determinado. Esta cuota no se restablece con el tiempo y debe retirarse de manera explícita cuando ya no quieras usar el recurso, por ejemplo, borrando un clúster de GKE.

Cada límite de cuota representa un recurso contable específico, como la cantidad de solicitudes a la API que se realizan por día hasta la cantidad de balanceadores de cargas que usa tu aplicación de forma simultánea.

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

  • Las cuotas protegen a la comunidad de usuarios de Google Cloud mediante la prevención de aumentos repentinos inesperados del uso.
  • Sirven para administrar los recursos. Por ejemplo, puedes establecer tus propios límites en el uso de servicios mientras desarrollas y pruebas tus aplicaciones.

Los diferentes proyectos pueden tener cuotas distintas para los mismos servicios. Por ejemplo, si usas una cuenta de prueba gratuita para explorar la plataforma, las cuotas serán más limitadas. Habilitar la facturación en tu proyecto aumenta las cuotas para la mayoría de los servicios, también puedes solicitar un aumento de cuota de un servicio en particular de forma explícita. Las cuotas también pueden aumentar a medida que incrementas el uso de Google Cloud con el tiempo.

Los límites de cuota en tu proyecto pueden verse afectados por anulaciones de cuota que se aplican mediante el propietario del servicio, el propietario del proyecto o el administrador de cuotas. Para obtener más información sobre cómo se calculan los límites de cuota, consulta el modelo de cuota de servicio.

Puedes configurar la supervisión y las alertas para realizar un seguimiento del uso de la cuota y enviarte una alerta en caso de vencimiento de la cuota o si hay un uso inusual.

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. Para obtener información sobre cómo ver otras métricas de uso de la API, consulta Supervisa el uso de la API.

Para encontrar la documentación sobre cuotas de un producto o servicio, usa la opción Buscar en cualquier página de documentación de Google Cloud y busca el nombre de servicio relevante y quota Por ejemplo, una búsqueda de cuota de “GKE” muestra la página de Cuotas y límites del servicio como primer resultado.

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

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.

También puedes ver y administrar la cuota de manera programática y desde la línea de comando. Puedes obtener más información más adelante en este documento.

Para obtener información sobre cómo supervisar el uso de las cuotas y cómo configurar alertas de cuota, consulta Supervisa y alerta sobre métricas de cuota.

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.

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.

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 los límites de cuota en Google Cloud Console mediante los pasos que se indican a continuación. 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 reconoce tu solicitud por correo electrónico.
  • Algunas cuotas no se pueden actualizar con Google Cloud Console. Si descubres que no puedes cambiar una cuota desde la consola, solicita el aumento desde Cloud Customer Care. El equipo de facturación no controla los aumentos de límite de cuota.

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

  1. Ir a la página de cuotas

    Ir a Cuotas

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

    1. Haz clic en TODOS CUOTAS en la fila de la cuota que deseas cambiar. En el PANEL de CUOTA, haz clic en la casilla de verificación Global.
    2. También puedes hacer clic en warning si se muestra en la columna Estado de la cuota. En el PANEL de CUOTA, haz clic en la casilla de verificación junto a la cuota que deseas cambiar.
  3. En la página principal Cuotas, haz clic en EDITAR CUOTAS.

  4. Complete el formulario de solicitud que se muestra a la derecha de la siguiente manera:

    1. En el campo Nuevo límite, ingresa la cuota mayor que solicitas.
    2. En el campo Descripción de la solicitud, ingresa el motivo de la solicitud. Es útil incluir información como planes de crecimiento futuros, expansión de región o zona 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 tu solicitud en Google Cloud Console, Google Cloud te envía un correo electrónico en el que se confirma la recepción de tu solicitud. Puedes responder a este correo electrónico si necesitas ayuda. Cloud Customer Care procesa tu solicitud, por lo general en un plazo de 2 a 3 días hábiles y, además, te envía un segundo correo electrónico en el que se te notifica si el aumento de la cuota se aprobó o rechazó. El correo electrónico proporcionará la fecha de entrada en vigor 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 para 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

    Si nunca usaste Cloud Monitoring, entonces, en tu primer acceso a Monitoring en Google Cloud Console, se creará un lugar de trabajo de forma automática y tu proyecto se asociará con ese lugar de trabajo. De lo contrario, si el proyecto no está asociado con un lugar de trabajo, aparecerá un diálogo y podrás crear uno o agregar tu proyecto a un lugar de trabajo existente. Te recomendamos que crees un lugar de trabajo. Después de realizar la selección, haz clic en Agregar.

  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. En el campo Find resource type and metric, selecciona el recurso y la métrica en el menú o ingresa sus nombres. 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.
  5. Para modificar cómo se muestran los datos, usa los menús Filtro, Agrupar por y Agregador. 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 crees 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.