Reservierungen mit Rabatten für zugesicherte Nutzung kombinieren

Rabatte für zugesicherte Nutzung (CUDs) bieten stark ermäßigte Preise für Ihre Compute Engine-Ressourcen im Gegenzug für ein- oder dreijährige Verträge für zugesicherte Nutzung (auch als Zusicherungen bezeichnet). Sie verpflichten sich damit zu einem Mindestbetrag für die Ressourcennutzung oder ihr Ausgaben und erhalten im Gegenzug CUDs für Ihre Ressourcennutzungskosten. Zusicherungen reservieren jedoch keine zonale Kapazität für Ihre zugesicherten Ressourcen. Um zonale Ressourcen zu ermäßigten Preisen zu erhalten und außerdem zu gewährleisten, dass die Kapazität für sie reserviert ist, müssen Sie sowohl Zusicherungen erwerben als auch Reservierungen für diese zonalen Ressourcen erstellen.

In diesem Dokument wird erläutert, wie Sie Rabatte für zugesicherte Nutzung für Ihre reservierten Ressourcen erhalten und wie Sie Reservierungen an ressourcenbasierte Zusicherungen anhängen.

Hinweise

• Grundlagen zu Reservierungen sowie die damit verbundenen Anforderungen und Einschränkungen lesen. Weitere Informationen finden Sie unter Reservierungen.
• 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

  1. Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl:

     gcloud init

     Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

     Hinweis: Wenn Sie die gcloud CLI zuvor installiert haben, prüfen Sie, ob Sie die aktuelle Version haben, indem Sie gcloud components update ausführen.
• 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.

CUDs für die Nutzung Ihrer reservierten Ressourcen

Sie erhalten Rabatte für zugesicherte Nutzung aus aktiven Zusicherungen für jede berechtigte Ressourcennutzung in Ihren Projekten. Wenn Sie auch Reservierungen für die Kapazität von Ressourcen in diesem Projekt haben, können CUDs aus aktiven Zusicherungen auch für diese reservierten Ressourcen gelten. Damit reservierte Ressourcen CUDs erhalten können, gelten die folgenden Anforderungen:

• Sie erhalten keine andere Form von Rabatt für Ihre Ressourcennutzung.
• Ihre VMs müssen die Reservierungen nutzen, während die Zusicherungen aktiv sind.

• Mindestens die folgenden Eigenschaften müssen zwischen Ihren aktiven Zusicherungen und den Reservierungen übereinstimmen, die Ihre VMs nutzen:

  • Die in Ihrer Reservierung angegebene Zone muss mit der in Ihrer Zusicherung angegebenen Region übereinstimmen.
  • Der in der Reservierung angegebene Maschinentyp muss von der spezifischen Zusicherung unterstützt werden, die Sie erwerben.
  • Wenn Sie eine ressourcenbasierte Zusicherung verwenden und die CUD-Freigabe in Ihrem Cloud-Rechnungskonto nicht aktiviert ist, müssen sich Ihre Reservierung und Ihre Zusicherung im selben Projekt befinden.

Je nach Ressourcentyp können Sie für die Nutzung Ihrer reservierten Instanzen entweder ressourcen- oder ausgabenbasierte CUDs erhalten.

Ressourcenbasierte CUDs

Compute Engine bietet ressourcenbasierte Rabatte für zugesicherte Nutzung für Maschinenressourcen wie vCPUs, Arbeitsspeicher, GPUs und lokale SSD-Laufwerke auf folgende Weise: Standardmäßig aktiviert Compute Engine die CUD-Freigabe, um Ihre ressourcenbasierten CUDs auf der Ebene des Cloud-Rechnungskonto zu bündeln und auf die berechtigte Nutzung in allen Projekten in diesem Konto anzuwenden.

• vCPUs und Arbeitsspeicher: Wenn Sie ressourcenbasierte CUDs für diese Ressourcentypen erhalten möchten, erwerben Sie ressourcenbasierte Zusicherungen, die die erforderlichen Ressourcentypen enthalten. Wenn VMs in Ihrem Cloud-Rechnungskonto Reservierungen verbrauchen, die diesen aktiven Zusicherungsattributen entsprechen, wendet Compute Engine die Rabatte automatisch auf die berechtigte Nutzung an. Wenn Sie mehr Ressourcen reserviert haben, als Sie zugesichert haben, erhalten Sie keine CUDs für diese zusätzlichen Ressourcen.

• GPUs und lokale SSD-Laufwerke: Wenn Sie ressourcenbasierte Rabatte für zugesicherte Nutzung für GPUs und die meisten lokalen SSD-Laufwerke erhalten möchten, müssen Sie Folgendes tun:

  • Kaufen Sie ressourcenbasierte Zusicherungen, die die erforderlichen Ressourcentypen enthalten.
  • Erstellen Sie Reservierungen, die die GPUs oder lokalen SSD-Laufwerke mit Attributen angeben, die Ihrer Zusicherung entsprechen, und hängen Sie diese Reservierungen an die Zusicherung an.

  Bei ressourcenbasierten Rabatten für zugesicherte Nutzung gilt diese Reservierungsanforderung für alle GPUs und lokalen SSD-Laufwerke, die mit den meisten Maschinenserien verwendet werden. Bei einigen Maschinenserien müssen Sie beim Kauf der Zusicherungen keine Reservierungen für lokale SSD-Laufwerke anhängen.

Achtung: Wenn Sie eine freigegebene Reservierung in einem Projekt haben und die Nutzung der freigegebenen Projekte für die CUDs des aktuellen Projekts infrage kommen soll, müssen Sie Folgendes sicherstellen:

1. Die CUD-Freigabe muss für das Cloud-Rechnungskonto des aktuellen Projekts aktiviert sein.
2. Geben Sie Ihre Reservierung nur für Projekte frei, die mit demselben Cloud-Rechnungskonto verknüpft sind.

Wenn Sie diese Bedingungen nicht erfüllen, kommt die Nutzung aus diesen Projekten nicht für die freigegebenen Rabatte für zugesicherte Nutzung infrage und Ihnen werden möglicherweise die On‑Demand-Preise in Rechnung gestellt.

Flexible CUDs für Compute

Ausgabenbasierte Rabatte für zugesicherte Nutzung für Compute Engine werden als flexible Compute-Rabatte für zugesicherte Nutzung bezeichnet. Eine einzelne flexible Compute-Zusicherung deckt Ihre förderfähigen Ausgaben in Höhe von Google Cloud für ein Cloud-Rechnungskonto in Compute Engine, GKE und Cloud Run ab. Diese Zusicherungen werden auf Cloud-Rechnungskontoebene erworben und decken berechtigte Ausgaben in allen Regionen und Maschinenkonfigurationen ab.

Speziell für Compute Engine sind die folgenden Ressourcen für flexible CUDs geeignet:

• vCPUs, Arbeitsspeicher geeigneter Maschinenreihen
• Alle lokalen SSDs
• GPUs für die Maschinenserien G2 (L4) und G4 (NVIDIA RTX Pro 6000)

Im Gegensatz zu ressourcenbasierten Zusicherungen sind für flexible Compute-Zusicherungen keine angehängten Reservierungen erforderlich und werden auch nicht unterstützt. Sie können flexible Compute-Zusicherungen für infrage kommende GPUs und lokale SSD-Laufwerke erwerben, ohne diese Ressourcen reservieren zu müssen. Daher sind diese Zusicherungen nicht mit einer zugesicherten Kapazität für infrage kommende Ressourcen verbunden. Wenn für GPU-Instanzen wie G2- oder G4-Maschinentypen die Kapazität für einen bestimmten Typ (z. B. G2) in einer Zone nicht verfügbar ist, können Sie Ihre flexible Compute-Zusicherung verwenden, um die Bereitstellung dieser GPU-Instanzen stattdessen in einer anderen verfügbaren Zone abzudecken. Wenn die Kapazität für einen bestimmten GPU-Typ (z. B. G2) in keiner Zone verfügbar ist, können Sie stattdessen Ihre flexible Compute-Zusicherung verwenden, um Ihre Bereitstellung des anderen GPU-Typs (z. B. G4) abzudecken. Wenn für keinen der beiden GPU-Typen in einer Region Kapazität verfügbar ist, können Sie Ihre flexible Compute-Zusicherung stattdessen verwenden, um Ihre berechtigten Ausgaben für andere unterstützte Ressourcen oder Dienste abzudecken. Wenn Sie eine Kapazitätsgarantie für GPUs zur Verwendung mit G2- oder G4-Instanzen wünschen, erstellen Sie separate Reservierungen für G2- oder G4-Instanzen.

Wenn Sie flexible Compute-Zusicherungen in einem Cloud-Rechnungskonto haben, können Sie entsprechende flexible Compute-CUDs für die Nutzung von Reservierungen in diesem Cloud-Rechnungskonto erhalten, sofern Ihre Ausgaben für berechtigte Ressourcen erfolgen und als berechtigte Ausgaben gelten.

Reservierungen an ressourcenbasierte Zusicherungen anhängen

Sie können jeder ressourcenbasierten Zusicherung Reservierungen hinzufügen und dafür sorgen, dass die Kapazitäten in bestimmten Zonen für die zu verwendenden zugesicherten Ressourcen vorhanden sind. Sie können mehrere Reservierungen an eine einzelne Zusicherung anhängen. Eine Reservierung kann jedoch nur einer einzelnen Zusicherung zugeordnet werden. Wenn Sie eine Zusicherung erwerben, können Sie Reservierungen auf eine der folgenden Arten an diese Zusicherung anhängen:

• Vorhandene Reservierungen verwenden, die mit den Zusicherungsattributen übereinstimmen
• Neue übereinstimmende Reservierungen beim Kauf der Zusicherung erstellen

Achtung: Wenn Sie eine freigegebene Reservierung in einem Projekt haben und die Nutzung der freigegebenen Projekte für die CUDs des aktuellen Projekts infrage kommen soll, müssen Sie Folgendes sicherstellen:

1. Aktivieren Sie die Freigabe des Rabatts für zugesicherte Nutzung für das Cloud-Rechnungskonto des aktuellen Projekts.
2. Geben Sie Ihre Reservierung nur für Projekte frei, die mit demselben Cloud-Rechnungskonto verknüpft sind.

Wenn Sie diese Bedingungen nicht erfüllen, kommt die Nutzung aus diesen Projekten nicht für die freigegebenen Rabatte für zugesicherte Nutzung infrage und Ihnen werden möglicherweise die On-Demand-Preise in Rechnung gestellt.

Ressourcentypen, für die keine verbundenen Reservierungen erforderlich sind

Für vCPUs, Arbeitsspeicher und lokale Titanium-SSD-Laufwerke, die mit einigen Maschinenserien verwendet werden, müssen Sie keine entsprechenden Reservierungen an Ihre Zusicherungen anhängen. Speziell für lokale Titanium-SSD-Laufwerke benötigen Sie keine angehängten Reservierungen, wenn Sie Zusicherungen für Zusicherungstypen erwerben, die für die folgenden Maschinenserien gelten:

• Beschleunigungsoptimiert (G4)
• Computing-optimiert (H4D)
• Für allgemeine Zwecke (C4)
• C4A für allgemeine Zwecke
• C4D für allgemeine Zwecke
• Netzwerkoptimiert (C4N)
• Speicheroptimiert (Z3)
• Speicheroptimiert (Z4D)
• Speicheroptimiert (Z4M)

Wenn Sie eine ressourcenbasierte Zusicherung erwerben möchten, die diese Ressourcentypen enthält, können Sie diese Zusicherung erwerben, ohne Reservierungen für diese Ressourcen anzuhängen. Wenn Sie Reservierungen für diese vCPUs, diesen Arbeitsspeicher oder diese lokalen Titanium-SSD-Laufwerke anhängen möchten, können Sie diese Reservierungen optional anhängen.

Die angehängten Reservierungen für diese Ressourcen müssen nicht mit den Ressourcentypen und -zahlen übereinstimmen, die in der Zusicherung angegeben sind. Konkret passiert Folgendes, wenn Sie mehr oder weniger Ressourcen als Ihre Zusicherung angeben:

• Wenn in Ihrer Zusicherung mehr dieser Ressourcentypen als in den angehängten Reservierungen angegeben sind, reserviert Compute Engine nur Kapazität für die in der Zusicherung angegebenen Ressourcen. Sie können die restlichen zugesicherten Ressourcen jedoch weiterhin verwenden, sofern sie in Ihrer Region verfügbar sind.
• Wenn in Ihrer Reservierung mehr dieser Ressourcen angegeben sind als in Ihrer Zusicherung, erhalten Sie weiterhin nur CUDs für Ihre berechtigte Ressourcennutzung. Wenn die CUD-Freigabe aktiviert ist, werden ressourcenbasierte Zusicherungen in Ihrem Cloud-Rechnungskonto zusammengefasst und auf jede berechtigte Nutzung angewendet. Wenn in Ihren angehängten Reservierungen mehr Ressourcen angegeben sind, als Ihre Zusicherungen abdecken können, wird die zusätzliche Nutzung möglicherweise zu On-Demand-Preisen abgerechnet.

Wenn Sie beispielsweise eine Zusicherung für 4 vCPUs und 30 GB Arbeitsspeicher erwerben, können Sie Folgendes tun:

• Keine Reservierungen anhängen.

• Reservierungen anhängen, in denen eine beliebige Kombination dieser Ressourcentypen angegeben ist, z. B.:

  • 4 vCPUs und 30 GB Arbeitsspeicher
  • 2 vCPUs und 50 GB Arbeitsspeicher
  • 10 vCPUs und 10 GB Arbeitsspeicher

Wenn in Ihrer Zusicherung jedoch zusätzliche Ressourcentypen angegeben sind, für die angehängte Reservierungen erforderlich sind, müssen Sie für diese Ressourcen weiterhin Reservierungen anhängen.

Informationen zum Erwerb von Zusicherungen für Ressourcen, für die keine Reservierungen erforderlich sind, finden Sie unter Ressourcenbasierte Zusicherungen ohne angehängte Reservierungen erwerben.

Ressourcentypen, für die angehängte Reservierungen erforderlich sind

Für alle GPUs und die meisten lokalen SSD-Laufwerke müssen Sie diese Ressourcen reservieren und die Reservierungen an Ihre ressourcenbasierten Zusicherungen anhängen. Ohne angehängte Reservierungen für diese Ressourcen schlägt der Kauf der ressourcenbasierten Zusicherung fehl. Einige lokale Titanium-SSD-Laufwerke zur Verwendung mit einer Auswahl von Maschinenserien sind von dieser obligatorischen Reservierungsanforderung ausgenommen. Wenn Sie eine ressourcenbasierte Zusicherung erwerben, die GPUs, entsprechende lokale SSD-Laufwerke oder beides enthält, müssen Sie diese Ressourcen reservieren und die Reservierungen an Ihre Zusicherung anhängen. Dazu können Sie eine einzelne Reservierung oder eine Kombination aus mehreren Reservierungen verwenden.

Hinweis: Diese Reservierungsanforderungen gelten nicht für G2- und G4-GPUs oder lokale SSDs, wenn sie durch flexible Compute-Zusicherungen abgedeckt sind.

Wenn Sie eine Zusicherung für diese Ressourcen erwerben, für die angehängte Reservierungen erforderlich sind, können Sie optional auch Ressourcen in dieselbe Zusicherung aufnehmen, für die keine angehängten Reservierungen erforderlich sind. In solchen Szenarien können Sie eine der folgenden Optionen auswählen:

• Reservieren Sie die optionalen Ressourcen in einer Anzahl, die der Zusicherung entspricht.
• Reservieren Sie die optionalen Ressourcen in einer anderen Anzahl als in der Zusicherung.
• Die optionalen Ressourcen überhaupt nicht reservieren.

Informationen zum Kauf von Zusicherungen für GPUs oder lokale SSD-Laufwerke finden Sie hier:

• Für GPUs, die mit den Maschinentypen A4X Max, A4X, A4 oder A3 Ultra verwendet werden: Weitere Informationen finden Sie unter Kapazität reservieren in der AI Hypercomputer-Dokumentation.

• Für alle anderen GPU-Typen und anwendbaren lokalen SSD-Laufwerke: Weitere Informationen finden Sie in diesem Dokument unter Ressourcenbasierte Zusicherungen mit angehängten Reservierungen erwerben.

