Zukünftige Reservierungsanfragen für ein einzelnes Projekt erstellen

In diesem Dokument wird erläutert, wie Sie zukünftige Reservierungsanfragen für ein einzelnes Projekt erstellen.

Wenn Google Cloud Ihre zukünftige Reservierungsanfrage für ein einzelnes Projekt genehmigt, erstellt Compute Engine ab der in Ihrer Anfrage angegebenen Startzeit automatisch Reservierungen, die nur von erstellten VM-Instanzen im selben Projekt genutzt werden können.

Vorbereitung

  • Lesen Sie die Funktionsweise zukünftiger Reservierungen, falls Sie dies noch nicht getan haben.
  • Prüfen Sie Ihr Kontingent, damit Sie ein ausreichendes Kontingent für die Ressourcen haben, die Sie reservieren möchten.
  • Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud-Dienste und APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei Compute Engine authentifizieren.

    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
    2. Set a default region and zone.

      3. REST

      Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle zum Berechnen von zukünftigen Reservierungsanfragen (roles/compute.futureReservationUser) für das Projekt zu erteilen, um die Berechtigungen zu erhalten, die Sie zum Erstellen von zukünftigen Reservierungsanfragen für einzelne Projekte benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen von zukünftigen Reservierungsanfragen für ein einzelnes Projekt erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um zukünftige Reservierungsanfragen für ein einzelnes Projekt zu erstellen:

  • So erstellen Sie eine zukünftige Reservierungsanfrage: compute.futureReservations.create für das Projekt
  • So werden von Compute Engine Reservierungen automatisch erstellt: compute.reservations.create für das Projekt
  • So geben Sie eine Instanzvorlage an: compute.instanceTemplates.useReadOnly für die Instanzvorlage

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

Anfrageentwurf erstellen

Wenn Sie eine Anfrage für eine zukünftige Reservierung erstellen, können Sie sie entweder als Entwurf speichern und später zur Prüfung an Google Cloud senden oder direkt zur Prüfung einreichen. Google empfiehlt, zuerst einen Anfrageentwurf zu erstellen. So können Sie die Anzahl der VMs bestimmen, die die Compute Engine für Ihre Anfrage bereitstellen wird, anstatt diese Anzahl manuell zu schätzen. Außerdem können Sie optional die Anzahl der reservierten VMs in der Anfrage ändern, bevor Sie sie zur Überprüfung einreichen.

Damit eine automatisch erstellte Reservierung für eine zukünftige Reservierung genutzt werden kann, muss eine VM Attribute haben, die genau mit dieser Reservierung übereinstimmen. Verwenden Sie eine der folgenden Methoden aus, um die Attribute der VMs anzugeben, für die Sie eine Reservierung anfragen möchten, indem Sie eine zukünftige Reservierungsanfrage erstellen:

  • Empfohlen: Instanzvorlage angeben

    Sie können eine vorhandene Instanzvorlage zum Definieren der Attribute einer zukünftigen Reservierungsanfrage verwenden. Mithilfe einer Instanzvorlage können Sie die Attribute einer zukünftigen Reservierung und der VMs definieren, die die automatisch erstellten Reservierungen an derselben Stelle nutzen können.

  • Vorhandene VM angeben

    Sie können eine vorhandene VM verwenden, um die Attribute einer zukünftigen Reservierungsanfrage zu definieren. Mithilfe der Attribute einer vorhandenen VM können Sie die automatisch erstellten Reservierungen nutzen, die für die zukünftige Reservierung bereitgestellt wurden. Dazu erstellen Sie VMs mit Attributen, die mit der Referenz-VM übereinstimmen.

  • Attribute direkt angeben

    Sie können die Attribute einer zukünftigen Reservierungsanfrage direkt definieren. Bei dieser Methode müssen Sie manuell prüfen, ob die Attribute Ihrer VMs und der automatisch erstellten Reservierungen genau übereinstimmen – nicht übereinstimmende Attribute verhindern die Nutzung.

Eine automatisch erstellte Reservierung für eine zukünftige Reservierung kann automatisch von jeder VM mit übereinstimmenden Attributen genutzt werden. Wenn Sie verhindern möchten, dass eine VM eine dieser automatisch erstellten Reservierungen nutzt, lesen Sie den Hilfeartikel VMs erstellen, ohne Reservierungen zu verbrauchen.

Instanzvorlage angeben

Beachten Sie beim Erstellen einer Anfrage für eine zukünftige Reservierung durch Angabe einer Instanzvorlage Folgendes:

  • Sie müssen Ihre zukünftige Reservierungsanfrage in derselben Region und Zone erstellen, in der sich auch die Ressourcen in der Instanzvorlage befinden. Alle regionalen oder zonalen Ressourcen, die in einer Instanzvorlage angegeben sind, z. B. ein Maschinentyp oder ein Persistent Disk, schränken die Verwendung der Vorlage auf die Standorte ein, an denen sich diese Ressourcen befinden. Wenn Ihre Instanzvorlage beispielsweise ein vorhandenes Persistent Disk in der Zone us-central1-a angibt, müssen Sie Ihre vorausschauende Reservierungsanfrage in derselben Zone erstellen. Andernfalls schlägt das Erstellen der vorausschauenden Reservierungsanfrage fehl.

    Wenn Sie prüfen möchten, ob eine vorhandene Vorlage Ressourcen enthält, die die Vorlage an eine bestimmte Region oder Zone binden, rufen Sie die Details der Vorlage auf und suchen Sie nach Verweisen auf regionale oder zonale Ressourcen, die darin enthalten sind.

  • Wenn Sie die automatisch erstellten Reservierungen, die für eine zukünftige Reservierung bereitgestellt wurden, mit einer Nutzungszusicherung verknüpfen möchten, müssen Sie die Option zum automatischen Löschen deaktivieren. Weitere Informationen finden Sie unter Einschränkungen nach der Erstellung.

Nachdem Sie eine zukünftige Reservierungsanfrage erstellt haben, können Sie diese nicht mehr ändern, um die VM-Attribute der Vorlage zu überschreiben oder eine andere Vorlage anzugeben. Stattdessen müssen Sie eine neue zukünftige Reservierungsanfrage erstellen.

Wählen Sie eine der folgenden Optionen aus, um eine Reservierung für ein einzelnes Projekt durch Angabe einer vorhandenen Instanzvorlage zu erstellen:

