Gestionar cuotas con la CLI de gcloud beta

En las siguientes secciones se incluyen ejemplos de los comandos gcloud beta quotas info y gcloud beta quotas preferences. Estos comandos te permiten ver y gestionar recursos QuotaInfo y QuotaPreference.

Puedes usar la CLI de Google Cloud (CLI de gcloud) para obtener los valores de cuota actuales y especificar las preferencias de cuota de algunas APIs y servicios. Google Cloud

Limitaciones

Cloud Quotas tiene las siguientes limitaciones:

  • En la mayoría de los casos, los ajustes de aumento de cuota deben hacerse a nivel de proyecto. Solo se pueden ajustar las cuotas de nivel de organización de un número limitado de productos. Para saber si un producto admite ajustes de aumento de cuota a nivel de organización, consulta la documentación de ese producto. Google Cloud

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

Antes de empezar

Antes de usar gcloud CLI, asegúrate de instalar e inicializar gcloud CLI.

También puede que necesites el valor QUOTA_ID. Si es así, consulta las instrucciones para encontrar tu ID de cuota.

Instalar e inicializar gcloud CLI

Para usar gcloud CLI en Cloud Quotas, asegúrate de instalar e inicializar los componentes:

  1. Instala gcloud CLI.

    Si usas Cloud Shell, puedes saltarte este paso porque la CLI de gcloud viene preinstalada.

  2. Inicializa gcloud CLI.

  3. Instala el componente beta ejecutando el siguiente comando:

    gcloud components install beta

Buscar tu ID de cuota

Varios comandos de la interfaz de línea de comandos de gcloud de este documento hacen referencia al valor de tu ID de cuota. Puedes encontrar el ID de cuota mediante la consola de Google Cloud, la CLI de gcloud, las bibliotecas de cliente o la API REST. Google Cloud En esta sección se muestra cómo encontrar el ID de cuota mediante la Google Cloud consola o la CLI de gcloud.

Consola

  1. En la Google Cloud consola, 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 filtrar por tu servicio.

  3. Si no ves la columna Nombre del límite, haz clic en el icono Opciones de visualización de columnas.... Seleccione Nombre del límite y haga clic en Aceptar.

  4. En la columna Nombre del límite se muestra el ID de la cuota.

gcloud

Para encontrar el valor del ID de cuota con la CLI de gcloud, ejecuta el siguiente comando para ver la información de cuota del servicio especificado:

  1. Introduce el siguiente comando de gcloud CLI en una ventana de terminal:

    gcloud beta quotas info list --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
--billing-project=BILLING_PROJECT_ID_OR_NUMBER

    Haz los cambios siguientes:

    • SERVICE_NAME: el nombre del servicio cuyas cuotas quieres consultar. Por ejemplo, el nombre del servicio de Compute Engine es compute.googleapis.com.

    • PROJECT_ID_OR_NUMBER: el ID o el número del proyecto

      Para encontrar el ID de tu proyecto con la consola, ve a la página Resource Manager: Google Cloud

      Ir a Gestor de recursos

    • BILLING_PROJECT_ID_OR_NUMBER: el ID o el número de proyecto para el uso de cuotas y facturación. Ejecutar un comando de gcloud afecta a la cuota como si hubieras hecho la solicitud equivalente directamente a través de una API REST o RPC.

      Especifica el proyecto cuya cuota quieres usar. Puede ser diferente del proyecto que contiene el servicio del que estás buscando el ID de cuota.

      Si ya has definido el proyecto de facturación al configurar la CLI de gcloud, esta marca es opcional. De lo contrario, si se omite, se puede producir un error de permiso denegado. Para obtener más información, consulta Definir el proyecto de cuota.

  2. La salida del comando gcloud beta quotas info list contiene texto similar al siguiente ejemplo:

    ...
"quotaInfos": [
    ...
    {
        "name": "projects/PROJECT_NUMBER/locations/global/services/compute.googleapis.com/quotaInfos/CPUS-per-project-region",
        "quotaId": "CPUS-per-project-region",
        "metric": "compute.googleapis.com/cpus",
        "containerType": "PROJECT",
        "dimensions": [
            "region"
        ],
        "dimensionsInfo": [
            {
                "details": {
                    "value": 20
                },
                "applicableLocations": [
                    "us-central1",
                    "us-central2",
                    "us-west1",
                    "us-east1"
                ]
                ...
            }
        ]
    },
    ...
]
...

  3. Busca el valor que corresponde a quotaId y úsalo al especificar QUOTA_ID en las siguientes secciones.