Wenn in Ihrer Zusicherung Ressourcentypen angegeben sind, für die eine angehängte Reservierung erforderlich ist, müssen in den angehängten Reservierungen die genaue Anzahl und die Typen dieser Ressourcen angegeben werden. Daher können Sie in Ihren angehängten Reservierungen auch keine zusätzliche Anzahl oder Typen dieser Ressourcen angeben.

Angenommen, Sie erwerben eine Zusicherung für 30 GB Arbeitsspeicher und 4 NVIDIA V100-GPUs. In der angehängten Reservierung (oder Kombination aus angehängten Reservierungen) kann eine beliebige Anzahl von vCPUs oder Arbeitsspeicher angegeben werden. Es müssen jedoch genau vier GPUs vom Typ NVIDIA V100 vorhanden sein. In diesem Beispiel können Sie keine Reservierungen anhängen, in denen eine der folgenden Kombinationen von Ressourcen angegeben ist:

• 6 NVIDIA V100-GPUs
• 2 NVIDIA V100-GPUs
• 4 NVIDIA V100-GPUs und 2 NVIDIA A100-GPUs
• 4 NVIDIA V100-GPUs und 4 lokale SSD-Laufwerke

Eine vollständige Liste der Maschinenreihen, die CUDs für GPUs und lokale SSDs unterstützen, finden Sie im Abschnitt Hardware-Zusicherungsarten der Dokumentation zu ressourcenbasierten CUDs.

Reservierungsverhalten nach dem Kauf einer Zusicherung

Nachdem Sie eine Zusicherung mit angehängten Reservierungen erworben haben, hängt das Verhalten der Reservierung davon ab, ob in der Zusicherung Ressourcentypen angegeben sind, für die angehängte Reservierungen erforderlich sind:

• Zusicherungen, für die angehängte Reservierungen erforderlich sind: Wenn in der Zusicherung einer dieser Ressourcentypen angegeben ist, können Sie während des gesamten Lebenszyklus der Zusicherung Folgendes nicht tun:
  • Löschen Sie die angehängten Reservierungen oder aktivieren Sie die Einstellung zum automatischen Löschen für diese angehängten Reservierungen. Wenn Zusicherungen, die diese Ressourcentypen angeben, ablaufen, werden alle angehängten Reservierungen automatisch gelöscht.
  • Sie können die Größe der Reservierungen ändern oder beliebige Attribute der Reservierungen außer den Freigabeeinstellungen ändern. Sie können jedoch vorhandene verbundene Reservierungen durch neue ersetzen.
• Zusicherungen, bei denen Reservierungen optional sind: Wenn die Zusicherung für Ressourcentypen gilt, bei denen Reservierungen optional sind, können Sie die Reservierungen jederzeit löschen, die Anzahl der reservierten VMs ändern oder Attribute wie das automatische Löschen ändern. Wenn diese Zusicherungen ablaufen, bleiben alle angehängten Reservierungen bestehen, sofern Sie sie nicht so konfigurieren, dass sie automatisch gelöscht werden. Das Löschen dieser Reservierungen hat keine Auswirkungen auf ausgeführte VMs, die die reservierte Kapazität genutzt haben. Die ausgeführten VMs werden weiterhin ausgeführt und Sie erhalten eine CUD-Abdeckung, bis Ihre Zusicherung abläuft.

Weitere Informationen dazu, was für Ihre angehängten Reservierungen geändert werden kann und was nicht, finden Sie in diesem Dokument im Abschnitt Zulässige Änderungen.

Ressourcenbasierte Zusicherungen mit angehängten Reservierungen erwerben

Wenn Sie eine neue Zusicherung erwerben, können Sie Reservierungen auf eine der folgenden Arten an Ihre Zusicherung anhängen:

• Vorhandene Reservierungen verwenden, die mit den Zusicherungsattributen übereinstimmen
• Neue übereinstimmende Reservierungen beim Kauf der Zusicherung erstellen

Nach dem Kauf einer Zusicherung wird Ihre Zusicherung am folgenden Tag um 00:00 Uhr US and Canadian Pacific Time (UTC-8 oder UTC-7 während der Sommerzeit) aktiviert. Compute Engine pflegt eine Sperre für Ihr Projekt für jede Region in Ihrem Projekt, in der Sie eine Zusicherung erwerben. Wenn Sie eine neue Zusicherung für eine Region in Ihrem Projekt erwerben, verknüpft Compute Engine die Sperre für diese Region mit der neu erstellten Zusicherung.

Zwischen dem Zeitpunkt des Zusicherungskaufs und der Aktivierungszeit bleibt der Status der Zusicherung NOT_YET_ACTIVE (oder PENDING in der Google Cloud Console). Nach der Aktivierung ändert sich der Status Ihrer Zusicherung in ACTIVE. Angenommen, Sie erwerben Ihre Zusicherung am 20. Januar 2024 um 22:00 Uhr US and Canadian Pacific Time (UTC-8 oder UTC-7). Compute Engine erstellt die Zusicherung sofort mit dem Status NOT_YET_ACTIVE. Ihre Zusicherung wird am 21. Januar 2024 um 00:00 Uhr US and Canadian Pacific Time (UTC-8 oder UTC-7) ACTIVE.

Wichtig: Sobald Sie eine Zusicherung erworben haben, können Sie sie nicht mehr stornieren. Wenn Sie das Projekt, das mit der Zusicherung verknüpft ist, in ein anderes Cloud-Rechnungskonto verschieben, übernimmt das Projekt die Einstellungen für die Attribution und die CUD-Freigabe, die für das Zielkonto gelten. Weitere Informationen finden Sie unter Auswirkungen der Änderung des Cloud-Rechnungskontos eines Projekts.

Voraussetzungen

Bevor Sie eine Zusicherung mit angehängten Reservierungen erwerben, lesen Sie diese Voraussetzungen und achten Sie darauf, dass Ihre Zusicherung und die Reservierungen die folgenden Kriterien erfüllen:

• Sie müssen die Zusicherung erwerben und die zugehörigen Reservierungen im selben Projekt und in derselben Region erstellen.
• Sie müssen die Zusicherung erwerben und die zugehörigen Reservierungen für Ressourcen aus derselben Maschinenfamilienreihe erstellen.
• Wenn in Ihrer Zusicherung Ressourcentypen angegeben sind, für die angehängte Reservierungen erforderlich sind, müssen Sie die Option zum automatischen Löschen für die angehängten Reservierungen deaktivieren. Weitere Informationen zu den Ressourcentypen, für die angehängte Reservierungen erforderlich sind
• Wenn die Zusicherung GPUs enthält, mudd der GPU-Typ in der Reservierung und der Zusicherung übereinstimmen.

• Bei GPUs und den meisten lokalen SSD-Laufwerken muss die Anzahl der reservierten Ressourcen jedes Ressourcentyps genau mit der Anzahl der für diesen Ressourcentyp zugesicherten Ressourcen übereinstimmen. Diese Anforderung gilt jedoch nicht, wenn Sie in Ihrer Zusicherung lokale Titanium-SSD-Laufwerke für die Verwendung mit den Maschinentypen C4, C4A, C4D, C4N, G4, H4D oder Z3 angeben.

  Wenn Sie beispielsweise eine Zusicherung für 4 V100-GPUs und 2 lokale SSD-Laufwerke erwerben möchten, müssen die mit der Zusicherung verbundenen Reservierungen insgesamt 4 V100-GPUs und 2 lokale SSDs angeben. Die Anzahl der vCPUs und die Menge an Arbeitsspeicher können jedoch unter der von Ihnen zugesicherten Nutzung liegen. Wenn Sie jedoch 4 C4A-vCPUs und 2 lokale Titanium-SSDs in Ihrer Zusicherung angeben, müssen Sie keine Reservierungen an die Zusicherung anhängen.

• Bei GPUs erwerben Sie Nutzungszusicherungen für die spezifischen GPU-Typen, die Sie verwenden möchten. Sie können beispielsweise Zusicherungen für NVIDIA A100- oder NVIDIA V100-GPUs erwerben, aber Sie können keine Zusicherungen verwenden, die für NVIDIA A100-GPUs erworben wurden, um NVIDIA V100-GPUs abzudecken.

• Wenn Ihre angehängte Reservierung eine freigegebene Reservierung ist und Sie die entsprechenden CUDs erhalten möchten, wenn Sie diese Reservierung außerhalb des Projekts Ihrer Zusicherung nutzen, müssen Sie Folgendes tun:

  • Geben Sie Ihre Reservierungen nur für Projekte frei, die zum selben Cloud-Rechnungskonto wie die Zusicherung gehören.
  • Prüfen Sie, ob die CUD-Freigabe für dieses Cloud-Rechnungskonto aktiviert ist.

Vorhandene Reservierungen anhängen

Sie können vorhandene Reservierungen beim Kauf Ihrer Zusicherung über die Google Cloud Console, die Google Cloud CLI oder REST anhängen.

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie folgende Berechtigungen:

• Zum Erwerben einer Zusicherung: compute.commitments.create für das Projekt
• Zum Erstellen von Reservierungen: compute.reservations.create für das Projekt

Console

Bevor Sie eine Zusicherung mit der Google Cloud Console erwerben, wählen Sie das Projekt aus, mit dem Sie die Zusicherung erwerben möchten. Wenn die CUD-Freigabe für ein Cloud-Rechnungskonto aktiviert ist, können Sie die Zusicherung über jedes Projekt über dieses Cloud-Rechnungskonto erwerben. Gehen Sie nach der Auswahl des Projekts so vor:

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

2. Klicken Sie auf Zusicherung kaufen. Die Seite Zusicherung erwerben wird angezeigt.

3. Geben Sie im Feld Name einen Namen für Ihre Zusicherung ein.

4. Wählen Sie im Feld Region die Region aus, in der Sie die Zusicherung erwerben möchten.

5. Wählen Sie im Feld Zusicherungstyp die Maschinenfamilienreihe für Ihre Zusicherung aus. Die folgenden Zusicherungstypen bieten Optionen für GPUs, lokale SSD-Laufwerke oder beides:

   • Wählen Sie für A2-Maschinentypen Beschleunigungsoptimiert (A2) aus.
   • Wählen Sie für die Maschinentypen A3 Edge und A3 High Beschleunigungsoptimiert (A3) aus.
   • Wählen Sie für A3 Mega-Maschinentypen Beschleunigungsoptimiert (A3 Mega) aus.
     Hinweis: Für die Maschinentypen A4X Max, A4X, A4 oder A3 Ultra müssen Sie Ihre Zusicherungen über die Verbrauchsoption Vorausschauende Reservierungen in AI Hypercomputer erwerben. Weitere Informationen finden Sie unter Kapazität über Ihr Account-Management-Team reservieren.
   • Wählen Sie für G2-Maschinentypen Grafikoptimierte G2 aus.
   • Wählen Sie für G4-Maschinentypen Grafikoptimiert (G4) aus.
   • Wählen Sie für C2-Maschinentypen Computing-optimiert (C2) aus.
   • Wählen Sie für C2D-Maschinentypen Computing-optimiert (C2D) aus.
   • Wählen Sie für C3-Maschinentypen für allgemeine Zwecke (C3) aus.
   • Wählen Sie für C3D-Maschinentypen C3D für allgemeine Zwecke aus.
     Achtung: Bei C3- und C3D-Zusicherungstypen ändert sich die durch den Zusicherungstyp angegebene Maschinenfamilie je nach Schnittstelle:

     • In der gcloud CLI und REST wird für die Werte des Zusicherungstyps Computing-optimiert als Maschinenfamilie verwendet, obwohl C3 und C3D zur Maschinenfamilie für allgemeine Zwecke gehören.
     • In der Google Cloud Console verwenden die Werte für den Zusicherungstyp die richtige Maschinenreihe: Für allgemeine Zwecke.

     Achten Sie darauf, den richtigen Wert für den Zusicherungstyp auszuwählen, der der von Ihnen verwendeten Schnittstelle entspricht.
   • Wählen Sie für C4-Maschinentypen für allgemeine Zwecke (C4) aus.
   • Wählen Sie für C4A-Maschinentypen C4A für allgemeine Zwecke aus.
   • Wählen Sie für C4D-Maschinentypen für allgemeine Zwecke (C4D) aus.
   • Wählen Sie für C4N-Maschinentypen Netzwerkoptimiert (C4N) aus.
   • Wählen Sie für N1-Maschinentypen Allgemeiner Zweck (N1) aus.
   • Wählen Sie für N2-Maschinentypen Allgemeiner Zweck (N2) aus.
   • Wählen Sie für N2D-Maschinentypen für allgemeine Zwecke (N2D) aus.
   • Wählen Sie für M1-Maschinentypen Speicheroptimiert (M1/M2) aus.
   • Wählen Sie für M3-Maschinentypen Speicheroptimiert (M3) aus.
   • Wählen Sie für Z3-Maschinentypen Speicheroptimiert (Z3) aus.
   • Wählen Sie für Z4D-Maschinentypen Speicheroptimiert (Z4D) aus.
   • Wählen Sie für Z4M-Maschinentypen Speicheroptimiert (Z4M) aus.

6. So hängen Sie der Zusicherung eine oder mehrere vorhandene Reservierungen an:

   1. Klicken Sie das Kästchen Neue oder vorhandene Reservierung anhängen an.

   2. Klicken Sie auf Vorhandene Reservierung anhängen. Der Bereich Vorhandene Reservierungen anhängen wird angezeigt und enthält Reservierungen aus Ihrem Projekt. Diese Liste wird nach der angegebenen Region und dem angegebenen Zusicherungstyp gefiltert.

   3. Klicken Sie im Bereich Vorhandene Reservierungen anhängen das Kästchen für jede Reservierung an, die Sie anhängen möchten.

   4. Sehen Sie sich die Ressourcenzusammenfassung für die ausgewählten Reservierungen an und klicken Sie dann auf Anhängen.

   Nachdem Sie Ihre Reservierungen angehängt haben, füllt Compute Engine die Felder im Abschnitt Zusicherungsdetails automatisch mit den Zahlen und Typen der Ressourcen aus Ihren angehängten Reservierungen aus. Wenn Sie vor dem Anhängen von Reservierungen manuell Werte für Ressourcen im Abschnitt Details zur Zusicherung eingegeben haben, werden diese Werte mit den Werten aus den Reservierungen überschrieben.

7. Geben Sie im Abschnitt Zusicherungsdetails Folgendes an:

   1. Prüfen Sie im Feld Kerne den vorausgefüllten Wert. Optional können Sie eine andere Anzahl von vCPUs angeben.

   2. Prüfen Sie im Feld Arbeitsspeicher die vorausgefüllte Größe des Arbeitsspeichers in GB. Optional können Sie einen anderen Betrag angeben. Sie können den Speicher nur in Schritten von 0,25 GB angeben. Wenn Sie einen benutzerdefinierten Arbeitsspeicherwert für Ihre Zusicherung angeben möchten, verwenden Sie stattdessen die gcloud CLI oder REST.

   3. Erweitern Sie den Abschnitt GPUs und lokale SSDs und prüfen Sie, ob die Typen und die Anzahl der Zusicherung und der angehängten Reservierungen übereinstimmen:

      1. Prüfen Sie im Feld GPU-Typ den vorausgefüllten GPU-Typ.

      2. Prüfen Sie im Feld Anzahl der GPUs die vorausgefüllte Anzahl der GPUs.

      3. Prüfen Sie im Feld Lokale SSDs die vorausgefüllte Anzahl von Laufwerken.

      Wenn Sie für eines dieser Felder manuell andere Werte als die der angehängten Reservierungen angeben, wird der Kauf der Zusicherung nicht abgeschlossen. Bei allen GPUs und den meisten lokalen SSD-Laufwerken müssen die Gesamtzahl und die Typen zwischen Ihrer Zusicherung und den angehängten Reservierungen übereinstimmen.

      Hinweis: Diese Anforderung gilt nicht für lokale Titanium-SSD-Laufwerke, die mit den Maschinenserien C4, C4A, C4D, C4N, H4D, Z3 oder G4 verwendet werden. Nur für diese Laufwerke müssen Sie keine Reservierungen anhängen und können unterschiedliche Zahlen zwischen Ihrer Zusicherung und den angehängten Reservierungen angeben.

