Diese Seite wurde von der Cloud Translation API übersetzt.

Reservierungen mit Rabatten für zugesicherte Nutzung kombinieren

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

In diesem Dokument wird erläutert, wie Sie CUDs für Ihre reservierten Ressourcen erhalten und Reservierungen ressourcenbasierten Zusicherungen hinzufügen.

Hinweise

Hier finden Sie grundlegende Informationen zu Reservierungen sowie zu den zugehörigen Anforderungen und Einschränkungen. Weitere Informationen finden Sie unter Reservierungen für zonale Compute Engine-Ressourcen.
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 bei Compute Engine authentifizieren. Wählen Sie dazu eine der folgenden Optionen aus:

Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

CUDs für Ihre reservierten Ressourcen

Sie erhalten CUDs aus aktiven Zusicherungen für jede zulässige Ressourcennutzung in Ihren Projekten. Wenn Sie auch Kapazitäten für Ressourcen in diesem Projekt reserviert haben, können CUDs aus aktiven Zusicherungen auch auf diese reservierten Ressourcen angewendet werden. Damit reservierte Ressourcen CUDs erhalten können, gelten die folgenden Anforderungen:

Sie erhalten keine andere Art von Rabatt für Ihre Ressourcennutzung.
Ihre VMs müssen die Reservierungen nutzen, solange die Zusicherungen aktiv sind.
Mindestens die folgenden Eigenschaften müssen zwischen Ihren aktiven Zusicherungen und den Reservierungen übereinstimmen, die Ihre VMs nutzen:
- Projekt und Region, für die sie gelten
- Maschinenfamilienreihen

Je nach Ressourcentyp können Sie CUDs für Ihre reservierten Ressourcen auf eine der folgenden Arten erhalten:

vCPUs und Arbeitsspeicher: Wenn Sie CUDs für einen oder beide dieser Ressourcentypen erhalten möchten, können Sie ressourcen- oder ausgabenbasierte Zusicherungen erwerben, die die erforderlichen Ressourcentypen enthalten. Wenn VMs in Ihrem Projekt Reservierungen nutzen, deren Eigenschaften mit solchen aktiven Zusicherungen übereinstimmen, erhalten Sie automatisch die entsprechenden CUDs für diese Arten von reservierten Ressourcen. Wenn Sie mehr Ressourcen reserviert haben, als Sie zugesichert haben, erhalten Sie keine CUDs für diese zusätzlichen Ressourcen.
GPUs und lokale SSD-Laufwerke: Wenn Sie CUDs für einen oder beide dieser Ressourcentypen erhalten möchten, gehen Sie so vor:
- Ressourcenbasierte Zusicherungen kaufen, die die erforderlichen Ressourcentypen enthalten
- Erstellen Sie Reservierungen für alle zugesagten Ressourcen mit Attributen, die Ihrer Zusicherung entsprechen, und hängen Sie diese Reservierungen an die Zusicherung an.
Wenn VMs in Ihrem Projekt diese verknüpften Reservierungen nutzen, erhalten Sie die entsprechenden CUDs für diese Arten von reservierten Ressourcen.

Reservierungen an ressourcenbasierte Zusicherungen anhängen

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

Vorhandene Reservierungen verwenden, deren Attribute mit der Zusicherung übereinstimmen
Neue übereinstimmende Reservierungen beim Kauf der Zusicherung erstellen

Nachdem Sie eine Zusicherung mit angehängten Reservierungen erworben haben, bleiben die Reservierungen so lange aktiv, wie die Zusicherung aktiv ist. Wenn Ihre Zusicherung abgelaufen ist, löscht Compute Engine automatisch alle verbundenen Reservierungen. Das Löschen dieser Reservierungen hat keine Auswirkungen auf laufende VMs, die diese Reservierungen genutzt haben. Die ausgeführten VMs werden weiterhin ausgeführt und diese VMs werden weiterhin in Rechnung gestellt.

Zugesicherte Ressourcen, für die keine verbundenen Reservierungen erforderlich sind

Für vCPUs und Arbeitsspeicher, deren Nutzung Sie zusichern, müssen Sie Ihre Zusicherungen nicht mit entsprechenden Reservierungen verknüpfen. Wenn Sie jedoch eine Zusicherung erwerben, die vCPUs, Arbeitsspeicher oder beides umfasst, können Sie weiterhin Reservierungen anhängen, in denen diese Ressourcen angegeben sind. Wie Sie Zusicherungen ausschließlich für vCPUs, Arbeitsspeicher oder beides erwerben, ohne Reservierungen anzuhängen, lesen Sie Zusicherungen ohne angehängte Reservierungen erwerben.

Zugesicherte Ressourcen, für die verbundene Reservierungen erforderlich sind

Für GPUs und lokale SSDs, deren Nutzung Sie zusichern, müssen Sie Ihre Zusicherungen mit entsprechenden Reservierungen verknüpfen. Wenn Sie eine Zusicherung erwerben, die GPUs, lokale SSD-Laufwerke oder beides enthält, müssen Sie diese Ressourcen auch reservieren und die Reservierungen an Ihre Zusicherung anhängen. Sie können dazu eine einzelne Reservierung oder eine Kombination von Reservierungen verwenden. Wenn Sie eine solche Zusicherung erwerben, können Sie auch vCPUs, Arbeitsspeicher oder beides einschließen. Sie müssen diese vCPUs oder den Arbeitsspeicher jedoch nicht reservieren. Informationen zum Kauf von Zusicherungen, die GPUs oder lokale SSD-Laufwerke oder beides enthalten, finden Sie in diesem Dokument unter Zusicherungen mit angehängten Reservierungen erwerben.

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

Mengen der Ressourcen, die in verbundenen Reservierungen zulässig sind

Für vCPUs und Arbeitsspeicher können Sie Reservierungen mit einer größeren oder kleineren Anzahl von Ressourcen anhängen, als Sie zusichern. Wenn Sie die Nutzung von mehr vCPUs oder mehr Arbeitsspeicher als von Ihnen reserviert zusichern, reserviert Compute Engine Kapazitäten nur für diese reservierten Ressourcen. Sie können Ihre zusätzlichen zugesicherten Ressourcen jedoch weiterhin verwenden, sofern sie in Ihrer Region verfügbar sind. Wenn Sie mehr vCPUs oder Arbeitsspeicher reservieren, als Sie zusichern, erhalten Sie keine CUDs für diese zusätzlichen Ressourcen.

Wenn Sie beispielsweise eine Zusicherung für 4 vCPUs und 30 GB Arbeitsspeicher erwerben, haben Sie folgende Möglichkeiten:

