Ressourcenbasierte Zusicherungen ansehen

In Compute Engine können Sie eine Liste aller erworbenen ressourcenbasierten Zusicherungen aufrufen oder die detaillierten Attribute einer bestimmten Zusicherung abrufen.

Sie können diese Zusicherungen über die Google Cloud Console, die gcloud CLI oder REST aufrufen.

Hinweis

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Compute-Betrachter“ (roles/compute.viewer) oder „Compute-Administrator“ (roles/compute.admin) für Ihr Projekt zuzuweisen, um die Berechtigung zu erhalten, die Sie zum Aufrufen von ressourcenbasierten Zusicherungen benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen compute.commitments.get und compute.commitments.list, die zum Aufrufen von ressourcenbasierten Zusicherungen erforderlich sind.

Sie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Liste der Zusicherungen ansehen

Sie können eine Liste aller Zusicherungen in Ihrem Projekt mit derGoogle Cloud Console, der gcloud CLI oder REST aufrufen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Rabatte für zugesicherte Nutzung auf. Zur Seite „Rabatte für zugesicherte Nutzung“

  2. Wählen Sie einen der folgenden Tabs aus, um eine Liste der Zusicherungen für eine bestimmte Kategorie aufzurufen:

    • Hardwarezusicherungen: Wählen Sie diesen Tab aus, um Zusicherungen für Hardwareressourcen wie vCPUs, Arbeitsspeicher, GPUs, lokale SSD-Laufwerke und Knoten für einzelne Mandanten aufzurufen.
    • Software-Lizenzzusicherungen: Wählen Sie diesen Tab aus, um Zusicherungen für Betriebssystemlizenzen aufzurufen.
    • Blockspeicher-Zusicherungen: Wählen Sie diesen Tab aus, um Zusicherungen für die Exapool-Kapazität aufzurufen.

gcloud

Verwenden Sie den Befehl gcloud compute commitments list, um alle Zusicherungen in einer bestimmten Region aufzulisten:

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

Ersetzen Sie Folgendes:

  • REGION: die Region, für die Sie die Zusicherungen aufrufen möchten.
  • PROJECT_ID: Projekt-ID.

Beispiele

Wenn Sie beispielsweise die Zusicherungen in der Region us-central1 mit dem Projekt project-list-example auflisten möchten, führen Sie den folgenden Befehl aus:

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

REST

Wenn Sie Zusicherungen in einer bestimmten Region auflisten möchten, senden Sie eine GET-Anfrage an die Methode regionCommitments.list:

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

Wenn Sie Zusicherungen für alle Regionen in Ihrem Projekt auflisten möchten, senden Sie eine GET-Anfrage an die Methode regionCommitments.aggregatedList:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID des Projekts, für das Sie Zusicherungen aufrufen möchten.
  • REGION: die Region, aus der Sie Zusicherungen aufrufen möchten.

Details einer bestimmten Zusicherung ansehen

Sie können sich die detaillierten Eigenschaften einer Zusicherung ansehen, z. B.:

  • Status
  • Zusicherungsplan
  • Start- und Endzeit der Zusicherung
  • Einstellungen für die automatische Verlängerung
  • Arten und Mengen zugesicherter Ressourcen

Sie können Ihre Zusicherungen über die Google Cloud Console, die gcloud CLI oder REST aufrufen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Rabatte für zugesicherte Nutzung auf. Zur Seite „Rabatte für zugesicherte Nutzung“

  2. Wählen Sie den Tab für die Kategorie der Zusicherung aus, die Sie sich ansehen möchten:

    • Klicken Sie auf den Tab Hardwarezusicherungen, um Zusicherungen für Hardwareressourcen aufzurufen. Hardwarezusicherungen decken vCPUs, Arbeitsspeicher, GPUs, lokale SSD-Laufwerke und Knoten für einzelne Mandanten ab.
    • Wenn Sie Zusicherungen für Premium-Softwarelizenzen aufrufen möchten, wählen Sie den Tab Software-Lizenzzusicherungen aus. Lizenzzusicherungen decken Betriebssystemlizenzen wie SUSE Linux Enterprise Server (SLES), SLES for SAP oder Red Hat Enterprise Linux (RHEL) ab.
    • Wenn Sie Zusicherungen für Network Attached Storage-Pools aufrufen möchten, wählen Sie den Tab Zusicherungen für Blockspeicher aus. Blockspeicherzusicherungen decken die Exapool-Kapazität ab.

  3. Klicken Sie auf den Namen der Zusicherung, um die Detailseite für eine Zusicherung aufzurufen.

gcloud

Verwenden Sie den Befehl gcloud compute commitments describe, um eine bestimmte Zusicherung zu beschreiben:

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

Ersetzen Sie Folgendes:

  • COMMITMENT_NAME: der Name Ihrer Zusicherung.
  • REGION: die Region, in der sich die Zusicherung befindet
  • PROJECT_ID: Projekt-ID.

Beispiele

In den folgenden Beispielen werden Zusicherungen im Projekt myproject und in der Region us-central1 beschrieben.

Beispiel 1: Hardwarezusicherung beschreiben

Führen Sie den folgenden Befehl aus, um eine vorhandene Hardwarezusicherung (example-hardware-commitment) zu beschreiben:

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

Der Befehl gibt die Eigenschaften Ihrer Zusicherung zurück, die in etwa so aussehen:

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

Beispiel 2: Blockspeicherzusicherung beschreiben

Führen Sie den Befehl gcloud beta compute commitments describe aus, um eine vorhandene Zusicherung für Blockspeicher (example-block-storage-commitment) zu beschreiben:

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

Der Befehl gibt die Attribute Ihrer Zusicherung zurück und stellt die Beziehung der Zusicherung zu Exapools her, ähnlich wie im folgenden Beispiel:

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

Stellen Sie eine GET-Anfrage an die Methode regionCommitments.get:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: Projekt-ID Ihres Projekts
  • REGION: die Region, in der die Zusicherung erworben wurde.
  • COMMITMENT_NAME: der Name Ihrer Zusicherung.

Beispiele

In den folgenden Beispielen werden die Details einer Zusicherung im Projekt myproject und in der Region us-central1 abgerufen.

Beispiel 1: Hardwarezusicherung beschreiben

Senden Sie die folgende GET-Anfrage, um die Attribute einer Hardwarezusicherung (example-hardware-commitment) abzurufen:

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

Die Antwort enthält die Attribute Ihrer Hardwarezusicherung, ähnlich der folgenden Ausgabe:

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

Beispiel 2: Blockspeicherzusicherung beschreiben

Wenn Sie die Attribute einer Blockspeicher-Zusicherung (example-block-storage-commitment) abrufen möchten, stellen Sie die folgende GET-Anfrage an die Methode beta regionCommitments.get:

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

Die Antwort enthält die Attribute, die Ihre Zusicherungskapazität für Blockspeicher darstellen, ähnlich der folgenden JSON-Ausgabe:

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