Ve y administra cuotas

En este documento, se describe cómo puedes ver los valores de cuota en la consola deGoogle Cloud . También puedes administrar las cuotas desde laGoogle Cloud consola, la API de Cloud Quotas y Google Cloud CLI (gcloud CLI).

Limitaciones

Cloud Quotas tiene las siguientes limitaciones:

  • En la mayoría de los casos, los ajustes de aumento de cuota deben realizarse a nivel del proyecto. Una cantidad limitada de productos admite ajustes de aumento de cuota a nivel de la organización. Para saber si un producto Google Cloud admite ajustes de aumento de cuota a nivel de la organización, consulta la documentación de ese producto.

  • Puedes solicitar ajustes de disminución de cuota para cuotas a nivel de proyecto, organización y carpeta.

Antes de comenzar

Las tareas de este documento requieren roles de Identity and Access Management (IAM).

Roles obligatorios

Para obtener los permisos que necesitas para solicitar ajustes de cuota, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto, la carpeta o la organización:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para solicitar ajustes de cuota. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para solicitar ajustes de cuota:

  • Para solicitar ajustes de cuota, sigue estos pasos: serviceusage.quotas.update

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Consulta las cuotas en la consola de Google Cloud

Puedes ver los valores de cuota actuales en dos áreas diferentes de la consola deGoogle Cloud :

Consulta las cuotas de tu proyecto

En la página IAM y administración > Cuotas y límites del sistema, 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 Quota, 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.

Para ver los valores y el uso de cuota de todos los recursos de tu proyecto, sigue estos pasos:

Console

  1. En la consola de Google Cloud , ve a la página IAM y administración > Cuotas y límites del sistema:

    Ir a Cuotas y límites del sistema

  2. Para enfocarte en la información que necesitas, filtra y ordena la lista de la siguiente manera:

    • Para filtrar la lista, ingresa las propiedades y los valores en el campo. 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.

  3. Opcional: Para inspeccionar el uso agregado de cuota a nivel de carpeta y organización, elige la organización o carpeta en el selector de recursos.

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 Porcentaje de uso actual y Uso actual. El uso actual se calcula de acuerdo con los siguientes criterios:

  • Para cuotas de minutos por minuto:

    • El promedio de uso por minuto en los últimos 10 minutos.

  • Para las cuotas de tarifa por día:

    • El uso total hasta el momento en el día actual, según la hora estándar del Pacífico.

  • Para las cuotas de asignación:

    • El valor más reciente. Por ejemplo, puede que esta cantidad muestre la cantidad de balanceadores de cargas que usa tu proyecto.

  • Para cuotas simultáneas:

    • El valor más reciente. Por ejemplo, este número puede mostrar la cantidad de vuelos_insert_operations de un servicio determinado.

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.

Cómo ver y exportar el uso de la cuota a lo largo del tiempo

Puedes ver el uso de la cuota a lo largo del tiempo con gráficos. En la página Cuotas y límites del sistema de la consola, se proporcionan gráficos para cada cuota o límite del sistema individual que se encuentra en la tabla Cuotas y límites del sistema. Después de ver un gráfico, puedes exportarlo. Para ver y exportar un gráfico, sigue estos pasos:

Console

  1. En la consola de Google Cloud , ve a la página IAM y administración > Cuotas y límites del sistema:

    Ir a Cuotas y límites del sistema

  2. Busca la cuota o el límite del sistema que te interesa. En la entrada de esta cuota o límite del sistema, haz clic en Mostrar gráfico de uso. Se abrirá la vista de gráfico.

  3. En la vista del gráfico, establece el período. El valor predeterminado es de 7 días. Para cambiarlo, haz clic en el menú de período y selecciona el período que desees.

  4. Para exportar el gráfico, haz clic en Más opciones del gráfico y, luego, selecciona Descargar > Descargar PNG. El gráfico se descarga como un archivo PNG.

Para obtener más información sobre los gráficos, consulta Configura alertas y supervisión de cuotas.

Cómo ver las cuotas específicas 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 Google Cloud consola. Según 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.

