Administra cuotas con la CLI de gcloud beta

Las siguientes secciones contienen los comandos gcloud beta quotas info y gcloud beta quotas preferences de ejemplo. Estos comandos te permiten ver y administrar los recursos QuotaInfo y QuotaPreference.

Puedes usar Google Cloud CLI (gcloud CLI) para obtener valores de cuotas y especificar las preferencias de cuota para algunos servicios y APIs de Google Cloud .

Limitaciones

Cloud Quotas tiene las siguientes limitaciones:

  • En la mayoría de los casos, los ajustes de aumento de cuota deben realizarse a nivel de proyecto. Una cantidad limitada de productos admite ajustes de aumento de cuota a nivel de la organización. Para ver si un producto de 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.

  • La API de Cloud Quotas solo admite operaciones a nivel del proyecto. No se admiten las operaciones a nivel de carpeta y de organización.

Antes de comenzar

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

Es posible que también necesites tu valor QUOTA_ID. Si es así, consulta las instrucciones para encontrar tu ID de cuota.

Instala e inicializa la CLI de gcloud

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

  1. Instala la CLI de gcloud.

    Si usas Cloud Shell, puedes omitir este paso porque gcloud CLI viene preinstalado.

  2. Inicializa la CLI de gcloud.

  3. Para instalar el componente beta, ejecuta el siguiente comando:

    gcloud components install beta

Encuentra el ID de tu cuota

Varios comandos de gcloud CLI en esta página hacen referencia al valor de tu ID de cuota. Puedes encontrar el ID de cuota con la consola de Google Cloud, gcloud CLI, las bibliotecas cliente o la API de REST. En esta sección, se muestra cómo encontrar el ID de cuota con la consola de Google Cloud o gcloud CLI.

Console

  1. Ve a la página Cuotas y límites del sistema:

    Ir a Cuotas y límites del sistema

  2. Haz clic en Filtrar para filtrar tu servicio.

  3. Si no ves la columna Nombre del límite, haz clic en el ícono Opciones de visualización de columnas…. Selecciona Limitar nombre y haz clic en Aceptar.

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

gcloud

Para encontrar el valor de ID de cuota con gcloud CLI, ejecuta el siguiente comando para obtener una lista con la información sobre tu cuota para el servicio especificado:

  1. Ingresa 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

    Reemplaza lo siguiente:

    • SERVICE_NAME: el nombre del servicio con cuotas que deseas ver, por ejemplo, el nombre del servicio de Compute Engine es compute.googleapis.com

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

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

      Ir al administrador de recursos

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

      Especifica el proyecto cuya cuota deseas usar. Puede ser diferente del proyecto que contiene el servicio para el que buscas el ID de cuota.

      Si ya configuraste el proyecto de facturación cuando configuraste gcloud CLI, esta marca es opcional. De lo contrario, omitir esta opción podría generar un error de permiso denegado. Para obtener más información, consulta Configura el proyecto de cuota.

  2. El resultado 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 corresponda a quotaId y úsalo cuando especifiques QUOTA_ID en las siguientes secciones.

Ejemplo de comandos de información de cuotas de gcloud

En esta sección, se proporcionan ejemplos que muestran cómo usar comandos gcloud beta quotas info para ver la información de la cuota de un servicio específico o de una organización.

QuotaInfo es un recurso de solo lectura que proporciona metadatos e información del valor de la cuota sobre una cuota en particular para una carpeta, organización o proyecto determinado.

Consulta la información sobre las cuotas de un servicio en particular

Para ver la información sobre la cuota de un servicio en particular, 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