8. Führen Sie im Abschnitt Laufzeit folgende Schritte aus:

   1. Wählen Sie entweder 1 Jahr oder 3 Jahre aus, um den Plan für Ihre Zusicherung anzugeben. Der Plan bestimmt den Rabatt für zugesicherte Nutzung und die voreingestellte Laufzeit Ihrer Zusicherung.

   2. Prüfen Sie das Feld Startdatum, in dem das Datum und die Uhrzeit angezeigt werden, zu denen Ihre Zusicherung aktiv wird. Dieses Feld wird automatisch auf 00:00 Uhr US-amerikanische und kanadische Pacific Time am Tag nach dem aktuellen Datum festgelegt.

   3. Optional. Wenn Sie die Laufzeit Ihrer Zusicherung über die voreingestellte Laufzeit hinaus verlängern möchten, die durch Ihren Zusicherungsplan definiert ist, geben Sie im Feld Enddatum ein benutzerdefiniertes Enddatum für Ihre Zusicherung an. Weitere Informationen finden Sie unter Laufzeit von Zusicherungen verlängern.

   4. Optional. Wenn Sie möchten, dass Ihre Zusicherung am Ende der Laufzeit automatisch verlängert wird, klicken Sie auf das Kästchen Zusicherung automatisch verlängern.

9. Prüfen Sie im Bereich Zusammenfassung die Details Ihrer Zusicherung und mögliche Kontingentbeschränkungen.

10. So schließen Sie den Kauf Ihrer Zusicherung ab:

    1. Gehen Sie zum Ende der Seite.

    2. Lesen Sie den Abschnitt Offenlegungen, der Informationen zu Gebühren, Rabattberechtigung und Nutzungsbedingungen enthält.

    3. Klicken Sie das Kästchen an, um zu bestätigen, dass Sie den Zusicherungspreis und die dienstspezifischen Nutzungsbedingungen akzeptieren.

    4. Klicken Sie auf Kaufen.

gcloud

Führen Sie den Befehl gcloud compute commitments create aus, um eine Zusicherung durch Anhängen vorhandener Reservierungen zu erwerben. Fügen Sie in Ihrem Befehl das Flag --existing-reservation ein, um eine vorhandene Reservierung anzugeben, die Sie an Ihre Zusage anhängen möchten. Fügen Sie für jede vorhandene Reservierung, die Sie anhängen möchten, eine neue Instanz dieses Flags ein. Sie können beliebig viele vorhandene Reservierungen an Ihre Zusicherung anhängen.

Wenn Sie beispielsweise eine Zusicherung erwerben möchten, indem Sie zwei Reservierungen daran anhängen, führen Sie den folgenden Befehl aus:

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
    --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
    --plan=PLAN \
    --type=COMMITMENT_TYPE \
    --custom-end-time=CUSTOM_END_DATE \
    --existing-reservation=name='RESERVATION_NAME_1',zone='RESERVATION_ZONE_1' \
    --existing-reservation=name='RESERVATION_NAME_2',zone='RESERVATION_ZONE_2'

Ersetzen Sie Folgendes:

• COMMITMENT_NAME: der Name der Zusicherung.
• REGION: die Region, in der sich die Zusicherung befindet
• PROJECT_ID: die ID des Projekts, in dem Sie die Zusicherung mit den angehängten Reservierungen kaufen möchten.
• PLAN: der Plan für zugesicherte Nutzung, der Ihren Rabatt für zugesicherte Nutzung und die voreingestellte Laufzeit bestimmt. Geben Sie 12-month oder 36-month an.
• CUSTOM_END_DATE: Optional. Ein benutzerdefiniertes Enddatum für Ihre Laufzeit, das als YYYY-MM-DD formatiert sein muss. Wenn Sie beispielsweise den 20. April 2024 als benutzerdefiniertes Enddatum angeben möchten, formatieren Sie es als 2024-04-20.

• COMMITMENT_TYPE: der Zusicherungstyp. Die folgenden Zusicherungstypen bieten Optionen für GPUs, lokale SSD-Laufwerke oder beides:

  • Verwenden Sie für A2-Maschinentypen accelerator-optimized.
  • Verwenden Sie für die Maschinentypen A3 Edge und A3 High accelerator-optimized-a3.
  • Verwenden Sie für A3 Mega-Maschinentypen accelerator-optimized-a3-mega.
    Hinweis: Für die Maschinentypen A4X Max, A4X, A4 oder A3 Ultra müssen Sie Ihre Zusicherungen über die Verbrauchsoption Vorausschauende Reservierungen in AI Hypercomputer erwerben. Weitere Informationen finden Sie unter Kapazität über Ihr Account-Management-Team reservieren.
  • Verwenden Sie für G2-Maschinentypen graphics-optimized.
  • Verwenden Sie für G4-Maschinentypen graphics-optimized-g4.
  • Verwenden Sie für C2-Maschinentypen compute-optimized.
  • Verwenden Sie für C2D-Maschinentypen compute-optimized-c2d.
  • Verwenden Sie für C3-Maschinentypen compute-optimized-c3.
  • Verwenden Sie für C3D-Maschinentypen compute-optimized-c3d.
    Achtung: Bei C3- und C3D-Zusicherungstypen ändert sich die durch den Zusicherungstyp angegebene Maschinenfamilie je nach Schnittstelle:

    • In der gcloud CLI und REST wird für die Werte des Zusicherungstyps Computing-optimiert als Maschinenfamilie verwendet, obwohl C3 und C3D zur Maschinenfamilie für allgemeine Zwecke gehören.
    • In der Google Cloud Console verwenden die Werte für den Zusicherungstyp die richtige Maschinenreihe: Für allgemeine Zwecke.

    Achten Sie darauf, den richtigen Wert für den Zusicherungstyp auszuwählen, der der von Ihnen verwendeten Schnittstelle entspricht.
  • Verwenden Sie für N1-Maschinentypen general-purpose.
  • Verwenden Sie für C4-Maschinentypen general-purpose-c4.
  • Verwenden Sie für C4A-Maschinentypen general-purpose-c4a.
  • Verwenden Sie für C4D-Maschinentypen general-purpose-c4d.
  • Verwenden Sie für C4N-Maschinentypen network-optimized-c4n.
  • Verwenden Sie für N2-Maschinentypen general-purpose-n2.
  • Verwenden Sie für N2D-Maschinentypen general-purpose-n2d.
  • Verwenden Sie für M1-Maschinentypen memory-optimized.
  • Verwenden Sie für M3-Maschinentypen memory-optimized-m3.
  • Verwenden Sie für Z3-Maschinentypen storage-optimized-z3.
  • Verwenden Sie für Z4D-Maschinentypen storage-optimized-z4d.
  • Verwenden Sie für Z4M-Maschinentypen storage-optimized-z4m.

• COMMITTED_VCPUS: Die Anzahl der vCPUs, die Sie in Ihrer Zusicherung benötigen. Diese Zahl muss eine positive ganze Zahl sein.

• COMMITTED_MEMORY: die Arbeitsspeichermenge in MB oder GB, die Sie in Ihrer Zusicherung verwenden möchten. Beispiel: 10240MB oder 10GB. In der gcloud CLI können Sie den Arbeitsspeicher in MB oder GB angeben. Wenn Sie keine Einheit angeben, verwendet die Compute Engine GB als Standardeinheit. Beachten Sie jedoch, dass Compute Engine bei Verwendung von REST MB als Standardeinheit verwendet.

• COMMITTED_LOCAL_SSD: die Menge an lokalem SSD-Speicherplatz in GB, die Sie in Ihrer Zusicherung verwenden möchten.

• COMMITTED_ACCELERATOR_COUNT: die Anzahl der GPUs, die Sie in Ihrer Zusicherung verwenden möchten.

• COMMITTED_ACCELERATOR_TYPE: der GPU-Typ, den Sie in Ihrer Zusicherung verwenden möchten.

• RESERVATION_NAME_1 und RESERVATION_NAME_2: die Namen der vorhandenen Reservierungen, die Sie der Nutzungszusicherung anhängen möchten.

• RESERVATION_ZONE_1 und RESERVATION_ZONE_2: die Zonen der vorhandenen Reservierungen, die Sie der Zusicherung anhängen möchten.

Beispiel: Eine Zusicherung durch Anhängen vorhandener Reservierungen erwerben

Angenommen, Sie haben zwei Reservierungen res-01 und res-02 in den Zonen us-central1-a und us-central1-b des Projekts myproject. Angenommen, diese Reservierungen haben eine kombinierte Kapazität für 4 NVIDIA T4-GPUs und 4 lokale SSDs. Wenn Sie in der Region us-central1 dieses Projekts eine neue Zusicherung für diese GPUs und lokalen SSDs erwerben und diese vorhandenen Reservierungen als angehängte Reservierungen verwenden möchten, führen Sie den folgenden Befehl aus. Die Zusicherung umfasst 96 vCPUs, 624 GB Arbeitsspeicher, 4 NVIDIA T4-GPUs und 1.500 GB lokalen SSD-Speicher (entspricht 4 lokalen SSD-Laufwerken). Der Wert für den lokalen SSD-Speicher muss in GB angegeben werden (z. B. 375GB). In der gcloud CLI können Sie den Speicher in MB oder GB angeben. Wenn Sie keine Einheit angeben, verwendet Compute Engine GB als Standardeinheit. Beachten Sie jedoch, dass Compute Engine bei Verwendung von REST MB als Standardeinheit verwendet.

gcloud compute commitments create commitment-01 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624GB,local-ssd=1500 \
    --resources-accelerator=type=nvidia-tesla-t4,count=4 \
    --plan 12-month \
    --existing-reservation=name=res-01,zone=us-central1-a \
    --existing-reservation=name=res-02,zone=us-central1-b
    

REST

Wenn Sie eine Zusicherung durch Anhängen vorhandener Reservierungen erwerben möchten, senden Sie eine POST-Anfrage an die Methode regionCommitments.insert. Fügen Sie in Ihrer Anfrage das Feld existingReservations ein, um eine durch Kommas getrennte Liste aller vorhandenen Reservierungen anzugeben, die Sie an Ihre Zusicherung anhängen möchten. Sie können beliebig viele vorhandene Reservierungen an Ihre Zusicherung anhängen.

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

{
  "name": "COMMITMENT_NAME",
  "plan": "PLAN",
  "type": "COMMITMENT_TYPE",
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    },
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "existingReservations": "RESERVATION_URLS"
}

Ersetzen Sie Folgendes:

• COMMITMENT_NAME: der Name der Zusicherung.
• REGION: die Region, in der sich die Zusicherung befindet
• PROJECT_ID: die ID des Projekts, in dem Sie die Zusicherung mit den angehängten Reservierungen kaufen möchten.
• PLAN: der Plan für zugesicherte Nutzung, der Ihren Rabatt für zugesicherte Nutzung und die voreingestellte Laufzeit bestimmt. Geben Sie TWELVE_MONTH oder THIRTY_SIX_MONTH an.

• COMMITMENT_TYPE: der Zusicherungstyp. Die folgenden Zusicherungstypen bieten Optionen für GPUs, lokale SSD-Laufwerke oder beides:

  • Verwenden Sie für A2-Maschinentypen ACCELERATOR_OPTIMIZED.
  • Verwenden Sie für die Maschinentypen A3 Edge und A3 High ACCELERATOR_OPTIMIZED_A3.
  • Verwenden Sie für A3 Mega-Maschinentypen ACCELERATOR_OPTIMIZED_A3_MEGA.
    Hinweis: Für die Maschinentypen A4X Max, A4X, A4 oder A3 Ultra müssen Sie Ihre Zusicherungen über die Verbrauchsoption Vorausschauende Reservierungen in AI Hypercomputer erwerben. Weitere Informationen finden Sie unter Kapazität über Ihr Account-Management-Team reservieren.
  • Verwenden Sie für G2-Maschinentypen GRAPHICS_OPTIMIZED.
  • Verwenden Sie für G4-Maschinentypen GRAPHICS_OPTIMIZED_G4.
  • Verwenden Sie für C2-Maschinentypen COMPUTE_OPTIMIZED.
  • Verwenden Sie für C2D-Maschinentypen COMPUTE_OPTIMIZED_C2D.
  • Verwenden Sie für C3-Maschinentypen COMPUTE_OPTIMIZED_C3.
  • Verwenden Sie für C3D-Maschinentypen COMPUTE_OPTIMIZED_C3D.
    Achtung: Bei C3- und C3D-Zusicherungstypen ändert sich die durch den Zusicherungstyp angegebene Maschinenfamilie je nach Schnittstelle:

    • In der gcloud CLI und REST wird für die Werte des Zusicherungstyps Computing-optimiert als Maschinenfamilie verwendet, obwohl C3 und C3D zur Maschinenfamilie für allgemeine Zwecke gehören.
    • In der Google Cloud Console verwenden die Werte für den Zusicherungstyp die richtige Maschinenreihe: Für allgemeine Zwecke.

    Achten Sie darauf, den richtigen Wert für den Zusicherungstyp auszuwählen, der der von Ihnen verwendeten Schnittstelle entspricht.
  • Verwenden Sie für N1-Maschinentypen GENERAL_PURPOSE.
  • Verwenden Sie für C4-Maschinentypen GENERAL_PURPOSE_C4.
  • Verwenden Sie für C4A-Maschinentypen GENERAL_PURPOSE_C4A.
  • Verwenden Sie für C4D-Maschinentypen GENERAL_PURPOSE_C4D.
  • Verwenden Sie für C4N-Maschinentypen NETWORK_OPTIMIZED_C4N.
  • Verwenden Sie für N2-Maschinentypen GENERAL_PURPOSE_N2.
  • Verwenden Sie für N2D-Maschinentypen GENERAL_PURPOSE_N2D.
  • Verwenden Sie für M1-Maschinentypen MEMORY_OPTIMIZED.
  • Verwenden Sie für M3-Maschinentypen MEMORY_OPTIMIZED_M3.
  • Verwenden Sie für Z3-Maschinentypen STORAGE_OPTIMIZED_Z3.
  • Verwenden Sie für Z4D-Maschinentypen STORAGE_OPTIMIZED_Z4D.
  • Verwenden Sie für Z4M-Maschinentypen STORAGE_OPTIMIZED_Z4M.

• COMMITTED_VCPUS: Die Anzahl der vCPUs, die Sie in Ihrer Zusicherung benötigen. Diese Zahl muss eine positive ganze Zahl sein.

• COMMITTED_MEMORY: die Arbeitsspeichermenge, die Sie in Ihrer Zusicherung verwenden möchten. Bei REST verwendet Compute Engine MB als Standardeinheit. Wenn Sie die gcloud CLI verwenden, verwendet Compute Engine jedoch GB als Standardeinheit.

• COMMITTED_LOCAL_SSD: die Größe des lokalen SSD-Speichers in GB, die Sie in Ihrer Zusicherung verwenden möchten.

• COMMITTED_ACCELERATOR_COUNT: die Anzahl der GPUs, die Sie in Ihrer Zusicherung verwenden möchten.

• COMMITTED_ACCELERATOR_TYPE: der GPU-Typ, den Sie in Ihrer Zusicherung verwenden möchten.

• CUSTOM_END_DATE: Optional. Ein benutzerdefiniertes Enddatum für Ihre Laufzeit, das als YYYY-MM-DD formatiert sein muss. Wenn Sie beispielsweise den 20. April 2024 als benutzerdefiniertes Enddatum angeben möchten, formatieren Sie es als 2024-04-20.

• END_TIME: 00:00 Uhr US and Canadian Pacific Time (UTC-8 oder UTC-7), als Versatz der koordinierten Weltzeit (Coordinated Universal Time, UTC). Geben Sie diesen Wert nur an, wenn Sie ein benutzerdefiniertes Enddatum für Ihre Zusicherung angegeben haben. Geben Sie einen der folgenden Werte an:

  • Während der Sommerzeit: 07:00:00
  • Zu anderen Zeiten: 08:00:00

• RESERVATION_URLS: eine durch Kommas getrennte Liste der URLs der vorhandenen Reservierungen, die Sie an die Zusicherung anhängen möchten. Wenn Sie beispielsweise zwei Reservierungen, res-1 und res-2, anhängen möchten, geben Sie Folgendes an:

  "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/example-res-1",
  "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/reservations/example-res-2"
  

Beispiel: Eine Zusicherung durch Anhängen vorhandener Reservierungen erwerben