Ejemplos de comandos de información de cuotas de gcloud

En esta sección se muestran ejemplos de cómo usar los comandos gcloud beta quotas info para ver la información de cuota de un servicio concreto o de una organización.

QuotaInfo es un recurso de solo lectura que proporciona metadatos e información sobre el valor de cuota de una cuota concreta de un proyecto, una carpeta o una organización.

Ver información sobre la cuota de un servicio concreto

Para ver la información de la cuota de un servicio concreto, ejecuta el siguiente comando:

gcloud beta quotas info describe QUOTA_ID --service=SERVICE_NAME \
    --project=PROJECT_ID_OR_NUMBER --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Haz los cambios siguientes:

  • QUOTA_ID: el valor del ID de cuota. Para encontrar este valor, consulte Buscar el ID de cuota.
  • SERVICE_NAME: el nombre del servicio con las cuotas que quieres ver. Por ejemplo, el nombre del servicio de Compute Engine es compute.googleapis.com.
  • PROJECT_ID_OR_NUMBER: el ID o el número del proyecto

  • BILLING_PROJECT_ID_OR_NUMBER: el ID o el número de proyecto para el uso de cuotas y facturación. Ejecutar un comando de gcloud afecta a la cuota como si hubieras hecho la solicitud equivalente directamente a través de una API REST o RPC.

    Especifica el proyecto cuya cuota quieres usar. Puede ser diferente del proyecto que contiene el servicio del que estás consultando la información de la cuota.

    Si ya has definido el proyecto de facturación al configurar la CLI de gcloud, esta marca es opcional. De lo contrario, si se omite, se puede producir un error de permiso denegado. Para obtener más información, consulta Definir el proyecto de cuota.

Ver información sobre la cuota de una organización

Para ver los detalles de la cuota del mismo servicio en una organización, ejecuta el siguiente comando:

gcloud beta quotas info list --service=SERVICE_NAME --organization=ORGANIZATION_ID \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Haz los cambios siguientes:

  • SERVICE_NAME: el nombre del servicio con las cuotas que quieres ver. Por ejemplo, el nombre del servicio de Compute Engine es compute.googleapis.com.
  • ORGANIZATION_ID: el ID de tu organización

  • BILLING_PROJECT_ID_OR_NUMBER: el ID o el número de proyecto para el uso de cuotas y facturación. Ejecutar un comando de gcloud afecta a la cuota como si hubieras hecho la solicitud equivalente directamente a través de una API REST o RPC.

    Especifica el proyecto cuya cuota quieres usar. Puede ser diferente del proyecto que contiene el servicio del que estás consultando la información de la cuota.

    Si ya has definido el proyecto de facturación al configurar la CLI de gcloud, esta marca es opcional. De lo contrario, si se omite, se puede producir un error de permiso denegado. Para obtener más información, consulta Definir el proyecto de cuota.

Ejemplos de comandos de gcloud quota preferences

En esta sección se ofrecen ejemplos que muestran cómo usar los comandos gcloud beta quotas preferences para comprobar las preferencias de cuota y ajustar el valor de la cuota.

El recurso QuotaPreference representa tu preferencia por una combinación de dimensiones concreta. Una dimensión es un atributo que representa una región o una zona, o una dimensión específica de un servicio, como gpu_family o network_id.

Comprobar si ya hay preferencias

Para comprobar si hay preferencias, ejecuta el siguiente comando:

gcloud beta quotas preferences list --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Haz los cambios siguientes:

  • PROJECT_ID_OR_NUMBER : el ID o el número del proyecto

  • BILLING_PROJECT_ID_OR_NUMBER: el ID o el número de proyecto para el uso de cuotas y facturación. Ejecutar un comando de gcloud afecta a la cuota como si hubieras hecho la solicitud equivalente directamente a través de una API REST o RPC.

    Especifica el proyecto cuya cuota quieres usar. Puede ser diferente del proyecto para el que estás comprobando las preferencias de cuota.

    Si ya has definido el proyecto de facturación al configurar la CLI de gcloud, esta marca es opcional. De lo contrario, si se omite, se puede producir un error de permiso denegado. Para obtener más información, consulta Definir el proyecto de cuota.

Comprobar si hay preferencias con ajustes de cuota pendientes

Para comprobar si hay preferencias con ajustes de cuota pendientes, añade la marca --reconciling-only=true, como se muestra en el siguiente comando:

gcloud beta quotas preferences list --project=PROJECT_ID_OR_NUMBER --reconciling-only=true \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Haz los cambios siguientes:

  • PROJECT_ID_OR_NUMBER : el ID o el número del proyecto

  • BILLING_PROJECT_ID_OR_NUMBER: el ID o el número de proyecto para el uso de cuotas y facturación. Ejecutar un comando de gcloud afecta a la cuota como si hubieras hecho la solicitud equivalente directamente a través de una API REST o RPC.

    Especifica el proyecto cuya cuota quieres usar. Puede ser diferente del proyecto para el que estás comprobando las preferencias de cuota.

    Si ya has definido el proyecto de facturación al configurar la CLI de gcloud, esta marca es opcional. De lo contrario, si se omite, se puede producir un error de permiso denegado. Para obtener más información, consulta Definir el proyecto de cuota.

Solicitar un ajuste de aumento de cuota cuando aún no se ha definido una preferencia de cuota

Para solicitar un ajuste del aumento de cuota de una región específica cuando aún no se ha definido ninguna preferencia, ejecuta el siguiente comando:

gcloud beta quotas preferences create --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME  --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER --email=EMAIL \
    --justification=JUSTIFICATION --preference-id=PREFERENCE_ID

Haz los cambios siguientes:

  • PREFERRED_VALUE: el valor de cuota preferido
  • QUOTA_ID: el valor del ID de cuota. Para encontrar este valor, consulte Buscar el ID de cuota.
  • SERVICE_NAME: el nombre del servicio con las cuotas que quieres ver. Por ejemplo, el nombre del servicio de Compute Engine es compute.googleapis.com.
  • PROJECT_ID_OR_NUMBER: el ID o el número del proyecto

  • BILLING_PROJECT_ID_OR_NUMBER: el ID o el número de proyecto para el uso de cuotas y facturación. Ejecutar un comando de gcloud afecta a la cuota como si hubieras hecho la solicitud equivalente directamente a través de una API REST o RPC.

    Especifica el proyecto cuya cuota quieres usar. Puede ser diferente del proyecto para el que solicitas un ajuste de cuota.

    Si ya has definido el proyecto de facturación al configurar la CLI de gcloud, esta marca es opcional. De lo contrario, si se omite, se puede producir un error de permiso denegado. Para obtener más información, consulta Definir el proyecto de cuota.

  • EMAIL: una dirección de correo que se pueda usar como contacto en caso de que Google Cloud necesite más información para poder conceder cuota adicional.

  • JUSTIFICATION: una cadena opcional que explica tu solicitud.

  • PREFERENCE_ID: ID de preferencia opcional. Si no especificas un ID de preferencia, la API genera un identificador único universal (UUID)

Solicitar un ajuste de aumento de cuota cuando se haya definido una preferencia de cuota

Para solicitar un ajuste del aumento de la cuota de una región específica y ya hay una preferencia, ejecuta el siguiente comando:

gcloud beta quotas preferences update PREFERENCE_ID --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER --email=EMAIL  \
    --justification=JUSTIFICATION

Haz los cambios siguientes:

  • PREFERENCE_ID: el ID de preferencia, que es obligatorio como primer argumento al usar el comando gcloud beta quotas preferences update.
  • PREFERRED_VALUE: el valor de cuota preferido
  • QUOTA_ID: el valor del ID de cuota. Para encontrar este valor, consulte Buscar el ID de cuota.
  • SERVICE_NAME: el nombre del servicio con las cuotas que quieres ver. Por ejemplo, el nombre del servicio de Compute Engine es compute.googleapis.com.
  • PROJECT_ID_OR_NUMBER: el ID o el número del proyecto

  • BILLING_PROJECT_ID_OR_NUMBER: el ID o el número de proyecto para el uso de cuotas y facturación. Ejecutar un comando de gcloud afecta a la cuota como si hubieras hecho la solicitud equivalente directamente a través de una API REST o RPC.

    Especifica el proyecto cuya cuota quieres usar. Puede ser diferente del proyecto para el que solicitas un ajuste de cuota.

    Si ya has definido el proyecto de facturación al configurar la CLI de gcloud, esta marca es opcional. De lo contrario, si se omite, se puede producir un error de permiso denegado. Para obtener más información, consulta Definir el proyecto de cuota.

  • EMAIL: una dirección de correo que se pueda usar como contacto en caso de que Google Cloud necesite más información para poder conceder cuota adicional.

  • JUSTIFICATION: una cadena opcional que explica tu solicitud.

Solicitar un ajuste de aumento de cuota mediante una dimensión

Para solicitar un ajuste del aumento de cuota mediante una dimensión, ejecuta el siguiente comando:

gcloud beta quotas preferences create --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
    --dimensions=KEY1=VALUE1,KEY2=VALUE2,... --billing-project=BILLING_PROJECT_ID_OR_NUMBER \
    --email=EMAIL --justification=JUSTIFICATION --preference-id=PREFERENCE_ID

Haz los cambios siguientes:

  • PREFERRED_VALUE: el valor de cuota preferido
  • QUOTA_ID: el valor del ID de cuota. Para encontrar este valor, consulte Buscar el ID de cuota.
  • SERVICE_NAME: el nombre del servicio con las cuotas que quieres ver. Por ejemplo, el nombre del servicio de Compute Engine es compute.googleapis.com.
  • PROJECT_ID_OR_NUMBER: el ID o el número del proyecto
  • KEY1=VALUE1,KEY2=VALUE2,...: una lista opcional que especifica su dimensión como una lista de pares clave-valor separados por comas. Por ejemplo, su dimensión puede especificar los siguientes valores de Compute Engine:
    • KEY1=VALUE1: region=us-east4
    • KEY2=VALUE2: gpu_family=NVIDIA_H100

  • BILLING_PROJECT_ID_OR_NUMBER: el ID o el número de proyecto para el uso de cuotas y facturación. Ejecutar un comando de gcloud afecta a la cuota como si hubieras hecho la solicitud equivalente directamente a través de una API REST o RPC.

    Especifica el proyecto cuya cuota quieres usar. Puede ser diferente del proyecto para el que solicitas un ajuste de cuota.

    Si ya has definido el proyecto de facturación al configurar la CLI de gcloud, esta marca es opcional. De lo contrario, si se omite, se puede producir un error de permiso denegado. Para obtener más información, consulta Definir el proyecto de cuota.

  • EMAIL: una dirección de correo que se pueda usar como contacto en caso de que Google Cloud necesite más información para poder conceder cuota adicional.

  • JUSTIFICATION: una cadena opcional que explica tu solicitud.

  • PREFERENCE_ID: ID de preferencia opcional. Si no especificas un ID de preferencia, la API genera un identificador único universal (UUID)

La salida contendría datos específicos de tu configuración y sería similar a la siguiente salida de ejemplo:

{
    "createTime":"CREATE_TIME",
    "dimensions":{
        "gpu_family":"NVIDIA_H100",
        "region":"us-east4"
    },
    "etag":"ETAG_VALUE",
    "name":"projects/12345/locations/global/quotaPreferences/PREFERENCE_ID",
    "quotaConfig":{
        "grantedValue":"0",
        "preferredValue":"128",
        "traceId":"TRACE_ID"
    },
    "quotaId":"GPUS-PER-GPU-FAMILY-per-project-region",
    "reconciling":true,
    "service":"compute.googleapis.com",
    "updateTime":"UPDATE_TIME",
}

Ver una preferencia de cuota

Para ver los detalles de la preferencia de cuota que acabas de crear, ejecuta el siguiente comando:

gcloud beta quotas preferences describe PREFERENCE_ID \
    --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

Haz los cambios siguientes:

  • PREFERENCE_ID: el ID de preferencia, que es obligatorio como primer argumento al usar el comando gcloud beta quotas preferences describe.
  • PROJECT_ID_OR_NUMBER: el ID o el número del proyecto

  • BILLING_PROJECT_ID_OR_NUMBER: el ID o el número de proyecto para el uso de cuotas y facturación. Ejecutar un comando de gcloud afecta a la cuota como si hubieras hecho la solicitud equivalente directamente a través de una API REST o RPC.

    Especifica el proyecto cuya cuota quieres usar. Puede ser diferente del proyecto para el que estás viendo la preferencia de cuota.

    Si ya has definido el proyecto de facturación al configurar la CLI de gcloud, esta marca es opcional. De lo contrario, si se omite, se puede producir un error de permiso denegado. Para obtener más información, consulta Definir el proyecto de cuota.

La salida contendría datos específicos de tu configuración y sería similar a la siguiente salida de ejemplo:

createTime: 'CREATE_TIME'
dimensions:
  gpu_family: NVIDIA_H100
  region: us-east4
etag: ETAG_VALUE
name: projects/12345/locations/global/quotaPreferences/PREFERENCE_ID
quotaConfig:
  grantedValue: '0'
  preferredValue: '128'
  traceId: TRACE_ID
quotaId: GPUS-PER-GPU-FAMILY-per-project-region
reconciling: true
service: compute.googleapis.com
updateTime: 'UPDATE_TIME'