Keine Reservierungen anhängen
Reservierungen anhängen, in denen eine beliebige Kombination dieser Ressourcentypen angegeben ist, z. B.:
- 4 vCPUs und 30 GB Arbeitsspeicher
- 2 vCPUs und 50 GB Arbeitsspeicher
- 10 vCPUs und 10 GB Arbeitsspeicher

Wenn Ihre Zusicherung jedoch GPUs, lokale SSD-Laufwerke oder beides enthält, müssen Sie alle diese Ressourcen reservieren und anhängen. In den angehängten Reservierungen müssen die genaue Anzahl und die Typen der GPUs und lokalen SSDs angegeben werden, die Sie zusichern. Daher können Sie in Ihren angehängten Reservierungen auch keine zusätzliche Anzahl oder Typen von GPUs oder lokalen SSDs angeben. Angenommen, Sie erwerben eine Zusicherung für 30 GB Arbeitsspeicher und 4 NVIDIA P100-GPUs. Die angehängte Reservierung (oder die Kombination angehängter Reservierungen) kann eine beliebige Anzahl von vCPUs oder Arbeitsspeicher angeben, muss aber genau vier GPUs vom Typ NVIDIA P100 haben. In diesem Beispiel können Sie keine Reservierungen anhängen, in denen eine der folgenden Kombinationen von Ressourcen angegeben ist:

6 NVIDIA P100-GPUs
2 NVIDIA P100-GPUs
4 NVIDIA P100-GPUs und 2 NVIDIA V100-GPUs
4 NVIDIA P100-GPUs und 4 lokale SSDs

Zusicherungen 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, deren Attribute mit der Zusicherung übereinstimmen
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. 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 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 jedochACTIVE nur am 21. Januar um 00:00 Uhr US-amerikanischer und kanadischer Pazifikzeit (UTC-8 oder UTC-7).

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.
Sie müssen die Option zum automatischen Löschen für die angehängten Reservierungen deaktivieren.
Wenn die Zusicherung GPUs enthält, mudd der GPU-Typ in der Reservierung und der Zusicherung übereinstimmen.
Bei GPUs und lokalen SSD-Laufwerken muss die Anzahl der reservierten Ressourcen jedes Ressourcentyps genau mit der Anzahl der für diesen Ressourcentyp zugesicherten Ressourcen übereinstimmen. Wenn Sie beispielsweise eine Zusicherung für 4 V100-GPUs erwerben möchten, müssen die mit der Zusicherung verbundenen Reservierungen insgesamt 4 V100-GPUs haben. Die Anzahl der vCPUs und die Menge an Arbeitsspeicher können jedoch unter der von Ihnen zugesicherten Nutzung liegen.
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.
- Aktivieren Sie die CUD-Freigabe für dieses Cloud-Rechnungskonto.

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 Erstellen 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 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:

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

Zur Seite "Rabatte für zugesicherte Nutzung"
Klicken Sie auf Zusicherung kaufen, um eine Zusicherung zu kaufen. Die Seite Rabatt für zugesicherte Nutzung erwerben wird geöffnet und der Tab Hardware wird angezeigt.
Geben Sie im Feld Name einen Namen für Ihre Zusicherung ein.
Wählen Sie im Feld Region die Region aus, in der Sie Compute Engine-Ressourcen zusichern möchten.
Wählen Sie im Feld Zusicherungstyp die Maschinenfamilienreihe für Ihre zugesicherten Ressourcen aus. Die folgenden Zusicherungstypen bieten Optionen für GPUs, lokale SSD-Laufwerke oder beides:
- Beschleunigungsoptimiert (A2) für A2-Maschinentyp-Ressourcen
- Beschleunigungsoptimiert (A3) für A3 Edge- und High-Maschinentyp-Ressourcen
- Beschleunigungsoptimiert (A3) Mega für A3 Mega-Maschinentyp-Ressourcen
- Computing-optimiert (C2) für C2-Maschinentyp-Ressourcen
- Computing-optimiert (C2D) für C2D-Maschinentyp-Ressourcen
- Allgemeiner Zweck (C3) für C3-Maschinentyp-Ressourcen
- Allgemeiner Zweck C3D für C3D-Maschinentypen-Ressourcen
- Allgemeiner Zweck (N1) für N1-Maschinentyp-Ressourcen
- Allgemeiner Zweck (N2) für N2-Maschinentyp-Ressourcen
- Allgemeiner Zweck (N2D) für N2D-Maschinentyp-Ressourcen
- Grafikoptimierte G2 für G2-Maschinentypen-Ressourcen
- Speicheroptimiert (M3) für M3-Maschinentyp-Ressourcen
- Speicheroptimiert (Z3) für Z3-Maschinentyp-Ressourcen
Gehen Sie unter Dauer so vor:
1. Wählen Sie entweder 1 Jahr oder 3 Jahre aus, um den Plan für Ihre Zusicherung anzugeben. Mit dieser Einstellung wird die voreingestellte Laufzeit Ihrer Bindung festgelegt.
2. Optional. Wenn Sie eine benutzerdefinierte Laufzeit für Ihre Bindung festlegen möchten, klicken Sie auf die Ein/Aus-Schaltfläche Enddatum verlängern und geben Sie dann im Feld Datum ein benutzerdefiniertes Enddatum ein. Weitere Informationen finden Sie unter Laufzeit von Zusicherungen verlängern.
Geben Sie im Feld Kerne die Anzahl der vCPUs ein, die Sie zusichern möchten.
Geben Sie im Feld Speicher die Größe des Arbeitsspeichers in GB ein, die Sie zusichern möchten.
Wenn Sie GPUs zusichern möchten, klicken Sie im Bereich GPUs auf GPU hinzufügen und gehen Sie dann so vor:
1. Wählen Sie im Feld GPU-Typ den GPU-Typ aus.
2. Geben Sie im Feld Anzahl der GPUs die Anzahl der GPUs ein.
3. Optional: Wenn Ihr GPU-Modell NVIDIA RTX Virtual Workstations (vWS) für Grafikarbeitslasten unterstützt und Sie grafikintensive Arbeitslasten ausführen möchten, klicken Sie das Kästchen Virtuelle Workstation (NVIDIA GRID) aktivieren an.
Wenn Sie lokale SSD-Laufwerke zusichern möchten, klicken Sie im Bereich Lokale SSDs auf SSD hinzufügen und geben Sie dann im Feld Anzahl der SSDs die Anzahl der Laufwerke ein.
Wenn Sie der Zusicherung eine oder mehrere vorhandene Reservierungen anhängen möchten, wählen Sie im Feld Reservierungen die Option Vorhandene Reservierungen anhängen aus.