Angenommen, Sie haben zwei Reservierungen res-01 und res-02 in den Zonen us-central1-a und us-central1-b des Projekts myproject. Angenommen, diese Reservierungen haben eine kombinierte Kapazität für 4 NVIDIA T4-GPUs und 4 lokale SSDs. Wenn Sie für diese GPUs und lokalen SSDs eine neue Zusicherung in der Region us-central1 dieses Projekts erwerben und diese vorhandenen Reservierungen als angehängte Reservierungen verwenden möchten, senden Sie die folgende POST-Anfrage. Die Zusicherung umfasst 96 vCPUs, 624 GB Arbeitsspeicher, 4 NVIDIA T4-GPUs und 1.500 GB lokalen SSD-Speicher. Der Wert für den lokalen SSD-Speicher muss in GB angegeben werden. Für den Arbeitsspeicher müssen Sie den Wert in MB angeben. Wenn Sie die gcloud CLI verwenden, verwendet Compute Engine jedoch GB als Standardeinheit für den Arbeitsspeicher.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-01",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-t4",
      "amount": "4",
      "type": "ACCELERATOR"
    },
    {
      "amount": "1500",
      "type": "LOCAL_SSD"
    }
  ],
  "existingReservations":
  [
    "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/res-01",
    "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-b/reservations/res-02"
  ]
}

Neue Reservierungen zum Anhängen erstellen

Sie können die angehängten Reservierungen beim Kauf der Zusicherung über die Google Cloud Console, die gcloud CLI oder REST erstellen.

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie folgende Berechtigungen:

• Zum Erwerben einer Zusicherung: compute.commitments.create für das Projekt
• Zum Erstellen von Reservierungen: compute.reservations.create für das Projekt

Console

Bevor Sie eine Zusicherung mit der Google Cloud Console erwerben, wählen Sie das Projekt aus, mit dem Sie die Zusicherung erwerben möchten. Wenn die CUD-Freigabe für ein Cloud-Rechnungskonto aktiviert ist, können Sie die Zusicherung über jedes Projekt über dieses Cloud-Rechnungskonto erwerben. Gehen Sie nach der Auswahl des Projekts so vor:

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

2. Klicken Sie auf Zusicherung kaufen. Die Seite Zusicherung erwerben wird angezeigt.

3. Geben Sie im Feld Name einen Namen für Ihre Zusicherung ein.

4. Wählen Sie im Feld Region die Region aus, in der Sie die Zusicherung erwerben möchten.

5. Wählen Sie im Feld Zusicherungstyp die Maschinenfamilienreihe für Ihre Zusicherung aus. Die folgenden Zusicherungstypen bieten Optionen für GPUs, lokale SSD-Laufwerke oder beides:

   • Wählen Sie für A2-Maschinentypen Beschleunigungsoptimiert (A2) aus.
   • Wählen Sie für die Maschinentypen A3 Edge und A3 High Beschleunigungsoptimiert (A3) aus.
   • Wählen Sie für A3 Mega-Maschinentypen Beschleunigungsoptimiert (A3 Mega) aus.
     Hinweis: Für die Maschinentypen A4X Max, A4X, A4 oder A3 Ultra müssen Sie Ihre Zusicherungen über die Verbrauchsoption Vorausschauende Reservierungen in AI Hypercomputer erwerben. Weitere Informationen finden Sie unter Kapazität über Ihr Account-Management-Team reservieren.
   • Wählen Sie für G2-Maschinentypen Grafikoptimierte G2 aus.
   • Wählen Sie für G4-Maschinentypen Grafikoptimiert (G4) aus.
   • Wählen Sie für C2-Maschinentypen Computing-optimiert (C2) aus.
   • Wählen Sie für C2D-Maschinentypen Computing-optimiert (C2D) aus.
   • Wählen Sie für C3-Maschinentypen für allgemeine Zwecke (C3) aus.
   • Wählen Sie für C3D-Maschinentypen C3D für allgemeine Zwecke aus.
     Achtung: Bei C3- und C3D-Zusicherungstypen ändert sich die durch den Zusicherungstyp angegebene Maschinenfamilie je nach Schnittstelle:

     • In der gcloud CLI und REST wird für die Werte des Zusicherungstyps Computing-optimiert als Maschinenfamilie verwendet, obwohl C3 und C3D zur Maschinenfamilie für allgemeine Zwecke gehören.
     • In der Google Cloud Console verwenden die Werte für den Zusicherungstyp die richtige Maschinenreihe: Für allgemeine Zwecke.

     Achten Sie darauf, den richtigen Wert für den Zusicherungstyp auszuwählen, der der von Ihnen verwendeten Schnittstelle entspricht.
   • Wählen Sie für C4-Maschinentypen für allgemeine Zwecke (C4) aus.
   • Wählen Sie für C4A-Maschinentypen C4A für allgemeine Zwecke aus.
   • Wählen Sie für C4D-Maschinentypen für allgemeine Zwecke (C4D) aus.
   • Wählen Sie für C4N-Maschinentypen Netzwerkoptimiert (C4N) aus.
   • Wählen Sie für N1-Maschinentypen Allgemeiner Zweck (N1) aus.
   • Wählen Sie für N2-Maschinentypen Allgemeiner Zweck (N2) aus.
   • Wählen Sie für N2D-Maschinentypen für allgemeine Zwecke (N2D) aus.
   • Wählen Sie für M1-Maschinentypen Speicheroptimiert (M1/M2) aus.
   • Wählen Sie für M3-Maschinentypen Speicheroptimiert (M3) aus.
   • Wählen Sie für Z3-Maschinentypen Speicheroptimiert (Z3) aus.
   • Wählen Sie für Z4D-Maschinentypen Speicheroptimiert (Z4D) aus.
   • Wählen Sie für Z4M-Maschinentypen Speicheroptimiert (Z4M) aus.

6. So erstellen Sie eine neue Reservierung und hängen sie an die Zusicherung an:

   1. Klicken Sie das Kästchen Neue oder vorhandene Reservierung anhängen an.

   2. Klicken Sie auf Neue Reservierung erstellen. Der Bereich Neue Reservierung erstellen wird angezeigt.

   3. Geben Sie im Feld Name einen Namen für die Reservierung ein.

   4. Optional: Geben Sie im Feld Beschreibung eine Beschreibung ein.

   5. Wählen Sie im Feld Zone die Zone aus, in der die reservierten Ressourcen verfügbar sein sollen.

   6. Geben Sie im Bereich Freigabetyp an, wie Sie diese Reservierung freigeben möchten:

      • Um eine Reservierung für ein Einzelprojekt zu erstellen, wählen Sie Lokal aus.
      • Wenn Sie eine Reservierung erstellen möchten, die für mehrere Projekte freigegeben ist, wählen Sie Freigegeben aus. Klicken Sie dann auf Projekte hinzufügen und wählen Sie die gewünschten Projekte aus.

   7. Geben Sie im Abschnitt Google Cloud-Dienste an, ob diese Reservierung für andere Dienste wie Google Kubernetes Engine oder Vertex AI freigegeben werden soll.

   8. Wählen Sie im Abschnitt Mit VM-Instanz verwenden aus, wie VMs Ihre Reservierung nutzen sollen:

      • Damit VMs mit übereinstimmenden Attributen diese Reservierung automatisch verwenden können, wählen Sie Reservierung automatisch verwenden aus.
      • Wenn Sie die Ressourcen dieser Reservierung nur dann verbrauchen möchten, wenn sie ausdrücklich namentlich ausgewählt wurde, wählen Sie Spezifische Reservierung auswählen aus.

   9. Geben Sie im Abschnitt Ressourcendetails Folgendes an:

      1. Geben Sie im Feld Anzahl der VM-Instanzen die Anzahl der VMs ein.

      2. Geben Sie im Abschnitt Maschinenkonfiguration Attribute an, indem Sie Maschinentyp auswählen. Wählen Sie einen Maschinentyp aus der Liste aus oder wählen Sie Benutzerdefiniert aus, um die Anzahl der Kerne und die Größe des Arbeitsspeichers anzugeben.

      3. Optional: Wenn Sie GPUs reservieren möchten, klicken Sie auf GPU hinzufügen und geben Sie den GPU-Typ und die Anzahl der GPUs für jede VM an.

      4. Optional: Wenn Sie lokale SSDs reservieren möchten, geben Sie die Anzahl der Laufwerke und den Schnittstellentyp an.

      5. Optional: Wenn Sie eine Richtlinie für die Gruppenplatzierung angeben möchten, wählen Sie in der Liste Richtlinie für die Gruppenplatzierung eine Richtlinie aus oder erstellen Sie eine.

   10. Klicken Sie auf Erstellen und anhängen, um das Festlegen der Attribute für diese Reservierung abzuschließen.

   11. Optional: Wenn Sie weitere neue Reservierungen erstellen und anhängen möchten, klicken Sie noch einmal auf Neue Reservierung erstellen und wiederholen Sie diese Schritte.

   Nachdem Sie Ihre Reservierungen angehängt haben, füllt Compute Engine die Felder im Abschnitt Zusicherungsdetails automatisch mit den Zahlen und Typen der Ressourcen aus Ihren angehängten Reservierungen aus. Wenn Sie vor dem Anhängen von Reservierungen manuell Werte für Ressourcen im Abschnitt Details zur Zusicherung eingegeben haben, werden diese Werte mit den Werten aus den Reservierungen überschrieben.

7. Geben Sie im Abschnitt Zusicherungsdetails Folgendes an:

   1. Prüfen Sie im Feld Kerne den vorausgefüllten Wert. Optional können Sie eine andere Anzahl von vCPUs angeben.

   2. Prüfen Sie im Feld Arbeitsspeicher die vorausgefüllte Größe des Arbeitsspeichers in GB. Optional können Sie einen anderen Betrag angeben. Sie können den Speicher nur in Schritten von 0,25 GB angeben. Wenn Sie einen benutzerdefinierten Arbeitsspeicherwert für Ihre Zusicherung angeben möchten, verwenden Sie stattdessen die gcloud CLI oder REST.

   3. Erweitern Sie den Abschnitt GPUs und lokale SSDs und prüfen Sie, ob die Typen und die Anzahl der Zusicherung und der angehängten Reservierungen übereinstimmen:

      1. Prüfen Sie im Feld GPU-Typ den vorausgefüllten GPU-Typ.

      2. Prüfen Sie im Feld Anzahl der GPUs die vorausgefüllte Anzahl der GPUs.

      3. Prüfen Sie im Feld Lokale SSDs die vorausgefüllte Anzahl von Laufwerken.

      Wenn Sie für eines dieser Felder manuell andere Werte als die der angehängten Reservierungen angeben, wird der Kauf der Zusicherung nicht abgeschlossen. Bei allen GPUs und den meisten lokalen SSD-Laufwerken müssen die Gesamtzahl und die Typen zwischen Ihrer Zusicherung und den angehängten Reservierungen übereinstimmen.

      Hinweis: Diese Anforderung gilt nicht für lokale Titanium-SSD-Laufwerke, die mit den Maschinenserien C4, C4A, C4D, C4N, H4D, Z3 oder G4 verwendet werden. Nur für diese Laufwerke müssen Sie keine Reservierungen anhängen und können unterschiedliche Zahlen zwischen Ihrer Zusicherung und den angehängten Reservierungen angeben.

8. Führen Sie im Abschnitt Laufzeit folgende Schritte aus:

   1. Wählen Sie entweder 1 Jahr oder 3 Jahre aus, um den Plan für Ihre Zusicherung anzugeben. Der Plan bestimmt den Rabatt für zugesicherte Nutzung und die voreingestellte Laufzeit Ihrer Zusicherung.

   2. Prüfen Sie das Feld Startdatum, in dem das Datum und die Uhrzeit angezeigt werden, zu denen Ihre Zusicherung aktiv wird. Dieses Feld wird automatisch auf 00:00 Uhr US-amerikanische und kanadische Pacific Time am Tag nach dem aktuellen Datum festgelegt.

   3. Optional. Wenn Sie die Laufzeit Ihrer Zusicherung über die voreingestellte Laufzeit hinaus verlängern möchten, die durch Ihren Zusicherungsplan definiert ist, geben Sie im Feld Enddatum ein benutzerdefiniertes Enddatum für Ihre Zusicherung an. Weitere Informationen finden Sie unter Laufzeit von Zusicherungen verlängern.

   4. Optional. Wenn Sie möchten, dass Ihre Zusicherung am Ende der Laufzeit automatisch verlängert wird, klicken Sie auf das Kästchen Zusicherung automatisch verlängern.

9. Prüfen Sie im Bereich Zusammenfassung die Details Ihrer Zusicherung und mögliche Kontingentbeschränkungen.

10. So schließen Sie den Kauf Ihrer Zusicherung ab:

    1. Gehen Sie zum Ende der Seite.

    2. Lesen Sie den Abschnitt Offenlegungen, der Informationen zu Gebühren, Rabattberechtigung und Nutzungsbedingungen enthält.

    3. Klicken Sie das Kästchen an, um zu bestätigen, dass Sie den Zusicherungspreis und die dienstspezifischen Nutzungsbedingungen akzeptieren.

    4. Klicken Sie auf Kaufen.

gcloud

Wenn Sie die angehängten Reservierungen beim Kauf der Zusicherung erstellen möchten, führen Sie den Befehl gcloud compute commitments create aus.

Hinweis: Sie können die gcloud CLI nicht verwenden, um Ihre angehängten Reservierungen mithilfe von Instanzvorlagen zu erstellen. Stattdessen müssen Sie die VM-Attribute für Ihre Reservierungen manuell angeben.

Je nachdem, ob Sie eine einzelne Reservierung oder mehrere Reservierungen anhängen möchten, führen Sie den Befehl auf eine der folgenden Arten aus:

• Wenn Sie eine einzelne Reservierung erstellen und an Ihre Zusicherung anhängen möchten, definieren Sie die Attribute der angehängten Reservierung mit dem folgenden Befehl:

  gcloud compute commitments create COMMITMENT_NAME \
      --region=REGION \
      --project=PROJECT_ID \
      --plan PLAN \
      --type COMMITMENT_TYPE \
      --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
      --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
      --custom-end-time=CUSTOM_END_DATE \
      --reservation=RESERVATION_NAME \
      --reservation-zone=RESERVATION_ZONE \
      --machine-type=RESERVED_MACHINE_TYPE \
      --require-specific-reservation=REQUIRE_SPECIFIC_RESERVATION_VALUE \
      --vm-count=NUMBER_OF_RESERVED_VMS \
      --accelerator=type=RESERVED_ACCELERATOR_TYPE,count=RESERVED_ACCELERATOR_COUNT \
      --local-ssd=interface=INTERFACE_1,size=375 \
      --local-ssd=interface=INTERFACE_2,size=375 \
      --minimum-cpu-platform=MINIMUM_CPU_PLATFORM \
      --share-setting=SHARE_SETTING \
      --share-with=CONSUMER_PROJECT_ID_1,CONSUMER_PROJECT_ID_2
  

• Wenn Sie mehrere Reservierungen erstellen und an Ihre Zusicherung anhängen möchten, definieren Sie die Attribute der Reservierung mithilfe einer YAML-Datei und geben Sie diese YAML-Datei dann in dem Befehl an, mit dem Sie Ihre Zusicherung erwerben. Optional können Sie diesen YAML-Dateiansatz auch verwenden, um eine einzelne Reservierung zu erstellen und an Ihre Zusicherung anzuhängen. So erstellen Sie Ihre angehängten Reservierungen mit diesem Ansatz:

  1. Erstellen Sie die YAML-Datei im aktuellen Verzeichnis und geben Sie die gewünschte Konfiguration für jede angehängte Reservierung an. Wenn Sie beispielsweise die Konfiguration einer freigegebenen Reservierung angeben möchten, die für zwei Projekte freigegeben ist und GPUs, zwei lokale SSD-Laufwerke und eine Mindest-CPU-Plattform angibt, fügen Sie den folgenden Text in Ihre YAML-Datei ein:

     - reservation: RESERVATION_NAME
       reservation_zone: RESERVATION_ZONE
       require_specific_reservation: REQUIRE_SPECIFIC_RESERVATION_VALUE
       vm_count: NUMBER_OF_RESERVED_VMS
       machine_type: RESERVED_MACHINE_TYPE
       accelerator:
       - count: RESERVED_ACCELERATOR_COUNT
         type: RESERVED_ACCELERATOR_TYPE
       local_ssd:
       - interface: INTERFACE_1
         size: 375
       - interface: INTERFACE_2
         size: 375
       project: OWNER_PROJECT_ID
       minimum-cpu-platform: MINIMUM_CPU_PLATFORM
       share-setting: SHARE_SETTING
       share-with:
       - CONSUMER_PROJECT_ID_1
       - CONSUMER_PROJECT_ID_2
     
     

     Wenn Sie die Konfiguration für mehrere Reservierungen angeben möchten, wiederholen Sie diese Attribute für jede Reservierung, die Sie erstellen möchten. Sie können beliebig viele vorhandene Reservierungen an Ihre Zusicherung anhängen.

  2. Verwenden Sie den gcloud compute commitments create-Befehl und fügen Sie das Flag --reservations-from-file ein.

     gcloud compute commitments create COMMITMENT_NAME \
         --region REGION \
         --project PROJECT_ID \
         --plan PLAN \
         --type COMMITMENT_TYPE \
         --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
         --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
         --reservations-from-file=YAML_FILE
     

