Visualizza gli impegni basati sulle risorse

Compute Engine ti consente di visualizzare un elenco di tutti gli impegni basati sulle risorse acquistati o di recuperare le proprietà dettagliate di un impegno specifico.

Puoi visualizzare questi impegni utilizzando la console Google Cloud , gcloud CLI o REST.

Prima di iniziare

• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso ad API e servizi Google Cloud . Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

  Seleziona la scheda in base a come prevedi di utilizzare gli esempi in questa pagina:

  Console

  Quando utilizzi la console Google Cloud per accedere ai servizi e alle API Google Cloud , non devi configurare l'autenticazione.

  gcloud

  1. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente:

     gcloud init

     Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

     Nota:se hai installato gcloud CLI in precedenza, assicurati di avere l'ultima versione eseguendo gcloud components update.
• Imposta una regione e una zona predefinite.

REST

Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli obbligatori

Per ottenere l'autorizzazione necessaria per visualizzare gli impegni basati sulle risorse, chiedi all'amministratore di concederti il ruolo IAM Compute Viewer (roles/compute.viewer) o Compute Admin (roles/compute.admin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni compute.commitments.get e compute.commitments.list necessarie per visualizzare gli impegni basati sulle risorse.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Visualizza un elenco di impegni

Puoi visualizzare un elenco di tutti gli impegni nel tuo progetto utilizzando la consoleGoogle Cloud , gcloud CLI o REST.

Console

1. Nella console Google Cloud , vai alla pagina Sconti per impegno di utilizzo. Vai a Sconti per impegno di utilizzo

2. Per visualizzare un elenco di impegni per una categoria specifica, seleziona una delle seguenti schede:

   • Impegni hardware: seleziona questa scheda per visualizzare gli impegni per le risorse hardware, come vCPU, memoria, GPU, dischi SSD locali e nodi single-tenant.
   • Impegni relativi a licenze software: seleziona questa scheda per visualizzare gli impegni relativi alle licenze del sistema operativo.
   • Impegni di archiviazione a blocchi: seleziona questa scheda per visualizzare gli impegni per la capacità di Exapool.

gcloud

Per elencare tutti gli impegni in una regione specifica, utilizza il comando gcloud compute commitments list:

gcloud compute commitments list \
    --regions=REGION \
    --project=PROJECT_ID

Sostituisci quanto segue:

• REGION: la regione per la quale vuoi visualizzare gli impegni.
• PROJECT_ID: l'ID progetto

Esempi

Ad esempio, per elencare gli impegni all'interno della regione us-central1 utilizzando il progetto project-list-example, esegui il seguente comando:

gcloud compute commitments list \
    --regions=us-central1 \
    --project=project-list-example

REST

Per elencare gli impegni in una regione specifica, effettua una richiesta GET al metodo regionCommitments.list:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments

Per elencare gli impegni in tutte le regioni del progetto, invia una richiesta GET al metodo regionCommitments.aggregatedList:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/commitments

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto per il quale vuoi visualizzare gli impegni.
• REGION: la regione da cui vuoi visualizzare gli impegni.

Visualizza i dettagli di un impegno specifico

Puoi visualizzare le proprietà dettagliate di un impegno, ad esempio:

• Stato
• Piano dell'impegno
• Ora di inizio e di fine dell'impegno
• Impostazioni di rinnovo automatico
• Tipi e quantità di risorse impegnate

Puoi visualizzare i tuoi impegni utilizzando la console Google Cloud , gcloud CLI o REST.

Console

1. Nella console Google Cloud , vai alla pagina Sconti per impegno di utilizzo. Vai a Sconti per impegno di utilizzo

2. Seleziona la scheda relativa alla categoria di impegno che vuoi visualizzare:

   • Per visualizzare gli impegni per le risorse hardware, fai clic sulla scheda Impegni hardware. Gli impegni hardware coprono vCPU, memoria, GPU, dischi SSD locali e nodi single-tenant.
   • Per visualizzare gli impegni per le licenze software premium, seleziona la scheda Impegni licenze software. Gli impegni di licenza coprono le licenze dei sistemi operativi (OS), come SUSE Linux Enterprise Server (SLES), SLES for SAP o Red Hat Enterprise Linux (RHEL).
   • Per visualizzare gli impegni per i pool di Network Attached Storage, seleziona la scheda Impegni di archiviazione a blocchi. Gli impegni di archiviazione a blocchi coprono la capacità Exapool.

3. Per visualizzare la pagina dei dettagli di un impegno, fai clic sul nome dell'impegno.

gcloud

Per descrivere un impegno specifico, utilizza il comando gcloud compute commitments describe:

gcloud compute commitments describe COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID

Sostituisci quanto segue:

• COMMITMENT_NAME: il nome del tuo impegno.
• REGION: la regione in cui si trova l'impegno.
• PROJECT_ID: l'ID progetto

Esempi

Gli esempi riportati di seguito descrivono gli impegni nel progetto myproject e nella regione us-central1.

Esempio 1: descrivi un impegno hardware

Per descrivere un impegno hardware esistente (example-hardware-commitment), esegui il seguente comando:

gcloud compute commitments describe example-hardware-commitment \
    --region=us-central1 \
    --project=myproject

Il comando restituisce le proprietà del tuo impegno, simili alle seguenti:

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

Esempio 2: descrivi un impegno di archiviazione a blocchi

Per descrivere un impegno di archiviazione a blocchi esistente (example-block-storage-commitment), esegui il comando gcloud beta compute commitments describe:

gcloud beta compute commitments describe example-block-storage-commitment \
    --region=us-central1 \
    --project=myproject

Il comando restituisce le proprietà del tuo impegno, stabilendo la relazione dell'impegno con gli Exapool, in modo simile a quanto segue:

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

Effettua una richiesta GET al metodo regionCommitments.get:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments/COMMITMENT_NAME

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto.
• REGION: la regione in cui è stato acquistato l'impegno.
• COMMITMENT_NAME: il nome del tuo impegno.

Esempi

Gli esempi seguenti recuperano i dettagli di un impegno nel progetto myproject e nella regione us-central1.

Esempio 1: descrivi un impegno hardware

Per recuperare le proprietà di un impegno hardware (example-hardware-commitment), effettua la seguente richiesta GET:

GET https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/commitments/example-hardware-commitment

La risposta contiene le proprietà del tuo impegno hardware, simile al seguente output:

{
  "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"
}

Esempio 2: descrivi un impegno di archiviazione a blocchi

Per recuperare le proprietà di un impegno di archiviazione a blocchi (example-block-storage-commitment), invia la seguente richiesta GET al metodo beta regionCommitments.get:

GET https://compute.googleapis.com/compute/beta/projects/myproject/regions/us-central1/commitments/example-block-storage-commitment

La risposta contiene le proprietà che rappresentano la capacità dell'impegno di archiviazione a blocchi, simile al seguente output 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"
}