In der Google Cloud Console wird eine Liste aller Reservierungen in Ihrem Projekt angezeigt, deren Region, Maschinentyp und GPU-Typ mit der Zusicherung übereinstimmen. Gehen Sie anschließend so vor:
1. Optional. Wenn Sie sich Reservierungen mit bestimmten Attributen ansehen möchten, fügen Sie im Menü Filter Filter für die gewünschten Attribute hinzu oder entfernen Sie diese.
2. Wählen Sie alle Reservierungen aus, die Sie der Zusicherung zuordnen möchten.
Wichtig: Die Typen und die Gesamtzahl der GPUs und lokalen SSDs, die in allen angehängten Reservierungen angegeben sind, müssen mit den Angaben in Ihrer Zusicherung übereinstimmen. Andernfalls können Sie die Zusicherung nicht kaufen.
So schließen Sie den Kauf Ihrer Zusicherung mit den angehängten Reservierungen ab:
1. Klicken Sie auf Kaufen.
2. Wenn Sie im Dialogfeld Rabatt für zugesicherte Nutzung kaufen den dienstspezifischen Nutzungsbedingungen zustimmen, klicken Sie noch einmal 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 hinzu. 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=DURATION \
    --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: 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.
DURATION: Laufzeit der Zusicherung, entweder 12-month oder 36-month.
CUSTOM_END_DATE: Optional. Ein benutzerdefiniertes Enddatum für den Zeitraum, das als YYYY-MM-DD formatiert sein muss. Wenn Sie beispielsweise den 20. April 2024 als Enddatum angeben möchten, formatieren Sie es als 2024-04-20.
COMMITMENT_TYPE: den Zusicherungstyp. Die folgenden Zusicherungstypen bieten Optionen für GPUs, lokale SSD-Laufwerke oder beides:
- accelerator-optimized für A2-Maschinentyp-Ressourcen
- accelerator-optimized-a3 für A3 Edge- und High-Maschinentyp-Ressourcen
- accelerator-optimized-a3-mega für A3 Mega-Maschinentyp-Ressourcen
- compute-optimized für C2-Maschinentyp-Ressourcen
- compute-optimized-c2d für C2D-Maschinentyp-Ressourcen
- compute-optimized-c3 für C3-Maschinentyp-Ressourcen
- compute-optimized-c3d für C3D-Maschinentyp-Ressourcen
- general-purpose für N1-Maschinentyp-Ressourcen
- general-purpose-n2 für N2-Maschinentyp-Ressourcen
- general-purpose-n2d für N2D-Maschinen-Ressourcen
- graphics-optimized für G2-Maschinentypen-Ressourcen
- memory-optimized-m3 für M3-Maschinentyp-Ressourcen
- storage-optimized-z3 für Z3-Maschinentyp-Ressourcen
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. Wenn Sie keine Einheit angeben, verwendet die Compute Engine GB als Einheit. Sie können Arbeitsspeicher in Schritten von 0,25 GB erwerben.
COMMITTED_LOCAL_SSD: die Menge an lokalem SSD-Speicherplatz in GB, die Sie in Ihrer Zusicherung verwenden möchten. Jede lokale SSD ist 375 GB groß.
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. Beachten Sie, dass die Beispielzusicherung auch vCPUs und Arbeitsspeicher enthält.

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, senden Sie eine POST-Anfrage an die Methode regionCommitments.insert. Geben Sie in Ihrer Anfrage das Feld existingReservations an, um eine durch Kommas getrennte Liste aller vorhandenen Reservierungen anzugeben, die Sie Ihrer 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": "DURATION",
  "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: 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.
