Visualiza las cuotas con la CLI alpha de gcloud

Las siguientes secciones contienen ejemplos de comandos gcloud alpha quotas info y gcloud alpha quotas preferences. 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:

Todos los ajustes de aumento de cuota están sujetos a la aprobación de Google Cloud.
Puedes solicitar ajustes de aumento y disminución de cuota para cuotas a nivel de proyecto.
Puedes solicitar ajustes de disminución de cuota para cuotas de nivel de project-, folder- y organización.

Antes de comenzar

Antes de comenzar, 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 QUOTA_ID.

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

Muchos de los comandos de gcloud CLI en esta página hacen referencia a tu valor de 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
```
Reemplaza lo siguiente:
- SERVICE_NAME: el nombre del servicio con cuotas que deseas ver, por ejemplo, el nombre del servicio para Cloud Logging es logging.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

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 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 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

Reemplaza lo siguiente:

QUOTA_ID: el ID de la cuota
SERVICE_NAME: el nombre del servicio con cuotas que deseas ver, por ejemplo, el nombre del servicio para Cloud Logging es logging.googleapis.com
PROJECT_ID_OR_NUMBER: el ID o número del proyecto.

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

Reemplaza lo siguiente:

SERVICE_NAME: el nombre del servicio con cuotas que deseas ver, por ejemplo, el nombre del servicio para Cloud Logging es logging.googleapis.com
ORGANIZATION_ID: el ID de tu organización

Ejemplo de comandos de preferencias de cuota de gcloud

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

Reemplaza PROJECT_ID_OR_NUMBER por el ID o el número del proyecto.

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

Reemplaza PROJECT_ID_OR_NUMBER por el ID o el número del proyecto.

Solicita un ajuste de aumento de cuota para una región específica cuando 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 --preference-id=PREFERENCE_ID

Reemplaza lo siguiente:

PREFERRED_VALUE: el valor de cuota preferido.
QUOTA_ID: el ID de la cuota
SERVICE_NAME: el nombre del servicio con cuotas que deseas ver, por ejemplo, el nombre del servicio para Cloud Logging es logging.googleapis.com
PROJECT_ID_OR_NUMBER: el ID o número del proyecto.
PREFERENCE_ID: el ID de preferencia.

Solicita un ajuste de aumento de cuota para una región específica 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, vuelve a ejecutar 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

Reemplaza lo siguiente:

PREFERENCE_ID: el ID de preferencia.
PREFERRED_VALUE</var>"}}: el valor de cuota preferido.
QUOTA_ID: el ID de la cuota
SERVICE_NAME: el nombre del servicio con cuotas que deseas ver, por ejemplo, el nombre del servicio para Cloud Logging es logging.googleapis.com
PROJECT_ID_OR_NUMBER: el ID o número del proyecto.

Recupera una preferencia de cuota existente

Para recuperar una preferencia de cuota existente, ejecuta el siguiente comando:

gcloud alpha quotas preferences describe PREFERENCE_ID project=PROJECT_ID_OR_NUMBER

Reemplaza lo siguiente:

PREFERENCE_ID: el ID de preferencia.
PROJECT_ID_OR_NUMBER: el ID o número del proyecto.

Otros servicios con comandos de la CLI de gcloud relacionados con las cuotas

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 una lista completa de los comandos y las marcas de gcloud alpha quotas, consulta la sección Cuotas alfa de gcloud 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.