Ersetzen Sie Folgendes durch die entsprechenden Attribute der Zusicherung und der angehängten Reservierungen:

Verpflichtung

• COMMITMENT_NAME: der Name der Zusicherung.
• REGION: die Region, in der sich die Zusicherung befindet
• PROJECT_ID: die ID des Projekts, in dem Sie die Zusicherung mit den angehängten Reservierungen kaufen möchten.
• PLAN: der Plan für zugesicherte Nutzung, der Ihren Rabatt für zugesicherte Nutzung und die voreingestellte Laufzeit bestimmt. Geben Sie 12-month oder 36-month an.
• CUSTOM_END_DATE: Optional. Ein benutzerdefiniertes Enddatum für Ihre Laufzeit, das als YYYY-MM-DD formatiert sein muss. Wenn Sie beispielsweise den 20. April 2024 als benutzerdefiniertes Enddatum angeben möchten, formatieren Sie es als 2024-04-20.

• COMMITMENT_TYPE: der Zusicherungstyp. Die folgenden Zusicherungstypen bieten Optionen für GPUs, lokale SSD-Laufwerke oder beides:

  • Verwenden Sie für A2-Maschinentypen accelerator-optimized.
  • Verwenden Sie für die Maschinentypen A3 Edge und A3 High accelerator-optimized-a3.
  • Verwenden Sie für A3 Mega-Maschinentypen accelerator-optimized-a3-mega.
    Hinweis: Für die Maschinentypen A4X Max, A4X, A4 oder A3 Ultra müssen Sie Ihre Zusicherungen über die Verbrauchsoption Vorausschauende Reservierungen in AI Hypercomputer erwerben. Weitere Informationen finden Sie unter Kapazität über Ihr Account-Management-Team reservieren.
  • Verwenden Sie für G2-Maschinentypen graphics-optimized.
  • Verwenden Sie für G4-Maschinentypen graphics-optimized-g4.
  • Verwenden Sie für C2-Maschinentypen compute-optimized.
  • Verwenden Sie für C2D-Maschinentypen compute-optimized-c2d.
  • Verwenden Sie für C3-Maschinentypen compute-optimized-c3.
  • Verwenden Sie für C3D-Maschinentypen compute-optimized-c3d.
    Achtung: Bei C3- und C3D-Zusicherungstypen ändert sich die durch den Zusicherungstyp angegebene Maschinenfamilie je nach Schnittstelle:

    • In der gcloud CLI und REST wird für die Werte des Zusicherungstyps Computing-optimiert als Maschinenfamilie verwendet, obwohl C3 und C3D zur Maschinenfamilie für allgemeine Zwecke gehören.
    • In der Google Cloud Console verwenden die Werte für den Zusicherungstyp die richtige Maschinenreihe: Für allgemeine Zwecke.

    Achten Sie darauf, den richtigen Wert für den Zusicherungstyp auszuwählen, der der von Ihnen verwendeten Schnittstelle entspricht.
  • Verwenden Sie für N1-Maschinentypen general-purpose.
  • Verwenden Sie für C4-Maschinentypen general-purpose-c4.
  • Verwenden Sie für C4A-Maschinentypen general-purpose-c4a.
  • Verwenden Sie für C4D-Maschinentypen general-purpose-c4d.
  • Verwenden Sie für C4N-Maschinentypen network-optimized-c4n.
  • Verwenden Sie für N2-Maschinentypen general-purpose-n2.
  • Verwenden Sie für N2D-Maschinentypen general-purpose-n2d.
  • Verwenden Sie für M1-Maschinentypen memory-optimized.
  • Verwenden Sie für M3-Maschinentypen memory-optimized-m3.
  • Verwenden Sie für Z3-Maschinentypen storage-optimized-z3.
  • Verwenden Sie für Z4D-Maschinentypen storage-optimized-z4d.
  • Verwenden Sie für Z4M-Maschinentypen storage-optimized-z4m.

• COMMITTED_VCPUS: Die Anzahl der vCPUs, die Sie in Ihrer Zusicherung benötigen. Diese Zahl muss eine positive ganze Zahl sein.

• COMMITTED_MEMORY: die Arbeitsspeichermenge in MB oder GB, die Sie in Ihrer Zusicherung verwenden möchten. Beispiel: 10GB oder 10240MB. In der gcloud CLI können Sie den Arbeitsspeicher in MB oder GB angeben. Wenn Sie keine Einheit angeben, verwendet Compute Engine GB als Standardeinheit. Beachten Sie jedoch, dass Compute Engine bei Verwendung von REST MB als Standardeinheit verwendet.

• COMMITTED_LOCAL_SSD: die Menge an lokalem SSD-Speicher, die in GB angegeben werden muss, z. B. 375GB.

• COMMITTED_ACCELERATOR_COUNT: die Anzahl der GPUs, die Sie in Ihrer Zusicherung verwenden möchten.

• COMMITTED_ACCELERATOR_TYPE: der GPU-Typ, den Sie in Ihrer Zusicherung verwenden möchten.

• YAML_FILE: der Pfad zur YAML-Datei, die die Konfiguration der angehängten Reservierungen enthält.

Angehängte Reservierungen

• RESERVATION_NAME: der Name der angehängten Reservierung.
• RESERVATION_ZONE: die Zone der angehängten Reservierung.
• REQUIRE_SPECIFIC_RESERVATION_VALUE: gibt an, ob die angehängte Reservierung eine gezielte Reservierung ist; entweder true oder false. Weitere Informationen zu gezielten Reservierungen finden Sie unter Funktionsweise von Reservierungen.
• NUMBER_OF_RESERVED_VMS: die Anzahl der VMs, die Sie in der angehängten Reservierung reservieren möchten.

• RESERVED_MACHINE_TYPE: der Maschinentyp, den Sie für die VMs in Ihrer angehängten Reservierung verwenden möchten.

  • Verwenden Sie für vordefinierte Maschinentypen das Format MACHINE_FAMILY-standard-CPUS, z. B. n2-standard-4.

  • Verwenden Sie für benutzerdefinierte Maschinentypen das Format MACHINE_FAMILY-custom-CPUS-MEMORY, z. B. n2-custom-4-5120. Eine vollständige Liste der Einschränkungen finden Sie in den Spezifikationen für benutzerdefinierte Maschinentypen.

    Ersetzen Sie Folgendes:

    • MACHINE_FAMILY: die Maschinentypfamilie. Geben Sie beispielsweise für N2-VMs n2 an.
    • CPUS: die Anzahl der vCPUs.
    • MEMORY: der gesamte Arbeitsspeicher für eine reservierte VM. Der Arbeitsspeicher muss ein Vielfaches von 256 MB sein und in MB angegeben werden. Verwenden Sie zum Beispiel n2-custom-4-5120, um eine N2-VM mit 4 vCPUs und 5 GB Arbeitsspeicher zu erstellen, die 5.120 MB entspricht.

• RESERVED_ACCELERATOR_COUNT: die Anzahl der GPUs, die Sie pro VM in der angehängten Reservierung hinzufügen möchten.

• RESERVED_ACCELERATOR_TYPE: der Beschleunigertyp, den Sie in der angehängten Reservierung hinzufügen möchten.

• INTERFACE_1 und INTERFACE_2: der Schnittstellentyp, den die lokalen SSD-Laufwerke für jede reservierte VM verwenden sollen. Gültige Optionen sind: scsi und nvme. Wiederholen Sie den Parameter local_ssd für jedes lokale SSD-Laufwerk, das Sie hinzufügen möchten. Sie können bis zu 24 lokale SSDs angeben.

• OWNER_PROJECT_ID: die ID des Projekts, in dem Sie die Zusicherung mit der angehängten Reservierung kaufen möchten. Geben Sie dieses Feld an, wenn Sie die angehängte Reservierung auf mehrere Nutzerprojekte aufteilen möchten.

• MINIMUM_CPU_PLATFORM: die Mindest-CPU-Plattform, die Sie für die angehängte Reservierung angeben möchten.

• SHARE_SETTING: die Art der Freigabe für die angehängte Reservierung. Geben Sie dieses Feld mit dem Wert projects an, wenn Sie Ihre angehängte Reservierung auf mehrere Nutzerprojekte aufteilen möchten. Schließen Sie dieses Feld aus, wenn Sie eine Reservierung für ein einzelnes Projekt erstellen möchten.

• CONSUMER_PROJECT_ID_1 und CONSUMER_PROJECT_ID_2: die Projekt-IDs der Projekte, die diese Reservierung gemeinsam nutzen können, z. B. project-1 und project-2. Sie können bis zu 100 Nutzerprojekte hinzufügen. Diese Projekte müssen sich in derselben Organisation wie das Inhaberprojekt befinden. Fügen Sie nicht die ID des Projekts ein, wenn Sie diese Reservierung erstellen, da dieses Projekt diese Reservierung standardmäßig nutzen darf. Schließen Sie diese Felder aus, wenn Sie eine Reservierung für ein einzelnes Projekt erstellen möchten.

Compute Engine erstellt die Zusicherung mit den verbundenen Reservierungen nur, wenn genügend Ressourcen des angegebenen Maschinentyps in der Zielzone und ausreichend Kontingente zum Zeitpunkt der Anfrage vorhanden sind. Wenn der Kauf erfolgreich war, wird eine Erfolgsmeldung wie die folgende angezeigt:

Created[https://www.googleapis.com/compute/v1/projects/your-project/regions/your-region/commitments/your-commitment-name]

Beispiele

In den folgenden Beispielszenarien und ‑befehlen wird gezeigt, wie Sie eine Zusicherung für GPUs, lokale SSD-Laufwerke oder beides erwerben, indem Sie neue Reservierungen erstellen, die an diese Zusicherung angehängt werden.

Beispiel 1: Zusicherung für GPUs durch Anhängen einer einzelnen neuen Reservierung erwerben

Angenommen, Sie möchten eine einjährige Zusicherung für Ressourcen für allgemeine Zwecke (oder GPU-Ressourcen) in der Region us-central1 mit 96 vCPUs, 624 GB Arbeitsspeicher und 4 NVIDIA V100-GPUs erwerben. Sie möchten eine neue Reservierung reservation-01 in der Zone us-central1-a erstellen, die zwei n1-standard-32-VMs (jede VM mit 32 vCPUs, 120 GB Arbeitsspeicher und zwei NVIDIA V100-GPUs) reserviert, um diese zugesicherten Ressourcen zu nutzen. Führen Sie den folgenden Befehl aus, um diese Beispielzusicherung mit der angehängten Reservierung zu erwerben. In der gcloud CLI können Sie den Arbeitsspeicher in MB oder GB angeben. Wenn Sie keine Einheit angeben, verwendet Compute Engine GB als Standardeinheit. Beachten Sie jedoch, dass Compute Engine bei Verwendung von REST MB als Standardeinheit verwendet.

gcloud compute commitments create commitment-01 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624GB \
    --resources-accelerator=type=nvidia-tesla-v100,count=4 \
    --plan 12-month \
    --reservation=reservation-01 \
    --reservation-zone=us-central1-a \
    --machine-type=n1-standard-32 \
    --accelerator=type=nvidia-tesla-v100,count=2 \
    --vm-count=2

Beispiel 2: Zusicherung von GPUs erwerben, ohne vCPUs oder Arbeitsspeicher anzugeben

Wenn Sie die Nutzung von GPUs und lokalen SSDs zusichern möchten, nicht aber die von vCPUs und Arbeitsspeicher, geben Sie für die zugesicherte Menge von vCPUs und Arbeitsspeicher 0 an. Angenommen, Sie möchten eine einjährige Zusicherung für GPU-Ressourcen in der Region us-west2 mit 0 vCPUs, 0 GB Arbeitsspeicher und 1 NVIDIA P4-GPU erwerben. Sie möchten auch eine neue Reservierung reservation-01 in der Zone us-west2-b erstellen, die eine n1-standard-2-VM (mit 2 vCPUs, 7,5 GB Arbeitsspeicher und 1 NVIDIA P4-GPU) reserviert, um sie an die Zusicherung anzuhängen. Führen Sie den folgenden Befehl aus, um diese Beispielzusicherung mit der angehängten Reservierung zu erwerben. In der gcloud CLI können Sie den Arbeitsspeicher in MB oder GB angeben. Wenn Sie keine Einheit angeben, verwendet Compute Engine GB als Standardeinheit. Beachten Sie jedoch, dass Compute Engine bei Verwendung von REST MB als Standardeinheit verwendet.

gcloud compute commitments create commitment-02 \
    --region=us-west2 \
    --project=myproject \
    --resources=vcpu=0,memory=0 \
    --resources-accelerator=type=nvidia-tesla-p4,count=1 \
    --plan 12-month \
    --reservation=reservation-01 \
    --reservation-zone=us-west2-b \
    --machine-type=n1-standard-2 \
    --accelerator=type=nvidia-tesla-p4,count=1 \
    --vm-count=1

Beispiel 3: Eine Zusicherung für GPUs und lokale SSD-Laufwerke erwerben, indem Sie mehrere neue Reservierungen anhängen

Angenommen, Sie möchten eine einjährige Zusicherung für Ressourcen für allgemeine Zwecke (oder GPU- und lokale SSD-Ressourcen) in der Region us-central1 erwerben. Sie möchten die Zusicherung für 96 vCPUs, 624 GB Arbeitsspeicher, 1 NVIDIA V100-GPU und 750 GB lokalen SSD-Speicher (entspricht 2 lokalen SSD-Laufwerken). Außerdem möchten Sie zwei Reservierungen in der Zone us-central1-a erstellen und anhängen. In der ersten Reservierung res-01 möchten Sie eine n1-standard-2-VM mit 2 vCPUs, 7,5 GB Arbeitsspeicher und 1 NVIDIA V100-GPU reservieren.Dies ist eine ausgewählte Reservierung. Mit der zweiten Reservierung res-02 möchten Sie eine n1-standard-8-VM (mit 8 vCPUs, 30 GB Arbeitsspeicher) reservieren und zwei lokale SSDs (eine SCSI-Schnittstelle, eine NVMe-Schnittstelle) anhängen.

Wenn Sie diese Beispielzusicherung mit den angehängten Reservierungen erwerben möchten, erstellen Sie zuerst die YAML-Datei mit den Attributen beider Reservierungen:

- reservation: res-01
  reservation_zone: us-central1-a
  require_specific_reservation: true
  vm_count: 1
  machine_type: n1-standard-2
  accelerator:
  - count: 1
    type: nvidia-tesla-v100
- reservation: res-02
  reservation_zone: us-central1-a
  vm_count: 1
  machine_type: n1-standard-8
  local_ssd:
  - interface: scsi
    size: 375
  - interface: nvme
    size: 375

Nachdem Sie die YAML-Datei erstellt haben, führen Sie den folgenden Befehl aus, um den Kauf der Zusicherung mit den angehängten Reservierungen abzuschließen. Der Wert für den lokalen SSD-Speicher muss in GB angegeben werden (z. B. 375GB). In der gcloud CLI können Sie den Speicher in MB oder GB angeben. Wenn Sie keine Einheit angeben, verwendet Compute Engine GB als Standardeinheit. Beachten Sie jedoch, dass Compute Engine bei Verwendung von REST MB als Standardeinheit für den Arbeitsspeicher verwendet.

gcloud compute commitments create commitment-03 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624,local-ssd=750 \
    --resources-accelerator=type=nvidia-tesla-v100,count=1 \
    --plan 12-month \
    --reservations-from-file=YAML_FILE

REST

Wenn Sie die angehängten Reservierungen beim Kauf der Zusicherung erstellen möchten, senden Sie eine POST-Anfrage an die Methode regionCommitments.insert. Fügen Sie in Ihrer Anfrage das Feld reservations ein, um eine Liste aller neuen Reservierungen zu definieren, die Sie erstellen und anhängen möchten. Sie können beliebig viele vorhandene Reservierungen an Ihre Zusicherung anhängen.

• Wenn Sie die neue Reservierung erstellen möchten, indem Sie alle VM-Attribute manuell angeben, fügen Sie das Feld instanceProperties hinzu und schließen Sie das Feld sourceInstanceTemplate aus.

  Wenn Sie beispielsweise die Konfiguration einer freigegebenen Reservierung, die für zwei Projekte freigegeben ist und die GPUs, zwei lokale SSD-Laufwerke und eine Mindest-CPU-Plattform angibt, manuell festlegen möchten, stellen Sie die folgende Anfrage:

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
  
  {
  "name": "COMMITMENT_NAME",
  "plan": "PLAN",
  "type": "COMMITMENT_TYPE",
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    },
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "reservations":
  [
    {
      "name": "RESERVATION_NAME",
      "specificReservation":
      {
        "count": "NUMBER_OF_RESERVED_VMS",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "RESERVED_ACCELERATOR_COUNT",
              "acceleratorType": "RESERVED_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "INTERFACE_2"
            }
          ],
          "machineType": "RESERVED_MACHINE_TYPE",
          "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
        }
      },
      "specificReservationRequired": "REQUIRE_SPECIFIC_RESERVATION_VALUE",
      "zone": "RESERVATION_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "CONSUMER_PROJECT_ID_1":
          {
            "projectId": "CONSUMER_PROJECT_ID_1"
          },
          "CONSUMER_PROJECT_ID_2":
          {
            "projectId": "CONSUMER_PROJECT_ID_2"
          }
        }
      }
    }
  ]
  }
  
  