DURATION: Laufzeit der Zusicherung, entweder TWELVE_MONTH oder THIRTY_SIX_MONTH.
COMMITMENT_TYPE: den Zusicherungstyp. Die folgenden Zusicherungstypen bieten Optionen für GPUs, lokale SSD-Laufwerke oder beides:
- ACCELERATOR_OPTIMIZED für A2-Maschinentyp-Ressourcen
- ACCELERATOR_OPTIMIZED_A3 für A3 Edge- und High-Maschinentyp-Ressourcen
- ACCELERATOR_OPTIMIZED_A3_MEGA für A3 Mega-Maschinentyp-Ressourcen
- COMPUTE_OPTIMIZED für C2-Maschinentyp-Ressourcen
- COMPUTE_OPTIMIZED_C2D für C2D-Maschinentyp-Ressourcen
- COMPUTE_OPTIMIZED_C3 für C3-Maschinentyp-Ressourcen
- COMPUTE_OPTIMIZED_C3D für C3D-Maschinentyp-Ressourcen
- GENERAL_PURPOSE für N1-Maschinentyp-Ressourcen
- GENERAL_PURPOSE_N2 für N2-Maschinentyp-Ressourcen
- GENERAL_PURPOSE_N2D für N2D-Maschinen-Ressourcen
- GRAPHICS_OPTIMIZED für G2-Maschinentypen-Ressourcen
- MEMORY_OPTIMIZED_M3 für M3-Maschinentyp-Ressourcen
- STORAGE_OPTIMIZED_Z3 für Z3-Maschinentyp-Ressourcen
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, die Sie in Ihrer Zusicherung verwenden möchten. Beispiel: 10240MB. Sie können Arbeitsspeicher in Schritten von 256 MB erwerben.
COMMITTED_LOCAL_SSD: die Größe des lokalen SSD-Speichers in GB, die Sie in Ihrer Zusicherung verwenden möchten. Jede lokale SSD ist 375 GB groß.
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 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 Bindung angegeben haben. Geben Sie einen der folgenden Werte an:
- Während der Sommerzeit: 07:00:00
- In anderen Fällen: 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. Beachten Sie, dass die Beispielzusicherung auch vCPUs und Arbeitsspeicher enthält.

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": "1536000",
      "type": "LOCAL_SSD"
    }
  ],
  "existingReservations":
  [
    "https://www.googleapis.com/compute/v1/projects/my-project/zone/us-central1-a/reservations/res-01",
    "https://www.googleapis.com/compute/v1/projects/my-project/zone/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:

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

Console

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

Zur Seite "Rabatte für zugesicherte Nutzung"
Klicken Sie auf Zusicherung kaufen, um eine Zusicherung zu kaufen. Die Seite Rabatt für zugesicherte Nutzung erwerben wird geöffnet und der Tab Hardware wird angezeigt.
Geben Sie im Feld Name einen Namen für Ihre Zusicherung ein.
Wählen Sie im Feld Region die Region aus, in der Sie Compute Engine-Ressourcen zusichern möchten.
Wählen Sie im Feld Zusicherungstyp die Maschinenfamilienreihe für Ihre zugesicherten Ressourcen aus. Die folgenden Zusicherungstypen bieten Optionen für GPUs, lokale SSD-Laufwerke oder beides:
- Beschleunigungsoptimiert (A2) für A2-Maschinentyp-Ressourcen
- Beschleunigungsoptimiert (A3) für A3 Edge- und High-Maschinentyp-Ressourcen
- Beschleunigungsoptimiert (A3) Mega für A3 Mega-Maschinentyp-Ressourcen
- Computing-optimiert (C2) für C2-Maschinentyp-Ressourcen
- Computing-optimiert (C2D) für C2D-Maschinentyp-Ressourcen
- Allgemeiner Zweck (C3) für C3-Maschinentyp-Ressourcen
- Allgemeiner Zweck C3D für C3D-Maschinentypen-Ressourcen
- Allgemeiner Zweck (N1) für N1-Maschinentyp-Ressourcen
- Allgemeiner Zweck (N2) für N2-Maschinentyp-Ressourcen
- Allgemeiner Zweck (N2D) für N2D-Maschinentyp-Ressourcen
- Grafikoptimierte G2 für G2-Maschinentypen-Ressourcen
- Speicheroptimiert (M3) für M3-Maschinentyp-Ressourcen
- Speicheroptimiert (Z3) für Z3-Maschinentyp-Ressourcen
Wählen Sie unter Dauer entweder 1 Jahr oder 3 Jahre als Laufzeit der Zusicherung aus.
Geben Sie im Feld Kerne die Anzahl der vCPUs ein, die Sie zusichern möchten.
Geben Sie im Feld Speicher die Größe des Arbeitsspeichers in GB ein, die Sie zusichern möchten.
Wenn Sie GPUs zusichern möchten, klicken Sie im Bereich GPUs auf GPU hinzufügen und gehen Sie dann so vor:
1. Wählen Sie im Feld GPU-Typ den GPU-Typ aus.
2. Geben Sie im Feld Anzahl der GPUs die Anzahl der GPUs ein.
3. Optional: Wenn Ihr GPU-Modell NVIDIA RTX Virtual Workstations (vWS) für Grafikarbeitslasten unterstützt und Sie grafikintensive Arbeitslasten ausführen möchten, klicken Sie das Kästchen Virtuelle Workstation (NVIDIA GRID) aktivieren an.
Wenn Sie lokale SSD-Laufwerke zusichern möchten, klicken Sie im Bereich Lokale SSDs auf SSD hinzufügen und geben Sie dann im Feld Anzahl der SSDs die Anzahl der Laufwerke ein.
Wenn Sie eine neue Reservierung erstellen und sie der Zusicherung anhängen möchten, wählen Sie im Feld Reservierungen die Option Reservierungen erstellen aus und führen Sie dann die folgenden Schritte aus. Wiederholen Sie diesen Schritt für jede neue Reservierung, die Sie erstellen und anhängen möchten.
1. Klicken Sie auf Reservierung hinzufügen. Der Abschnitt Neue Reservierung wird angezeigt.
2. Geben Sie im Feld Name einen Namen für die angehängte Reservierung ein.
3. Wählen Sie im Feld Region dieselbe Region wie für Ihre Zusicherung aus.
4. Wählen Sie im Feld Zone die Zone aus, in der Sie Ressourcen reservieren möchten.
5. 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 wird, wählen Sie Freigegeben aus. Klicken Sie dann auf Projekte hinzufügen und wählen Sie die Projekte aus der Organisation des aktuellen Projekts aus, für die Sie die Reservierung freigeben möchten.
6. Wählen Sie im Feld Mit VM-Instanz verwenden aus, wie VMs Ihre Reservierung nutzen sollen:
  - Klicken Sie auf Reservierung automatisch verwenden (Standardeinstellung), damit VMs mit übereinstimmenden Eigenschaften diese Reservierung automatisch nutzen können.
  - Wenn Sie die Ressourcen der Reservierung nur zum Erstellen von VMs mit übereinstimmenden Attributen verwenden möchten, die ausdrücklich namentlich auf diese Reservierung abzielen, klicken Sie auf Spezifische Reservierung auswählen.
7. Geben Sie im Abschnitt Ressourcendetails Folgendes an:
  1. Geben Sie im Feld Anzahl der VM-Instanzen die Anzahl der VM-Instanzen ein, die Sie reservieren möchten.
  2. Geben Sie im Abschnitt Maschinenkonfiguration die Attributes Ihrer reservierten VMs auf eine der folgenden Arten an:
    1. Um die Attribute Ihrer VMs aus einer vorhandenen Instanzvorlage anzugeben, wählen Sie Instanzvorlage verwenden aus.
      
      Wählen Sie im Feld Instanzvorlage eine Instanzvorlage aus, die dieselbe Maschinenfamilienreihe wie Ihre Zusicherung angibt. Wenn Sie eine regionale Instanzvorlage auswählen, muss die Region dieser Instanzvorlage mit der in Ihrer Zusicherung angegebenen Region übereinstimmen.
    2. Wenn Sie die Eigenschaften Ihrer VMs manuell angeben möchten, wählen Sie Maschinentyp auswählen aus und gehen Sie dann so vor:
      1. Wählen Sie die Maschinenfamilie aus, die für die Maschinenreihe gilt, die Sie für die Zusicherung angegeben haben:
        
        Allgemeiner Zweck für Maschinenserien für allgemeine Zwecke
        
        Compute-optimiert für computing-optimierte Maschinenreihen
        
        Speicheroptimiert für speicheroptimierte Maschinenreihen
        
        GPUs für beschleunigungsoptimierte Maschinenserien
      2. Wählen Sie in der Tabelle mit der Spalte Reihe dieselbe Maschinenreihe aus, die Sie für die Zusicherung angegeben haben.
      3. Geben Sie im Feld Maschinentyp einen vordefinierten oder benutzerdefinierten Maschinentyp auf eine der folgenden Arten an:
        
        Wenn Sie einen vordefinierten Maschinentyp auswählen möchten, wählen Sie Vordefiniert und dann den gewünschten Maschinentyp aus.
        
        Wenn Sie einen benutzerdefinierten Maschinentyp auswählen möchten, wählen Sie Benutzerdefiniert aus und geben Sie dann die gewünschten Kerne und Arbeitsspeicher an.
      4. Wenn Sie eine Mindest-CPU-Plattform, GPUs oder beides angeben möchten, maximieren Sie das Menü CPU-Plattform und GPU und gehen Sie so vor:
        
        Optional: Wählen Sie in der Liste CPU-Formular eine Option aus, um eine Minimalanforderung für die CPU-Plattform anzugeben.
        
        Optional: Klicken Sie zum Reservieren von GPUs auf GPU hinzufügen. Wählen Sie dann in den Feldern GPU-Typ und Anzahl der GPUs den Typ und die Anzahl der GPUs für jede VM aus.
        
        Wichtig: Die Typen und die Gesamtzahl der GPUs, die in allen angehängten Reservierungen angegeben sind, müssen mit den Angaben in Ihrer Zusicherung übereinstimmen. Andernfalls können Sie die Zusicherung nicht kaufen.
      5. So reservieren Sie lokale SSDs:
        
        Wählen Sie im Feld Anzahl der Laufwerke die gewünschte Anzahl der lokalen SSD-Laufwerke für jede VM aus.
        
        Wählen Sie im Feld Schnittstellentyp die Schnittstelle für die lokalen SSD-Laufwerke aus.
        
        Wichtig: Die Gesamtzahl der lokalen SSD-Laufwerke, die für alle angehängten Reservierungen angegeben ist, muss mit der in Ihrer Zusicherung angegebenen Anzahl übereinstimmen. Andernfalls können Sie die Zusicherung nicht kaufen.
8. Klicken Sie auf Fertig, um das Festlegen der Attribute für diese Reservierung abzuschließen.
So schließen Sie den Kauf Ihrer Zusicherung mit den angehängten Reservierungen ab:
1. Klicken Sie auf Kaufen.
2. Wenn Sie im Dialogfeld Rabatt für zugesicherte Nutzung kaufen den dienstspezifischen Nutzungsbedingungen zustimmen, klicken Sie noch einmal 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.

Je nachdem, ob Sie eine einzelne 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 DURATION \
    --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 Eigenschaften der Reservierung in einer YAML-Datei und geben Sie diese YAML-Datei dann in dem Befehl an, mit dem Sie die Zusicherung erwerben. Optional können Sie diese YAML-Datei auch verwenden, um eine einzelne Reservierung zu erstellen und an Ihre Zusicherung anzuhängen. So erstellen Sie mit diesem Ansatz Ihre angehängten Reservierungen:
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 DURATION \
    --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: 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.
DURATION: Laufzeit der Zusicherung, entweder 12-month oder 36-month.
CUSTOM_END_DATE: Optional. Ein benutzerdefiniertes Enddatum für den Zeitraum, das als YYYY-MM-DD formatiert sein muss. Wenn Sie beispielsweise den 20. April 2024 als Enddatum angeben möchten, formatieren Sie es als 2024-04-20.
COMMITMENT_TYPE: den Zusicherungstyp. Die folgenden Zusicherungstypen bieten Optionen für GPUs, lokale SSD-Laufwerke oder beides:
- accelerator-optimized für A2-Maschinentyp-Ressourcen
- accelerator-optimized-a3 für A3 Edge- und High-Maschinentyp-Ressourcen
- accelerator-optimized-a3-mega für A3 Mega-Maschinentyp-Ressourcen
- compute-optimized für C2-Maschinentyp-Ressourcen
- compute-optimized-c2d für C2D-Maschinentyp-Ressourcen
- compute-optimized-c3 für C3-Maschinentyp-Ressourcen
- compute-optimized-c3d für C3D-Maschinentyp-Ressourcen
- general-purpose für N1-Maschinentyp-Ressourcen
- general-purpose-n2 für N2-Maschinentyp-Ressourcen
- general-purpose-n2d für N2D-Maschinen-Ressourcen
- graphics-optimized für G2-Maschinentypen-Ressourcen
- memory-optimized-m3 für M3-Maschinentyp-Ressourcen
- storage-optimized-z3 für Z3-Maschinentyp-Ressourcen
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. Wenn Sie keine Einheit angeben, verwendet die Compute Engine GB als Einheit. Sie können Arbeitsspeicher in Schritten von 0,25 GB erwerben.
COMMITTED_LOCAL_SSD: die Größe des lokalen SSD-Speichers in GB, die Sie in Ihrer Zusicherung verwenden möchten. Jede lokale SSD ist 375 GB groß.
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. Jede lokale SSD ist 375 GB groß. Wiederholen Sie den Parameter local_ssd für jedes lokale SSD-Laufwerk, das Sie hinzufügen möchten. Sie können bis zu 24 lokale SSDs angeben.
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 entsprechende Meldung angezeigt, die in etwa so aussieht:

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

Beispiele für den Kauf von Zusicherungen durch das Erstellen neuer Reservierungen, die angehängt werden sollen

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 Zusicherung commitment-01 in der Region us-central1 erwerben, die vier NVIDIA V100-GPUs umfasst. Sie möchten eine neue Reservierung reservation-01 als angehängte Reservierung für diese GPUs erstellen. Angenommen, Sie möchten außerdem Compute Engine so einstellen, dass diese reservierten GPUs auf zwei n1-standard-32-VMs in der Zone us-central1-a verwendet werden. Wenn Sie diese Beispielzusicherung mit der angehängten Reservierung erwerben möchten, führen Sie den folgenden Befehl aus:

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 Zusicherung von vCPUs oder Arbeitsspeicher

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 commitment-02 für eine einzelne NVIDIA P4-GPU in der Region us-west2 erwerben. Sie möchten auch eine neue Reservierung als angehängte Reservierung erstellen und Compute Engine auffordern, die reservierte GPU auf einer n1-standard-2-VM in der Zone us-west2-b zu verwenden. Wenn Sie diese Beispielzusicherung mit der angehängten Reservierung erwerben möchten, führen Sie den folgenden Befehl aus:

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 Zusicherung commitment-03 für eine NVIDIA V100-GPU und zwei lokale SSD-Laufwerke in der Region us-central1 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 einer GPU reservieren. Sie möchten res-01 zu einer Zielreservierung machen. Das bedeutet, dass Sie diese Reservierung ausdrücklich namentlich dafür auswählen müssen, ihre reservierten VMs zu verwenden. Mit der zweiten Reservierung res-02 möchten Sie eine n1-standard-8-VM mit zwei Arten von angehängten lokalen SSDs reservieren.

Wenn Sie diese Beispielzusicherung mit den angehängten Reservierungen erwerben möchten, erstellen Sie zuerst die YAML-Datei mit den Eigenschaften 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. Beachten Sie, dass die Beispiel-Zusicherung auch vCPU- und Arbeitsspeicherressourcen enthält.

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 hinzu, um eine Liste aller neuen Reservierungen anzugeben, die Sie erstellen und anhängen möchten. Sie können beliebig viele vorhandene Reservierungen an Ihre Zusicherung anhängen.

Wenn Sie eine neue Reservierung erstellen möchten, indem Sie alle VM-Attribute manuell angeben, schließen 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": "DURATION",
"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 schließen Sie das Feld instanceProperties aus.

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

{
"name": "COMMITMENT_NAME",
"plan": "DURATION",
"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: 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.
DURATION: Laufzeit der Zusicherung, entweder TWELVE_MONTH oder THIRTY_SIX_MONTH.
COMMITMENT_TYPE: den Zusicherungstyp. Die folgenden Zusicherungstypen bieten Optionen für GPUs, lokale SSD-Laufwerke oder beides:
- ACCELERATOR_OPTIMIZED für A2-Maschinentyp-Ressourcen
- ACCELERATOR_OPTIMIZED_A3 für A3 Edge- und High-Maschinentyp-Ressourcen
- ACCELERATOR_OPTIMIZED_A3_MEGA für A3 Mega-Maschinentyp-Ressourcen
- COMPUTE_OPTIMIZED für C2-Maschinentyp-Ressourcen
- COMPUTE_OPTIMIZED_C2D für C2D-Maschinentyp-Ressourcen
- COMPUTE_OPTIMIZED_C3 für C3-Maschinentyp-Ressourcen
- COMPUTE_OPTIMIZED_C3D für C3D-Maschinentyp-Ressourcen
- GENERAL_PURPOSE für N1-Maschinentyp-Ressourcen
- GENERAL_PURPOSE_N2 für N2-Maschinentyp-Ressourcen
- GENERAL_PURPOSE_N2D für N2D-Maschinen-Ressourcen
- GRAPHICS_OPTIMIZED für G2-Maschinentypen-Ressourcen
- MEMORY_OPTIMIZED_M3 für M3-Maschinentyp-Ressourcen
- STORAGE_OPTIMIZED_Z3 für Z3-Maschinentyp-Ressourcen
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, die Sie in Ihrer Zusicherung verwenden möchten. Beispiel: 10240MB. Sie können Arbeitsspeicher in Schritten von 256 MB erwerben.
COMMITTED_LOCAL_SSD: die Größe des lokalen SSD-Speichers in GB, die Sie in Ihrer Zusicherung verwenden möchten. Jede lokale SSD ist 375 GB groß.
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 den 20. April 2024 als 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 Bindung angegeben haben. Geben Sie einen der folgenden Werte an:
- Während der Sommerzeit: 07:00:00
- In anderen Fällen: 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. Jede lokale SSD ist 375 GB groß. Wiederholen Sie den Parameter localSsds für jedes lokale SSD-Laufwerk, das Sie hinzufügen möchten. Sie können bis zu 24 lokale SSDs angeben.
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 für den Kauf von Zusicherungen durch das Erstellen neuer Reservierungen, die angehängt werden sollen

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

Angenommen, Sie möchten eine Zusicherung commitment-01 in der Region us-central1 erwerben, die vier NVIDIA V100-GPUs umfasst. Sie möchten eine neue Reservierung reservation-01 als angehängte Reservierung für diese GPUs erstellen. Angenommen, Sie möchten außerdem Compute Engine so einstellen, dass diese reservierten GPUs auf zwei n1-standard-8-VMs in der Zone us-central1-a verwendet werden. Wenn Sie diese Beispielzusicherung mit der angehängten Reservierung erwerben möchten, stellen Sie die folgende POST-Anfrage:

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 Zusicherung von vCPUs oder Arbeitsspeicher

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

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": "768000",
      "type": "LOCAL_SSD"
    }
  ],
  "reservations":
  [
    {
      "name": "res-01",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 1,
              "acceleratorType": "nvidia-tesla-v100"
            }
          ],
          "machineType": "n1-standard-2"
        }
      },
      "specificReservationRequired": true,
      "zone": "us-central1-a"
    },
    {
      "name": "res-02",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "SCSI"
            },
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            }
          ]
          "machineType": "n1-standard-8"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-central1-a"
    }
  ]
}

