Las siguientes secciones contienen los comandos
gcloud alpha quotas info
y
gcloud alpha 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:
Los ajustes de aumento de cuota deben realizarse a nivel de proyecto y están sujetos a la aprobación de Google Cloud.
Puedes solicitar ajustes de disminución de cuota para cuotas de nivel de project-, folder- y organización.
La API de Cloud Quotas solo admite operaciones a nivel de proyecto. No se admiten las operaciones a nivel de carpeta y de organización.
Antes de comenzar
Antes de comenzar, asegúrate de instalar e inicializar gcloud CLI.
Es posible que también necesites tu valor de 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, asegúrate de haber instalado e inicializado la última versión de gcloud CLI, incluidos el componente de comandos alfa. Si usas Cloud Shell para interactuar con Google Cloud, se instala gcloud CLI de manera automática.
Encuentra el ID de tu cuota
Varios comandos de gcloud CLI en esta página hacen referencia al valor de tu ID de cuota.
Para encontrar el valor de ID de cuota, usa el siguiente comando de gcloud CLI para obtener una lista con la información sobre tu cuota para el servicio especificado:
Ingresa el siguiente comando de gcloud CLI en una ventana de terminal:
gcloud alpha 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 escompute.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:
BILLING_PROJECT_ID_OR_NUMBER
: el número o el ID del proyecto de facturaciónSi 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 del comando
gcloud alpha 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" ] ... } ] }, ... ] ...
Busca el valor que corresponda a
quotaId
y úsalo cuando especifiquesQUOTA_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 alpha 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 alpha 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 escompute.googleapis.com
PROJECT_ID_OR_NUMBER
: el ID o número del proyecto.BILLING_PROJECT_ID_OR_NUMBER
: el número o el ID del proyecto de facturaciónSi 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
Si quieres ver los detalles de cuota del mismo servicio para una organización, ejecuta el siguiente comando:
gcloud alpha 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 escompute.googleapis.com
ORGANIZATION_ID
: el ID de tu organizaciónBILLING_PROJECT_ID_OR_NUMBER
: el número o el ID del proyecto de facturaciónSi 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.
Comandos de preferencias de cuota de gcloud de ejemplo
En esta sección, se proporcionan ejemplos que muestran cómo usar comandos de gcloud alpha 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 alpha 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 el ID del proyecto de facturaciónSi 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 alpha 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 el ID del proyecto de facturaciónSi 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 alpha 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 --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 escompute.googleapis.com
PROJECT_ID_OR_NUMBER
: el ID o número del proyecto.BILLING_PROJECT_ID_OR_NUMBER
: el número o el ID del proyecto de facturaciónSi 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 para tomar una decisión antes de que se pueda otorgar una cuota adicionalPREFERENCE_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 alpha quotas preferences update PREFERENCE_ID --preferred-value=PREFERRED_VALUE \
--quota-id=QUOTA_ID --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
--email=EMAIL --billing-project=BILLING_PROJECT_ID_OR_NUMBER
Reemplaza lo siguiente:
PREFERENCE_ID
: El ID de preferencia, que es obligatorio como primer argumento cuando se usa el comandogcloud alpha 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 escompute.googleapis.com
PROJECT_ID_OR_NUMBER
: el ID o número del proyecto.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 adicionalBILLING_PROJECT_ID_OR_NUMBER
: el número o el ID del proyecto de facturaciónSi 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 con una dimensión
Para solicitar un ajuste de aumento de cuota con una dimensión, ejecuta el siguiente comando:
gcloud alpha 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 escompute.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 el ID del proyecto de facturaciónSi 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 para tomar una decisión antes de que se pueda otorgar una cuota adicionalJUSTIFICATION
: 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 alpha quotas preferences describe PREFERENCE_ID \
--project=PROJECT_ID_OR_NUMBER \
--billing-project=BILLING_PROJECT_ID_OR_NUMBER
Reemplaza lo siguiente:
PREFERENCE_ID
: El ID de preferencia, que es obligatorio como primer argumento cuando se usa el comandogcloud alpha quotas preferences describe
PROJECT_ID_OR_NUMBER
: el ID o número del proyecto.BILLING_PROJECT_ID_OR_NUMBER
: el número o el ID del proyecto de facturaciónSi 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'
Otros servicios con comandos de gcloud CLI relacionados con la cuota
Además de gcloud alpha 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:
- Cuotas de asignación
- La descripción general de gcloud CLI compute
- El comando gcloud CLI compute de la referencia del SDK de Google Cloud.
¿Qué sigue?
Para obtener más información sobre las marcas y los comandos de gcloud alpha quotas
, consulta la sección cuotas de gcloud alpha de la referencia de Google Cloud CLI.
Para obtener más información sobre la terminología de las cuotas, consulta Obtén información sobre los valores de cuota y los límites del sistema.