Console

  1. Öffnen Sie in der Google Cloud Console die Seite Reservierungen.

    Zu „Reservierungen“

  2. Klicken Sie auf den Tab Zukünftige Reservierungen.

  3. Klicken Sie auf Zukünftige Reservierung erstellen.

    Die Seite Zukünftige Reservierung erstellen wird geöffnet.

  4. Geben Sie unter Name einen Namen für die zukünftige Reservierungsanfrage ein.

  5. Geben Sie unter Präfix ein Namenspräfix ein. Der Name jeder automatisch erstellten Reservierung aus dieser zukünftigen Reservierungsanfrage beginnt mit diesem Präfix.

  6. Wählen Sie als Region und Zone die Region und Zone aus, in der Sie Ressourcen reservieren möchten.

  7. Geben Sie unter Beginn eine Startzeit für den Reservierungszeitraum ein. Der Beginn darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie eine zukünftige Reservierungsanfrage zur Prüfung einreichen. Damit genügend Zeit bleibt, um die zukünftige Reservierung vor Eingabe der Sperrzeit optional zu ändern, zu stornieren oder zu löschen, müssen Sie einen empfohlenen Wert für die Startzeit angeben.

  8. Geben Sie unter Ende ein Ende für den Reservierungszeitraum ein. Der Reservierungszeitraum muss mindestens 24 Stunden dauern.

    Im Abschnitt Dauer – Zusammenfassung sehen Sie die Länge des Reservierungszeitraums. Wenn Sie die Wahrscheinlichkeit erhöhen möchten, dass Google Cloud Ihre zukünftige Reservierungsanfrage nach der Überprüfung genehmigt, geben Sie einen empfohlenen Wert für den Reservierungszeitraum an.

  9. Wählen Sie im Abschnitt Freigabetyp die Option Lokal aus, falls sie noch nicht ausgewählt ist.

  10. Geben Sie unter Anzahl der VM-Instanzen die Gesamtzahl der VMs ein, die für den Zeitraum, die VM-Konfiguration und die Projekte, die in dieser zukünftigen Reservierungsanfrage angegeben sind, reserviert werden sollen.

  11. Führen Sie im Abschnitt Maschinenkonfiguration die folgenden Schritte aus:

    1. Wählen Sie Instanzvorlage verwenden aus.

    2. Wählen Sie unter Instanzvorlage die gewünschte Instanzvorlage aus. Wenn Sie eine regionale Instanzvorlage auswählen, können Sie Ressourcen nur innerhalb der Region reservieren, in der sich die Vorlage befindet.

  12. Führen Sie im Abschnitt Zeit für das automatische Löschen von automatisch generierten Reservierungen einen der folgenden Schritte aus:

    • So aktivieren Sie in Compute Engine das automatische Löschen der automatisch erstellten Reservierungen für Ihre zukünftige Reservierungsanfrage:

      1. Klicken Sie auf die Ein/Aus-Schaltfläche Automatisches Löschen aktivieren, um die Position „Ein“ festzulegen, falls dies noch nicht geschehen ist.

      2. Optional: Geben Sie unter Zeit bis zum automatischen Löschen ein Datum und eine Uhrzeit für das Löschen der automatisch erstellten Reservierungen ein. Das Datum und die Uhrzeit müssen nach der Endzeit des Reservierungszeitraums liegen. Wenn Sie dieses Feld leer lassen, werden die automatisch erstellten Reservierungen innerhalb von zwei Stunden nach dem Ende des Reservierungszeitraums gelöscht.

    • Klicken Sie andernfalls auf die Ein/Aus-Schaltfläche Automatisches Löschen aktivieren, um die Position „Aus“ festzulegen.

  13. Klicken Sie auf Entwurf speichern, um den Entwurf der zukünftigen Reservierungsanfrage fertigzustellen.

Die Seite Reservierungen wird geöffnet. Das Erstellen der zukünftige Reservierungsanfrage kann bis zu einer Minute dauern.

gcloud

Verwenden Sie den Befehl gcloud beta compute future-reservations create, um eine zukünftige Reservierungsanfrage für ein einzelnes Projekt zu erstellen. Geben Sie dazu eine Instanzvorlage an.

Wenn Sie einen Entwurf einer Anfrage für eine zukünftige Reservierung erstellen möchten, indem Sie eine Instanzvorlage ohne optionale Flags angeben, und die automatisch erstellte Reservierung am Ende des Reservierungszeitraums automatisch löschen möchten, führen Sie den folgenden Befehl aus:

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Ersetzen Sie dabei Folgendes:

  • FUTURE_RESERVATION_NAME: der Name der zukünftigen Reservierungsanfrage.

  • MACHINE_TYPE: der Maschinentyp, der für jede reservierte VM verwendet werden soll.

  • PROJECT_ID: die ID des Projekts, in dem Sie Ressourcen reservieren möchten und in dem sich die Instanzvorlage befindet.

  • LOCATION: der Speicherort der Instanzvorlage. Geben Sie einen der folgenden Werte an:

    • Für eine regionale Instanzvorlage: regions/REGION. Ersetzen Sie REGION durch die Region, in der sich die Instanzvorlage befindet. Wenn Sie eine regionale Instanzvorlage angeben, können Sie die Anfrage für die zukünftige Reservierung nur in derselben Region erstellen wie die Vorlage.

    • Für eine globale Instanzvorlage: global

  • INSTANCE_TEMPLATE_NAME: der Name einer vorhandenen Instanzvorlage.

  • START_TIME: der Beginn des Reservierungszeitraums als RFC 3339-Zeitstempel, der so formatiert sein muss:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Ersetzen Sie dabei Folgendes:

    • YYYY-MM-DD: ein Datum, formatiert als vierstelliges Jahr, zweistelliger Monat und zweistelliger Tag des Monats und durch Bindestriche (-) getrennt.

    • HH:MM:SS: eine Uhrzeit, die als zweistellige Stundenzahl im 24-Stunden-Format, zweistellige Minuten und zweistellige Sekunden formatiert und durch Doppelpunkte getrennt (:) ist.

    • OFFSET: die Zeitzone formatiert als Versatz der koordinierten Weltzeit (Coordinated Universal Time, UTC). Wenn Sie beispielsweise Pacific Standard Time (PST) verwenden möchten, geben Sie -08:00 an. Wenn Sie keinen Versatz verwenden möchten, geben Sie Z an.

    Der Beginn darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie eine zukünftige Reservierungsanfrage zur Prüfung einreichen. Damit genügend Zeit bleibt, um eine zukünftige Reservierungsanfrage nach der Genehmigung oder vor Eingabe der Sperrzeit optional zu stornieren, zu löschen oder zu ändern, müssen Sie einen empfohlenen Wert für die Startzeit angeben.

  • END_TIME: das Ende des Reservierungszeitraums, formatiert als RFC 3339-Zeitstempel. Der Reservierungszeitraum muss mindestens 24 Stunden dauern. Alternativ können Sie das Flag --end-time durch das Flag --duration=END_DURATION ersetzen. Ersetzen Sie END_DURATION durch die Dauer des Reservierungszeitraums in Sekunden. Geben Sie beispielsweise 1209600 für 1.209.600 Sekunden (14 Tage) an.

    Wenn Sie die Wahrscheinlichkeit erhöhen möchten, dass Google Cloud eine zukünftige Reservierungsanfrage genehmigt, nachdem Sie sie zur Überprüfung eingereicht haben, geben Sie eine empfohlene Mindestdauer an.

  • TOTAL_COUNT: die Gesamtzahl der VMs, die Sie reservieren möchten.

  • ZONE: die Zone, in der Ressourcen reserviert werden sollen.