Reservierungen ändern, die mit Zusicherungen verbunden sind

Ersetzen Sie die vorhandene angehängte Reservierung Ihrer Zusicherung durch eine neue, wenn Sie die Typen und Anzahl der VMs ändern möchten, die Ihre zugesicherten Ressourcen verwenden.

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

Zulässige Änderungen

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

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

Wichtig: Wenn eine Reservierung, die an eine Zusicherung angehängt ist, von einem Projekt genutzt wird, das nicht in der Zusicherung enthalten ist, erhalten Sie keinen Rabatt. Wenn Ihre angehängten Reservierungen freigegebene Reservierungen sind, geben Sie diese Reservierungen nur für Projekte frei, die in der Zusicherung enthalten sind, damit Sie die Rabatte für zugesicherte Nutzung erhalten.

Voraussetzungen

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

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

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

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

Schritte zum Ersetzen einer angehängten Reservierung

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

gcloud

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

Erstellen Sie im aktuellen Verzeichnis eine YAML-Datei mit den Konfigurationen der folgenden angehängten Reservierungen:
- Die aktuelle Reservierung, die Sie ersetzen möchten.
  
  Informationen zum Abrufen der Reservierung finden Sie unter Details einer Reservierung ansehen.
- Die neue Ersatzreservierung.
Der Inhalt der YAML-Datei sieht in etwa so aus:
```
- reservation: CURRENT_RESERVATION_NAME
  reservation_zone: CURRENT_RESERVATION_ZONE
  vm_count: 0
  machine_type: CURRENT_RESERVATION_MACHINE_TYPE
  accelerator:
  - count: CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS
    type: CURRENT_RESERVATION_ACCELERATOR_TYPE
  local_ssd:
  - interface: CURRENT_RESERVATION_INTERFACE_1
    size: 375
  - interface: CURRENT_RESERVATION_INTERFACE_2
    size: 375
  project: CURRENT_RESERVATION_PROJECT_ID
  share_setting: CURRENT_RESERVATION_SHARE_SETTING
  share_with:
  - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1
  - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2
- reservation: REPLACEMENT_RESERVATION_NAME
  reservation_zone: REPLACEMENT_RESERVATION_ZONE
  vm_count: REPLACEMENT_RESERVATION_NUMBER_OF_VMs
  machine_type: REPLACEMENT_RESERVATION_MACHINE_TYPE
  accelerator:
  - count: REPLACEMENT_RESERVATION_ACCELERATOR_COUNT
    type: REPLACEMENT_RESERVATION_ACCELERATOR_TYPE
  local_ssd:
  - interface: REPLACEMENT_RESERVATION_INTERFACE_1
    size: 375
  - interface: REPLACEMENT_RESERVATION_INTERFACE_2
    size: 375
  project: REPLACEMENT_RESERVATION_PROJECT_ID
  share_setting: REPLACEMENT_RESERVATION_SHARE_SETTING
  share_with:
  - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1
  - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2
```
Ersetzen Sie Folgendes durch die entsprechenden Attribute der aktuellen und der Ersatzreservierung:
Momentane Reservierung
Für die aktuelle Reservierung müssen alle folgenden Eigenschaften genau mit den Angaben übereinstimmen, die Sie bei der Anzeige der Reservierung gesehen haben. Lassen Sie die Felder für alle Eigenschaften aus, die in der aktuellen Reservierung noch nicht vorhanden sind.
- CURRENT_RESERVATION_NAME: der Name der aktuell angehängten Reservierung
- CURRENT_RESERVATION_ZONE: die Zone der aktuell angehängten Reservierung
- CURRENT_RESERVATION_MACHINE_TYPE: der Maschinentyp der aktuell angehängten Reservierung
- CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS: die Anzahl der GPUs, die in der aktuell verbundenen Reservierung reserviert sind
- CURRENT_RESERVATION_ACCELERATOR_TYPE: der Typ des Beschleunigers, der in der aktuell angehängten Reservierung reserviert ist
- CURRENT_RESERVATION_INTERFACE_1 und CURRENT_RESERVATION_INTERFACE_2: der Schnittstellentyp, den die lokalen SSDs für jede reservierte VM in der aktuell angehängten Reservierung verwenden Gültige Optionen sind: scsi und nvme. Jede lokale SSD ist 375 GB groß. Wiederholen Sie den Parameter local_ssd für alle reservierten lokalen SSD-Laufwerke.
- CURRENT_RESERVATION_PROJECT_ID: die ID des aktuellen Projekts, das die Zusicherung und die angehängte Reservierung enthält Geben Sie dieses Feld an, wenn Ihre aktuell angehängte Reservierung von mehreren Nutzerprojekten gemeinsam genutzt wird.
- CURRENT_RESERVATION_SHARE_SETTING: die Art der Freigabe für die aktuelle Reservierung Geben Sie dieses Feld mit dem Wert projects an, wenn Ihre aktuell angehängte Reservierung von mehreren Nutzerprojekten gemeinsam genutzt wird.
- CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1 und CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2: die Projekt-IDs der Projekte, für die Sie die aktuell angehängte Reservierung freigeben, z. B. project-1 und project-2
Ersatzreservierung
Legen Sie für die Ersatzreservierung die folgenden Attribute fest. Achten Sie darauf, dass Sie alle Anforderungen erfüllen, wenn Sie diese Attribute angeben. Lassen Sie alle zusätzlichen Felder weg, die Sie nicht verwenden möchten.
- REPLACEMENT_RESERVATION_NAME: der Name der neuen Ersatzreservierung
- REPLACEMENT_RESERVATION_ZONE: die Zone der neuen Ersatzreservierung
- REPLACEMENT_RESERVATION_NUMBER_OF_VMS: die Anzahl der VMs, die Sie in der neuen Ersatzreservierung reservieren möchten
- REPLACEMENT_RESERVATION_MACHINE_TYPE: der Maschinentyp, den Sie für die VMs in Ihrer neuen Ersatzreservierung verwenden möchten
  - Verwenden Sie für vordefinierte Maschinentypen das Format MACHINE_FAMILY-standard-CPUS, z. B. n2-standard-4.
  - Verwenden Sie für benutzerdefinierte Maschinentypen das Format MACHINE_FAMILY-custom-CPUS-MEMORY, z. B. n2-custom-4-5120. Eine vollständige Liste der Einschränkungen finden Sie in den Spezifikationen für benutzerdefinierte Maschinentypen.
  Ersetzen Sie Folgendes:
  - MACHINE_FAMILY: die Maschinentypfamilie. Geben Sie beispielsweise für N2-VMs n2 an.
  - CPUS: die Anzahl der vCPUs.
  - MEMORY: der gesamte Arbeitsspeicher für eine reservierte VM. Der Arbeitsspeicher muss ein Vielfaches von 256 MB sein und in MB angegeben werden. Verwenden Sie zum Beispiel n2-custom-4-5120, um eine N2-VM mit 4 vCPUs und 5 GB Arbeitsspeicher zu erstellen, die 5.120 MB entspricht.
- REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS: die Anzahl der GPUs, die Sie pro VM in der Ersatzreservierung hinzufügen möchten
- REPLACEMENT_RESERVATION_ACCELERATOR_TYPE: der Beschleunigertyp, den Sie der Ersatzreservierung hinzufügen möchten
- REPLACEMENT_RESERVATION_INTERFACE_1 und REPLACEMENT_RESERVATION_INTERFACE_2: der Schnittstellentyp, den die lokalen SSD-Laufwerke für jede reservierte VM verwenden sollen. Gültige Optionen sind: scsi und nvme. Jede lokale SSD ist 375 GB groß. Wiederholen Sie den Parameter local_ssd für jedes lokale SSD-Laufwerk, das Sie hinzufügen möchten. Sie können bis zu 24 lokale SSDs angeben.
- REPLACEMENT_RESERVATION_PROJECT_ID: die ID des aktuellen Projekts, das die Zusicherung und die angehängte Reservierung enthält Geben Sie dieses Feld an, wenn Sie die Ersatzreservierung auf mehrere Nutzerprojekte aufteilen möchten.
- REPLACEMENT_RESERVATION_SHARE_SETTING: die Art der Freigabe für die Ersatzreservierung Geben Sie dieses Feld mit dem Wert projects an, wenn Sie Ihre Ersatzreservierung auf mehrere Nutzerprojekte aufteilen möchten.
- REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1 und REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2: die Projekt-IDs der Projekt, die diese Reservierung gemeinsam nutzen können, z. B. project-1,project-2 Sie können bis zu 100 Nutzerprojekte hinzufügen. Diese Projekte müssen sich in derselben Organisation wie das Inhaberprojekt befinden. Sie brauchen das REPLACEMENT_RESERVATION_PROJECT_ID nicht mit einzuschließen. Es kann diese Reservierung bereits standardmäßig nutzen.
Führen Sie den Befehl gcloud beta compute commitments update-reservations aus und geben Sie den Pfad zur YAML-Datei mit dem Flag --reservations-from-file an.
```
gcloud beta compute commitments update-reservations COMMITMENT_NAME \
    --project= PROJECT_ID \
    --region= REGION \
    --reservations-from-file= YAML_FILE
```
Ersetzen Sie Folgendes:
- COMMITMENT_NAME: der Name der Zusicherung mit der angehängten Reservierung
- PROJECT_ID: die Projekt-ID der Zusicherung mit der angehängten Reservierung
- REGION: die Region, in der sich die Zusicherung befindet
- YAML_FILE: der Pfad zur YAML-Datei, die die Konfiguration der aktuellen und Ersatzreservierungen enthält

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

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

