Configura las dimensiones de cuotas de Cloud

Las dimensiones de las cuotas de Cloud representan diferentes formas de medir el uso de los recursos en Google Cloud. Por lo general, las dimensiones son una región, una zona, un usuario de Google Cloud o un atributo de producto.

La API de Cloud Quotas representa las dimensiones como pares clave-valor. key es el nombre de la dimensión (por ejemplo, region). value es el valor asignado para la dimensión (por ejemplo, una región como us-central1).

Por ejemplo, Compute Engine mide el uso de las VMs con diferentes dimensiones. La dimensión region mide la cantidad de VMs que tienes en una región determinada. Compute Engine también tiene varias dimensiones de atributos de producto, incluida gpu_family. La dimensión gpu_family mide la cantidad de GPUs de una familia determinada en tu proyecto de Google Cloud.

Ver dimensiones

Puedes ver las dimensiones de las cuotas y los límites del sistema en la consola de Google Cloud, con Google Cloud CLI, consultando la API de REST o a través de bibliotecas cliente. Para ver las dimensiones para las que no especificaste un valor, usa gcloud CLI. También usa gcloud CLI para ver las dimensiones de las cuotas y los límites del sistema que no tienen dimensiones regionales o zonales si tu proyecto aún no usa el recurso asociado. En esta sección, se muestra cómo ver dimensiones con la consola y con gcloud CLI.

Console

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

En la tabla de esta página, se muestran las dimensiones en la columna Dimensiones.
Si no ves la columna Dimensiones, sigue estos pasos. De lo contrario, omite este paso.
1. Haz clic en Opciones de visualización de columnas.
2. Selecciona Dimensiones.
3. Haz clic en Aceptar. La columna Dimensiones aparecerá en la tabla.
Para filtrar los resultados, ingresa el nombre o el valor de una propiedad en el campo junto a Filtro.
- Para filtrar por producto, comienza a escribir el nombre del producto y selecciónalo en la lista que aparece.
- Para filtrar por dimensión, ingresa la dimensión con el siguiente formato: dimension_name:dimension_value. Por ejemplo, para ver las cuotas y los límites del sistema definidos para la región us-central1, ingresa: region:us-central.

Comprende las dimensiones en blanco

A veces, la columna Dimensiones está vacía. Esto puede suceder por los siguientes motivos:

El valor de la cuota o el límite del sistema es el valor predeterminado y se aplica a todas las dimensiones. En el caso de algunas cuotas y límites del sistema, la consola muestra una línea que enumera el valor predeterminado de la cuota o el límite del sistema como referencia. Como la configuración predeterminada se aplica a todos los valores de dimensión, la columna Dimensiones está en blanco. Consulta la columna Nombre para identificar estas entradas. La columna Nombre indica estas entradas con la palabra "predeterminada" entre paréntesis al final del nombre de la cuota o del límite del sistema.

Por ejemplo, la cuota SetIamPolicyRequestsPerMinutePerProject se define en la dimensión region. La consola muestra una entrada de referencia y una entrada para cada región. En la columna Nombre, la entrada de referencia aparece como "SetIAMPolicy requests per minute per region (default)". Para esta entrada, la columna Dimensiones está vacía.
No se aplican dimensiones. Por ejemplo, la cuota de Compute Engine NETWORKS-per-project no está asociada con un atributo de región, zona o producto, por lo que no hay dimensiones para mostrar.

gcloud

Puedes usar gcloud CLI para ver las dimensiones de una sola cuota o un límite del sistema, o de todas las cuotas y límites del sistema asociados con un producto determinado. Por lo general, ver las dimensiones de una sola cuota o límite del sistema es más rápido que ver las dimensiones de todas las cuotas y límites del sistema asociados con un producto. La respuesta a una consulta de una sola cuota suele ser de aproximadamente 200 líneas. La respuesta a una consulta de un producto puede superar las 2,000 líneas.

Consulta las dimensiones de una sola cuota o límite del sistema con gcloud

Para ver las dimensiones de una sola cuota o límite del sistema con gcloud CLI, ejecuta el siguiente comando en la terminal:

gcloud alpha quotas info describe QUOTA_ID --project=PROJECT_ID --service=SERVICE_ID

Reemplaza lo siguiente:

QUOTA_ID: Es el ID de la cuota o el límite del sistema. Si no conoces el ID de tu cuota, elige una de las siguientes opciones:
1. Para encontrarlo, usa la consola como se describe en Encuentra tu ID de cuota.
2. Consulta todas las dimensiones del producto asociadas con la cuota o el límite del sistema que te interesa. Este comando no requiere el ID de cuota. Consulta la sección Visualiza las dimensiones de un producto con gcloud CLI.
PROJECT_ID: Es el ID de tu proyecto de Google Cloud. Para encontrar el ID de tu proyecto, elige una de las siguientes opciones:
1. Para encontrar el ID de tu proyecto con la consola, consulta Identifica proyectos.
2. Si configuraste tu proyecto actual como el predeterminado en la configuración de gcloud CLI, ejecuta el siguiente comando de gcloud en la terminal para encontrar el ID de tu proyecto:
```
gcloud config get-value project
```
SERVICE_ID: Es el ID de servicio del producto asociado con la cuota o el límite del sistema. Por ejemplo, si la cuota es para CPUs A2 de Compute Engine, el ID de servicio es compute.googleapis.com.

Visualiza las dimensiones de un producto con gcloud CLI

Para ver las dimensiones de una sola cuota o límite del sistema con gcloud CLI, ejecuta el siguiente comando en la terminal:

gcloud alpha quotas info list --project=PROJECT_ID --service=SERVICE_ID

Reemplaza lo siguiente:

PROJECT_ID: Es el ID de tu proyecto de Google Cloud. Para encontrar el ID de tu proyecto, elige una de las siguientes opciones:
1. Para encontrar el ID de tu proyecto con la consola, consulta Identifica proyectos.
2. Si configuraste tu proyecto actual como el predeterminado en la configuración de gcloud CLI, ejecuta el siguiente comando de gcloud en la terminal para encontrar el ID de tu proyecto:
```
gcloud config get-value project
```
SERVICE_ID: Es el ID de servicio del producto asociado con la cuota o el límite del sistema. Por ejemplo, si la cuota es para CPUs A2 de Compute Engine, el ID de servicio es compute.googleapis.com.

Prioridad de dimensión

Algunos casos de uso de la API de Cloud Quotas tienen parámetros de configuración de dimensiones complejas. Las cuotas se pueden configurar a un nivel más detallado que solo las regiones y zonas. Puedes lograr este nivel de detalle cuando usas dimensiones específicas del servicio. Por ejemplo, gpu_family y network_id son dimensiones específicas del servicio en el servicio de Compute Engine. Cada servicio individual define las dimensiones, y cada servicio puede tener un conjunto diferente de dimensiones específicas del servicio.

Cuando se trabaja con dimensiones de ubicación o específicas del servicio, se aplica la siguiente prioridad:

Una configuración de preferencia de cuota con todas las dimensiones específicas de la ubicación y del servicio especificadas tiene prioridad sobre cualquier otra configuración.
Las configuraciones que especifican dimensiones de ubicación solo tienen prioridad sobre aquellas que contienen solo dimensiones específicas del servicio.

Combina dimensiones

En una configuración de preferencia de cuota, puedes combinar dimensiones de las siguientes maneras:

La configuración puede contener ambas dimensiones de ubicación y dimensiones específicas del servicio. Este es el orden más alto en prioridad.
La configuración solo puede contener dimensiones de ubicación. Esta configuración se aplica a todas las dimensiones específicas del servicio, excepto las que se configuran de forma explícita con el método 1.
La configuración solo puede contener dimensiones específicas del servicio. Esta configuración se aplica a todas las ubicaciones, excepto las configuradas de manera explícita con los métodos 1 o 2.
Si la configuración contiene cualquier dimensión específica del servicio, debe contener todas las dimensiones específicas del servicio.
Puedes tener configuraciones sin ninguna dimensión. Estas opciones de configuración se aplican a todas las ubicaciones y a todas las dimensiones específicas del servicio, excepto las que se configuran de forma explícita.