Si no hay ningún valor para una cuota determinada, el valor aparece como Unlimited.

Puedes ver los límites actuales de una API en particular en dos áreas diferentes de la consola de Google Cloud : en la página Cuotas y límites del sistema de la consola de Google Cloud o en la página APIs y servicios. Usa la vista de consola que prefieras:

Console

  • Para ver las cuotas específicas de la API en la página Cuotas y límites del sistema con un filtro, sigue estos pasos:

    1. En la consola de Google Cloud , ve a la página IAM y administración > Cuotas y límites del sistema:

      Ir a Cuotas y límites del sistema

    2. Haz clic en Filtro y selecciona Servicio en el menú que aparece.

    3. Selecciona o ingresa el nombre del servicio que quieres ver.

      En la página, se muestra información sobre las cuotas y los límites del sistema para la API especificada. Los números que aparecen en la columna Value son los valores de cuota predeterminados, a menos que hayas realizado un ajuste de cuota.

  • Para ver las cuotas específicas de la API desde la página APIs y servicios, haz lo siguiente:

    1. Ve a la página APIs y servicios:

      Ir a API y servicios

    2. Elige tu proyecto.

    3. Haz clic en el nombre de la API del servicio que deseas ver.

    4. Haz clic en la pestaña Cuotas y límites del sistema.

      En la página, se muestra información sobre las cuotas y los límites del sistema para la API especificada. Los números que aparecen en la columna Value son los valores de cuota predeterminados, a menos que hayas realizado un ajuste de cuota.

Para ver el uso a lo largo del tiempo, haz clic en Mostrar gráfico de uso.

Filtrar cuotas

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

Console

  1. En la consola de Google Cloud , ve a la página IAM y administración > Cuotas y límites del sistema:

    Ir a Cuotas y límites del sistema

  2. Haz clic en Filtrar para consultar tus cuotas por un nombre o valor de propiedad específico.

Administra tus cuotas con la consola

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

Solicita un ajuste de cuota

Las solicitudes de ajuste de cuotas de Cloud están sujetas a revisión. Si tu solicitud de ajuste de cuota requiere una revisión, recibirás un correo electrónico en el que se confirmará la recepción de la solicitud. Si necesitas asistencia adicional, responde el correo electrónico. Después de revisar tu solicitud, recibirás una notificación por correo electrónico en la que se indicará si se aprobó. Puedes solicitar un ajuste de cuota a través de la consola de Google Cloud , la API de Cloud Quotas o Google Cloud CLI. En las siguientes instrucciones, se muestra cómo solicitar un nuevo valor de cuota con la consola de Google Cloud o con una solicitud de REST a la API de Cloud Quotas.

Console

Para solicitar un ajuste de cuota, sigue estos pasos:

  1. En la consola de Google Cloud , ve a la página IAM y administración > Cuotas y límites del sistema:

    Ir a Cuotas y límites del sistema

    Si se te solicita que selecciones un proyecto, elige el que quieras ajustar.

  2. Busca la cuota que deseas ajustar y abre el diálogo Cambios de cuota:

    • Cuotas que no se incluyen en la tabla:

      • Busca tu cuota en el cuadro de búsqueda Filtrar. No especifiques la región o la zona (si corresponde), ya que las cuotas que no tienen valores de uso o ajustados no se muestran en la tabla.
      • Busca cualquier entrada de tu cuota en la tabla. Puede ser la entrada predeterminada o cualquier entrada con historial, independientemente de la región o la zona.
      • En la línea de la entrada, haz clic en Más acciones > Configurar regiones o zonas adicionales.
      • Selecciona la región o zona que deseas ajustar. Haz clic en Editar.

    • Todas las demás cuotas:

      • Busca tu cuota en el cuadro de búsqueda Filtrar.
      • En la línea de la entrada, selecciona la casilla de verificación de tu cuota.
      • Haz clic en Editar.

    Aparecerá el diálogo Cambios en la cuota.

  3. Si ves un vínculo a Solicitar una cuota mayor sobre el campo Valor nuevo y quieres aumentar el valor de tu cuota más allá del número indicado en la pantalla, sigue el vínculo. Completa el formulario, envíalo y omite los pasos restantes aquí. De lo contrario, continúa siguiendo esta guía.

  4. En el campo Valor nuevo, ingresa el valor de cuota aumentado que deseas. Si aparece el campo Descripción de la solicitud, ingresa una descripción. Haz clic en Listo.

    • Si ves una casilla de verificación con el texto "Comprendo que esta solicitud quitará cualquier anulación", el valor de tu cuota se estableció por debajo del predeterminado. Si ajustas el valor de la cuota al valor predeterminado o por sobre este, se quitará la anulación. Para continuar, selecciona la casilla de verificación. Obtén más información sobre las anulaciones de cuotas.

    Si aparece el botón Siguiente, haz clic en Siguiente y completa los detalles de tu contacto en la pantalla que aparece a continuación.

  5. Haz clic en Enviar solicitud.

