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 beschrieben, wie Sie ressourcenbasierte Zusicherungen mit angehängten Reservierungen über die Google Cloud Console, die gcloud CLI oder REST kaufen.

Weitere Informationen zur Funktionsweise angehängter Reservierungen finden Sie unter Reservierungen an ressourcenbasierten 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. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei Compute Engine authentifizieren:

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

  Console

  Wenn Sie über die Google Cloud Console auf Google Cloud Dienste und APIs 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 Kaufen von Zusicherungen und 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 Kaufen von Zusicherungen und 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.

Projektinhaber 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.

Ressourcenbasierte Hardwarezusicherung mit verbundenen Reservierungen erwerben

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

• Vorhandene Reservierungen verwenden, die den Zusicherungsattributen entsprechen
• Neue passende 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 derGoogle Cloud -Konsole). 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-amerikanischer und kanadischer Pazifikzeit (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 Attribution und Rabattfreigabe, 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 C4-, C4A-, C4D-, C4N-, G4-, H4D- oder Z3-Maschinentypen 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 haben. Die Anzahl der vCPUs und die Menge an Arbeitsspeicher können jedoch unter der von Ihnen zugesicherten Nutzung liegen. Wenn Sie in Ihrer Zusicherung jedoch 4 C4A-vCPUs und 2 lokale Titanium-SSDs angeben, müssen Sie der Zusicherung keine Reservierungen 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 P100- oder NVIDIA V100-GPUs erwerben, aber Sie können keine Zusicherungen verwenden, die für NVIDIA P100-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.
  • Die CUD-Freigabe muss für dieses Cloud-Rechnungskonto aktiviert sein.

Vorhandene Reservierungen anhängen

Sie können beim Kauf Ihrer Zusicherung vorhandene Reservierungen ü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:

• So erwerben Sie eine 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 kaufen 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 A3 Edge- und A3 High-Maschinentypen Beschleunigungsoptimiert (A3) aus.
   • Wählen Sie für A3 Mega-Maschinentypen Beschleunigungsoptimiert (A3) Mega aus.
     Hinweis: Für A4X Max-, A4X-, A4- oder A3 Ultra-Maschinentypen müssen Sie Ihre Zusicherungen mit der Verbrauchsoption Zukünftige 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 Allgemeiner Zweck (C3) aus.
   • Wählen Sie für C3D-Maschinentypen Allgemeiner Zweck C3D aus.
     Achtung: Bei C3- und C3D-Zusicherungstypen ändert sich die vom Zusicherungstyp angegebene Maschinenfamilie je nach Schnittstelle:

     • In der gcloud CLI und REST wird Compute-optimized als Maschinenfamilie für die Werte des Zusagetyp verwendet, obwohl C3 und C3D zur Maschinenfamilie für allgemeine Zwecke gehören.
     • In der Google Cloud -Konsole wird für die Werte des Zusagetyp die richtige Maschinenreihe verwendet: Allgemeiner Zweck.

     Achten Sie darauf, den richtigen Zusicherungstyp auszuwählen, der der verwendeten Oberfläche entspricht.
   • Wählen Sie für C4-Maschinentypen Allgemeiner Zweck (C4) aus.
   • Wählen Sie für C4A-Maschinentypen Allgemeiner Zweck (C4A) aus.
   • Wählen Sie für C4D-Maschinentypen Allgemeiner Zweck (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 Allgemeiner Zweck (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.

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

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

   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 gefiltert, um Ihrer angegebenen Region und Ihrem Commitment-Typ zu entsprechen.

   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 Bereich 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 Commitment-Details eingegeben haben, werden Ihre Werte mit den Werten aus den Reservierungen überschrieben.

7. Führen Sie im Abschnitt Details zur Zusage folgende Schritte aus:

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

   2. Prüfen Sie im Feld Arbeitsspeicher den vorab ausgefüllten Arbeitsspeicher in GB. Optional können Sie einen anderen Betrag angeben. Sie können den Arbeitsspeicher 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. Maximieren Sie den Bereich GPUs und lokale SSDs und prüfen Sie, ob die Typen und Zahlen zwischen der Zusicherung und den 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 der Laufwerke.

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

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

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

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

   2. Sehen Sie sich das Feld Startdatum an. Dort wird das Datum und die Uhrzeit angezeigt, zu der Ihre Zusicherung aktiv wird. Dieses Feld wird automatisch auf 00:00 Uhr US-amerikanischer und kanadischer Pazifikzeit 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 in Ihrem Zusicherungsplan definiert ist, geben Sie im Feld Enddatum ein benutzerdefiniertes Enddatum für Ihre Zusicherung an. Weitere Informationen finden Sie unter Laufzeiten von Zusicherungen verlängern.

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

9. Prüfen Sie im Bereich Zusammenfassung die Details Ihrer Zusicherung und alle potenziellen Kontingentbeschränkungen.

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

    1. Scrollen Sie zum Ende der Seite.

    2. Im Abschnitt Offenlegungen finden Sie Informationen zu Gebühren, Rabattberechtigung sowie Nutzungsbedingungen.

    3. Klicken Sie das Kästchen an, um zu bestätigen, dass Sie den Mindestpreis und die dienstspezifischen Bedingungen 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 den Zeitraum, das als YYYY-MM-DD formatiert sein muss. Wenn Sie beispielsweise ein benutzerdefiniertes Enddatum am 20. April 2024 festlegen 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:

  • Für A2-Maschinentypen verwenden Sie accelerator-optimized.
  • Für A3 Edge- und A3 High-Maschinentypen verwenden Sie 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 mit der Verbrauchsoption Zukünftige Reservierungen in AI Hypercomputer erwerben. Weitere Informationen finden Sie unter Kapazität über Ihr Account-Management-Team reservieren.
  • Für G2-Maschinentypen verwenden Sie graphics-optimized.
  • Für G4-Maschinentypen verwenden Sie graphics-optimized-g4.
  • Für C2-Maschinentypen verwenden Sie compute-optimized.
  • Für C2D-Maschinentypen verwenden Sie compute-optimized-c2d.
  • Für C3-Maschinentypen verwenden Sie 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 Compute-optimized als Maschinenfamilie für die Werte des Zusagetyp verwendet, obwohl C3 und C3D zur Maschinenfamilie für allgemeine Zwecke gehören.
    • In der Google Cloud -Konsole wird für die Werte des Zusagetyp die richtige Maschinenreihe verwendet: Allgemeiner Zweck.

    Achten Sie darauf, den richtigen Zusicherungstyp auszuwählen, der der verwendeten Oberfläche entspricht.
  • Für N1-Maschinentypen verwenden Sie general-purpose
  • Für C4-Maschinentypen verwenden Sie general-purpose-c4.
  • Für C4A-Maschinentypen verwenden Sie general-purpose-c4a.
  • Für C4D-Maschinentypen verwenden Sie general-purpose-c4d.
  • Für C4N-Maschinentypen verwenden Sie network-optimized-c4n.
  • Für N2-Maschinentypen verwenden Sie general-purpose-n2.
  • Für N2D-Maschinentypen verwenden Sie general-purpose-n2d.
  • Für M1-Maschinentypen verwenden Sie memory-optimized.
  • Für M3-Maschinentypen verwenden Sie memory-optimized-m3.
  • Für Z3-Maschinentypen verwenden Sie storage-optimized-z3.

• 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. Wenn Sie REST verwenden, wird in Compute Engine jedoch 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 P100-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 gibt 96 vCPUs, 624 GB Arbeitsspeicher, 4 NVIDIA P100-GPUs und 1.500 GB lokalen SSD-Speicher an (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 Arbeitsspeicher in MB oder GB angeben. Wenn Sie keine Einheit angeben, verwendet Compute Engine GB als Standardeinheit. Wenn Sie REST verwenden, wird in Compute Engine jedoch standardmäßig MB als Einheit 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-p100,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, stellen Sie eine POST-Anfrage an die Methode regionCommitments.insert. Fügen Sie in Ihre Anfrage das Feld existingReservations ein, um eine durch Kommas getrennte Liste aller vorhandenen Reservierungen anzugeben, die Sie an Ihre Zusage 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:

  • Für A2-Maschinentypen verwenden Sie ACCELERATOR_OPTIMIZED.
  • Für A3 Edge- und A3 High-Maschinentypen verwenden Sie 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 mit der Verbrauchsoption Zukünftige Reservierungen in AI Hypercomputer erwerben. Weitere Informationen finden Sie unter Kapazität über Ihr Account-Management-Team reservieren.
  • Für G2-Maschinentypen verwenden Sie GRAPHICS_OPTIMIZED.
  • Für G4-Maschinentypen verwenden Sie GRAPHICS_OPTIMIZED_G4.
  • Für C2-Maschinentypen verwenden Sie COMPUTE_OPTIMIZED.
  • Für C2D-Maschinentypen verwenden Sie COMPUTE_OPTIMIZED_C2D.
  • Für C3-Maschinentypen verwenden Sie 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 Compute-optimized als Maschinenfamilie für die Werte des Zusagetyp verwendet, obwohl C3 und C3D zur Maschinenfamilie für allgemeine Zwecke gehören.
    • In der Google Cloud -Konsole wird für die Werte des Zusagetyp die richtige Maschinenreihe verwendet: Allgemeiner Zweck.

    Achten Sie darauf, den richtigen Zusicherungstyp auszuwählen, der der verwendeten Oberfläche entspricht.
  • Für N1-Maschinentypen verwenden Sie GENERAL_PURPOSE
  • Für C4-Maschinentypen verwenden Sie GENERAL_PURPOSE_C4.
  • Für C4A-Maschinentypen verwenden Sie GENERAL_PURPOSE_C4A.
  • Für C4D-Maschinentypen verwenden Sie GENERAL_PURPOSE_C4D.
  • Für C4N-Maschinentypen verwenden Sie NETWORK_OPTIMIZED_C4N.
  • Für N2-Maschinentypen verwenden Sie GENERAL_PURPOSE_N2.
  • Für N2D-Maschinentypen verwenden Sie GENERAL_PURPOSE_N2D.
  • Für M1-Maschinentypen verwenden Sie MEMORY_OPTIMIZED.
  • Für M3-Maschinentypen verwenden Sie MEMORY_OPTIMIZED_M3.
  • Für Z3-Maschinentypen verwenden Sie STORAGE_OPTIMIZED_Z3.

• 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 standardmäßig MB als Einheit. Wenn Sie die gcloud CLI verwenden, wird in Compute Engine standardmäßig GB als Einheit verwendet.

• 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 den Zeitraum, das als YYYY-MM-DD formatiert sein muss. Wenn Sie beispielsweise ein benutzerdefiniertes Enddatum für den 20. April 2024 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 Zusage 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 P100-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 P100-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, wird in Compute Engine jedoch standardmäßig GB als Einheit für den Arbeitsspeicher 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-p100",
      "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 Ihre angehängten Reservierungen beim Kauf Ihrer Zusicherung über die Google Cloud Console, die Google Cloud CLI oder REST erstellen.

Erforderliche Berechtigungen für diese Aufgabe

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

• So erwerben Sie eine 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 kaufen 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 A3 Edge- und A3 High-Maschinentypen Beschleunigungsoptimiert (A3) aus.
   • Wählen Sie für A3 Mega-Maschinentypen Beschleunigungsoptimiert (A3) Mega aus.
     Hinweis: Für A4X Max-, A4X-, A4- oder A3 Ultra-Maschinentypen müssen Sie Ihre Zusicherungen mit der Verbrauchsoption Zukünftige 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 Allgemeiner Zweck (C3) aus.
   • Wählen Sie für C3D-Maschinentypen Allgemeiner Zweck C3D aus.
     Achtung: Bei C3- und C3D-Zusicherungstypen ändert sich die vom Zusicherungstyp angegebene Maschinenfamilie je nach Schnittstelle:

     • In der gcloud CLI und REST wird Compute-optimized als Maschinenfamilie für die Werte des Zusagetyp verwendet, obwohl C3 und C3D zur Maschinenfamilie für allgemeine Zwecke gehören.
     • In der Google Cloud -Konsole wird für die Werte des Zusagetyp die richtige Maschinenreihe verwendet: Allgemeiner Zweck.

     Achten Sie darauf, den richtigen Zusicherungstyp auszuwählen, der der verwendeten Oberfläche entspricht.
   • Wählen Sie für C4-Maschinentypen Allgemeiner Zweck (C4) aus.
   • Wählen Sie für C4A-Maschinentypen Allgemeiner Zweck (C4A) aus.
   • Wählen Sie für C4D-Maschinentypen Allgemeiner Zweck (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 Allgemeiner Zweck (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.

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

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

   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:

      • Wenn Sie eine Reservierung für ein einzelnes Projekt erstellen möchten, 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 Bereich Google Cloud-Dienste an, ob Sie diese Reservierung für andere Dienste wie Google Kubernetes Engine oder Vertex AI freigeben möchten.

   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 die Ressourcen dieser Reservierung nur beim Erstellen übereinstimmender VMs verbraucht werden sollen, die ausdrücklich namentlich auf diese Reservierung abzielen, 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 Eigenschaften 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 SSD-Laufwerke 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 die Schritte.

   Nachdem Sie Ihre Reservierungen angehängt haben, füllt Compute Engine die Felder im Bereich 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 Commitment-Details eingegeben haben, werden Ihre Werte mit den Werten aus den Reservierungen überschrieben.

7. Führen Sie im Abschnitt Details zur Zusage folgende Schritte aus:

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

   2. Prüfen Sie im Feld Arbeitsspeicher den vorab ausgefüllten Arbeitsspeicher in GB. Optional können Sie einen anderen Betrag angeben. Sie können den Arbeitsspeicher 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. Maximieren Sie den Bereich GPUs und lokale SSDs und prüfen Sie, ob die Typen und Zahlen zwischen der Zusicherung und den 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 der Laufwerke.

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

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

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

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

   2. Sehen Sie sich das Feld Startdatum an. Dort wird das Datum und die Uhrzeit angezeigt, zu der Ihre Zusicherung aktiv wird. Dieses Feld wird automatisch auf 00:00 Uhr US-amerikanischer und kanadischer Pazifikzeit 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 in Ihrem Zusicherungsplan definiert ist, geben Sie im Feld Enddatum ein benutzerdefiniertes Enddatum für Ihre Zusicherung an. Weitere Informationen finden Sie unter Laufzeiten von Zusicherungen verlängern.

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

9. Prüfen Sie im Bereich Zusammenfassung die Details Ihrer Zusicherung und alle potenziellen Kontingentbeschränkungen.

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

    1. Scrollen Sie zum Ende der Seite.

    2. Im Abschnitt Offenlegungen finden Sie Informationen zu Gebühren, Rabattberechtigung sowie Nutzungsbedingungen.

    3. Klicken Sie das Kästchen an, um zu bestätigen, dass Sie den Mindestpreis und die dienstspezifischen Bedingungen 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 Google Cloud CLI nicht verwenden, um angehängte Reservierungen mit Instanzvorlagen zu erstellen. Stattdessen müssen Sie die VM-Attribute für Ihre Reservierungen manuell angeben.

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

• Wenn Sie eine einzelne Reservierung erstellen und an Ihre Zusicherung anhängen möchten, definieren Sie die Attribute der angehängten Reservierung, indem Sie den folgenden Befehl ausführen:

  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 Nutzungszusicherung anhängen möchten, definieren Sie die Attribute der Reservierung in einer YAML-Datei und geben Sie diese YAML-Datei dann in dem Befehl an, mit dem Sie Ihre Nutzungszusicherung erwerben. Optional können Sie auch mit dieser YAML-Datei eine einzelne Reservierung erstellen und an Ihre Zusicherung anhängen. So erstellen Sie Ihre verknüpften 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
       localssd:
       - 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 --reservation-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 den Zeitraum, das als YYYY-MM-DD formatiert sein muss. Wenn Sie beispielsweise ein benutzerdefiniertes Enddatum am 20. April 2024 festlegen 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:

  • Für A2-Maschinentypen verwenden Sie accelerator-optimized.
  • Für A3 Edge- und A3 High-Maschinentypen verwenden Sie 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 mit der Verbrauchsoption Zukünftige Reservierungen in AI Hypercomputer erwerben. Weitere Informationen finden Sie unter Kapazität über Ihr Account-Management-Team reservieren.
  • Für G2-Maschinentypen verwenden Sie graphics-optimized.
  • Für G4-Maschinentypen verwenden Sie graphics-optimized-g4.
  • Für C2-Maschinentypen verwenden Sie compute-optimized.
  • Für C2D-Maschinentypen verwenden Sie compute-optimized-c2d.
  • Für C3-Maschinentypen verwenden Sie 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 Compute-optimized als Maschinenfamilie für die Werte des Zusagetyp verwendet, obwohl C3 und C3D zur Maschinenfamilie für allgemeine Zwecke gehören.
    • In der Google Cloud -Konsole wird für die Werte des Zusagetyp die richtige Maschinenreihe verwendet: Allgemeiner Zweck.

    Achten Sie darauf, den richtigen Zusicherungstyp auszuwählen, der der verwendeten Oberfläche entspricht.
  • Für N1-Maschinentypen verwenden Sie general-purpose
  • Für C4-Maschinentypen verwenden Sie general-purpose-c4.
  • Für C4A-Maschinentypen verwenden Sie general-purpose-c4a.
  • Für C4D-Maschinentypen verwenden Sie general-purpose-c4d.
  • Für C4N-Maschinentypen verwenden Sie network-optimized-c4n.
  • Für N2-Maschinentypen verwenden Sie general-purpose-n2.
  • Für N2D-Maschinentypen verwenden Sie general-purpose-n2d.
  • Für M1-Maschinentypen verwenden Sie memory-optimized.
  • Für M3-Maschinentypen verwenden Sie memory-optimized-m3.
  • Für Z3-Maschinentypen verwenden Sie storage-optimized-z3.

• 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. Wenn Sie REST verwenden, wird in Compute Engine jedoch 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 Bestätigungsmeldung 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: Eine Zusicherung für GPUs durch Anhängen einer einzelnen neuen Reservierung erwerben

Angenommen, Sie möchten eine 1-Jahres-Zusicherung für allgemeine Ressourcen (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, mit der zwei n1-standard-32-VMs (jede VM mit 32 vCPUs, 120 GB Arbeitsspeicher und 2 NVIDIA V100-GPUs) reserviert werden, um diese zugesicherten Ressourcen zu nutzen. Wenn Sie diese Beispielzusicherung mit der angehängten Reservierung erwerben möchten, führen Sie den folgenden Befehl aus. 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. Wenn Sie REST verwenden, wird in Compute Engine jedoch 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 für 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 1-jährige Zusicherung für GPU-Ressourcen in der Region us-west2 mit 0 vCPUs, 0 GB Arbeitsspeicher und 1 NVIDIA P4-GPU erwerben. Außerdem möchten Sie eine neue Reservierung reservation-01 in der Zone us-west2-b erstellen, die 1 n1-standard-2-VM (mit 2 vCPUs, 7,5 GB Arbeitsspeicher und 1 NVIDIA P4-GPU) reserviert, die an die Zusicherung angehängt werden soll. Wenn Sie diese Beispielzusicherung mit der angehängten Reservierung erwerben möchten, führen Sie den folgenden Befehl aus. 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. Wenn Sie REST verwenden, wird in Compute Engine jedoch 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 einer 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 SSD-Laufwerke anhängen (ein SCSI- und ein NVMe-Laufwerk).

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 Arbeitsspeicher in MB oder GB angeben. Wenn Sie keine Einheit angeben, verwendet Compute Engine GB als Standardeinheit. Wenn Sie REST verwenden, wird in Compute Engine standardmäßig MB als Einheit 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 Ihre 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 Ihre neue Reservierung erstellen möchten, indem Sie alle VM-Attribute manuell angeben, fügen Sie das Feld instanceProperties ein 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": "RESERVED_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "RESERVED_INTERFACE_2"
            }
          ],
          "machineType": "RESERVED_MACHINE_TYPE",
          "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
        }
      },
      "specificReservationRequired": "REQUIRE_SPECIFIC_RESERVATION_VALUE",
      "zone": "RESERVED_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 eine neue Reservierung durch Angabe einer Instanzvorlage erstellen möchten, schließen Sie das Feld sourceInstanceTemplate ein und 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": "RESERVED_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:

  • Für A2-Maschinentypen verwenden Sie ACCELERATOR_OPTIMIZED.
  • Für A3 Edge- und A3 High-Maschinentypen verwenden Sie 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 mit der Verbrauchsoption Zukünftige Reservierungen in AI Hypercomputer erwerben. Weitere Informationen finden Sie unter Kapazität über Ihr Account-Management-Team reservieren.
  • Für G2-Maschinentypen verwenden Sie GRAPHICS_OPTIMIZED.
  • Für G4-Maschinentypen verwenden Sie GRAPHICS_OPTIMIZED_G4.
  • Für C2-Maschinentypen verwenden Sie COMPUTE_OPTIMIZED.
  • Für C2D-Maschinentypen verwenden Sie COMPUTE_OPTIMIZED_C2D.
  • Für C3-Maschinentypen verwenden Sie 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 Compute-optimized als Maschinenfamilie für die Werte des Zusagetyp verwendet, obwohl C3 und C3D zur Maschinenfamilie für allgemeine Zwecke gehören.
    • In der Google Cloud -Konsole wird für die Werte des Zusagetyp die richtige Maschinenreihe verwendet: Allgemeiner Zweck.

    Achten Sie darauf, den richtigen Zusicherungstyp auszuwählen, der der verwendeten Oberfläche entspricht.
  • Für N1-Maschinentypen verwenden Sie GENERAL_PURPOSE
  • Für C4-Maschinentypen verwenden Sie GENERAL_PURPOSE_C4.
  • Für C4A-Maschinentypen verwenden Sie GENERAL_PURPOSE_C4A.
  • Für C4D-Maschinentypen verwenden Sie GENERAL_PURPOSE_C4D.
  • Für C4N-Maschinentypen verwenden Sie NETWORK_OPTIMIZED_C4N.
  • Für N2-Maschinentypen verwenden Sie GENERAL_PURPOSE_N2.
  • Für N2D-Maschinentypen verwenden Sie GENERAL_PURPOSE_N2D.
  • Für M1-Maschinentypen verwenden Sie MEMORY_OPTIMIZED.
  • Für M3-Maschinentypen verwenden Sie MEMORY_OPTIMIZED_M3.
  • Für Z3-Maschinentypen verwenden Sie STORAGE_OPTIMIZED_Z3.

• 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 standardmäßig MB als Einheit. Wenn Sie die gcloud CLI verwenden, wird in Compute Engine standardmäßig GB als Einheit verwendet.

• 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 den Zeitraum, das als YYYY-MM-DD formatiert sein muss. Wenn Sie beispielsweise ein benutzerdefiniertes Enddatum am 20. April 2024 festlegen 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 Zusage 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: Eine Zusicherung für GPUs durch Anhängen einer einzelnen neuen Reservierung erwerben

Angenommen, Sie möchten eine 1-Jahres-Zusicherung für allgemeine Ressourcen 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, mit der zwei n1-standard-8-VMs (jede VM mit 8 vCPUs, 30 GB Arbeitsspeicher und 2 NVIDIA V100-GPUs) reserviert werden, die an diese Zusicherung angehängt werden sollen. Wenn Sie diese Beispielzusicherung mit der angehängten Reservierung erwerben möchten, stellen Sie die folgende POST-Anfrage. Bei REST müssen Sie den Speicher in MB angeben. Wenn Sie die gcloud CLI verwenden, wird in Compute Engine standardmäßig GB als Einheit 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 für 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 1-Jahres-Zusicherung nur für GPU-Ressourcen in der Region us-west2 mit 0 vCPUs, 0 MB Arbeitsspeicher und 4 NVIDIA P4-GPUs erwerben. Außerdem möchten Sie 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, die an die Zusicherung angehängt werden soll. Wenn Sie diese Beispielzusicherung mit der angehängten Reservierung erwerben möchten, stellen Sie die folgende POST-Anfrage. Bei REST müssen Sie den Speicher in MB angeben. Wenn Sie die gcloud CLI verwenden, wird in Compute Engine standardmäßig GB als Einheit 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 1-Jahres-Zusicherung für allgemeine Ressourcen in der Region us-central1 mit 96 vCPUs, 624 GB Arbeitsspeicher (entspricht 638.976 MB), 1 NVIDIA V100-GPU und 750 GB lokalem SSD-Speicher erwerben. 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 einer 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 anhängen (eine SCSI-Schnittstelle, eine NVMe-Schnittstelle). 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. Wenn Sie die gcloud CLI verwenden, wird in Compute Engine jedoch standardmäßig GB als Einheit 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"
    }
  ]
}