Habilitar el ajustador de cuotas a través de un proyecto de cliente

Un proyecto de cliente es el proyecto que usa una aplicación o un usuario para acceder a los recursos de Google Cloud e interactuar con ellos, mientras que un proyecto de recursos es el proyecto subyacente en el que se almacenan y gestionan esos recursos.

Para habilitar el ajustador de cuotas a través de un proyecto de cliente mediante la CLI de gcloud, sigue estos pasos:

  1. Crear un proyecto de cliente:

    gcloud projects create CLIENT_PROJECT_ID
gcloud config set project CLIENT_PROJECT_ID

    Sustituye CLIENT_PROJECT_ID por el ID del proyecto que quieras crear. Los IDs de proyecto son inmutables y solo se pueden definir durante la creación del proyecto. Deben empezar por una letra minúscula y pueden incluir letras ASCII minúsculas, dígitos o guiones. Los IDs de proyecto deben tener entre 6 y 30 caracteres.

  2. Habilita la API Cloud Quotas en el proyecto del cliente:

    gcloud services enable cloudquotas.googleapis.com

  3. Crea una cuenta de servicio en el proyecto del cliente:

    gcloud iam service-accounts create SA_NAME \
  --display-name SA_DISPLAY_NAME \
  --project=CLIENT_PROJECT_ID

    Haz los cambios siguientes:

    • SA_NAME: el nombre interno de la nueva cuenta de servicio. Se usa para generar una IAM_ACCOUNT (una dirección de correo interna de IAM que se usa como identificador de la cuenta de servicio), que debe transferirse a los comandos posteriores.
    • SA_DISPLAY_NAME: el nombre visible de la cuenta de servicio.
    • CLIENT_PROJECT_ID: el ID del proyecto de cliente.

  4. Crea una clave de cuenta de servicio: 

    gcloud iam service-accounts keys create KEY_FILE \
  --iam-account=SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com

    Haz los cambios siguientes:

    • KEY_FILE: la ruta al archivo JSON de la clave de la cuenta de servicio.
    • SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com: la dirección de correo de la cuenta de servicio.

  5. Concede permisos de gestión de identidades y accesos a la cuenta de servicio:

    gcloud projects add-iam-policy-binding CLIENT_PROJECT_ID \
  --member="serviceAccount:SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/serviceusage.serviceUsageConsumer"

gcloud projects add-iam-policy-binding RESOURCE_PROJECT_ID \
  --member="serviceAccount:SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/cloudquotas.admin"

    Haz los cambios siguientes:

    • CLIENT_PROJECT_ID: el ID del proyecto de cliente.
    • RESOURCE_PROJECT_ID: el ID del proyecto de recursos.
    • SA_NAME@CLIENT_PROJECT_ID.iam.gserviceaccount.com: la dirección de correo de la cuenta de servicio.

  6. Activa la cuenta de servicio con la clave que has creado antes:

    gcloud auth activate-service-account --key-file=KEY_FILE

  7. Habilita el ajustador de cuotas en tu proyecto de recursos especificando el proyecto y el ajuste de habilitación:

    gcloud beta quotas adjuster settings update --project=RESOURCE_PROJECT_ID \
  --enablement=enabled

    Esta opción es obligatoria cuando se usa la CLI de gcloud y debe tener el valor enabled o disabled.

  8. Opcional: Para ver la configuración actual del ajustador de cuotas, ejecuta el siguiente comando:

    gcloud beta quotas adjuster settings describe --project=RESOURCE_PROJECT_ID

    La salida es similar al siguiente ejemplo:

    enablement: ENABLED
etag: 8izmJp6EI__mOfLyhkQU9
name: projects/RESOURCE_PROJECT_ID/locations/global/quotaAdjusterSettings
updateTime: '2025-01-10T17:22:37.883221181Z'

Para habilitar el ajustador de cuotas en varios proyectos de cliente, sigue los pasos del 5 al 8 anteriores. Cuando lo hagas, asegúrate de que se cumplan las siguientes condiciones:

  • La API Cloud Quotas está habilitada en el proyecto del cliente.
  • Asegúrate de que la cuenta de servicio tenga el rol de gestión de identidades y accesos cloudquotas.adminen todos los proyectos de recursos en los que quieras habilitar el ajustador de cuotas.

Otros servicios con comandos de la interfaz de línea de comandos de gcloud relacionados con las cuotas

Además de gcloud beta quotas, 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 la información de las cuotas. Para obtener más información, consulta las siguientes secciones de Compute Engine:

Siguientes pasos