Angenommen, Sie möchten einen Entwurf für eine zukünftige Reservierungsanfrage namens fr-01 in Zone us-central1-a mit den folgenden Eigenschaften erstellen:

  • Ein Reservierungszeitraum, der am 10. November 2024 um Mitternacht (UTC) beginnt und am 10. Dezember 2024 um Mitternacht (UTC) endet.

  • Insgesamt 80 VMs.

  • Eine regionale Instanzvorlage aus der Region us-central1.
  • Die Option zum automatischen Löschen ist aktiviert. Die automatisch erstellten Reservierungen werden am Ende des Reservierungszeitraums gelöscht.

Führen Sie den folgenden Befehl aus, um fr-01 zu erstellen:

gcloud beta compute future-reservations create fr-01 \
    --auto-delete-auto-created-reservations \
    --source-instance-template=projects/example-project/regions/us-central1/instanceTemplates/example-template \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

Optional können Sie eine oder mehrere der folgenden Optionen angeben:

  • Wenn Sie die automatisch erstellten Reservierungen nach dem Ende des Reservierungszeitraums löschen möchten, wählen Sie eine der folgenden Methoden aus:

    • Wenn Sie die automatisch erstellten Reservierungen zu einem bestimmten Datum und einer bestimmten Uhrzeit nach dem Ende des Reservierungszeitraums löschen möchten, fügen Sie das Flag --auto-created-reservations-delete-time hinzu.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

      Ersetzen Sie AUTO_CREATED_RESERVATIONS_DELETE_TIME durch ein Datum und eine Uhrzeit im RFC 3339-Zeitstempel.

    • Wenn Sie die automatisch erstellten Reservierungen nach einer bestimmten Dauer nach dem Ende des Reservierungszeitraums löschen möchten, geben Sie das Flag --auto-created-reservations-duration an.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

      Ersetzen Sie DURATION_BEFORE_DELETE durch eine Dauer in Tagen, Stunden, Minuten oder Sekunden. Geben Sie beispielsweise 30m für 30 Minuten oder 1d2h3m4s für einen Tag, zwei Stunden, drei Minuten und vier Sekunden an.

  • Wenn Sie die Option zum automatischen Löschen für die automatisch erstellten Reservierungen deaktivieren möchten, ersetzen Sie das Flag --auto-delete-auto-created-reservations durch das Flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

  • Wenn Sie ein Namenspräfix für die automatisch erstellten Reservierungen angeben möchten, fügen Sie das Flag --name-prefix hinzu.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --name-prefix=NAME_PREFIX \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Ersetzen Sie NAME_PREFIX durch das Namenspräfix für jede automatisch erstellte Reservierung. Geben Sie ein eindeutiges Namenspräfix an, um die automatisch erstellten Reservierungen für diese zukünftige Reservierungsanfrage zu identifizieren.

REST

Wenn Sie eine zukünftige Reservierungsanfrage für ein einzelnes Projekt erstellen möchten, indem Sie eine Instanzvorlage angeben, stellen Sie eine POST-Anfrage an die Methode beta.futureReservations.insert.

Um einen Entwurf einer zukünftigen Reservierungsanfrage zu erstellen, indem Sie eine Instanzvorlage angeben, ohne optionale Felder einzubeziehen, stellen Sie eine POST-Anfrage so:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Ersetzen Sie dabei Folgendes:

  • PROJECT_ID: die ID des Projekts, in dem Sie Ressourcen reservieren möchten und in dem sich die Instanzvorlage befindet.

  • ZONE: die Zone, in der Ressourcen reserviert werden sollen.

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Wenn Sie dieses Feld auf true setzen, löscht die Compute Engine automatisch die automatisch erstellten Reservierungen für diese zukünftige Reservierung innerhalb von zwei Stunden nach dem Ende des Reservierungszeitraums. Wenn Sie Ihre automatisch erstellten Reservierungen an eine Zusicherung anhängen möchten, legen Sie für dieses Feld false fest.

  • LOCATION: der Speicherort der Instanzvorlage. Geben Sie einen der folgenden Werte an:

    • Für eine regionale Instanzvorlage: regions/REGION. Ersetzen Sie REGION durch die Region, in der sich die Instanzvorlage befindet. Wenn Sie eine regionale Instanzvorlage angeben, können Sie die Anfrage für die zukünftige Reservierung nur in derselben Region erstellen wie die Vorlage.

    • Für eine globale Instanzvorlage: global

  • INSTANCE_TEMPLATE_NAME: der Name einer vorhandenen Instanzvorlage.

  • TOTAL_COUNT: die Gesamtzahl der VMs, die Sie reservieren möchten.

  • START_TIME: der Beginn des Reservierungszeitraums als RFC 3339-Zeitstempel, der so formatiert sein muss:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Ersetzen Sie dabei Folgendes:

    • YYYY-MM-DD: ein Datum, formatiert als vierstelliges Jahr, zweistelliger Monat und zweistelliger Tag des Monats und durch Bindestriche (-) getrennt.

    • HH:MM:SS: eine Uhrzeit, die als zweistellige Stundenzahl im 24-Stunden-Format, zweistellige Minuten und zweistellige Sekunden formatiert und durch Doppelpunkte getrennt (:) ist.

    • OFFSET: die Zeitzone formatiert als Versatz der koordinierten Weltzeit (Coordinated Universal Time, UTC). Wenn Sie beispielsweise Pacific Standard Time (PST) verwenden möchten, geben Sie -08:00 an. Wenn Sie keinen Versatz verwenden möchten, geben Sie Z an.

    Der Beginn darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie eine zukünftige Reservierungsanfrage zur Prüfung einreichen. Damit genügend Zeit bleibt, um eine zukünftige Reservierungsanfrage nach der Genehmigung oder vor Eingabe der Sperrzeit optional zu stornieren, zu löschen oder zu ändern, müssen Sie einen empfohlenen Wert für die Startzeit angeben.

  • END_TIME: das Ende des Reservierungszeitraums, formatiert als RFC 3339-Zeitstempel. Der Reservierungszeitraum muss mindestens 24 Stunden dauern. Alternativ können Sie das Feld endTime durch das Feld duration ersetzen, um eine bestimmte Dauer ab dem Beginn des Reservierungszeitraums anzugeben:

    "duration": {
  "seconds": END_DURATION
}

    Ersetzen Sie END_DURATION durch die Dauer in Sekunden. Geben Sie beispielsweise 1209600 für 1.209.600 Sekunden (14 Tage) an.

    Wenn Sie die Wahrscheinlichkeit erhöhen möchten, dass Google Cloud eine zukünftige Reservierungsanfrage genehmigt, nachdem Sie sie zur Überprüfung eingereicht haben, geben Sie einen der empfohlenen Werte für Ihren Reservierungszeitraum an.

