Configurar dimensiones de cuotas de Cloud

Las dimensiones de cuotas de Cloud representan diferentes formas de medir el uso de recursos en Google Cloud. Las dimensiones suelen ser un atributo de región, zona, Google Cloud usuario o producto.

La API 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 a la dimensión (por ejemplo, una región como us-central1).

Por ejemplo, Compute Engine mide el uso de las VMs mediante diferentes dimensiones. La dimensión region mide el número de máquinas virtuales que tiene en una región determinada. Compute Engine también tiene varias dimensiones de atributos de producto, como las siguientes: gpu_family La dimensión gpu_family mide el número de GPUs de una familia determinada de tu proyecto Google Cloud .

Ver dimensiones

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

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

    En la tabla de esta página se muestran las dimensiones en la columna Dimensiones.

  2. Si no ve la columna Dimensiones, siga estos pasos. De lo contrario, sáltate este paso.

    1. Haz clic en Opciones de visualización de columnas.
    2. Seleccione Dimensiones.
    3. Haz clic en Aceptar. La columna Dimensiones aparece en la tabla.

  3. Para filtrar los resultados, introduce un nombre o un valor de propiedad en el campo situado junto a Filtrar.

    • Para filtrar por producto, empieza a escribir el nombre del producto y selecciónalo en la lista que aparece.
    • Para filtrar por dimensión, introduzca 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, introduce region:us-central.

Información sobre las dimensiones en blanco

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

  • El valor de la cuota o del límite del sistema es el valor predeterminado y se aplica a todas las dimensiones. En algunas cuotas y límites del sistema, la consola muestra una línea con el valor predeterminado de la cuota o el límite del sistema como referencia. Como el valor predeterminado se aplica a todos los valores de dimensión, la columna Dimensiones está en blanco. Consulta la columna Nombre para identificar estas entradas. En la columna Nombre se indica que estas entradas son predeterminadas con la palabra "predeterminado" 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 se muestra como "Solicitudes SetIamPolicy por minuto y región (predeterminadas)". En esta entrada, la columna Dimensiones está vacía.

  • No se aplica ninguna dimensión. Por ejemplo, la cuota de Compute Engine NETWORKS-per-project no está asociada a ningún atributo de región, zona o producto, por lo que no hay dimensiones que mostrar.

gcloud

Puedes usar la CLI de gcloud para ver las dimensiones de una sola cuota o límite del sistema, o de todas las cuotas y límites del sistema asociados a un producto concreto. Consultar las dimensiones de una sola cuota o límite del sistema suele ser más rápido que consultar las dimensiones de todas las cuotas y los límites del sistema asociados a un producto. La respuesta a una consulta de una sola cuota suele ser de unas 200 líneas. La respuesta a una consulta de un producto puede superar las 2000 líneas.

Ver 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 la CLI de gcloud, ejecuta el siguiente comando en tu terminal:

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

Haz los cambios siguientes:

  • QUOTA_ID: el ID de la cuota o el límite del sistema. Si no sabes cuál es tu ID de cuota, elige una de las siguientes opciones:

    1. Para encontrarlo, usa la consola tal como se describe en Buscar tu ID de cuota.
    2. Consulte todas las dimensiones del producto asociado a la cuota o al límite del sistema que le interese. Este comando no requiere el ID de cuota. Consulta la sección Ver dimensiones de un producto con la herramienta de línea de comandos gcloud.

  • PROJECT_ID: 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 mediante la consola, consulta el artículo sobre cómo identificar proyectos.
    2. Si has configurado tu proyecto actual como proyecto predeterminado en la configuración de la CLI de gcloud, busca el ID de tu proyecto ejecutando el siguiente comando de gcloud en tu terminal: 
      gcloud config get-value project

  • SERVICE_ID: el ID de servicio del producto asociado a la cuota o al límite del sistema. Por ejemplo, si la cuota es para las CPUs A2 de Compute Engine, el ID de servicio es compute.googleapis.com.

Ver las dimensiones de un producto con la CLI de gcloud

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

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

Haz los cambios siguientes:

  • PROJECT_ID: 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 mediante la consola, consulta el artículo sobre cómo identificar proyectos.
    2. Si has configurado tu proyecto actual como proyecto predeterminado en la configuración de la CLI de gcloud, busca el ID de tu proyecto ejecutando el siguiente comando de gcloud en tu terminal: 
      gcloud config get-value project

  • SERVICE_ID: el ID de servicio del producto asociado a la cuota o al límite del sistema. Por ejemplo, si la cuota es para las CPUs A2 de Compute Engine, el ID de servicio es compute.googleapis.com.

Prioridad de las dimensiones

Algunos casos prácticos de la API Cloud Quotas tienen configuraciones de dimensiones complejas. Las cuotas se pueden configurar en un nivel más granular que el de regiones y zonas. Puedes conseguir este nivel de detalle si usas dimensiones específicas de cada servicio. Por ejemplo, gpu_family y network_id son dimensiones específicas del servicio Compute Engine. Cada servicio define sus dimensiones y puede tener un conjunto diferente de dimensiones específicas del servicio.

Cuando se trabaja con dimensiones de ubicación o dimensiones específicas de un servicio, se aplica el siguiente orden de prioridad:

  1. Una configuración de preferencia de cuota con todas las dimensiones específicas de la ubicación y del servicio tiene prioridad sobre cualquier otra configuración.

  2. Las configuraciones que especifican dimensiones de ubicación solo tienen prioridad sobre las configuraciones que contienen dimensiones específicas de un servicio.

Combinar dimensiones

En una configuración de preferencia de cuota, puede combinar dimensiones de las siguientes formas:

  1. La configuración puede contener dimensiones de ubicación y dimensiones específicas del servicio. Este es el orden de prioridad más alto.

  2. La configuración solo puede contener dimensiones de ubicación. Esta configuración se aplica a todas las dimensiones específicas del servicio, excepto a las que se hayan configurado explícitamente con el método 1.

  3. La configuración solo puede contener dimensiones específicas del servicio. Esta configuración se aplica a todas las ubicaciones, excepto a las que se hayan configurado explícitamente con el método 1 o el 2.

  4. Si la configuración contiene alguna dimensión específica del servicio, debe contener todas las dimensiones específicas del servicio.

  5. Puede tener configuraciones sin dimensiones. Estas configuraciones se aplican a todas las ubicaciones y dimensiones específicas de los servicios, excepto a las que se hayan configurado explícitamente.