Hardwarezusicherungen mit verbundenen Reservierungen erwerben

In Compute Engine sind Rabatte für ressourcenbasierte zugesicherte Nutzung (CUDs) für Ihre vorhersehbaren Arbeitslasten verfügbar. Wenn Sie Zusicherungen für GPUs oder die meisten lokalen SSD-Laufwerke erwerben, müssen Sie diese Ressourcen reservieren und die Reservierungen an Ihre Zusicherung anhängen.

In diesem Dokument wird erläutert, wie Sie ressourcenbasierte Zusicherungen mit angehängten Reservierungen über die Google Cloud Console, die gcloud CLI oder REST erwerben.

Weitere Informationen zur Funktionsweise angehängter Reservierungen finden Sie unter Reservierungen an ressourcenbasierte Zusicherungen anhängen.

Informationen zum Erwerb von Zusicherungen für vCPUs und Arbeitsspeicher ohne angehängte Reservierungen finden Sie unter Ressourcenbasierte Zusicherungen ohne angehängte Reservierungen erwerben.

Hinweis

• Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud Dienste und APIs überprüft. Zum Ausführen von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei der Compute Engine authentifizieren:

  Wählen Sie den Tab für die gewünschte Verwendung der Beispiele auf dieser Seite aus:

  Console

  Wenn Sie über die Google Cloud Console auf Dienste und APIs von Google Cloud zugreifen, müssen Sie die Authentifizierung nicht einrichten.

  gcloud

  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.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute-Administrator (roles/compute.admin) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erwerben von Zusicherungen und zum Erstellen von Reservierungen benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erwerben von Zusicherungen und zum Erstellen von Reservierungen erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Zusicherungen zu erwerben und Reservierungen zu erstellen:

• compute.commitments.create
• compute.reservations.create

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

Project Owner sind standardmäßig berechtigt, ressourcenbasierte Zusicherungen zu erwerben. Die Inhaber können benutzerdefinierte Rollen erstellen, die bestimmte Nutzer ein- oder ausschließen. Lesen Sie die Informationen zur Zugriffssteuerung, um sicherzustellen, dass Sie die Berechtigung zum Erwerb einer ressourcenbasierten Zusicherung haben.

Hardware-ressourcenbasierte Zusicherung 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. Scrollen 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. Scrollen 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"
    }
  ]
}