Angenommen, Sie möchten einen Entwurf für eine zukünftige Reservierungsanfrage namens fr-01 in Zone us-central1-a mit den folgenden Eigenschaften erstellen:

  • Ein Reservierungszeitraum, der am 10. November 2024 um Mitternacht (UTC) beginnt und am 10. Dezember 2024 um Mitternacht (UTC) endet.

  • Insgesamt 80 VMs.

  • Eine regionale Instanzvorlage aus der Region us-central1.
  • Die Option zum automatischen Löschen ist aktiviert. Die automatisch erstellten Reservierungen werden am Ende des Reservierungszeitraums gelöscht.

So erstellst du fr-01: Stelle eine POST-Anfrage:

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-01",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/example-project/regions/us-central1/instanceTemplates/example-template",
    "totalCount": 80
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

Optional können Sie eine oder mehrere der folgenden Optionen angeben:

  • Wenn Sie ein Namenspräfix für die automatisch erstellten Reservierungen angeben möchten, fügen Sie das Feld namePrefix ein.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Ersetzen Sie NAME_PREFIX durch das Namenspräfix für jede automatisch erstellte Reservierung. Geben Sie ein eindeutiges Namenspräfix an, um die automatisch erstellten Reservierungen für diese zukünftige Reservierungsanfrage zu identifizieren.

  • Wenn Sie die automatisch erstellten Reservierungen nach dem Ende des Reservierungszeitraums löschen möchten, wählen Sie eine der folgenden Methoden aus:

    • Wenn Sie die automatisch erstellten Reservierungen zu einem bestimmten Zeitpunkt nach dem Ende Ihres Reservierungszeitraums löschen möchten, setzen Sie autoDeleteAutoCreatedReservations auf true und schließen Sie das Feld autoCreatedReservationsDeleteTime mit ein.

      POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

      Ersetzen Sie DELETE_TIME durch ein Datum und eine Uhrzeit, zu der Compute Engine die automatisch erstellten Reservierungen löscht. Datum und Uhrzeit müssen als RFC 3339-Zeitstempel formatiert sein.

    • Wenn Sie die automatisch erstellten Reservierungen nach einer bestimmten Dauer ab dem Beginn des Reservierungszeitraums löschen möchten, setzen Sie autoDeleteAutoCreatedReservations auf true und schließen das Feld autoCreatedReservationsDuration mit ein.

      POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

      Ersetzen Sie DURATION_BEFORE_DELETE durch die Dauer in Sekunden. Geben Sie beispielsweise 604800 für 604.800 Sekunden (7 Tage) an.

Nachdem Sie einen Entwurf für eine Anfrage für eine zukünftige Reservierung erstellt haben, können Sie die Anzahl der VMs festlegen, die die Compute Engine für die Anfrage bereitstellen soll.

Vorhandene VM angeben

Sie können nur einen Entwurf einer zukünftigen Reservierungsanfrage basierend auf einer vorhandenen VM in derselben Zone wie die VM erstellen.

Nachdem die Anfrage für eine zukünftige Reservierung von Google Cloud genehmigt wurde und der Reservierungszeitraum begonnen hat, können Sie die automatisch erstellten Reservierungen nutzen, indem Sie VMs mit Attributen erstellen, die mit der Referenz-VM übereinstimmen. Dazu können Sie eines der folgenden Dinge tun:

So erstellen Sie eine Anfrage für eine vorausschauende Reservierung für ein einzelnes Projekt, bei der die Attribute einer vorhandenen VM verwendet werden:

  1. Öffnen Sie in der Google Cloud Console die Seite Reservierungen.

    Zu „Reservierungen“

  2. Klicken Sie auf den Tab Zukünftige Reservierungen.

  3. Klicken Sie auf Zukünftige Reservierung erstellen.

    Die Seite Zukünftige Reservierung erstellen wird geöffnet.

  4. Geben Sie unter Name einen Namen für die zukünftige Reservierungsanfrage ein.

  5. Geben Sie unter Präfix ein Namenspräfix ein. Der Name jeder automatisch erstellten Reservierung aus dieser zukünftigen Reservierungsanfrage beginnt mit diesem Präfix.

  6. Wählen Sie als Region und Zone die Region und Zone aus, in der Sie Ressourcen reservieren möchten.

  7. Geben Sie unter Beginn eine Startzeit für den Reservierungszeitraum ein. Der Beginn darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie eine zukünftige Reservierungsanfrage zur Prüfung einreichen. Damit genügend Zeit bleibt, um die zukünftige Reservierung vor Eingabe der Sperrzeit optional zu ändern, zu stornieren oder zu löschen, müssen Sie einen empfohlenen Wert für die Startzeit angeben.

  8. Geben Sie unter Ende ein Ende für den Reservierungszeitraum ein. Der Reservierungszeitraum muss mindestens 24 Stunden dauern.

    Im Abschnitt Dauer – Zusammenfassung sehen Sie die Länge des Reservierungszeitraums. Wenn Sie die Wahrscheinlichkeit erhöhen möchten, dass Google Cloud Ihre zukünftige Reservierungsanfrage nach der Überprüfung genehmigt, geben Sie einen empfohlenen Wert für den Reservierungszeitraum an.

  9. Führen Sie im Abschnitt Freigabetyp folgende Schritte aus:

    1. Wählen Sie Freigegeben aus, um eine Anfrage für freigegebene zukünftige Reservierungen anzugeben.

    2. Klicken Sie auf Projekte hinzufügen und wählen Sie die Projekte aus der Organisation des aktuellen Projekts aus, für die Sie die zukünftige Reservierungsanfrage freigeben möchten. Sie können bis zu 100 Projekte auswählen.

  10. Geben Sie unter Anzahl der VM-Instanzen die Gesamtzahl der VMs ein, die für den Zeitraum, die VM-Konfiguration und die Projekte, die in dieser zukünftigen Reservierungsanfrage angegeben sind, reserviert werden sollen.

  11. Führen Sie im Abschnitt Maschinenkonfiguration die folgenden Schritte aus:

    1. Wählen Sie Vorhandene VM verwenden aus.

    2. Wählen Sie unter Vorhandene VM die VM mit den Attributen aus, die Sie zum Erstellen der Reservierung verwenden möchten.

  12. Führen Sie im Abschnitt Zeit für das automatische Löschen von automatisch generierten Reservierungen einen der folgenden Schritte aus:

    • So aktivieren Sie in Compute Engine das automatische Löschen der automatisch erstellten Reservierungen für Ihre zukünftige Reservierungsanfrage:

      1. Klicken Sie auf die Ein/Aus-Schaltfläche Automatisches Löschen aktivieren, um die Position „Ein“ festzulegen, falls dies noch nicht geschehen ist.

      2. Optional: Geben Sie unter Zeit bis zum automatischen Löschen ein Datum und eine Uhrzeit für das Löschen der automatisch erstellten Reservierungen ein. Das Datum und die Uhrzeit müssen nach der Endzeit des Reservierungszeitraums liegen. Wenn Sie dieses Feld leer lassen, werden die automatisch erstellten Reservierungen innerhalb von zwei Stunden nach dem Ende des Reservierungszeitraums gelöscht.

    • Klicken Sie andernfalls auf die Ein/Aus-Schaltfläche Automatisches Löschen aktivieren, um die Position „Aus“ festzulegen.

  13. Klicken Sie auf Entwurf speichern, um den Entwurf der zukünftigen Reservierungsanfrage fertigzustellen.