• Wenn Sie die neue Reservierung durch Angabe einer Instanzvorlage erstellen möchten, fügen Sie das Feld sourceInstanceTemplate hinzu und schließen Sie das Feld instanceProperties aus.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
  
  {
  "name": "COMMITMENT_NAME",
  "plan": "PLAN",
  "type": "COMMITMENT_TYPE",
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    },
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "reservations":
  [
    {
      "name": "RESERVATION_NAME",
      "specificReservation":
      {
        "count": "NUMBER_OF_RESERVED_VMS",
        "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME"
      },
      "specificReservationRequired": "REQUIRE_SPECIFIC_RESERVATION_VALUE",
      "zone": "RESERVATION_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "CONSUMER_PROJECT_ID_1":
          {
            "projectId": "CONSUMER_PROJECT_ID_1"
          },
          "CONSUMER_PROJECT_ID_2":
          {
            "projectId": "CONSUMER_PROJECT_ID_2"
          }
        }
      }
    }
  ]
  }
  
  

Ersetzen Sie Folgendes durch die entsprechenden Attribute der Zusicherung und der angehängten Reservierungen:

Verpflichtung

• COMMITMENT_NAME: der Name der Zusicherung.
• REGION: die Region, in der sich die Zusicherung befindet
• PROJECT_ID: die ID des Projekts, in dem Sie die Zusicherung mit den angehängten Reservierungen kaufen möchten.
• PLAN: der Plan für zugesicherte Nutzung, der Ihren Rabatt für zugesicherte Nutzung und die voreingestellte Laufzeit bestimmt. Geben Sie TWELVE_MONTH oder THIRTY_SIX_MONTH an.

• COMMITMENT_TYPE: der Zusicherungstyp. Die folgenden Zusicherungstypen bieten Optionen für GPUs, lokale SSD-Laufwerke oder beides:

  • Verwenden Sie für A2-Maschinentypen ACCELERATOR_OPTIMIZED.
  • Verwenden Sie für die Maschinentypen A3 Edge und A3 High ACCELERATOR_OPTIMIZED_A3.
  • Verwenden Sie für A3 Mega-Maschinentypen ACCELERATOR_OPTIMIZED_A3_MEGA.
    Hinweis: Für die Maschinentypen A4X Max, A4X, A4 oder A3 Ultra müssen Sie Ihre Zusicherungen über die Verbrauchsoption Vorausschauende Reservierungen in AI Hypercomputer erwerben. Weitere Informationen finden Sie unter Kapazität über Ihr Account-Management-Team reservieren.
  • Verwenden Sie für G2-Maschinentypen GRAPHICS_OPTIMIZED.
  • Verwenden Sie für G4-Maschinentypen GRAPHICS_OPTIMIZED_G4.
  • Verwenden Sie für C2-Maschinentypen COMPUTE_OPTIMIZED.
  • Verwenden Sie für C2D-Maschinentypen COMPUTE_OPTIMIZED_C2D.
  • Verwenden Sie für C3-Maschinentypen COMPUTE_OPTIMIZED_C3.
  • Verwenden Sie für C3D-Maschinentypen COMPUTE_OPTIMIZED_C3D.
    Achtung: Bei C3- und C3D-Zusicherungstypen ändert sich die durch den Zusicherungstyp angegebene Maschinenfamilie je nach Schnittstelle:

    • In der gcloud CLI und REST wird für die Werte des Zusicherungstyps Computing-optimiert als Maschinenfamilie verwendet, obwohl C3 und C3D zur Maschinenfamilie für allgemeine Zwecke gehören.
    • In der Google Cloud Console verwenden die Werte für den Zusicherungstyp die richtige Maschinenreihe: Für allgemeine Zwecke.

    Achten Sie darauf, den richtigen Wert für den Zusicherungstyp auszuwählen, der der von Ihnen verwendeten Schnittstelle entspricht.
  • Verwenden Sie für N1-Maschinentypen GENERAL_PURPOSE.
  • Verwenden Sie für C4-Maschinentypen GENERAL_PURPOSE_C4.
  • Verwenden Sie für C4A-Maschinentypen GENERAL_PURPOSE_C4A.
  • Verwenden Sie für C4D-Maschinentypen GENERAL_PURPOSE_C4D.
  • Verwenden Sie für C4N-Maschinentypen NETWORK_OPTIMIZED_C4N.
  • Verwenden Sie für N2-Maschinentypen GENERAL_PURPOSE_N2.
  • Verwenden Sie für N2D-Maschinentypen GENERAL_PURPOSE_N2D.
  • Verwenden Sie für M1-Maschinentypen MEMORY_OPTIMIZED.
  • Verwenden Sie für M3-Maschinentypen MEMORY_OPTIMIZED_M3.
  • Verwenden Sie für Z3-Maschinentypen STORAGE_OPTIMIZED_Z3.
  • Verwenden Sie für Z4D-Maschinentypen STORAGE_OPTIMIZED_Z4D.
  • Verwenden Sie für Z4M-Maschinentypen STORAGE_OPTIMIZED_Z4M.

• COMMITTED_VCPUS: Die Anzahl der vCPUs, die Sie in Ihrer Zusicherung benötigen. Diese Zahl muss eine positive ganze Zahl sein.

• COMMITTED_MEMORY: die Arbeitsspeichermenge, die Sie in Ihrer Zusicherung verwenden möchten. Bei REST verwendet Compute Engine MB als Standardeinheit. Wenn Sie die gcloud CLI verwenden, verwendet Compute Engine jedoch GB als Standardeinheit.

• COMMITTED_LOCAL_SSD: die Größe des lokalen SSD-Speichers in GB, die Sie in Ihrer Zusicherung verwenden möchten.

• COMMITTED_ACCELERATOR_COUNT: die Anzahl der GPUs, die Sie in Ihrer Zusicherung verwenden möchten.

• COMMITTED_ACCELERATOR_TYPE: der GPU-Typ, den Sie in Ihrer Zusicherung verwenden möchten.

• CUSTOM_END_DATE: Optional. Ein benutzerdefiniertes Enddatum für Ihre Laufzeit, das als YYYY-MM-DD formatiert sein muss. Wenn Sie beispielsweise den 20. April 2024 als benutzerdefiniertes Enddatum angeben möchten, formatieren Sie es als 2024-04-20.

• END_TIME: 00:00 Uhr US and Canadian Pacific Time (UTC-8 oder UTC-7), als Versatz der koordinierten Weltzeit (Coordinated Universal Time, UTC). Geben Sie diesen Wert nur an, wenn Sie ein benutzerdefiniertes Enddatum für Ihre Zusicherung angegeben haben. Geben Sie einen der folgenden Werte an:

  • Während der Sommerzeit: 07:00:00
  • Zu anderen Zeiten: 08:00:00

Angehängte Reservierungen

• RESERVATION_NAME: der Name der angehängten Reservierung.
• RESERVATION_ZONE: die Zone der angehängten Reservierung.
• REQUIRE_SPECIFIC_RESERVATION_VALUE: gibt an, ob die angehängte Reservierung eine gezielte Reservierung ist; entweder true oder false. Weitere Informationen zu gezielten Reservierungen finden Sie unter Funktionsweise von Reservierungen.
• NUMBER_OF_RESERVED_VMS: die Anzahl der VMs, die Sie in der angehängten Reservierung reservieren möchten.

• RESERVED_MACHINE_TYPE: der Maschinentyp, den Sie für die VMs in Ihrer angehängten Reservierung verwenden möchten.

  • Verwenden Sie für vordefinierte Maschinentypen das Format MACHINE_FAMILY-standard-CPUS, z. B. n2-standard-4.

  • Verwenden Sie für benutzerdefinierte Maschinentypen das Format MACHINE_FAMILY-custom-CPUS-MEMORY, z. B. n2-custom-4-5120. Eine vollständige Liste der Einschränkungen finden Sie in den Spezifikationen für benutzerdefinierte Maschinentypen.

    Ersetzen Sie Folgendes:

    • MACHINE_FAMILY: die Maschinentypfamilie. Geben Sie beispielsweise für N2-VMs n2 an.
    • CPUS: die Anzahl der vCPUs.
    • MEMORY: der gesamte Arbeitsspeicher für eine reservierte VM. Der Arbeitsspeicher muss ein Vielfaches von 256 MB sein und in MB angegeben werden. Verwenden Sie n2-custom-4-5120, um eine N2-VM mit 4 vCPUs und 5 GB Arbeitsspeicher zu erstellen, die 5.120 MB entspricht.

• RESERVED_ACCELERATOR_COUNT: die Anzahl der GPUs, die Sie pro VM in der angehängten Reservierung hinzufügen möchten.

• RESERVED_ACCELERATOR_TYPE: der Beschleunigertyp, den Sie in der angehängten Reservierung hinzufügen möchten.

• INTERFACE_1 und INTERFACE_2: der Schnittstellentyp, den die lokalen SSD-Laufwerke für jede reservierte VM verwenden sollen. Gültige Optionen sind: scsi und nvme. Wiederholen Sie den Parameter localSsds für jedes lokale SSD-Laufwerk, das Sie hinzufügen möchten. Sie können bis zu 24 lokale SSDs angeben.

• MINIMUM_CPU_PLATFORM: die Mindest-CPU-Plattform, die Sie für die angehängte Reservierung angeben möchten.

• INSTANCE_TEMPLATE_NAME: der Name der Instanzvorlage, mit der Sie die angehängte Reservierung erstellen möchten.

• SHARE_SETTING: die Art der Freigabe für die angehängte Reservierung. Geben Sie dieses Feld mit dem Wert SPECIFIC_PROJECTS an, wenn Sie Ihre angehängte Reservierung auf mehrere Nutzerprojekte aufteilen möchten. Schließen Sie dieses Feld aus, wenn Sie eine Reservierung für ein einzelnes Projekt erstellen möchten.

• CONSUMER_PROJECT_ID_1 und CONSUMER_PROJECT_ID_2: die Projekt-IDs der Projekte, die diese Reservierung gemeinsam nutzen können, z. B. project-1 und project-2. Sie können bis zu 100 Nutzerprojekte hinzufügen. Diese Projekte müssen sich in derselben Organisation wie das Inhaberprojekt befinden. Fügen Sie nicht die ID des Projekts ein, wenn Sie diese Reservierung erstellen, da dieses Projekt diese Reservierung standardmäßig nutzen darf. Schließen Sie diese Felder aus, wenn Sie eine Reservierung für ein einzelnes Projekt erstellen möchten.

Compute Engine erstellt die Zusicherung mit den verbundenen Reservierungen nur, wenn genügend Ressourcen des angegebenen Maschinentyps in der Zielzone und ausreichend Kontingente zum Zeitpunkt der Anfrage vorhanden sind. Wenn der Kauf erfolgreich war, gibt die Compute Engine den Status 200 für Ihre REST API-Anfrage zurück.

Beispiele

In den folgenden Beispielszenarien und ‑befehlen wird gezeigt, wie Sie eine Zusicherung für GPUs, lokale SSD-Laufwerke oder beides erwerben, indem Sie neue Reservierungen erstellen, die an diese Zusicherung angehängt werden.

Beispiel 1: Zusicherung für GPUs durch Anhängen einer einzelnen neuen Reservierung erwerben

Angenommen, Sie möchten eine einjährige Zusicherung für Ressourcen für allgemeine Zwecke in der Region us-central1 erwerben, die 96 vCPUs, 624 GB Arbeitsspeicher (entspricht 638.976 MB) und 4 NVIDIA V100-GPUs umfasst. Sie möchten eine neue Reservierung reservation-01 in der Zone us-central1-a erstellen, die zwei n1-standard-8-VMs (jede VM mit 8 vCPUs, 30 GB Arbeitsspeicher und zwei NVIDIA V100-GPUs) reserviert, um sie an diese Zusicherung anzuhängen. Wenn Sie diese Beispielzusicherung mit der angehängten Reservierung erwerben möchten, stellen Sie die folgende POST-Anfrage: Für REST müssen Sie den Speicher in MB angeben. Beachten Sie jedoch, dass Compute Engine bei Verwendung der gcloud CLI GB als Standardeinheit verwendet.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-01",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "4",
      "type": "ACCELERATOR"
    }
  ],
  "reservations":
  [
    {
      "name": "reservation-01",
      "specificReservation":
      {
        "count": "2",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 2,
              "acceleratorType": "nvidia-tesla-v100"
            }
          ],
          "machineType": "n1-standard-8"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-central1-a"
    }
  ]
}

Beispiel 2: Zusicherung von GPUs erwerben, ohne vCPUs oder Arbeitsspeicher anzugeben

Wenn Sie die Nutzung von GPUs und lokalen SSDs zusichern möchten, nicht aber die von vCPUs und Arbeitsspeicher, geben Sie für die zugesicherte Menge von vCPUs und Arbeitsspeicher 0 an. Angenommen, Sie möchten eine Zusicherung mit einjähriger Laufzeit nur für GPU-Ressourcen in der Region us-west2 erwerben, mit 0 vCPUs, 0 MB Arbeitsspeicher und 4 NVIDIA P4-GPUs. Sie möchten auch eine neue Reservierung reservation-01 in der Zone us-west2-b erstellen, die eine n1-standard-2-VM (mit 2 vCPUs, 7,5 GB Arbeitsspeicher und 4 NVIDIA P4-GPUs) reserviert, um sie an die Zusicherung anzuhängen. Wenn Sie diese Beispielzusicherung mit der angehängten Reservierung erwerben möchten, stellen Sie die folgende POST-Anfrage: Für REST müssen Sie den Speicher in MB angeben. Beachten Sie jedoch, dass Compute Engine bei Verwendung der gcloud CLI GB als Standardeinheit verwendet.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-west2/commitments

{
  "name": "commitment-02",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "0",
      "type": "VCPU"
    },
    {
      "amount": "0",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-p4",
      "amount": "4",
      "type": "ACCELERATOR"
    }
  ],
  "reservations":
  [
    {
      "name": "reservation-01",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 4,
              "acceleratorType": "nvidia-tesla-p4"
            }
          ],
          "machineType": "n1-standard-2"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-west2-b"
    }
  ]
}

Beispiel 3: Eine Zusicherung für GPUs und lokale SSD-Laufwerke erwerben, indem Sie mehrere neue Reservierungen anhängen