Si notas que no puedes solicitar un ajuste desde la consola, solicita el aumento desde Atención al cliente de Cloud.

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

Agrupación de solicitudes para ajustes de cuota

Para enviar solicitudes por lotes de ajustes de cuota, selecciona la casilla de verificación de cada cuota que quieras incluir. Sin embargo, las solicitudes por lotes pueden aumentar el tiempo que Google Cloud tarda en revisar tu solicitud.

Para reducir el tiempo de revisión, agrupa las solicitudes de ajuste de cuota por producto y área. Por ejemplo, si quieres solicitar ajustes en las cuotas de redes y de VM de Compute Engine, crea una solicitud para las cuotas de redes y otra para las cuotas de VMs de Compute Engine.

REST

Para solicitar un ajuste de cuota a la API de Cloud Quotas, usa la siguiente muestra de código. Completa los marcadores de posición editables con tus valores. Para obtener información sobre los campos de marcador de posición, consulta las descripciones que se encuentran después de la muestra de código.

POST projects/PROJECT_NUMBER/locations/global/quotaPreferences?quotaPreferenceId=QUOTA_PREFERENCE_ID {
    "service": "SERVICE_ID",
    "quotaId": "QUOTA_ID",
    "quotaConfig": { "preferredValue": "NEW_QUOTA_VALUE" },
    "dimensions": { "DIMENSION_1": "VALUE_1", "DIMENSION_2": "VALUE_2" },
    "justification": "JUSTIFICATION",
    "contactEmail": "EMAIL"
}

Reemplaza lo siguiente:

  • PROJECT_NUMBER: Es el número de tu proyecto de Google Cloud . Puedes encontrar el número del proyecto en la página de bienvenida de la consola de Google Cloud o ejecutando el siguiente comando de gcloud CLI:

    PROJECT=$(gcloud info --format='value(config.project)')
gcloud projects describe ${PROJECT} --format="value(projectNumber)"

  • QUOTA_PREFERENCE_ID: Es el ID de la preferencia de cuota que actualizas.

  • QUOTA_ID: Es el ID de la cuota que actualizas.

  • SERVICE_ID: Es el ID del Google Cloud al que pertenece la cuota que ajustas. Por lo general, tiene el formato SERVICE_NAME.googleapis.com. Por ejemplo, el nombre del servicio de Compute Engine es compute.googleapis.com.

  • DIMENSION_1: Es el tipo de dimensión que deseas ajustar, por ejemplo, region o zone. Puedes incluir varias dimensiones. Separa cada dimensión con una coma después de su valor, por ejemplo, VALUE_1. Para ajustar todas las dimensiones de la cuota, omite esta línea.

  • VALUE_1: Es el valor de la dimensión anterior. Por ejemplo, si la dimensión anterior es region, ingresa una región como us-central1.

  • JUSTIFICATION: Es el motivo de esta solicitud.

  • EMAIL: Una dirección de correo electrónico que se puede usar como contacto, en caso de que Google Cloud necesite más información para tomar una decisión antes de que se pueda otorgar una cuota adicional