Die Seite Reservierungen wird geöffnet. Das Erstellen der zukünftige Reservierungsanfrage kann bis zu einer Minute dauern.

Nachdem Sie einen Entwurf für eine Anfrage für eine zukünftige Reservierung erstellt haben, können Sie die Anzahl der VMs festlegen, die die Compute Engine für die Anfrage bereitstellen soll.

VM-Attribute direkt angeben

Wenn Sie die automatisch erstellten Reservierungen, die für eine zukünftige Reservierung bereitgestellt wurden, mit einer Nutzungszusicherung verknüpfen möchten, müssen Sie die Option zum automatischen Löschen deaktivieren. Weitere Informationen finden Sie unter Einschränkungen nach der Erstellung.

Wenn Sie eine zukünftige Reservierung für ein einzelnes Projekt erstellen möchten, indem Sie Attribute direkt angeben, wählen Sie eine der folgenden Optionen aus:

Console

  1. Öffnen Sie in der Google Cloud Console die Seite Reservierungen.

    Zu „Reservierungen“

  2. Klicken Sie auf den Tab Zukünftige Reservierungen.

  3. Klicken Sie auf Zukünftige Reservierung erstellen.

    Die Seite Zukünftige Reservierung erstellen wird geöffnet.

  4. Geben Sie unter Name einen Namen für die zukünftige Reservierungsanfrage ein.

  5. Geben Sie unter Präfix ein Namenspräfix ein. Der Name jeder automatisch erstellten Reservierung aus dieser zukünftigen Reservierungsanfrage beginnt mit diesem Präfix.

  6. Wählen Sie als Region und Zone die Region und Zone aus, in der Sie Ressourcen reservieren möchten.

  7. Geben Sie unter Beginn eine Startzeit für den Reservierungszeitraum ein. Der Beginn darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie eine zukünftige Reservierungsanfrage zur Prüfung einreichen. Damit genügend Zeit bleibt, um die zukünftige Reservierung vor Eingabe der Sperrzeit optional zu ändern, zu stornieren oder zu löschen, müssen Sie einen empfohlenen Wert für die Startzeit angeben.

  8. Geben Sie unter Ende ein Ende für den Reservierungszeitraum ein. Der Reservierungszeitraum muss mindestens 24 Stunden dauern.

    Im Abschnitt Dauer – Zusammenfassung sehen Sie die Länge des Reservierungszeitraums. Wenn Sie die Wahrscheinlichkeit erhöhen möchten, dass Google Cloud Ihre zukünftige Reservierungsanfrage nach der Überprüfung genehmigt, geben Sie einen empfohlenen Wert für den Reservierungszeitraum an.

  9. Wählen Sie im Abschnitt Freigabetyp die Option Lokal aus, falls sie noch nicht ausgewählt ist.

  10. Geben Sie unter Anzahl der VM-Instanzen die Gesamtzahl der VMs ein, die für den Zeitraum, die VM-Konfiguration und die Projekte, die in dieser zukünftigen Reservierungsanfrage angegeben sind, reserviert werden sollen.

  11. Führen Sie im Abschnitt Maschinenkonfiguration die folgenden Schritte aus:

    1. Wählen Sie Maschinentyp angeben aus, falls diese Option nicht bereits ausgewählt ist.

    2. Geben Sie den Maschinentyp an, der für die reservierten VMs verwendet werden soll.

  12. Führen Sie im Abschnitt Zeit für das automatische Löschen von automatisch generierten Reservierungen einen der folgenden Schritte aus:

    • So aktivieren Sie in Compute Engine das automatische Löschen der automatisch erstellten Reservierungen für Ihre zukünftige Reservierungsanfrage:

      1. Klicken Sie auf die Ein/Aus-Schaltfläche Automatisches Löschen aktivieren, um die Position „Ein“ festzulegen, falls dies noch nicht geschehen ist.

      2. Optional: Geben Sie unter Zeit bis zum automatischen Löschen ein Datum und eine Uhrzeit für das Löschen der automatisch erstellten Reservierungen ein. Das Datum und die Uhrzeit müssen nach der Endzeit des Reservierungszeitraums liegen. Wenn Sie dieses Feld leer lassen, werden die automatisch erstellten Reservierungen innerhalb von zwei Stunden nach dem Ende des Reservierungszeitraums gelöscht.

    • Klicken Sie andernfalls auf die Ein/Aus-Schaltfläche Automatisches Löschen aktivieren, um die Position „Aus“ festzulegen.

  13. Klicken Sie auf Entwurf speichern, um den Entwurf der zukünftigen Reservierungsanfrage fertigzustellen.

Die Seite Reservierungen wird geöffnet. Das Erstellen der zukünftige Reservierungsanfrage kann bis zu einer Minute dauern.

gcloud

Verwenden Sie den Befehl gcloud beta compute future-reservations create, um eine zukünftige Reservierungsanfrage für ein einzelnes Projekt zu erstellen, indem Sie Attribute direkt angeben.