Angenommen, Sie möchten eine einjährige Zusicherung für Ressourcen für allgemeine Zwecke in der Region us-central1 erwerben, mit 96 vCPUs, 624 GB Arbeitsspeicher (entspricht 638.976 MB), 1 NVIDIA V100-GPU und 750 GB lokalem SSD-Speicher. Außerdem möchten Sie zwei Reservierungen in der Zone us-central1-a erstellen und anhängen. In der ersten Reservierung res-01 möchten Sie eine n1-standard-2-VM mit 2 vCPUs, 7,5 GB Arbeitsspeicher und 1 NVIDIA V100-GPU reservieren.Dies ist eine ausgewählte Reservierung. Mit der zweiten Reservierung res-02 möchten Sie eine n1-standard-8-VM (mit 8 vCPUs, 30 GB Arbeitsspeicher) reservieren und zwei lokale SSDs (eine SCSI-Schnittstelle, eine NVMe-Schnittstelle) anhängen. Wenn Sie diese Beispielzusicherung mit den angehängten Reservierungen erwerben möchten, stellen Sie die folgende POST-Anfrage. Der Wert für den lokalen SSD-Speicher muss in GB angegeben werden. Für den Arbeitsspeicher müssen Sie den Wert in MB angeben. Beachten Sie jedoch, dass Compute Engine bei Verwendung der gcloud CLI GB als Standardeinheit für den Arbeitsspeicher verwendet.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-03",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "1",
      "type": "ACCELERATOR"
    },
    {
      "amount": "750",
      "type": "LOCAL_SSD"
    }
  ],
  "reservations":
  [
    {
      "name": "res-01",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 1,
              "acceleratorType": "nvidia-tesla-v100"
            }
          ],
          "machineType": "n1-standard-2"
        }
      },
      "specificReservationRequired": true,
      "zone": "us-central1-a"
    },
    {
      "name": "res-02",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "SCSI"
            },
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            }
          ],
          "machineType": "n1-standard-8"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-central1-a"
    }
  ]
}

Reservierungen ändern, die mit Zusicherungen verbunden sind

Bei Zusicherungen, für die angehängte Reservierungen erforderlich sind, können Sie die angehängten Reservierungen nicht direkt löschen, ihre Größe anpassen oder sie ändern. Sie können jedoch die Maschinentypen und die Anzahl der VMs ändern, die in der angehängten Reservierung angegeben sind. Sie können diese Änderungen vornehmen, indem Sie die vorhandene verbundene Reservierung der Zusicherung durch eine neue verbundene Reservierung ersetzen.

Bei Zusicherungen, bei denen angehängte Reservierungen optional sind, können Sie die angehängten Reservierungen direkt löschen oder ihre Größe ändern. Weitere Informationen zu den Verhaltensunterschieden finden Sie unter Reservierungsverhalten nach dem Kauf einer Zusicherung.

Die Ersatzreservierung ist immer eine neu erstellte Reservierung. Wenn Sie eine angehängte Reservierung ersetzen möchten, müssen Sie die Attribute der Reservierung angeben, die Sie als Ersatz verwenden möchten. Compute Engine erstellt dann automatisch eine neue Reservierung mit diesen Attributen und ersetzt damit Ihre angehängte Reservierung. Sie können eine vorhandene Reservierung nicht verwenden, um Ihre angehängte Reservierung zu ersetzen.

Zulässige Änderungen

Wenn Sie die vorhandene verbundene Reservierung einer Zusicherung durch eine neue Reservierung ersetzen, können Sie eine der folgenden Änderungen anfordern:

• Sie können VMs von einem anderen Maschinentyp reservieren. Sie müssen jedoch weiterhin VMs aus derselben Maschinenreihe reservieren, um weiterhin CUDs für Ihre reservierten Ressourcen zu erhalten.
• Sie können die Anzahl der VMs, die Sie reservieren möchten, ändern.
• Sie können die Anzahl der GPUs und lokalen SSD-Laufwerke, die pro VM angehängt werden, ändern, solange die Gesamtzahl der reservierten GPUs und lokalen SSD-Laufwerke gleich bleibt.
• Sie können die ersetzten Reservierungen als Reservierungen für ein einzelnes Projekt (in der Google Cloud Console auch als lokal bezeichnet) oder als freigegebene Reservierungen festlegen.

Voraussetzungen

Wenn Sie die angehängte Reservierung Ihrer Zusicherung durch eine neue ersetzen, muss Ihre Anfrage alle folgenden Anforderungen erfüllen:

• Sie können jeweils nur eine angehängte Reservierung durch genau eine neue angehängte Reservierung ersetzen. Wenn Sie eine verbundene Reservierung ersetzen möchten, entfernen Sie gleichzeitig eine vorhandene verbundene Reservierung. Setzen Sie dazu die VM-Anzahl auf 0 und definieren Sie eine neue angehängte Reservierung, die Sie ersetzen möchten.
• Die neue Reservierung muss sich im selben Projekt wie die Zusicherung befinden.
• Die neue Reservierung muss sich in derselben Zone wie die entfernte Reservierung befinden.
• Die Anzahl und die Typen der GPUs in der neuen Reservierung müssen mit der entfernten Reservierung übereinstimmen.
• Die Anzahl und die Typen der lokalen SSD-Laufwerke in der neuen Reservierung müssen mit der entfernten Reservierung übereinstimmen.
• Sie können nur bis zu 100 VMs pro Anfrage ändern. Wenn Sie eine Änderung vornehmen möchten, die mehr als 100 VMs umfasst, teilen Sie die Änderung in mehrere kleinere Anfragen auf oder wenden Sie sich an den Support von Google Cloud .

Ihre Anfrage zum Ersetzen einer Reservierung hängt auch von der zu diesem Zeitpunkt verfügbaren Kapazität ab. Wenn die Kapazität für eine Anfrage nicht verfügbar ist, schlägt die Anfrage fehl und gibt einen Ressourcenverfügbarkeitsfehler zurück, den Sie durch Ändern oder Verschieben der Anfrage beheben können. Weitere Informationen finden Sie in der Dokumentation zur Fehlerbehebung: Ressourcenverfügbarkeit.

Wenn Ihre Anfrage zum Ersetzen einer verbundenen Reservierung fehlschlägt, bleiben die angehängte Reservierung und die vorhandenen reservierten Ressourcen unverändert. Um Ihre Kapazität beizubehalten, warten Sie, bis die entsprechenden Änderungen an den VMs vorgenommen wurden, bis die Anfrage zum Ersetzen einer Reservierung erfolgreich ist.

Schritte zum Ersetzen einer angehängten Reservierung

Sie können die Reservierungen einer Zusicherung über die Google Cloud CLI oder REST ersetzen.

gcloud

So ersetzen Sie Reservierungen, die an Zusicherungen angehängt sind:

1. Erstellen Sie im aktuellen Verzeichnis eine YAML-Datei mit den Konfigurationen der folgenden angehängten Reservierungen:

   • Die aktuelle Reservierung, die Sie ersetzen möchten.

     Informationen zum Abrufen der Reservierung finden Sie unter Details einer Reservierung ansehen.

   • Die neue Ersatzreservierung.

   Der Inhalt der YAML-Datei sieht in etwa so aus:

   - reservation: CURRENT_RESERVATION_NAME
     reservation_zone: CURRENT_RESERVATION_ZONE
     vm_count: 0
     machine_type: CURRENT_RESERVATION_MACHINE_TYPE
     accelerator:
     - count: CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS
       type: CURRENT_RESERVATION_ACCELERATOR_TYPE
     local_ssd:
     - interface: CURRENT_RESERVATION_INTERFACE_1
       size: 375
     - interface: CURRENT_RESERVATION_INTERFACE_2
       size: 375
     project: CURRENT_RESERVATION_PROJECT_ID
     share_setting: CURRENT_RESERVATION_SHARE_SETTING
     share_with:
     - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1
     - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2
   - reservation: REPLACEMENT_RESERVATION_NAME
     reservation_zone: REPLACEMENT_RESERVATION_ZONE
     vm_count: REPLACEMENT_RESERVATION_NUMBER_OF_VMS
     machine_type: REPLACEMENT_RESERVATION_MACHINE_TYPE
     accelerator:
     - count: REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS
       type: REPLACEMENT_RESERVATION_ACCELERATOR_TYPE
     local_ssd:
     - interface: REPLACEMENT_RESERVATION_INTERFACE_1
       size: 375
     - interface: REPLACEMENT_RESERVATION_INTERFACE_2
       size: 375
     project: REPLACEMENT_RESERVATION_PROJECT_ID
     share_setting: REPLACEMENT_RESERVATION_SHARE_SETTING
     share_with:
     - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1
     - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2
   
   

   Ersetzen Sie Folgendes durch die entsprechenden Attribute der aktuellen und der Ersatzreservierung:

   Momentane Reservierung

   Für die aktuelle Reservierung müssen alle folgenden Eigenschaften genau mit den Angaben übereinstimmen, die Sie bei der Anzeige der Reservierung gesehen haben. Lassen Sie die Felder für alle Attribute weg, die die aktuelle Reservierung noch nicht hat.

   • CURRENT_RESERVATION_NAME: der Name der aktuellen verbundenen Reservierung
   • CURRENT_RESERVATION_ZONE: die Zone der aktuell angehängten Reservierung
   • CURRENT_RESERVATION_MACHINE_TYPE: der Maschinentyp der aktuell angehängten Reservierung
   • CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS: die Anzahl der GPUs, die in der aktuell verbundenen Reservierung reserviert sind
   • CURRENT_RESERVATION_ACCELERATOR_TYPE: der Typ des Beschleunigers, der in der aktuell angehängten Reservierung reserviert ist
   • CURRENT_RESERVATION_INTERFACE_1 und CURRENT_RESERVATION_INTERFACE_2: der Schnittstellentyp, den die lokalen SSDs für jede reservierte VM in der aktuell angehängten Reservierung verwenden Gültige Optionen sind: scsi und nvme. Jede lokale SSD ist 375 GB groß. Wiederholen Sie den Parameter local_ssd für alle reservierten lokalen SSD-Laufwerke.
   • CURRENT_RESERVATION_PROJECT_ID: die Projekt-ID des aktuellen Projekts, das die Zusicherung und die angehängte Reservierung enthält Geben Sie dieses Feld an, wenn Ihre aktuell angehängte Reservierung von mehreren Nutzerprojekten gemeinsam genutzt wird.
   • CURRENT_RESERVATION_SHARE_SETTING: die Art der Freigabe für die aktuelle Reservierung Geben Sie dieses Feld mit dem Wert projects an, wenn Ihre aktuell angehängte Reservierung von mehreren Nutzerprojekten gemeinsam genutzt wird.
   • CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1 und CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2: die Projekt-IDs der Projekte, für die Sie die aktuell angehängte Reservierung freigeben, z. B. project-1 und project-2

   Ersatzreservierung

   Legen Sie für die Ersatzreservierung die folgenden Attribute fest. Achten Sie darauf, dass Sie alle Anforderungen erfüllen, wenn Sie diese Attribute angeben. Lassen Sie alle zusätzlichen Felder weg, die Sie nicht verwenden möchten.

   • REPLACEMENT_RESERVATION_NAME: der Name der neuen Ersatzreservierung
   • REPLACEMENT_RESERVATION_ZONE: die Zone der neuen Ersatzreservierung
   • REPLACEMENT_RESERVATION_NUMBER_OF_VMS: die Anzahl der VMs, die Sie in der neuen Ersatzreservierung reservieren möchten

   • REPLACEMENT_RESERVATION_MACHINE_TYPE: der Maschinentyp, den Sie für die VMs in Ihrer neuen Ersatzreservierung verwenden möchten

     • Verwenden Sie für vordefinierte Maschinentypen das Format MACHINE_FAMILY-standard-CPUS, z. B. n2-standard-4.
     • Verwenden Sie für benutzerdefinierte Maschinentypen das Format MACHINE_FAMILY-custom-CPUS-MEMORY, z. B. n2-custom-4-5120. Eine vollständige Liste der Einschränkungen finden Sie in den Spezifikationen für benutzerdefinierte Maschinentypen.

     Ersetzen Sie Folgendes:

     • MACHINE_FAMILY: die Maschinentypfamilie. Geben Sie beispielsweise für N2-VMs n2 an.
     • CPUS: die Anzahl der vCPUs.
     • MEMORY: der gesamte Arbeitsspeicher für eine reservierte VM. Der Arbeitsspeicher muss ein Vielfaches von 256 MB sein und in MB angegeben werden. Verwenden Sie zum Beispiel n2-custom-4-5120, um eine N2-VM mit 4 vCPUs und 5 GB Arbeitsspeicher zu erstellen, die 5.120 MB entspricht.

   • REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS: die Anzahl der GPUs, die Sie pro VM in der Ersatzreservierung hinzufügen möchten

   • REPLACEMENT_RESERVATION_ACCELERATOR_TYPE: der Beschleunigertyp, den Sie der Ersatzreservierung hinzufügen möchten

   • REPLACEMENT_RESERVATION_INTERFACE_1 und REPLACEMENT_RESERVATION_INTERFACE_2: der Schnittstellentyp, den die lokalen SSD-Laufwerke für jede reservierte VM verwenden sollen. Gültige Optionen sind: scsi und nvme. Jede lokale SSD ist 375 GB groß. Wiederholen Sie den Parameter local_ssd für jedes lokale SSD-Laufwerk, das Sie hinzufügen möchten. Sie können bis zu 24 lokale SSDs angeben.

   • REPLACEMENT_RESERVATION_PROJECT_ID: die Projekt-ID des aktuellen Projekts, das die Zusicherung und die angehängte Reservierung enthält Geben Sie dieses Feld an, wenn Sie die Ersatzreservierung auf mehrere Nutzerprojekte aufteilen möchten.

   • REPLACEMENT_RESERVATION_SHARE_SETTING: die Art der Freigabe für die Ersatzreservierung Geben Sie dieses Feld mit dem Wert projects an, wenn Sie Ihre Ersatzreservierung auf mehrere Nutzerprojekte aufteilen möchten.

   • REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1 und REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2: die Projekt-IDs der Projekt, die diese Reservierung gemeinsam nutzen können, z. B. project-1,project-2 Sie können bis zu 100 Nutzerprojekte hinzufügen. Diese Projekte müssen sich in derselben Organisation wie das Inhaberprojekt befinden. Sie brauchen das REPLACEMENT_RESERVATION_PROJECT_ID nicht mit einzuschließen. Es kann diese Reservierung bereits standardmäßig nutzen.

2. Führen Sie den Befehl gcloud beta compute commitments update-reservations aus und geben Sie den Pfad zur YAML-Datei mit dem Flag --reservations-from-file an.

   gcloud beta compute commitments update-reservations COMMITMENT_NAME \
       --project=PROJECT_ID \
       --region=REGION \
       --reservations-from-file=YAML_FILE
   

   Ersetzen Sie Folgendes:

   • COMMITMENT_NAME: der Name der Zusicherung mit der angehängten Reservierung
   • PROJECT_ID: die Projekt-ID der Zusicherung mit der angehängten Reservierung
   • REGION: die Region, in der sich die Zusicherung befindet
   • YAML_FILE: der Pfad zur YAML-Datei, die die Konfiguration der aktuellen und Ersatzreservierungen enthält

Beispiel für das Ersetzen einer Reservierung, die an eine Nutzungszusicherung angehängt ist

Zur Veranschaulichung wird in diesem Abschnitt eine Beispielzusicherung mit einer angehängten Reservierung gezeigt und wie Sie die angehängte Beispielreservierung ersetzen.

Beispielzusicherung mit einer angehängten Reservierung

Angenommen, Sie möchten die angehängten Reservierungen für die Zusicherung my-commitment-with-reservations aktualisieren, die mit dem folgenden Befehl erworben wurden:

  gcloud beta compute commitments create my-commitment-with-reservations \
      --region=asia-east1 \
      --resources=vcpu=16,memory=60GB,local-ssd=3000 \
      --resources-accelerator=type=nvidia-tesla-v100,count=4 \
      --plan=12-month \
      --type=general-purpose \
      --reservations-from-file=one-reservation.yaml

Wenn dieser Befehl in diesem Beispiel ausgeführt wurde, war one-reservation.yaml eine Datei im aktuellen Verzeichnis mit folgendem Inhalt, die eine angehängte Reservierung mit dem Namen res-1 definiert.

  - reservation: res-1
    reservation_zone: asia-east1-a
    vm_count: 4
    machine_type: n1-standard-4
    accelerator:
    - count: 1
      type: nvidia-tesla-v100
    local_ssd:
    - interface: scsi
      size: 375
    - interface: scsi
      size: 375

Diese my-commitment-with-reservations-Zusicherung und die zugehörige Reservierung res-1 führen zu den folgenden zugesicherten und reservierten Ressourcen:

Ressourcentyp	Ressourcen in Zusicherung (my-commitment-with-reservations)	Ressourcen in der aktuell angehängten Reservierung (res-1)
Kombinationen aus vCPUs und Arbeitsspeicher	16 vCPUs und 60 GB	16 vCPUs und 60 GB (4 reservierte n1-standard-4- VMs)^*
GPUs	4 V100-GPUs	4 V100-GPUs (1 V100-GPU pro VM, für 4 VMs)^*
Lokale SSDs	3.000 GB oder 8 lokale SSD-Laufwerke	3.000 GB oder 8 lokale SSD-Laufwerke (750 GB oder 2 lokale SSD-Laufwerke pro VM für 4 VMs)^*