Ejemplo de solicitud

A continuación, se muestra un ejemplo de una solicitud de aumento del valor de la cuota para la cuota de Compute Engine PUS-PER-GPU-FAMILY-per-project-region. Solicita un valor de cuota de 100 para las máquinas de la familia de GPU NVIDIA_H100 que se encuentran en la región us-central1.

POST projects/123/locations/global/quotaPreferences?quotaPreferenceId=my_quota_preference_ID {
    "service": "compute.googleapis.com",
    "quotaId": "GPUS-PER-GPU-FAMILY-per-project-region",
    "quotaConfig": { "preferredValue": 100 },
    "dimensions": { "region": "us-central1", "gpu_family": "NVIDIA_H100" },
    "justification": "My justification.",
    "contactEmail": "222larabrown@gmail.com"
}

Consulta las solicitudes de aumento de cuota

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

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

Console

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

  2. En la consola de Google Cloud , ve a la página IAM y administración > Cuotas y límites del sistema:

    Ir a Cuotas y límites del sistema

  3. Aparecerá un ícono Pendiente junto a los valores de cuota que tienen pendiente una decisión para las solicitudes de aumento enviadas antes. Haz 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 ajuste de cuota está por enviarse.

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

Console

  1. En la consola de Google Cloud , ve a la página IAM y administración > Cuotas y límites del sistema:

    Ir a Cuotas y límites del sistema

  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.

Cuando se selecciona una organización o carpeta, la página muestra todas las solicitudes de aumento de cuota para todos los proyectos dentro de esta.

Crea una anulación de cuota

Para restringir el uso de un recurso en particular, crea una anulación de cuota cambiando el valor de la cuota a un valor inferior al valor de la cuota predeterminada. A veces, crear una anulación de cuota se denomina limitar el uso.

Para crear una anulación de cuota, sigue los pasos para actualizar un valor de cuota.

Las anulaciones de cuotas no están disponibles para todos los servicios. Para obtener información específica del servicio, consulta la documentación sobre los límites del sistema y las cuotas de tu servicio.

Restablece el valor de una cuota

Para restablecer el valor de la cuota después de aplicar una anulación, sigue estos pasos:

Console

  1. En la consola de Google Cloud , ve a la página IAM y administración > Cuotas y límites del sistema:

    Ir a Cuotas y límites del sistema

  2. Ingresa texto en el cuadro de búsqueda Filtrar para buscar tu cuota. Configura Tiene anulación: Verdadero para mostrar solo las cuotas que tienen una anulación.

  3. En la página Cuotas, aparece Anular junto a los límites de cuota que tienen una anulación. Haz clic en Anular para ver los detalles de esta cuota y una opción para restablecer el valor.

  4. Para confirmar que un restablecimiento quita tus anulaciones, haz clic en la casilla de verificación anterior a Restablecer valor y, luego, haz clic en Restablecer valor para restablecer la cuota.

A fin de restablecer una cuota de forma manual, sigue los mismos pasos que para solicitar un límite de cuota más alto. Asegúrate de que el Valor nuevo sea igual al Valor predeterminado que se muestra debajo del nombre de la cuota en el formulario Cambios en la cuota.

Administra cuotas con la API de Cloud Quotas

Puedes usar la API de Cloud Quotas para obtener información sobre la cuota actual y establecer preferencias de cuota para las APIs y los servicios de Google Cloud . Para obtener más información, consulta lo siguiente:

Administra cuotas con gcloud CLI

Para usar gcloud CLI, asegúrate de haber instalado y luego inicializado la última versión de gcloud CLI, incluido el componente de comandos beta. Si usas Cloud Shell para interactuar con Google Cloud, se instala gcloud CLI de manera automática.

Consulta las siguientes secciones para obtener más información:

Solicita cuota para el proyecto

Para obtener más información sobre cómo solicitar cuotas de proyecto adicionales, consulta el artículo de asistencia sobre solicitudes de cuotas de proyecto.

¿Qué sigue?