Wenn Sie einen Entwurf einer Anfrage für eine zukünftige Reservierung erstellen möchten, indem Sie Attribute direkt angeben, ohne optionale Flags anzugeben, und die automatisch erstellte Reservierung am Ende des Reservierungszeitraums automatisch löschen möchten, führen Sie den folgenden Befehl aus:

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Ersetzen Sie dabei Folgendes:

  • FUTURE_RESERVATION_NAME: der Name der zukünftigen Reservierungsanfrage.

  • MACHINE_TYPE: der Maschinentyp, der für jede reservierte VM verwendet werden soll.

  • START_TIME: der Beginn des Reservierungszeitraums als RFC 3339-Zeitstempel, der so formatiert sein muss:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Ersetzen Sie dabei Folgendes:

    • YYYY-MM-DD: ein Datum, formatiert als vierstelliges Jahr, zweistelliger Monat und zweistelliger Tag des Monats und durch Bindestriche (-) getrennt.

    • HH:MM:SS: eine Uhrzeit, die als zweistellige Stundenzahl im 24-Stunden-Format, zweistellige Minuten und zweistellige Sekunden formatiert und durch Doppelpunkte getrennt (:) ist.

    • OFFSET: die Zeitzone formatiert als Versatz der koordinierten Weltzeit (Coordinated Universal Time, UTC). Wenn Sie beispielsweise Pacific Standard Time (PST) verwenden möchten, geben Sie -08:00 an. Wenn Sie keinen Versatz verwenden möchten, geben Sie Z an.

    Der Beginn darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie eine zukünftige Reservierungsanfrage zur Prüfung einreichen. Damit genügend Zeit bleibt, um eine zukünftige Reservierungsanfrage nach der Genehmigung oder vor Eingabe der Sperrzeit optional zu stornieren, zu löschen oder zu ändern, müssen Sie einen empfohlenen Wert für die Startzeit angeben.

  • END_TIME: das Ende des Reservierungszeitraums, formatiert als RFC 3339-Zeitstempel. Der Reservierungszeitraum muss mindestens 24 Stunden dauern. Alternativ können Sie das Flag --end-time durch das Flag --duration=END_DURATION ersetzen. Ersetzen Sie END_DURATION durch die Dauer des Reservierungszeitraums in Sekunden. Geben Sie beispielsweise 1209600 für 1.209.600 Sekunden (14 Tage) an.

    Wenn Sie die Wahrscheinlichkeit erhöhen möchten, dass Google Cloud eine zukünftige Reservierungsanfrage genehmigt, nachdem Sie sie zur Überprüfung eingereicht haben, geben Sie eine empfohlene Mindestdauer an.

  • TOTAL_COUNT: die Gesamtzahl der VMs, die Sie reservieren möchten.

  • ZONE: die Zone, in der Ressourcen reserviert werden sollen.

Angenommen, Sie möchten einen Entwurf für eine zukünftige Reservierungsanfrage namens fr-01 in Zone us-central1-a mit den folgenden Eigenschaften erstellen:

  • Ein Reservierungszeitraum, der am 10. November 2024 um Mitternacht (UTC) beginnt und am 10. Dezember 2024 um Mitternacht (UTC) endet.

  • Insgesamt 80 VMs.

  • Ein vordefinierter N2-Maschinentyp mit 4 vCPUs
  • Die Option zum automatischen Löschen ist aktiviert. Die automatisch erstellten Reservierungen werden am Ende des Reservierungszeitraums gelöscht.

Führen Sie den folgenden Befehl aus, um fr-01 zu erstellen:

gcloud beta compute future-reservations create fr-01 \
    --auto-delete-auto-created-reservations \
    --machine-type=n2-standard-4 \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

Optional können Sie eine oder mehrere der folgenden Optionen angeben:

  • Wenn Sie GPUs an Ihre reservierten N1-VMs anhängen möchten, fügen Sie das Flag --accelerator ein.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --accelerator=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Ersetzen Sie dabei Folgendes:

    • NUMBER_OF_ACCELERATORS: die Anzahl der GPUs, die pro reservierter VM hinzugefügt werden sollen.

    • ACCELERATOR_TYPE: ein unterstütztes GPU-Modell für N1-VMs. Achten Sie darauf, dass das ausgewählte GPU-Modell in der Zone verfügbar ist, in der Sie die Anfrage für eine zukünftige Reservierung erstellen, um Fehler zu vermeiden.

  • Wenn Sie die automatisch erstellten Reservierungen nach dem Ende des Reservierungszeitraums löschen möchten, wählen Sie eine der folgenden Methoden aus:

    • Wenn Sie die automatisch erstellten Reservierungen zu einem bestimmten Datum und einer bestimmten Uhrzeit nach dem Ende des Reservierungszeitraums löschen möchten, fügen Sie das Flag --auto-created-reservations-delete-time hinzu.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

      Ersetzen Sie AUTO_CREATED_RESERVATIONS_DELETE_TIME durch ein Datum und eine Uhrzeit im RFC 3339-Zeitstempel.

    • Wenn Sie die automatisch erstellten Reservierungen nach einer bestimmten Dauer nach dem Ende des Reservierungszeitraums löschen möchten, geben Sie das Flag --auto-created-reservations-duration an.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

      Ersetzen Sie DURATION_BEFORE_DELETE durch eine Dauer in Tagen, Stunden, Minuten oder Sekunden. Geben Sie beispielsweise 30m für 30 Minuten oder 1d2h3m4s für einen Tag, zwei Stunden, drei Minuten und vier Sekunden an.

  • Wenn Sie die Option zum automatischen Löschen für die automatisch erstellten Reservierungen deaktivieren möchten, ersetzen Sie das Flag --auto-delete-auto-created-reservations durch das Flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

  • Fügen Sie ein oder mehrere --local-ssd-Flags hinzu, um jeder reservierten VM ein oder mehrere lokale SSD-Laufwerke hinzuzufügen. Sie können bis zu 24 lokale SSDs angeben. Jede lokale SSD ist 375 GB groß.

    Wenn Sie beispielsweise beim Erstellen eines Entwurfs einer zukünftigen Reservierungsanfrage zwei lokale SSD-Laufwerke angeben möchten, fügen Sie zwei --local-ssd-Flags hinzu:

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Ersetzen Sie INTERFACE_1 und INTERFACE_2 durch den Schnittstellentyp, den das lokale SSD-Laufwerk verwenden soll:

    Der von Ihnen für die reservierten VMs angegebene Maschinentyp muss die ausgewählten Laufwerkschnittstellen unterstützen. Andernfalls schlägt das Erstellen der vorausschauenden Reservierungsanfrage fehl. Weitere Informationen finden Sie unter Laufwerkschnittstelle auswählen.

  • Damit die reservierten VMs eine bestimmte Mindest-CPU-Plattform anstelle der Standard-CPU-Plattform der Zone verwenden, fügen Sie das Flag --min-cpu-platform ein.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform="MIN_CPU_PLATFORM" \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Ersetzen Sie MIN_CPU_PLATFORM durch eine Mindest-CPU-Plattform. Um sicherzustellen, dass eine CPU-Plattform in der Zone verfügbar ist, in der Sie Ressourcen reservieren, rufen Sie die verfügbaren CPU-Plattformen nach Zone auf.

  • Wenn Sie ein Namenspräfix für die automatisch erstellten Reservierungen angeben möchten, fügen Sie das Flag --name-prefix hinzu.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --name-prefix=NAME_PREFIX \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Ersetzen Sie NAME_PREFIX durch das Namenspräfix für jede automatisch erstellte Reservierung. Geben Sie ein eindeutiges Namenspräfix an, um die automatisch erstellten Reservierungen für diese zukünftige Reservierungsanfrage zu identifizieren.