Beispielzusicherung mit einer angehängten Reservierung

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

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

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

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

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

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

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

Beispiel für angehängte Reservierung ersetzen

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

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

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

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

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

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

Führen Sie dazu diesen Befehl aus:

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

REST

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

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

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

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

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

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

Zusicherung

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

Momentane Reservierung

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

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

Ersatzreservierung

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

REPLACEMENT_RESERVATION_NAME: der Name der neuen Ersatzreservierung
REPLACEMENT_RESERVATION_ZONE: die Zone der neuen Ersatzreservierung
REPLACEMENT_RESERVATION_NUMBER_OF_VMS: die Anzahl der VMs, die Sie in der neuen Ersatzreservierung reservieren möchten
REPLACEMENT_RESERVATION_MACHINE_TYPE: der Maschinentyp, den Sie für die VMs in Ihrer neuen Ersatzreservierung verwenden möchten
- Verwenden Sie für vordefinierte Maschinentypen das Format MACHINE_FAMILY-standard-CPUS, z. B. n2-standard-4.
- Verwenden Sie für benutzerdefinierte Maschinentypen das Format MACHINE_FAMILY-custom-CPUS-MEMORY, z. B. n2-custom-4-5120. Eine vollständige Liste der Einschränkungen finden Sie in den Spezifikationen für benutzerdefinierte Maschinentypen.
Ersetzen Sie Folgendes:
- MACHINE_FAMILY: die Maschinentypfamilie. Geben Sie beispielsweise für N2-VMs n2 an.
- CPUS: die Anzahl der vCPUs.
- MEMORY: der gesamte Arbeitsspeicher für eine reservierte Instanz. Der Arbeitsspeicher muss ein Vielfaches von 256 MB sein und in MB angegeben werden. Verwenden Sie n2-custom-4-5120, um eine N2-VM mit 4 vCPUs und 5 GB Arbeitsspeicher zu erstellen, die 5.120 MB entspricht.
REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS: die Anzahl der GPUs, die Sie pro VM in der Ersatzreservierung hinzufügen möchten
REPLACEMENT_RESERVATION_ACCELERATOR_TYPE: der Beschleunigertyp, den Sie der Ersatzreservierung hinzufügen möchten
REPLACEMENT_RESERVATION_INTERFACE_1 und REPLACEMENT_RESERVATION_INTERFACE_2: der Schnittstellentyp, den die lokalen SSD-Laufwerke für jede reservierte VM verwenden sollen. Gültige Optionen sind: scsi und nvme. Jede lokale SSD ist 375 GB groß. Wiederholen Sie den Parameter localSsds für jedes lokale SSD-Laufwerk, das Sie hinzufügen möchten. Sie können bis zu 24 lokale SSDs angeben.
REPLACEMENT_RESERVATION_SHARE_SETTING: die Art der Freigabe für die Ersatzreservierung Geben Sie diesen Parameter mit dem Wert projects an, wenn Sie Ihre Ersatzreservierung auf mehrere Nutzerprojekte aufteilen möchten.
REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1 und REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2: die Projekt-IDs der Projekt, die diese Reservierung gemeinsam nutzen können, z. B. project-1,project-2 Sie können bis zu 100 Nutzerprojekte hinzufügen. Diese Projekte müssen sich in derselben Organisation wie das Inhaberprojekt befinden. Sie brauchen das PROJECT_ID nicht mit einzuschließen. Es kann diese Reservierung bereits standardmäßig nutzen.

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

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

