Puedes ver estos compromisos con la consola de Google Cloud , gcloud CLI o REST.
Antes de comenzar
-
Si aún no lo hiciste, configura la autenticación.
La autenticación verifica tu identidad para acceder a los servicios y las APIs de Google Cloud . Para ejecutar
código o muestras desde un entorno de desarrollo local, puedes autenticarte en
Compute Engine seleccionando una de las siguientes opciones:
Selecciona la pestaña según cómo planeas usar las muestras de esta página:
Console
Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.
gcloud
-
Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando:
gcloud initSi usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.
-
- Configura una región y una zona predeterminadas.
REST
Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.
Instala Google Cloud CLI.
Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.
Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .
Roles obligatorios
Para obtener el permiso que
necesitas para ver los compromisos basados en recursos,
pídele a tu administrador que te otorgue el rol de IAM
Visualizador de Compute (roles/compute.viewer) o Administrador de Compute (roles/compute.admin)
en tu proyecto.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Este rol predefinido contiene los permisos
compute.commitments.get y compute.commitments.list,
que se requieren para
ver los compromisos basados en recursos.
También puedes obtener este permiso con roles personalizados o con otros roles predefinidos.
Visualiza una lista de compromisos
Puedes ver una lista de todos los compromisos de tu proyecto con la consola deGoogle Cloud , gcloud CLI o REST.
Console
En la consola de Google Cloud , ve a la página Descuentos por compromiso de uso. Ir a Descuentos por compromiso de uso
Para ver una lista de los compromisos de una categoría específica, selecciona una de las siguientes pestañas:
- Compromisos de hardware: Selecciona esta pestaña para ver los compromisos de recursos de hardware, como CPU virtuales, memoria, GPUs, discos SSD locales y nodos de usuario único.
- Compromisos de licencia de software: Selecciona esta pestaña para ver los compromisos de las licencias de SO.
- Compromisos de almacenamiento en bloque: Selecciona esta pestaña para ver los compromisos de la capacidad de Exapool.
gcloud
Para enumerar todos los compromisos en una región específica, usa el
comando gcloud compute commitments list:
gcloud compute commitments list \
--regions=REGION \
--project=PROJECT_ID
Reemplaza lo siguiente:
REGION: Es la región para la que deseas ver los compromisos.PROJECT_ID: Es el ID del proyecto.
Ejemplos
Por ejemplo, para enumerar los compromisos dentro de la región us-central1 con
el proyecto project-list-example, ejecuta el siguiente comando:
gcloud compute commitments list \
--regions=us-central1 \
--project=project-list-example
REST
Para enumerar los compromisos en una región específica, realiza una solicitud GET al
método regionCommitments.list:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
Para enumerar los compromisos en todas las regiones de tu proyecto, realiza una solicitud GET
al método regionCommitments.aggregatedList:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/commitments
Reemplaza lo siguiente:
PROJECT_ID: Es el ID del proyecto para el que deseas ver los compromisos.REGION: la región desde la que deseas ver los compromisos.
Visualiza los detalles de un compromiso específico
Puedes ver las propiedades detalladas de un compromiso, como las siguientes:
- Estado
- Plan de compromiso
- Horas de inicio y finalización del compromiso
- Configuración de renovación automática
- Tipos y cantidades de recursos comprometidos
Puedes ver tus compromisos con la consola de Google Cloud , gcloud CLI o REST.
Console
En la consola de Google Cloud , ve a la página Descuentos por compromiso de uso. Ir a Descuentos por compromiso de uso
Selecciona la pestaña de la categoría de compromiso que deseas ver:
- Para ver los compromisos de los recursos de hardware, haz clic en la pestaña Compromisos de hardware. Los compromisos de hardware abarcan CPU virtuales, memoria, GPUs, discos SSD locales y nodos de usuario único.
- Para ver los compromisos de las licencias de software premium, selecciona la pestaña Compromisos de licencia de software. Los compromisos de licencia cubren las licencias de sistemas operativos (SO), como SUSE Linux Enterprise Server (SLES), SLES para SAP o Red Hat Enterprise Linux (RHEL).
- Para ver los compromisos de los grupos de almacenamiento conectado a la red, selecciona la pestaña Compromisos de almacenamiento en bloque. Los compromisos de almacenamiento en bloque cubren la capacidad de Exapool.
Para ver la página de detalles de un compromiso, haz clic en el nombre del compromiso.
gcloud
Para describir un compromiso específico, usa el
comando gcloud compute commitments describe:
gcloud compute commitments describe COMMITMENT_NAME \
--region=REGION \
--project=PROJECT_ID
Reemplaza lo siguiente:
COMMITMENT_NAME: el nombre de tu compromiso.REGION: la región en la que se encuentra el compromisoPROJECT_ID: Es el ID del proyecto.
Ejemplos
En los siguientes ejemplos, se describen los compromisos en el proyecto myproject
y la región us-central1.
Ejemplo 1: Describe un compromiso de hardware
Para describir un compromiso de hardware existente (example-hardware-commitment),
ejecuta el siguiente comando:
gcloud compute commitments describe example-hardware-commitment \
--region=us-central1 \
--project=myproject
El comando devuelve las propiedades de tu compromiso, similar a lo siguiente:
autoRenew: true category: MACHINE creationTimestamp: '2025-05-15T09:30:00.000-07:00' endTimestamp: '2026-05-15T09:30:00.000-07:00' kind: compute#commitment name: example-hardware-commitment plan: TWELVE_MONTH region: https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1 resources: - amount: '4' type: VCPU - amount: '16384' type: MEMORY status: ACTIVE type: GENERAL_PURPOSE
Ejemplo 2: Describe un compromiso de almacenamiento en bloque
Para describir un compromiso de almacenamiento en bloque existente
(example-block-storage-commitment), ejecuta el
comando gcloud beta compute commitments describe:
gcloud beta compute commitments describe example-block-storage-commitment \
--region=us-central1 \
--project=myproject
El comando devuelve las propiedades de tu compromiso y establece la relación del compromiso con los Exapools, de manera similar a lo siguiente:
autoRenew: true category: PERSISTENT_DISK creationTimestamp: '2025-08-20T14:45:00.000-07:00' endTimestamp: '2026-08-20T14:45:00.000-07:00' kind: compute#commitment name: example-block-storage-commitment persistentDiskResources: - amount: '102400' dimensionType: CAPACITY_OPTIMIZED productType: HYPERDISK_EXAPOOL_BALANCED plan: TWELVE_MONTH region: https://www.googleapis.com/compute/beta/projects/myproject/regions/us-central1 status: ACTIVE
REST
Realiza una solicitud GET al
método regionCommitments.get.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments/COMMITMENT_NAME
Reemplaza lo siguiente:
PROJECT_ID: el ID del proyecto del proyecto.REGION: Es la región en la que se compró el compromiso.COMMITMENT_NAME: el nombre de tu compromiso.
Ejemplos
En los siguientes ejemplos, se recuperan los detalles de un compromiso en el
proyecto myproject y la región us-central1.
Ejemplo 1: Describe un compromiso de hardware
Para recuperar las propiedades de un compromiso de hardware
(example-hardware-commitment), realiza la siguiente solicitud GET:
GET https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/commitments/example-hardware-commitment
La respuesta contiene las propiedades de tu compromiso de hardware, similar al siguiente resultado:
{
"autoRenew": true,
"category": "MACHINE",
"creationTimestamp": "2025-05-15T09:30:00.000-07:00",
"endTimestamp": "2026-05-15T09:30:00.000-07:00",
"kind": "compute#commitment",
"name": "example-hardware-commitment",
"plan": "TWELVE_MONTH",
"region": "https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1",
"resources": [
{
"amount": "4",
"type": "VCPU"
},
{
"amount": "16384",
"type": "MEMORY"
}
],
"status": "ACTIVE",
"type": "GENERAL_PURPOSE"
}
Ejemplo 2: Describe un compromiso de almacenamiento en bloque
Para recuperar las propiedades de un compromiso de almacenamiento en bloque
(example-block-storage-commitment), realiza la siguiente solicitud GET al
método beta regionCommitments.get:
GET https://compute.googleapis.com/compute/beta/projects/myproject/regions/us-central1/commitments/example-block-storage-commitment
La respuesta contiene las propiedades que representan tu capacidad de compromiso de almacenamiento en bloque, similar al siguiente resultado JSON:
{
"autoRenew": true,
"category": "PERSISTENT_DISK",
"creationTimestamp": "2025-08-20T14:45:00.000-07:00",
"endTimestamp": "2026-08-20T14:45:00.000-07:00",
"kind": "compute#commitment",
"name": "example-block-storage-commitment",
"persistentDiskResources": [
{
"amount": "102400",
"dimensionType": "CAPACITY_OPTIMIZED",
"productType": "HYPERDISK_EXAPOOL_BALANCED"
}
],
"plan": "TWELVE_MONTH",
"region": "https://www.googleapis.com/compute/beta/projects/myproject/regions/us-central1",
"status": "ACTIVE"
}