REST

Wenn Sie eine zukünftige Reservierungsanfrage für ein einzelnes Projekt erstellen möchten, indem Sie Attribute direkt angeben, senden Sie eine POST-Anfrage an die Methode beta.futureReservations.insert.

Wenn Sie einen Entwurf einer zukünftigen Reservierungsanfrage erstellen möchten, indem Sie Attribute direkt angeben, ohne optionale Felder einzubeziehen, stellen Sie eine POST-Anfrage wie unten beschrieben:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Ersetzen Sie dabei Folgendes:

  • PROJECT_ID: die ID des Projekts, in dem Sie Ressourcen reservieren möchten.

  • ZONE: die Zone, in der Ressourcen reserviert werden sollen.

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Wenn Sie dieses Feld auf true setzen, löscht die Compute Engine automatisch die automatisch erstellten Reservierungen für diese zukünftige Reservierung innerhalb von zwei Stunden nach dem Ende des Reservierungszeitraums. Wenn Sie Ihre automatisch erstellten Reservierungen an eine Zusicherung anhängen möchten, legen Sie für dieses Feld false fest.

  • TOTAL_COUNT: die Gesamtzahl der VMs, die Sie reservieren möchten.

  • START_TIME: der Beginn des Reservierungszeitraums als RFC 3339-Zeitstempel, der so formatiert sein muss:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Ersetzen Sie dabei Folgendes:

    • YYYY-MM-DD: ein Datum, formatiert als vierstelliges Jahr, zweistelliger Monat und zweistelliger Tag des Monats und durch Bindestriche (-) getrennt.

    • HH:MM:SS: eine Uhrzeit, die als zweistellige Stundenzahl im 24-Stunden-Format, zweistellige Minuten und zweistellige Sekunden formatiert und durch Doppelpunkte getrennt (:) ist.

    • OFFSET: die Zeitzone formatiert als Versatz der koordinierten Weltzeit (Coordinated Universal Time, UTC). Wenn Sie beispielsweise Pacific Standard Time (PST) verwenden möchten, geben Sie -08:00 an. Wenn Sie keinen Versatz verwenden möchten, geben Sie Z an.

    Der Beginn darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie eine zukünftige Reservierungsanfrage zur Prüfung einreichen. Damit genügend Zeit bleibt, um eine zukünftige Reservierungsanfrage nach der Genehmigung oder vor Eingabe der Sperrzeit optional zu stornieren, zu löschen oder zu ändern, müssen Sie einen empfohlenen Wert für die Startzeit angeben.

  • END_TIME: das Ende des Reservierungszeitraums, formatiert als RFC 3339-Zeitstempel. Der Reservierungszeitraum muss mindestens 24 Stunden dauern. Alternativ können Sie das Feld endTime durch das Feld duration ersetzen, um eine bestimmte Dauer ab dem Beginn des Reservierungszeitraums anzugeben:

    "duration": {
  "seconds": END_DURATION
}

    Ersetzen Sie END_DURATION durch die Dauer in Sekunden. Geben Sie beispielsweise 1209600 für 1.209.600 Sekunden (14 Tage) an.

    Wenn Sie die Wahrscheinlichkeit erhöhen möchten, dass Google Cloud eine zukünftige Reservierungsanfrage genehmigt, nachdem Sie sie zur Überprüfung eingereicht haben, geben Sie einen der empfohlenen Werte für Ihren Reservierungszeitraum an.

Angenommen, Sie möchten einen Entwurf für eine zukünftige Reservierungsanfrage namens fr-01 in Zone us-central1-a mit den folgenden Eigenschaften erstellen:

  • Ein Reservierungszeitraum, der am 10. November 2024 um Mitternacht (UTC) beginnt und am 10. Dezember 2024 um Mitternacht (UTC) endet.

  • Insgesamt 80 VMs.

  • Ein vordefinierter N2-Maschinentyp mit 4 vCPUs
  • Die Option zum automatischen Löschen ist aktiviert. Die automatisch erstellten Reservierungen werden am Ende des Reservierungszeitraums gelöscht.

So erstellst du fr-01: Stelle eine POST-Anfrage:

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-01",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "n2-standard-4"
    },
    "totalCount": 80
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