^*In diesem Fall werden mit der angehängten Beispielreservierung res-1 4 n1-standard-4-VMs mit jeweils 1 V100-GPU und 2 lokalen SSDs des Schnittstellentyps scsi reserviert. Der Maschinentyp n1-standard-4 verwendet 4 vCPUs und 15 GB für jede VM.

Beispiel für angehängte Reservierung ersetzen

Angenommen, Sie möchten die angehängte Reservierung res-1 für die Zusicherung durch eine neue angehängte Reservierung res-2 ersetzen und die reservierten Ressourcen so ändern:

Ressourcentyp	Ressourcen in Zusicherung (my-commitment-with-reservations)	Ressourcen in der aktuell angehängten Reservierung (res-1)	Ressourcen in angehängter Ersatzreservierung (res-2)
Kombinationen aus vCPUs und Arbeitsspeicher	16 vCPUs und 60 GB	16 vCPUs und 60 GB (4 reservierte n1-standard-4- VMs)^*	16 vCPUs und 60 GB (2 reservierte und freigegebene n1-standard-8-VMs)^†
GPUs	4 V100-GPUs	4 V100-GPUs (1 V100-GPU pro VM, für 4 VMs)^*	4 V100-GPUs (2 V100-GPUs pro VM für 2 VMs)^†
Lokale SSDs	3.000 GB oder 8 lokale SSD-Laufwerke	3.000 GB oder 8 lokale SSD-Laufwerke (750 GB oder 2 lokale SSD-Laufwerke pro VM für 4 VMs)^*	3.000 GB oder 8 lokale SSD-Laufwerke (1500 GB oder 4 lokale SSD-Laufwerke pro VM für 2 VMs)^*

^*In diesem Fall werden mit der angehängten Beispielreservierung res-1 4 n1-standard-4-VMs mit jeweils 1 V100-GPU und 2 lokalen SSDs des Schnittstellentyps scsi reserviert. Der Maschinentyp n1-standard-4 verwendet 4 vCPUs und 15 GB für jede VM.

^†Im Einzelnen definiert die angehängte Ersatzreservierung res-2, das 2 n1-standard-8-VMs mit jeweils 2 V100-GPUs und 4 lokalen SSDs des Schnittstellentyps scsi. Darüber hinaus wird res-2 für zwei andere Projekte freigegeben, project-1 und project-2, die dem aktuellen Projekt my-project gehören. Der Maschinentyp n1-standard-8 verwendet 8 vCPUs und 30 GB für jede VM.

So ersetzen Sie die angehängte Reservierung res-1 durch res-2 für die Zusicherung my-commitment-with-reservations:

1. Erstellen Sie im aktuellen Verzeichnis eine Datei mit dem Namen two-reservations.yaml, die folgenden Inhalt enthält:

   - reservation: res-1
     reservation_zone: asia-east1-a
     vm_count: 0
     machine_type: n1-standard-4
     accelerator:
     - count: 1
       type: nvidia-tesla-v100
     local_ssd:
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
   - reservation: res-2
     reservation_zone: asia-east1-a
     vm_count: 2
     machine_type: n1-standard-8
     accelerator:
     - count: 2
       type: nvidia-tesla-v100
     project: my-project
     share_setting: projects
     share_with:
     - project-1
     - project-2
     local_ssd:
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
   

2. Führen Sie dazu diesen Befehl aus:

   gcloud beta compute commitments update-reservations my-commitment-with-reservations \
       --region=asia-east1 \
       --reservations-from-file=two-reservations.yaml
   

REST

Wenn Sie Reservierungen ersetzen möchten, die an Zusicherungen angehängt sind, stellen Sie eine POST-Anfrage mit der Methode regionCommitments.updateReservations.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/COMMITMENT_REGION/commitments/COMMITMENT_NAME/updateReservations

{
  "reservations":
  [
    {
      "name": "REPLACEMENT_RESERVATION_NAME",
      "specificReservation":
      {
        "count": "REPLACEMENT_RESERVATION_NUMBER_OF_VMS",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS",
              "acceleratorType": "REPLACEMENT_RESERVATION_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "REPLACEMENT_RESERVATION_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "REPLACEMENT_RESERVATION_INTERFACE_2"
            }
          ],
          "machineType": "REPLACEMENT_RESERVATION_MACHINE_TYPE"

        }
      },
      "zone": "REPLACEMENT_RESERVATION_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1":
          {
            "projectId": "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1"
          },
          "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2":
          {
            "projectId": "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2"
          }
         }
      }
    },
    {
      "name": "CURRENT_RESERVATION_NAME",
      "specificReservation":
      {
        "count": "0",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS",
              "acceleratorType": "CURRENT_RESERVATION_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "CURRENT_RESERVATION_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "CURRENT_RESERVATION_INTERFACE_2"
            }
          ],
          "machineType": "CURRENT_RESERVATION_MACHINE_TYPE"

        }
      },
      "zone": "CURRENT_RESERVATION_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1":
          {
            "projectId": "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1"
          },
          "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2":
          {
            "projectId": "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2"
          }
         }
      }
    }
  ]
}

Ersetzen Sie Folgendes durch die entsprechenden Attribute der Zusicherung, der aktuellen Reservierung und der Ersatzreservierung:

Zusicherung

• COMMITMENT_NAME: der Name der Zusicherung mit der angehängten Reservierung
• PROJECT_ID: die Projekt-ID der Zusicherung mit der angehängten Reservierung Dies ist auch die Projekt-ID für die aktuellen und angehängten Reservierungen.
• COMMITMENT_REGION: die Region der Zusicherung mit der angehängten Reservierung

Momentane Reservierung

Für die aktuelle Reservierung müssen alle folgenden Eigenschaften genau mit den Angaben übereinstimmen, die Sie bei der Anzeige der Reservierung gesehen haben. Lassen Sie die Felder für alle Attribute weg, die in der aktuellen Reservierung nicht angegeben sind.

• CURRENT_RESERVATION_NAME: der Name der aktuellen verbundenen Reservierung
• CURRENT_RESERVATION_ZONE: die Zone der aktuell angehängten Reservierung
• CURRENT_RESERVATION_MACHINE_TYPE: der Maschinentyp der aktuell angehängten Reservierung
• CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS: die Anzahl der GPUs, die in der aktuell angehängten Reservierung reserviert sind
• CURRENT_RESERVATION_ACCELERATOR_TYPE: der Typ des Beschleunigers, der in der aktuell angehängten Reservierung reserviert ist
• CURRENT_RESERVATION_INTERFACE_1 und CURRENT_RESERVATION_INTERFACE_2: der Schnittstellentyp, den die lokalen SSDs für jede reservierte VM in der aktuell angehängten Reservierung verwenden Gültige Optionen sind: scsi und nvme. Jede lokale SSD ist 375 GB groß. Wiederholen Sie den Parameter localSsds für alle reservierten lokalen SSD-Laufwerke.
• CURRENT_RESERVATION_SHARE_SETTING: die Art der Freigabe für die aktuelle Reservierung Geben Sie dieses diesen Parameter mit dem Wert projects an, wenn Ihre aktuell angehängte Reservierung von mehreren Nutzerprojekten gemeinsam genutzt wird.
• CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1 und CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2: die Projekt-IDs der Projekte, für die Sie die aktuell angehängte Reservierung freigeben, z. B. project-1 und project-2

Ersatzreservierung

Legen Sie für die Ersatzreservierung die folgenden Attribute fest. Achten Sie darauf, dass Sie alle Anforderungen erfüllen, wenn Sie diese Attribute angeben. Lassen Sie alle zusätzlichen Felder weg, die Sie nicht verwenden möchten.

• REPLACEMENT_RESERVATION_NAME: der Name der neuen Ersatzreservierung
• REPLACEMENT_RESERVATION_ZONE: die Zone der neuen Ersatzreservierung
• REPLACEMENT_RESERVATION_NUMBER_OF_VMS: die Anzahl der Compute-Instanzen, die Sie in der neuen Ersatzreservierung reservieren möchten.

• REPLACEMENT_RESERVATION_MACHINE_TYPE: der Maschinentyp, den Sie für die Compute-Instanzen in Ihrer neuen Ersatzreservierung verwenden möchten

  • Verwenden Sie für vordefinierte Maschinentypen das Format MACHINE_FAMILY-standard-CPUS, z. B. n2-standard-4.
  • Verwenden Sie für benutzerdefinierte Maschinentypen das Format MACHINE_FAMILY-custom-CPUS-MEMORY, z. B. n2-custom-4-5120. Eine vollständige Liste der Einschränkungen finden Sie in den Spezifikationen für benutzerdefinierte Maschinentypen.

  Ersetzen Sie Folgendes:

  • MACHINE_FAMILY: die Maschinentypfamilie. Geben Sie beispielsweise für N2-Compute-Instanzen n2 an.
  • CPUS: die Anzahl der vCPUs.
  • MEMORY: der gesamte Arbeitsspeicher für eine reservierte Instanz. Der Arbeitsspeicher muss ein Vielfaches von 256 MB sein und in MB angegeben werden. Verwenden Sie n2-custom-4-5120, um eine N2-VM mit 4 vCPUs und 5 GB Arbeitsspeicher zu erstellen, die 5.120 MB entspricht.

• REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS: die Anzahl der GPUs, die Sie pro VM in der Ersatzreservierung hinzufügen möchten

• REPLACEMENT_RESERVATION_ACCELERATOR_TYPE: der Beschleunigertyp, den Sie der Ersatzreservierung hinzufügen möchten

• REPLACEMENT_RESERVATION_INTERFACE_1 und REPLACEMENT_RESERVATION_INTERFACE_2: der Schnittstellentyp, den die lokalen SSD-Laufwerke für jede reservierte VM verwenden sollen. Gültige Optionen sind: scsi und nvme. Jede lokale SSD ist 375 GB groß. Wiederholen Sie den Parameter localSsds für jedes lokale SSD-Laufwerk, das Sie hinzufügen möchten. Sie können bis zu 24 lokale SSDs angeben.

• REPLACEMENT_RESERVATION_SHARE_SETTING: die Art der Freigabe für die Ersatzreservierung Geben Sie diesen Parameter mit dem Wert projects an, wenn Sie Ihre Ersatzreservierung auf mehrere Nutzerprojekte aufteilen möchten.

• REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1 und REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2: die Projekt-IDs der Projekt, die diese Reservierung gemeinsam nutzen können, z. B. project-1,project-2 Sie können bis zu 100 Nutzerprojekte hinzufügen. Diese Projekte müssen sich in derselben Organisation wie das Inhaberprojekt befinden. Sie brauchen das PROJECT_ID nicht mit einzuschließen. Es kann diese Reservierung bereits standardmäßig nutzen.

Beispiel für das Ersetzen einer Reservierung, die an eine Nutzungszusicherung angehängt ist

Zur Veranschaulichung wird in diesem Abschnitt eine Beispielzusicherung mit einer angehängten Reservierung gezeigt und wie Sie die angehängte Beispielreservierung ersetzen.

Beispielzusicherung mit angehängter Reservierung

Angenommen, Sie möchten die angehänngte Reservierung res-1 für die Zusicherung my-commitment-with-reservations ersetzen, die erworben wurde, indem Sie die folgende POST-Anfrage stellen:

  POST https://compute.googleapis.com/compute/beta/projects/my-project/regions/asia-east1/commitments

  {
    "name": "my-commitment-with-reservations",
    "plan": "TWELVE_MONTH",
    "reservations":
    [
      {
        "name": "res-1",
        "specificReservation":
        {
          "count": "4",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": "1",
                "acceleratorType": "nvidia-tesla-v100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-4"
          }
        },
        "zone": "asia-east1-a"
      }
    ],
    "resources":
    [
      {
        "amount": "16",
        "type": "VCPU"
      },
      {
        "amount": "61440",
        "type": "MEMORY"
      },
      {
        "acceleratorType": "nvidia-tesla-v100",
        "amount": "4",
        "type": "ACCELERATOR"
      },
      {
        "amount": "3072000",
        "type": "LOCAL_SSD"
      }
    ],
    "type": "GENERAL_PURPOSE"
  }

Diese my-commitment-with-reservations-Zusicherung und die zugehörige Reservierung res-1 führen zu den folgenden zugesicherten und reservierten Ressourcen:

Ressourcentyp	Ressourcen in Zusicherung (my-commitment-with-reservations)	Ressourcen in der aktuell angehängten Reservierung (res-1)
Kombinationen aus vCPUs und Arbeitsspeicher	16 vCPUs und 60 GB	16 vCPUs und 60 GB (4 reservierte n1-standard-4- VMs)^*
GPUs	4 V100-GPUs	4 V100-GPUs (1 V100-GPU pro VM, für 4 VMs)^*
Lokale SSDs	3.000 GB oder 8 lokale SSD-Laufwerke	3.000 GB oder 8 lokale SSD-Laufwerke (750 GB oder 2 lokale SSD-Laufwerke pro VM für 4 VMs)^*

^*In diesem Fall werden mit der angehängten Beispielreservierung res-1 4 n1-standard-4-VMs mit jeweils 1 V100-GPU und 2 lokalen SSD-Laufwerken des Schnittstellentyps scsi reserviert. Der Maschinentyp n1-standard-4 verwendet 4 vCPUs und 15 GB für jede VM.

Beispiel für angehängte Reservierung ersetzen

Angenommen, Sie möchten die angehängte Reservierung res-1 für die Zusicherung durch eine neue angehängte Reservierung res-2 ersetzen und die reservierten Ressourcen so ändern:

Ressourcentyp	Ressourcen in Zusicherung (my-commitment-with-reservations)	Ressourcen in der aktuell angehängten Reservierung (res-1)	Ressourcen in angehängter Ersatzreservierung (res-2)
Kombinationen aus vCPUs und Arbeitsspeicher	16 vCPUs und 60 GB	16 vCPUs und 60 GB (4 reservierte n1-standard-4- VMs)^*	16 vCPUs und 60 GB (2 reservierte und freigegebene n1-standard-8-VMs)^†
GPUs	4 V100-GPUs	4 V100-GPUs (1 V100-GPU pro VM, für 4 VMs)^*	4 V100-GPUs (2 V100-GPUs pro VM für 2 VMs)^†
Lokale SSDs	3.000 GB oder 8 lokale SSD-Laufwerke	3.000 GB oder 8 lokale SSD-Laufwerke (750 GB oder 2 lokale SSD-Laufwerke pro VM für 4 VMs)^*	3.000 GB oder 8 lokale SSD-Laufwerke (1500 GB oder 4 lokale SSD-Laufwerke pro VM für 2 VMs)^*

^*In diesem Fall werden mit der angehängten Beispielreservierung res-1 4 n1-standard-4-VMs mit jeweils 1 V100-GPU und 2 lokalen SSDs des Schnittstellentyps scsi reserviert. Der Maschinentyp n1-standard-4 verwendet 4 vCPUs und 15 GB für jede VM.

^†Im Einzelnen definiert die angehängte Ersatzreservierung res-2, das 2 n1-standard-8-VMs mit jeweils 2 V100-GPUs und 4 lokalen SSDs des Schnittstellentyps scsi. Darüber hinaus wird res-2 für zwei andere Projekte freigegeben, project-1 und project-2, die dem aktuellen Projekt my-project gehören. Der Maschinentyp n1-standard-8 verwendet 8 vCPUs und 30 GB für jede VM.

Wenn Sie die angehängte Reservierung res-1 durch res-2 für die Zusicherung my-commitment-with-reservations ersetzen möchten, stellen Sie die folgende POST-Anfrage mit der Methode regionCommitments.updateReservations:

  POST https://compute.googleapis.com/compute/beta/projects/my-project/regions/asia-east1/commitments/my-commitment-with-reservations/updateReservations

  {
    "reservations":
    [
      {
        "name": "res-2",
        "specificReservation":
        {
          "count": "2",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": 2,
                "acceleratorType": "nvidia-tesla-v100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-8"
          }
        },
        "zone": "asia-east1-a"
      },
      {
        "name": "res-1",
        "specificReservation":
        {
          "count": "0",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": 1,
                "acceleratorType": "nvidia-tesla-v100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-4"
          }
        },
        "zone": "asia-east1-a"
      }
    ]
  }

Nächste Schritte

• Ressourcenbasierte CUDs
• Reservierungen verwenden
• Reservierungen ändern
• Reservierungen löschen