Reemplaza lo siguiente:

  • QUOTA_ID: Es el valor del ID de la cuota. Para encontrar este valor, consulta Encuentra el ID de tu cuota.
  • SERVICE_NAME: el nombre del servicio con cuotas que deseas ver, por ejemplo, el nombre del servicio de Compute Engine es compute.googleapis.com
  • PROJECT_ID_OR_NUMBER: el ID o número del proyecto.

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

    Especifica el proyecto cuya cuota deseas usar. Esto puede ser diferente del proyecto que contiene el servicio para el que estás viendo la información de la cuota.

    Si ya configuraste el proyecto de facturación cuando configuraste gcloud CLI, esta marca es opcional. De lo contrario, omitir esta opción podría generar un error de permiso denegado. Para obtener más información, consulta Configura el proyecto de cuota.

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

Para ver los detalles de cuota del mismo servicio de 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

Reemplaza lo siguiente:

  • SERVICE_NAME: el nombre del servicio con cuotas que deseas 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 número o ID del proyecto para el uso de la facturación y la cuota. Ejecutar un comando de gcloud afecta la cuota como si realizaras la solicitud equivalente directamente a través de una API de REST o RPC.

    Especifica el proyecto cuya cuota deseas usar. Esto puede ser diferente del proyecto que contiene el servicio para el que estás viendo la información de la cuota.

    Si ya configuraste el proyecto de facturación cuando configuraste gcloud CLI, esta marca es opcional. De lo contrario, omitir esta opción podría generar un error de permiso denegado. Para obtener más información, consulta Configura el proyecto de cuota.

Ejemplo de comandos de preferencias de cuotas de gcloud

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

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

Verifica si hay preferencias existentes

Para verificar las preferencias existentes, ejecuta el siguiente comando:

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

Reemplaza lo siguiente:

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

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

    Especifica el proyecto cuya cuota deseas usar. Puede ser diferente del proyecto para el que verificas las preferencias de cuota.

    Si ya configuraste el proyecto de facturación cuando configuraste gcloud CLI, esta marca es opcional. De lo contrario, omitir esta opción podría generar un error de permiso denegado. Para obtener más información, consulta Configura el proyecto de cuota.

Verifica las preferencias existentes con ajustes de cuota pendientes

Para verificar las preferencias existentes con ajustes de cuota pendientes, agrega 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

Reemplaza lo siguiente:

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

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

    Especifica el proyecto cuya cuota deseas usar. Puede ser diferente del proyecto para el que verificas las preferencias de cuota.

    Si ya configuraste el proyecto de facturación cuando configuraste gcloud CLI, esta marca es opcional. De lo contrario, omitir esta opción podría generar un error de permiso denegado. Para obtener más información, consulta Configura el proyecto de cuota.

Solicita un ajuste de aumento de cuota cuando aún no se estableció una preferencia de cuota

Para solicitar un ajuste de aumento de cuota en una región específica cuando se aplica una preferencia aún no se configuró; 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

Reemplaza lo siguiente:

  • PREFERRED_VALUE: el valor de cuota preferido.
  • QUOTA_ID: Es el valor del ID de la cuota. Para encontrar este valor, consulta Encuentra el ID de tu cuota.
  • SERVICE_NAME: el nombre del servicio con cuotas que deseas ver, por ejemplo, el nombre del servicio de Compute Engine es compute.googleapis.com
  • PROJECT_ID_OR_NUMBER: el ID o número del proyecto.

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

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

    Si ya configuraste el proyecto de facturación cuando configuraste gcloud CLI, esta marca es opcional. De lo contrario, omitir esta opción podría generar un error de permiso denegado. Para obtener más información, consulta Configura el proyecto de cuota.

  • 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 antes de que se pueda otorgar una cuota adicional

  • JUSTIFICATION: Es una cadena opcional que explica tu solicitud.

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

Solicita un ajuste de aumento de cuota cuando se haya establecido una preferencia de cuota

Para solicitar un ajuste de aumento de cuota en una región específica y ya existe 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