Optional können Sie eine oder mehrere der folgenden Optionen angeben:

  • Wenn Sie ein Namenspräfix für die automatisch erstellten Reservierungen angeben möchten, fügen Sie das Feld namePrefix ein.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Ersetzen Sie NAME_PREFIX durch das Namenspräfix für jede automatisch erstellte Reservierung. Geben Sie ein eindeutiges Namenspräfix an, um die automatisch erstellten Reservierungen für diese zukünftige Reservierungsanfrage zu identifizieren.

  • Wenn Sie GPUs an Ihre reservierten N1-VMs anhängen möchten, fügen Sie das Feld guestAccelerators ein.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Ersetzen Sie dabei Folgendes:

    • NUMBER_OF_ACCELERATORS: die Anzahl der GPUs, die pro reservierter VM hinzugefügt werden sollen.

    • ACCELERATOR_TYPE: ein unterstütztes GPU-Modell für N1-VMs. Achten Sie darauf, dass das ausgewählte GPU-Modell in der Zone verfügbar ist, in der Sie die Anfrage für eine zukünftige Reservierung erstellen, um Fehler zu vermeiden.

  • Wenn Sie jeder reservierten VM eine oder mehrere lokale SSD-Laufwerke hinzufügen möchten, fügen Sie das Feld localSsds ein. Sie können bis zu 24 lokale SSDs angeben. Jede lokale SSD ist 375 GB groß.

    Wenn Sie beispielsweise beim Erstellen eines Entwurfs einer zukünftigen Reservierungsanfrage zwei lokale SSD-Laufwerke angeben möchten, stellen Sie eine POST-Anfrage wie hier beschrieben:

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": {
    "instanceProperties": {
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Ersetzen Sie INTERFACE_1 und INTERFACE_2 durch den Schnittstellentyp, den die lokalen SSD-Laufwerke verwenden sollen:

    Der von Ihnen für die reservierten VMs angegebene Maschinentyp muss die ausgewählten Laufwerkschnittstellen unterstützen. Andernfalls schlägt das Erstellen der vorausschauenden Reservierungsanfrage fehl. Weitere Informationen finden Sie unter Laufwerkschnittstelle auswählen.

  • Damit die reservierten VMs eine bestimmte Mindest-CPU-Plattform anstelle der Standard-CPU-Plattform der Zone verwenden, fügen Sie minCpuPlatform ein.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Ersetzen Sie MIN_CPU_PLATFORM durch eine Mindest-CPU-Plattform. Um sicherzustellen, dass eine CPU-Plattform in der Zone verfügbar ist, in der Sie Ressourcen reservieren, rufen Sie die verfügbaren CPU-Plattformen nach Zone auf.

  • Wenn Sie die automatisch erstellten Reservierungen nach dem Ende des Reservierungszeitraums löschen möchten, wählen Sie eine der folgenden Methoden aus:

    • Wenn Sie die automatisch erstellten Reservierungen zu einem bestimmten Zeitpunkt nach dem Ende Ihres Reservierungszeitraums löschen möchten, setzen Sie autoDeleteAutoCreatedReservations auf true und schließen Sie das Feld autoCreatedReservationsDeleteTime mit ein.

      POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

      Ersetzen Sie DELETE_TIME durch ein Datum und eine Uhrzeit, zu der Compute Engine die automatisch erstellten Reservierungen löscht. Datum und Uhrzeit müssen als RFC 3339-Zeitstempel formatiert sein.

    • Wenn Sie die automatisch erstellten Reservierungen nach einer bestimmten Dauer ab dem Beginn des Reservierungszeitraums löschen möchten, setzen Sie autoDeleteAutoCreatedReservations auf true und schließen das Feld autoCreatedReservationsDuration mit ein.

      POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

      Ersetzen Sie DURATION_BEFORE_DELETE durch die Dauer in Sekunden. Geben Sie beispielsweise 604800 für 604.800 Sekunden (7 Tage) an.

Nachdem Sie einen Entwurf für eine zukünftige Reservierungsanfrage erstellt haben, können Sie die Anzahl der VMs festlegen, die die Compute Engine für die Anfrage bereitstellen soll.

Entwurfsanfrage senden

Nachdem eine zukünftige Reservierungsanfrage gesendet, von Google Cloud genehmigt und die Sperrzeit vergangen ist, können Sie die zukünftige Reservierung und ihre automatisch erstellten Reservierungen nur nach dem Ende des Reservierungszeitraums der zukünftigen Reservierung löschen. Das Löschen einer vorhandenen zukünftigen Reservierung ist nützlich, wenn Sie eine weitere zukünftige Reservierung mit denselben Eigenschaften erstellen möchten. Achten Sie daher vor dem Erstellen einer zukünftigen Reservierungsanfrage auf Folgendes:

  • Alle vorhandenen oder zukünftigen Reservierungen in einem Projekt schränken die Freigabeeinstellungen der zukünftigen Reservierungsanfrage ein, die Sie erstellen können. Informationen dazu, wie Sie erfolgreich eine zukünftige Reservierungsanfrage erstellen und dafür sorgen, dass die Anfrage keine Probleme in anderen Projekten verursacht, für die Sie zukünftige Reservierungsanfragen oder Reservierungen freigeben, finden Sie unter Einschränkungen.

  • Sie müssen sich dazu verpflichten, für die reservierten Ressourcen, die Compute Engine für den gesamten Reservierungszeitraum bereitstellt, zu zahlen, unabhängig davon, ob die automatisch erstellten Reservierungen verbraucht werden oder nicht. Weitere Informationen finden Sie in den Hilfeartikeln zur Abrechnung.

Wenn Sie auch ein oder mehrere Attribute ändern möchten, wenn Sie den Entwurf einer zukünftigen Reservierungsanfrage zur Prüfung senden, lesen Sie stattdessen den Artikel Anfragen für zukünftige Reservierungen ändern.

Wählen Sie eine der folgenden Optionen aus, um einen Entwurf einer zukünftigen Reservierungsanfrage zur Prüfung an Google Cloud zu senden:

Console

  1. Öffnen Sie in der Google Cloud Console die Seite Reservierungen.

    Zu „Reservierungen“

  2. Klicken Sie auf den Tab Zukünftige Reservierungen.

  3. Klicken Sie in der Spalte Name auf den Namen einer zukünftigen Reservierungsanfrage mit dem Beschaffungsstatus Entwurf.

    Die Seite zukünftige Reservierungen mit den Details der zukünftigen Reservierungsanfrage wird geöffnet.

  4. Klicken Sie auf  Entwurf bearbeiten.

    Die Seite zum Aktualisieren des Entwurfs für eine zukünftige Reservierungsanfrage wird geöffnet.

  5. Klicken Sie auf Senden, um den Entwurf der zukünftigen Reservierungsanfrage zur Prüfung einzureichen.

Die Seite Reservierung wird geöffnet. In der Spalte Status der zukünftigen Reservierungsanfrage, die Sie gerade gesendet haben, ist der Beschaffungsstatus auf Genehmigung ausstehend.

gcloud

Verwenden Sie zum Senden eines zukünftigen Reservierungsanfrageentwurfs zur Prüfung den Befehl gcloud beta compute future-reservations update, wobei das Flag --planning-status auf SUBMITTED gesetzt ist.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --planning-status=SUBMITTED \
    --zone=ZONE

Ersetzen Sie dabei Folgendes:

  • FUTURE_RESERVATION_NAME: der Name eines vorhandenen Reservierungsanfrageentwurfs.

  • ZONE: Die Zone, in der sich die zukünftige Reservierungsanfrage befindet.

REST

Wenn Sie einen zukünftigen Reservierungsanfrageentwurf zur Prüfung einreichen möchten, stellen Sie eine PATCH-Anfrage an die beta.futureReservations.update-Methode. Fügen Sie im Anfragetext das Feld planningStatus ein und legen Sie es auf SUBMITTED fest.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=planningStatus

{
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "SUBMITTED"
}

Ersetzen Sie dabei Folgendes:

  • PROJECT_ID: die ID des Projekts, in dem sich die zukünftige Reservierungsanfrage befindet.

  • ZONE: Die Zone, in der sich die zukünftige Reservierungsanfrage befindet.

  • FUTURE_RESERVATION_NAME: der Name eines vorhandenen Reservierungsanfrageentwurfs.

Nachdem Sie einen Entwurf einer zukünftigen Reservierungsanfrage zur Prüfung eingereicht haben, haben Sie folgende Möglichkeiten:

Fehlerbehebung

Wenn beim Erstellen einer zukünftigen Reservierungsanfrage Fehler auftreten, lesen Sie den Abschnitt zur Fehlerbehebung bei zukünftigen Reservierungsanfragen.

Sollten nach der Fehlerbehebung weiterhin Probleme auftreten, wenden Sie sich an Ihren Technical Account Manager oder das Vertriebsteam.

Nächste Schritte