Sie können diese Zusicherungen über die Google Cloud Console, die gcloud CLI oder REST aufrufen.
Hinweis
-
Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben.
Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud Dienste und APIs überprüft. Zum Ausführen von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei der Compute Engine authentifizieren:
Wählen Sie den Tab für die gewünschte Verwendung der Beispiele auf dieser Seite aus:
Console
Wenn Sie über die Google Cloud Console auf Dienste und APIs von Google Cloud zugreifen, müssen Sie die Authentifizierung nicht einrichten.
gcloud
-
Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl:
gcloud initWenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.
-
- Legen Sie eine Standardregion und -zone fest.
REST
Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.
Installieren Sie die Google Cloud CLI.
Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.
Weitere Informationen finden Sie in der Dokumentation zur Google Cloud -Authentifizierung unter Für die Verwendung von REST authentifizieren.
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
Rufen Sie in der Google Cloud Console die Seite Rabatte für zugesicherte Nutzung auf. Zur Seite „Rabatte für zugesicherte Nutzung“
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
Rufen Sie in der Google Cloud Console die Seite Rabatte für zugesicherte Nutzung auf. Zur Seite „Rabatte für zugesicherte Nutzung“
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.
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 befindetPROJECT_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 ProjektsREGION: 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"
}