Reemplaza lo siguiente:

  • PREFERENCE_ID: Es el ID de preferencia, que es obligatorio como primer argumento cuando se usa el comando gcloud beta quotas preferences update.
  • PREFERRED_VALUE: el valor de cuota preferido.
  • QUOTA_ID: Es el valor del ID de la cuota. Para encontrar este valor, consulta Encuentra el ID de tu cuota.
  • SERVICE_NAME: el nombre del servicio con cuotas que deseas ver, por ejemplo, el nombre del servicio de Compute Engine es compute.googleapis.com
  • PROJECT_ID_OR_NUMBER: el ID o número del proyecto.

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

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

    Si ya configuraste el proyecto de facturación cuando configuraste gcloud CLI, esta marca es opcional. De lo contrario, omitir esta opción podría generar un error de permiso denegado. Para obtener más información, consulta Configura el proyecto de cuota.

  • 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 antes de que se pueda otorgar una cuota adicional

  • JUSTIFICATION: Es una cadena opcional que explica tu solicitud.

Solicita un ajuste de aumento de cuota con una dimensión

Para solicitar un ajuste de aumento de cuota con 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

Reemplaza lo siguiente:

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

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

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

    Si ya configuraste el proyecto de facturación cuando configuraste gcloud CLI, esta marca es opcional. De lo contrario, omitir esta opción podría generar un error de permiso denegado. Para obtener más información, consulta Configura el proyecto de cuota.

  • 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 antes de que se pueda otorgar una cuota adicional

  • JUSTIFICATION: Es una cadena opcional que explica tu solicitud.

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

El resultado contendría datos específicos de tu configuración y sería similar al siguiente resultado 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",
}

Visualiza una preferencia de cuota existente

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

Reemplaza lo siguiente:

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

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

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

    Si ya configuraste el proyecto de facturación cuando configuraste gcloud CLI, esta marca es opcional. De lo contrario, omitir esta opción podría generar un error de permiso denegado. Para obtener más información, consulta Configura el proyecto de cuota.

El resultado contendría datos específicos de tu configuración y sería similar al siguiente resultado 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'

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

Un proyecto de cliente hace referencia al 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 administran esos recursos.

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

  1. Crea un proyecto de cliente:

    gcloud projects create CLIENT_PROJECT_ID
gcloud config set project CLIENT_PROJECT_ID

    Reemplaza CLIENT_PROJECT_ID por el ID del proyecto que deseas crear. Los IDs de proyecto son inmutables y solo se pueden establecer durante su creación. Deben comenzar con una letra minúscula y pueden tener letras minúsculas ASCII, números o guiones. Los IDs de proyecto deben tener entre 6 y 30 caracteres.

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

    gcloud services enable cloudquotas.googleapis.com

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

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

    Reemplaza lo siguiente:

    • SA_NAME: Es el nombre interno de la cuenta de servicio nueva. Se usa para generar una IAM_ACCOUNT (una dirección de correo electrónico interna de IAM que se usa como identificador de la cuenta de servicio), que se debe pasar a los comandos posteriores.
    • SA_DISPLAY_NAME: Es el nombre visible de la cuenta de servicio.
    • CLIENT_PROJECT_ID: El ID del proyecto del 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

    Reemplaza lo siguiente:

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

  5. Otorga permisos de IAM 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"

    Reemplaza lo siguiente:

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

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

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

  7. Para habilitar el ajustador de cuotas en tu proyecto de recursos, especifica el proyecto y el parámetro de configuración de habilitación:

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

    La configuración de habilitación es obligatoria cuando se usa gcloud CLI y se debe establecer en 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

    El resultado 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 para varios proyectos de cliente, sigue los pasos 5 a 8 anteriores. Cuando lo hagas, asegúrate de que se cumplan las siguientes condiciones:

  • La API de Cloud Quotas está habilitada en el proyecto del cliente.
  • Asegúrate de que la cuenta de servicio tenga el rol de IAM cloudquotas.admin en todos los proyectos de recursos en los que deseas habilitar el ajustador de cuotas.

Otros servicios con comandos de gcloud CLI relacionados con la cuota

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

¿Qué sigue?