Beispielzusicherung mit angehängter Reservierung

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

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

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

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

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

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

Beispiel für angehängte Reservierung ersetzen

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

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

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

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

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

Reservierungen mit Rabatten für zugesicherte Nutzung kombinieren

Hinweise

Console

gcloud

REST

CUDs für Ihre reservierten Ressourcen

Reservierungen an ressourcenbasierte Zusicherungen anhängen

Zugesicherte Ressourcen, für die keine verbundenen Reservierungen erforderlich sind

Zugesicherte Ressourcen, für die verbundene Reservierungen erforderlich sind

Mengen der Ressourcen, die in verbundenen Reservierungen zulässig sind

Zusicherungen mit verbundenen Reservierungen erwerben

Voraussetzungen

Vorhandene Reservierungen anhängen

Erforderliche Berechtigungen für diese Aufgabe

Console

gcloud

Beispiel: Eine Zusicherung durch Anhängen vorhandener Reservierungen erwerben

REST

Beispiel: Eine Zusicherung durch Anhängen vorhandener Reservierungen erwerben

Neue Reservierungen zum Anhängen erstellen

Erforderliche Berechtigungen für diese Aufgabe

Console

gcloud

Verpflichtung

Angehängte Reservierungen

Beispiele für den Kauf von Zusicherungen durch das Erstellen neuer Reservierungen, die angehängt werden sollen

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

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

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

REST

Verpflichtung

Angehängte Reservierungen

Beispiele für den Kauf von Zusicherungen durch das Erstellen neuer Reservierungen, die angehängt werden sollen

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

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

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

Reservierungen ändern, die mit Zusicherungen verbunden sind

Zulässige Änderungen

Voraussetzungen

Schritte zum Ersetzen einer angehängten Reservierung

gcloud

Momentane Reservierung

Ersatzreservierung

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

Beispielzusicherung mit einer angehängten Reservierung

Beispiel für angehängte Reservierung ersetzen

REST

Zusicherung

Momentane Reservierung

Ersatzreservierung

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

Beispielzusicherung mit angehängter Reservierung

Beispiel für angehängte Reservierung ersetzen

Nächste Schritte