Zukünftige Reservierungsanfragen ändern, stornieren oder löschen


In diesem Dokument wird erläutert, wie Sie zukünftige Reservierungsanfragen verwalten. Zum Beispiel:

  • Ändern Sie einen Entwurf oder eine gesendete Reservierungsanfrage, um eines oder mehrere seiner Attribute zu ändern.

  • Stornieren Sie eine zukünftige Reservierungsanfrage, um zu verhindern, dass Google Cloud sie prüft, oder beenden Sie eine genehmigte zukünftige Reservierung, wann sie nicht mehr gesperrt ist.

  • Löschen Sie eine zukünftige Reservierung, bevor sie die erforderliche Sperrzeit erreicht oder das Ende des Reservierungszeitraums erreicht ist.

Wenn Sie die automatisch erstellten Reservierungen für eine erfüllte zukünftige Reservierung nach Ablauf des Reservierungszeitraums verwalten möchten, lesen Sie stattdessen Folgendes:

Hinweise

  • 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. Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl:

      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.

        Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl:

        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 Berechtigung Compute-Administrator zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Ändern, Abbrechen oder Löschen Ihrer zukünftigen Reservierungsanfragen benötigen. (roles/compute.futureReservationAdmin) IAM-Rolle im Projekt. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Ändern, Abbrechen oder Löschen Ihrer zukünftigen Reservierungsanfragen erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Folgende Berechtigungen sind erforderlich, um zukünftige Reservierungsanfragen zu ändern, zu stornieren oder zu löschen:

  • So stornieren Sie eine zukünftige Reservierung: compute.futureReservations.cancel für das Projekt
  • So löschen Sie eine zukünftige Reservierung: compute.futureReservations.delete für das Projekt
  • So ändern einer zukünftigen Reservierung: compute.futureReservations.update für das Projekt

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

Einschränkungen

Zusätzlich zu den allgemeinen Einschränkungen für zukünftige Reservierungen gelten die folgenden Einschränkungen, wenn Sie zukünftige Reservierungen ändern, stornieren oder löschen:

  • Sie können eine zukünftige Reservierungsanfrage nur innerhalb des Projekts ändern, abbrechen oder löschen, in dem die zukünftige Reservierungsanfrage erstellt wurde. Auf diese Weise können Sie eine zukünftige Reservierungsanfrage für andere Projekte freigeben, aber Nutzer mit Berechtigungen nur für andere Projekte können diese zukünftige Reservierungsanfrage nicht ändern.

  • Sie können eine zukünftige Reservierungsanfrage nur ändern, stornieren oder löschen, wenn ihr Beschaffungsstatus dies zulässt. Weitere Informationen finden Sie in der folgenden Tabelle.

    Beschaffungsstatus Abbrechen Löschen Ändern
    Wird entworfen (DRAFTING)
    Genehmigung ausstehend (PENDING_APPROVAL)
    Genehmigt (APPROVED)
    Abgelehnt (DECLINED)
    Storniert (CANCELED)
    Wird beschafft (PROCURING)
    Wird bereitgestellt (PROVISIONING)
    Ausgeführt (FULFILLED) *
    Teilweise erfüllt (FAILED_PARTIALLY_FULFILLED) *
    Fehlgeschlagen (FAILED) *

    * Sie können eine erfüllte, teilweise erfüllte oder fehlgeschlagene zukünftige Reservierung erst nach ihrer Endzeit löschen.

Zukünftige Reservierungsanfragen ändern

Sie können eine zukünftige Reservierungsanfrage ändern, bevor sie den Beschaffungsstatus (Bereitstellung) (PROVISIONING) erreicht, solange sie nicht abgebrochen wird oder die Genehmigung aussteht. Beim Ändern einer zukünftigen Reservierungsanfrage können Sie die folgenden Attribute nicht ändern:

  • Für alle zukünftigen Reservierungen gilt:

    • Der Name der zukünftigen Reservierung.

    • Das Projekt, in dem die zukünftige Reservierungsanfrage erstellt wurde.

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

  • Für zukünftige Reservierungsanfragen, die durch Angabe einer Instanzvorlage erstellt wurden, gilt:

    • Sie können die in der Instanzvorlage angegebenen VM-Attribute nicht überschreiben.

    • Sie können die zum Erstellen einer zukünftigen Reservierungsanfrage verwendete Instanzvorlage nicht durch eine andere Vorlage ersetzen.

Wenn Sie eines dieser Attribute ändern möchten, müssen Sie eine neue zukünftige Reservierungsanfrage mit den gewünschten Aktualisierungen erstellen.

Wenn Sie andere Attribute ändern möchten, wählen Sie eine der folgenden Methoden aus:

  • Entwurf oder Ablehnung einer zukünftigen Reservierungsanfrage ändern

    In diesem Abschnitt wird erläutert, wie Sie eine zukünftige Reservierungsanfrage mit einem Beschaffungsstatus ändern, der auf "Entwurf" (DRAFTING) oder "Abgelehnt" (DECLINED) festgelegt ist.

  • Genehmigte oder zukünftige Reservierungen ändern

    In diesem Abschnitt wird erläutert, wie Sie eine zukünftige Reservierung ändern, wobei der Beschaffungsstatus auf „Genehmigt“ (APPROVED) oder „Beschaffen“ (PROCURING) festgelegt ist. Wenn Sie die Option zum automatischen Löschen, das Beschreibungs- oder Namenspräfix einer zukünftigen Reservierung ändern möchten, können Sie diese ohne Überprüfung ändern. Sie benötigen zum Ändern anderer Attribute die Genehmigung von Google Cloud.

Entwurf oder abgelehnte zukünftige Anfrage bearbeiten

Wenn Sie eine Entwurfsanfrage für eine zukünftige Reservierung ändern, können Sie Ihre Änderungen speichern oder die aktualisierte zukünftige Reservierungsanfrage zur Prüfung an Google Cloud senden. Wenn Sie stattdessen eine abgelehnte Reservierungsanfrage ändern, müssen Sie die Anfrage zur Überprüfung einreichen.

Wählen Sie eine der folgenden Methoden aus, um die Attribute eines Entwurfs oder einer abgelehnten zukünftigen Reservierungsanfrage zu ändern:

Entwurf oder abgelehnte zukünftige Reservierung ändern, indem Sie eine Instanzvorlage angeben

Für eine zukünftige Reservierungsanfrage, die durch Angabe einer Instanzvorlage mit dem Beschaffungsstatus "Entwurf" (DRAFTING) oder "Abgelehnt" (DECLINED) erstellt wurde, können Sie die folgenden Attribute ändern:

  • Automatisch löschen

  • Beschreibung

  • Namenspräfix

  • Freigabeeinstellungen

  • Start- und Endzeit des Reservierungszeitraums

  • Gesamtzahl (Zahl der VMs)

Sie können einen Entwurf für oder eine abgelehnte zukünftige Reservierungsanfrage ändern, die durch Angabe einer Instanzvorlage erstellt wurde, mit der Google Cloud Console, der gcloud CLI und REST ändern.

Console

Wenn Sie Google Cloud bitten möchten, einen Entwurf oder eine Ablehnung einer zukünftigen Reservierungsanfrage zu ändern, die durch Angabe einer Instanzvorlage erstellt wurde, gehen Sie so vor:

  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 der zukünftigen Reservierungsanfrage, die Sie ändern möchten.

    Die Detailseite der ausgewählten zukünftigen Reservierungsanfrage wird geöffnet.

  4. Klicken Sie zum Ändern der zukünftigen Reservierungsanfrage auf Bearbeiten oder Entwurf bearbeiten.

    Die Seite zum Bearbeiten der ausgewählten zukünftigen Reservierungsanfrage wird geöffnet.

  5. Führen Sie einen oder mehrere der folgenden Schritte aus:

    • Geben Sie im Feld Präfix ein neues Namenspräfix ein.

    • Geben Sie in das Feld Beschreibung eine neue Beschreibung ein.

    • Ändern Sie die Startzeit oder die Endzeit für Ihre zukünftige Reservierungsanfrage. Folgende Punkte sollten beachtet werden:

      • Die Startzeit darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie eine zukünftige Reservierungsanfrage zur Überprüfung senden.

      • Geben Sie einen empfohlenen Wert für die Startzeit an, damit genügend Zeit bleibt, bevor die zukünftige Reservierung die Sperrzeit erreicht.

      • Geben Sie einen empfohlenen Mindestreservierungszeitraum an, um die Wahrscheinlichkeit zu erhöhen, dass Google Cloud Ihre Anfrage nach der Überprüfung genehmigt.

    • Im Abschnitt Freigabetyp können Sie entweder Lokal oder Freigegeben auswählen. Wenn Sie Freigegeben auswählen, können Sie Projekte hinzufügen oder entfernen, für die die zukünftige Reservierungsanfrage freigegeben werden soll.

      Sie können bis zu 100 Projekte auswählen. Diese Projekte müssen sich in derselben Organisation wie das Projekt befinden, in dem die zukünftige Reservierungsanfrage erstellt wurde (das Inhaberprojekt). Geben Sie nicht das Inhaberprojekt an. Standardmäßig ist es zulässig, die automatisch erstellten freigegebenen Reservierungen für diese zukünftige Reservierungsanfrage zu nutzen.

    • Geben Sie in 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.

      Bei der Berechnung der Anzahl der Reservierungen, die für eine genehmigte zukünftige Reservierung erstellt werden sollen, prüft Compute Engine zuerst auf vorhandene Reservierungen. Wenn bereits Reservierungen vorhanden sind, die mit der genehmigten zukünftigen Reservierung übereinstimmen, wird die Anzahl der vorhandenen Reservierungen von der angeforderten Gesamtzahl der Reservierungen in der Anfrage subtrahiert, um die Anzahl der neuen Reservierungen zu ermitteln, die Compute Engine erstellt. Weitere Informationen finden Sie unter Reservierte Ressourcen zählen und bereitstellen.

    • Im Abschnitt Automatisch generierte Reservierungen automatisch löschen können Sie das automatische Löschen automatisch erstellter Reservierungen für Ihre zukünftige Reservierungsanfrage aktivieren oder deaktivieren.

      Optional. Wenn Sie die Option zum automatischen Löschen aktivieren, können Sie das Datum und die Uhrzeit angeben, zu der Compute Engine die automatisch erstellten Reservierungen löscht. Das Datum und die Uhrzeit müssen nach dem Ende 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.

  6. Führen Sie je nach dem Beschaffungsstatus der zukünftigen Reservierungsanfrage, die Sie ändern, einen der folgenden Schritte aus:

    • Wählen Sie für einen zukünftigen Reservierungsanfrageentwurf eine der folgenden Optionen aus:

      • Klicken Sie zum Speichern der Änderungen auf Entwurf speichern

      • Klicken Sie auf Senden, um die zukünftige Reservierungsanfrage zur Prüfung an Google Cloud zu senden.

    • Bei einer abgelehnten zukünftigen Reservierungsanfrage können Sie diese nur zur Überprüfung einreichen, indem Sie auf Senden klicken.

      Wenn Sie eine Anfrage senden, wird die Seite Reservierungen geöffnet. Andernfalls wird die Detailseite der zukünftigen Reservierungsanfrage geöffnet.

gcloud

Wenn Sie möchten, dass Google Cloud einen Entwurf einer abgelehnten Reservierungsanfrage ändert oder eine abgelehnte zukünftige Anfrage ändert, indem Sie eine Instanzvorlage angeben, verwenden Sie den Befehl gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • FUTURE_RESERVATION_NAME: der Name eines vorhandenen Entwurfs oder einer abgelehnten Reservierungsanfrage.
  • DESCRIPTION: Optional. Eine neue Beschreibung für die zukünftige Reservierungsanfrage.
  • NAME_PREFIX: Optional. Ein neues Namenspräfix für die zukünftige Reservierungsanfrage. Der Name jeder automatisch erstellten Reservierung für diese zukünftige Reservierungsanfrage beginnt mit dem Namenspräfix. Geben Sie ein eindeutiges Namenspräfix an, um die automatisch erstellten Reservierungen für diese zukünftige Reservierungsanfrage zu identifizieren.
  • PLANNING_STATUS: der Planungsstatus der zukünftigen Reservierungsanfrage. Sie können nur SUBMITTED angeben. Dadurch wird die zukünftige Reservierungsanfrage zur Prüfung an Google Cloud gesendet.

  • PROJECT_ID: Optional. Die ID des Projekts, in dem die zukünftige Reservierungsanfrage erstellt wurde. Wenn Sie eine zukünftige Reservierungsanfrage für ein einzelnes Projekt in eine freigegebene zukünftige Reservierungsanfrage ändern, wird dieses Projekt zum Inhaberprojekt der zukünftigen Reservierungsanfrage. Wenn Sie das Flag --project weglassen, wird der Wert auf die ID des aktuellen Projekts festgelegt.
  • SHARE_SETTING: Optional. Geben Sie einen der folgenden Werte an, um den Typ dieser zukünftigen Reservierungsanfrage zu ändern:

    • Geben Sie projects an, um eine zukünftige Reservierungsanfrage für ein einzelnes Projekt in eine freigegebene zukünftige Reservierungsanfrage zu ändern. Geben Sie mindestens ein Nutzerprojekt mit dem Flag --share-with an. Andernfalls schlägt das Ändern der zukünftigen Reservierung fehl.

    • Andernfalls geben Sie local an.

  • CONSUMER_PROJECT_IDS: Optional. Eine durch Kommas getrennte Liste der Projekt-IDs von Projekten, für die diese zukünftige Reservierungsanfrage freigegeben werden kann. Geben Sie beispielsweise project-1,project-2 an: Sie können bis zu 100 Projekte angeben. Diese Projekte müssen sich in derselben Organisation wie das Projekt befinden, in dem diese zukünftige Reservierungsanfrage erstellt wurde (das Inhaberprojekt). Geben Sie nicht das Inhaberprojekt an. Standardmäßig ist es zulässig, die automatisch erstellten freigegebenen Reservierungen für diese zukünftige Reservierungsanfrage zu nutzen.

  • START_TIME: Optional. Der neue Beginn des Reservierungszeitraums, formatiert als RFC 3339-Zeitstempel, der so aussehen muss:

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    Ersetzen Sie 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 die Pacific Standard Time (PST) verwenden möchten, geben Sie -08:00 an. Wenn Sie keinen Offset verwenden möchten, geben Sie Z an.

    Die Startzeit darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie eine zukünftige Reservierungsanfrage zur Überprüfung senden. Wenn Sie genügend Zeit haben, um eine zukünftige Reservierung nach der Genehmigung oder vor der Eingabe ihrer Sperrzeit optional zu stornieren, zu löschen oder zu ändern, müssen Sie eine empfohlene Startzeit angeben.

  • END_TIME: Optional. Die neue Endzeit 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, wobei END_DURATION die Dauer des Reservierungszeitraums in Sekunden ist. 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.

  • TOTAL_COUNT: Optional. Die neue Gesamtzahl der VMs, die Sie für den in dieser zukünftigen Reservierungsanfrage angegebenen Zeitraum reservieren möchten, die VM-Konfiguration und die Projekte.

    Bei der Berechnung der Anzahl der Reservierungen, die für eine genehmigte zukünftige Reservierung erstellt werden sollen, prüft Compute Engine zuerst auf vorhandene Reservierungen. Wenn bereits Reservierungen vorhanden sind, die mit der genehmigten zukünftigen Reservierung übereinstimmen, wird die Anzahl der vorhandenen Reservierungen von der angeforderten Gesamtzahl der Reservierungen in der Anfrage subtrahiert, um die Anzahl der neuen Reservierungen zu ermitteln, die Compute Engine erstellt. Weitere Informationen dazu, wie die Compute Engine Ressourcen zählt und bereitstellt, finden Sie hier.

    Achtung: Achten Sie darauf, dass Ihr Kontingent für die Ressourcen ausreicht, die Sie reservieren möchten. Andernfalls lehnt Google Cloud Ihre zukünftige Reservierungsanfrage ab.

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

Optional können Sie auch ändern, ob und wann Compute Engine die automatisch erstellten Reservierungen für eine zukünftige Reservierungsanfrage automatisch löscht. Führen Sie dazu einen der folgenden Schritte aus:

  • Damit Compute Engine die automatisch erstellten Reservierungen nach dem Ende des Reservierungszeitraums automatisch löschen kann, wählen Sie eine der folgenden Methoden aus:

    • Geben Sie das Flag --auto-delete-auto-created-reservations an, um die Reservierungen innerhalb von zwei Stunden nach der Endzeit zu löschen (Standard).

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations
      
    • Wenn Sie die automatisch erstellten Reservierungen zu einem bestimmten Zeitpunkt nach dem Ende des Reservierungszeitraums löschen möchten, geben Sie die Flags --auto-delete-auto-created-reservations und --auto-created-reservations-delete-time an.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
      

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

    • Wenn Sie die automatisch erstellten Reservierungen nach einem bestimmten Zeitpunkt nach dem Ende des Reservierungszeitraums löschen möchten, geben Sie die Flags --auto-delete-auto-created-reservations und --auto-created-reservations-duration an.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE
      

      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 1 Tag, 2 Stunden, 3 Minuten und 4 Sekunden an.

  • Mit dem Flag --no-auto-delete-auto-created-reservations können Sie verhindern, dass die Compute Engine die automatisch erstellten Reservierungen automatisch löscht.

    gcloud beta compute future-reservations update example-future-reservation \
        --no-auto-delete-auto-created-reservations
    

Betrachten Sie beispielsweise einen Entwurf einer freigegebenen zukünftigen Reservierungsanfrage namens fr-03, der sich in der Zone us-central1-a befindet. Angenommen, Sie möchten diese freigegebene zukünftige Reservierungsanfrage ändern, indem Sie die folgenden Änderungen vornehmen:

  • Wandeln Sie es in eine zukünftige Reservierungsanfrage für ein Einzelprojekt um.

  • Deaktivieren Sie die Option zum automatischen Löschen.

  • Reservieren Sie 100 VMs.

  • Senden Sie die zukünftige Reservierungsanfrage zur Genehmigung an Google Cloud.

Führen Sie den folgenden Befehl aus, um fr-03 zu ändern:

gcloud beta compute future-reservations update fr-03 \
    --clear-share-settings \
    --no-auto-delete-auto-created-reservations \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=100 \
    --zone=us-central1-a

REST

Wenn Sie Google Cloud bitten möchten, einen Entwurf einer oder eine abgelehnte Reservierungsanfrage zu ändern, der durch Angabe einer Instanzvorlage erstellt wurde, stellen Sie eine PATCH-Anfrage an die Methode beta.futureReservations.update. Geben Sie im Abfrageparameter updateMask alle Felder an, die Sie aktualisieren möchten. Wenn Sie ein optionales Feld aus Ihrer Reservierung löschen müssen, fügen Sie dieses Feld in den Abfrageparameter updateMask ein und lassen Sie dieses Feld im Anfragetext weg.

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

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

Ersetzen Sie 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 Entwurfs oder einer abgelehnten Reservierungsanfrage. Sie können den Namen einer zukünftigen Reservierungsanfrage nicht ändern.

  • UPDATE_FIELDS: eine durch Kommas getrennte Liste von Feldern, die in dieser PATCH-Anfrage aktualisiert werden sollen. Sie müssen jedes Komma als %2C codieren. Wenn Sie beispielsweise die Felder autoDeleteAutoCreatedReservations, totalCount und endTime in Ihrer zukünftigen Reservierungsanfrage aktualisieren möchten, geben Sie Folgendes an:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
    
  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Optional. Wenn Sie dieses Feld auf true setzen, löscht Compute Engine automatisch die automatisch erstellten Reservierungen für diese Reservierungsanfrage für eine zukünftige Reservierung. Standardmäßig wird die Löschzeit innerhalb von zwei Stunden nach dem Ende des Reservierungszeitraums liegen. Führen Sie einen der folgenden Schritte aus, um dies zu ändern:

    • 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 geben Sie das Feld autoCreatedReservationsDeleteTime an.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME"
      }
      

      Ersetzen Sie DELETE_TIME durch ein Datum und eine Uhrzeit, wenn Compute Engine Reservierungen löscht. Datum und Uhrzeit müssen als RFC 3339-Zeitstempel formatiert sein, der so aussehen muss:

      YYYY-MM-DDTHH:MM:SSOFFSET
      

      Ersetzen Sie 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 Offset verwenden möchten, geben Sie Z an.

    • 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 geben das Feld autoCreatedReservationsDuration an.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        }
      }
      

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

  • DESCRIPTION: Optional. Führen Sie einen der folgenden Schritte aus, um die Beschreibung für diese zukünftige Reservierungsanfrage zu aktualisieren:

    • Wenn Sie eine Beschreibung hinzufügen oder aktualisieren möchten, geben Sie eine Beschreibung an.

    • Wenn Sie die Beschreibung entfernen möchten, löschen Sie das Feld description aus dem Anfragetext und geben Sie es in UPDATE_FIELDS an.

  • NAME_PREFIX: Optional. Ein neues Namenspräfix für die zukünftige Reservierungsanfrage. Der Name jeder automatisch erstellten Reservierung für diese zukünftige Reservierungsanfrage beginnt mit dem Namenspräfix. Geben Sie ein eindeutiges Namenspräfix an, um die automatisch erstellten Reservierungen für diese zukünftige Reservierung zu identifizieren.

  • PLANNING_STATUS: der Planungsstatus der zukünftigen Reservierungsanfrage. Sie können nur SUBMITTED angeben. Dadurch wird die zukünftige Reservierungsanfrage zur Prüfung an Google Cloud gesendet.

  • SHARE_TYPE: Optional. Geben Sie einen der folgenden Werte an, um den Freigabetyp dieser zukünftigen Reservierungsanfrage zu ändern:

    • Geben Sie SPECIFIC_PROJECTS an, um eine zukünftige Reservierungsanfrage für ein einzelnes Projekt in eine freigegebene zukünftige Reservierungsanfrage zu ändern. Außerdem müssen Sie im Feld projects mindestens ein Nutzerprojekt angeben. Andernfalls schlägt das Ändern der zukünftigen Reservierungsanfrage fehl.

    • Andernfalls geben Sie LOCAL an. Darüber hinaus müssen Sie das Feld projects aus dem Anfragetext löschen und in UPDATE_FIELDS angeben. Andernfalls schlägt das Ändern der zukünftigen Reservierungsanfrage fehl.

  • CONSUMER_PROJECT_ID_1 und CONSUMER_PROJECT_ID_2: Optional. Die Projekt-IDs von Projekten, für die eine freigegebene zukünftige Reservierungsanfrage freigegeben werden kann. Sie können bis zu 100 Projekte angeben. Diese Projekte müssen sich in derselben Organisation wie das Projekt befinden, in dem die zukünftige Reservierungsanfrage erstellt wurde (das Inhaberprojekt). Geben Sie nicht das Inhaberprojekt an. Standardmäßig ist es zulässig, die automatisch erstellten freigegebenen Reservierungen für diese zukünftige Reservierungsanfrage zu nutzen.

  • TOTAL_COUNT: Optional. Die neue Gesamtzahl der VMs, die Sie für den in dieser zukünftigen Reservierungsanfrage angegebenen Zeitraum reservieren möchten, die VM-Konfiguration und die Projekte.

    Bei der Berechnung der Anzahl der Reservierungen, die für eine genehmigte zukünftige Reservierung erstellt werden sollen, prüft Compute Engine zuerst auf vorhandene Reservierungen. Wenn bereits Reservierungen vorhanden sind, die mit der genehmigten zukünftigen Reservierung übereinstimmen, wird die Anzahl der vorhandenen Reservierungen von der angeforderten Gesamtzahl der Reservierungen in der Anfrage subtrahiert, um die Anzahl der neuen Reservierungen zu ermitteln, die Compute Engine erstellt. Weitere Informationen finden Sie unter Reservierte Ressourcen zählen und bereitstellen.

  • START_TIME: Optional. Die neue Startzeit des Reservierungszeitraums ist als RFC 3339-Zeitstempel formatiert. Die Startzeit darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie eine zukünftige Reservierungsanfrage zur Überprüfung senden. Geben Sie außerdem eine empfohlene Startzeit an, damit genügend Zeit bleibt, bevor eine zukünftige Reservierung die Sperrzeit erreicht.

  • END_TIME: Optional. Die neue Endzeit 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 eine 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.

Betrachten Sie beispielsweise einen Entwurf einer freigegebenen zukünftigen Reservierungsanfrage namens fr-03, der sich in der Zone us-central1-a befindet. Angenommen, Sie möchten diese freigegebene zukünftige Reservierungsanfrage ändern, indem Sie die folgenden Änderungen vornehmen:

  • Wandeln Sie es in eine zukünftige Reservierungsanfrage für ein Einzelprojekt um.

  • Deaktivieren Sie die Option zum automatischen Löschen.

  • Reservieren Sie 100 VMs.

  • Senden Sie die zukünftige Reservierungsanfrage zur Genehmigung an Google Cloud.

Stellen Sie die folgende PATCH-Anfrage, um fr-03 zu ändern:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount

{
  "autoDeleteAutoCreatedReservations": "false",
  "name": "fr-03",
  "planningStatus": "SUBMITTED",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "totalCount": "100"
  }
}

Nachdem Sie eine zukünftige Reservierungsanfrage zur Prüfung an Google Cloud gesendet haben, rufen Sie die Details auf, um diesen Beschaffungsstatus zu überwachen.

Sie können einen Entwurf oder eine abgelehnte Reservierung ändern, indem Sie Attribute direkt angeben.

Für eine zukünftige Reservierungsanfrage, die direkt von Attributen mit dem Beschaffungsstatus "Entwurf" (DRAFTING) oder "Abgelehnt" (DECLINED) erstellt wird, können Sie die folgenden Attribute ändern:

  • Automatisch löschen

  • Beschreibung

  • Namenspräfix

  • GPUs

  • Lokale SSDs und der Typ der Laufwerkschnittstelle

  • Maschinenserie und Maschinentyp

  • Mindest-CPU-Plattform

  • Freigabeeinstellungen

  • Start- und Endzeit des Reservierungszeitraums

  • Gesamtzahl (Zahl der VMs)

Sie können einen Entwurf für oder eine abgelehnte zukünftige Reservierungsanfrage ändern, die durch Angabe von Attributen direkt erstellt wurde. Nutzen Sie dazu Google Cloud Console, die gcloud CLI und REST an.

Console

Wenn Sie Google Cloud bitten möchten, einen Entwurf oder eine Ablehnung einer zukünftigen Reservierungsanfrage zu ändern, die direkt durch Angabe von Attributen erstellt wurde, gehen Sie so vor:

  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 der zukünftigen Reservierungsanfrage, die Sie ändern möchten.

    Die Detailseite der ausgewählten zukünftigen Reservierungsanfrage wird geöffnet.

  4. Klicken Sie zum Ändern der zukünftigen Reservierungsanfrage auf Bearbeiten oder Entwurf bearbeiten.

    Die Seite zum Bearbeiten der ausgewählten zukünftigen Reservierungsanfrage wird geöffnet.

  5. Führen Sie einen oder mehrere der folgenden Schritte aus:

    • Geben Sie im Feld Präfix ein neues Namenspräfix ein.

    • Geben Sie in das Feld Beschreibung eine neue Beschreibung ein.

    • Ändern Sie die Startzeit oder die Endzeit für Ihre zukünftige Reservierungsanfrage. Folgende Punkte sollten beachtet werden:

      • Die Startzeit darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie eine zukünftige Reservierungsanfrage zur Überprüfung senden.

      • Geben Sie einen empfohlenen Wert für die Startzeit an, damit genügend Zeit bleibt, bevor die zukünftige Reservierung die Sperrzeit erreicht.

      • Geben Sie einen empfohlenen Mindestreservierungszeitraum an, um die Wahrscheinlichkeit zu erhöhen, dass Google Cloud Ihre Anfrage nach der Überprüfung genehmigt.

    • Im Abschnitt Freigabetyp können Sie entweder Lokal oder Freigegeben auswählen. Wenn Sie Freigegeben auswählen, können Sie Projekte hinzufügen oder entfernen, für die die zukünftige Reservierungsanfrage freigegeben werden soll.

      Sie können bis zu 100 Projekte auswählen. Diese Projekte müssen sich in derselben Organisation wie das Projekt befinden, in dem die zukünftige Reservierungsanfrage erstellt wurde (das Inhaberprojekt). Geben Sie nicht das Inhaberprojekt an. Standardmäßig ist es zulässig, die automatisch erstellten freigegebenen Reservierungen für diese zukünftige Reservierungsanfrage zu nutzen.

    • Geben Sie in 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.

      Bei der Berechnung der Anzahl der Reservierungen, die für eine genehmigte zukünftige Reservierung erstellt werden sollen, prüft Compute Engine zuerst auf vorhandene Reservierungen. Wenn bereits Reservierungen vorhanden sind, die mit der genehmigten zukünftigen Reservierung übereinstimmen, wird die Anzahl der vorhandenen Reservierungen von der angeforderten Gesamtzahl der Reservierungen in der Anfrage subtrahiert, um die Anzahl der neuen Reservierungen zu ermitteln, die Compute Engine erstellt. Weitere Informationen finden Sie unter Reservierte Ressourcen zählen und bereitstellen.

    • Im Abschnitt Maschinenkonfiguration können Sie Folgendes ändern:

      • Die Maschinenserie und der Maschinentyp, die in den reservierten VMs verwendet werden.

      • Die GPUs, die an die reservierten VMs angehängt werden.

      • Die lokalen SSDs und der Laufwerkschnittstellentyp der reservierten VMs.

  6. Führen Sie je nach dem Beschaffungsstatus der zukünftigen Reservierungsanfrage, die Sie ändern, einen der folgenden Schritte aus:

    • Wählen Sie für einen zukünftigen Reservierungsanfrageentwurf eine der folgenden Optionen aus:

      • Klicken Sie zum Speichern der Änderungen auf Entwurf speichern

      • Klicken Sie auf Senden, um die zukünftige Reservierungsanfrage zur Prüfung an Google Cloud zu senden.

    • Bei einer abgelehnten zukünftigen Reservierungsanfrage können Sie diese nur zur Überprüfung einreichen, indem Sie auf Senden klicken.

      Wenn Sie eine Anfrage senden, wird die Seite Reservierungen geöffnet. Andernfalls wird die Detailseite der zukünftigen Reservierungsanfrage geöffnet.

gcloud

Wenn Sie Google Cloud bitten möchten, einen Entwurf oder eine Ablehnung einer zukünftigen Reservierungsanfrage zu ändern, die direkt durch Angabe von Attributen erstellt wurde, verwenden Sie den Befehl gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --description="DESCRIPTION" \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • FUTURE_RESERVATION_NAME: der Name eines vorhandenen Entwurfs oder einer abgelehnten Reservierungsanfrage.
  • Optional. Führen Sie einen der folgenden Schritte aus:

    • Geben Sie Folgendes an, um jeder reservierten VM Grafikprozessoren (GPUs) hinzuzufügen:

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

      • ACCELERATOR_TYPE: der GPU-Typ, der den reservierten VMs hinzugefügt werden soll.

      Achten Sie darauf, dass der Maschinentyp, den Sie in der zukünftigen Reservierungsanfrage angeben, die von Ihnen angegebenen GPU-Typen unterstützt und die GPU in der Zone verfügbar ist, in der Sie Ressourcen reservieren möchten. Andernfalls treten Fehler auf.

    • Wenn Sie alle GPUs aus dieser zukünftigen Reservierungsanfrage entfernen möchten, ersetzen Sie das Flag --accelerator durch das Flag --clear-accelerator.

  • DESCRIPTION: Optional. Eine neue Beschreibung für die zukünftige Reservierungsanfrage.
  • Optional. Führen Sie einen der folgenden Schritte aus:

    • Zum Hinzufügen oder Bearbeiten des Schnittstellentyps, den die lokalen SSDs für jede VM verwenden sollen, ersetzen Sie INTERFACE_1 und INTERFACE_2. Der Wert muss einer der folgenden sein:

      Jede lokale SSD ist 375 GB groß. Wiederholen Sie das Flag --local-ssd für jede lokale SSD, die Sie hinzufügen möchten. Es können maximal 24 lokale SSDs angegeben werden.

    • Wenn Sie alle lokalen SSDs aus dieser zukünftigen Anfragereservierung entfernen möchten, entfernen Sie alle --local-ssd-Flags und geben Sie das Flag --clear-local-ssd an.

  • MACHINE_TYPE: Optional. Ein vordefinierter oder benutzerdefinierter Maschinentyp, der für jede VM verwendet wird. Lesen Sie die Einschränkungen für VMs mit benutzerdefinierten Maschinentypen, bevor Sie einen benutzerdefinierten Maschinentyp angeben.

  • MINIMUM_CPU_PLATFORM: Optional. Die für jede VM zu verwendende Mindest-CPU-Plattform. Wenn Sie das Flag --min-cpu-platform ausschließen, wird der Wert auf die Standard-CPU-Plattform der Zone festgelegt.

  • NAME_PREFIX: Optional. Ein neues Namenspräfix für die zukünftige Reservierungsanfrage. Der Name jeder automatisch erstellten Reservierung für diese zukünftige Reservierungsanfrage beginnt mit dem Namenspräfix. Geben Sie ein eindeutiges Namenspräfix an, um die automatisch erstellten Reservierungen für diese zukünftige Reservierungsanfrage zu identifizieren.
  • PLANNING_STATUS: der Planungsstatus der zukünftigen Reservierungsanfrage. Sie können nur SUBMITTED angeben. Dadurch wird die zukünftige Reservierungsanfrage zur Prüfung an Google Cloud gesendet.

  • PROJECT_ID: Optional. Die ID des Projekts, in dem die zukünftige Reservierungsanfrage erstellt wurde. Wenn Sie eine zukünftige Reservierungsanfrage für ein einzelnes Projekt in eine freigegebene zukünftige Reservierungsanfrage ändern, wird dieses Projekt zum Inhaberprojekt der zukünftigen Reservierungsanfrage. Wenn Sie das Flag --project weglassen, wird der Wert auf die ID des aktuellen Projekts festgelegt.
  • SHARE_SETTING: Optional. Geben Sie einen der folgenden Werte an, um den Typ dieser zukünftigen Reservierungsanfrage zu ändern:

    • Geben Sie projects an, um eine zukünftige Reservierungsanfrage für ein einzelnes Projekt in eine freigegebene zukünftige Reservierungsanfrage zu ändern. Geben Sie mindestens ein Nutzerprojekt mit dem Flag --share-with an. Andernfalls schlägt das Ändern der zukünftigen Reservierung fehl.

    • Andernfalls geben Sie local an.

  • CONSUMER_PROJECT_IDS: Optional. Eine durch Kommas getrennte Liste der Projekt-IDs von Projekten, für die diese zukünftige Reservierungsanfrage freigegeben werden kann. Geben Sie beispielsweise project-1,project-2 an: Sie können bis zu 100 Projekte angeben. Diese Projekte müssen sich in derselben Organisation wie das Projekt befinden, in dem diese zukünftige Reservierungsanfrage erstellt wurde (das Inhaberprojekt). Geben Sie nicht das Inhaberprojekt an. Standardmäßig ist es zulässig, die automatisch erstellten freigegebenen Reservierungen für diese zukünftige Reservierungsanfrage zu nutzen.

  • START_TIME: Optional. Der neue Beginn des Reservierungszeitraums, formatiert als RFC 3339-Zeitstempel, der so aussehen muss:

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    Ersetzen Sie 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 die Pacific Standard Time (PST) verwenden möchten, geben Sie -08:00 an. Wenn Sie keinen Offset verwenden möchten, geben Sie Z an.

    Die Startzeit darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie eine zukünftige Reservierungsanfrage zur Überprüfung senden. Wenn Sie genügend Zeit haben, um eine zukünftige Reservierung nach der Genehmigung oder vor der Eingabe ihrer Sperrzeit optional zu stornieren, zu löschen oder zu ändern, müssen Sie eine empfohlene Startzeit angeben.

  • END_TIME: Optional. Die neue Endzeit 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, wobei END_DURATION die Dauer des Reservierungszeitraums in Sekunden ist. 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.

  • TOTAL_COUNT: Optional. Die neue Gesamtzahl der VMs, die Sie für den in dieser zukünftigen Reservierungsanfrage angegebenen Zeitraum reservieren möchten, die VM-Konfiguration und die Projekte.

    Bei der Berechnung der Anzahl der Reservierungen, die für eine genehmigte zukünftige Reservierung erstellt werden sollen, prüft Compute Engine zuerst auf vorhandene Reservierungen. Wenn bereits Reservierungen vorhanden sind, die mit der genehmigten zukünftigen Reservierung übereinstimmen, wird die Anzahl der vorhandenen Reservierungen von der angeforderten Gesamtzahl der Reservierungen in der Anfrage subtrahiert, um die Anzahl der neuen Reservierungen zu ermitteln, die Compute Engine erstellt. Weitere Informationen dazu, wie die Compute Engine Ressourcen zählt und bereitstellt, finden Sie hier.

    Achtung: Achten Sie darauf, dass Ihr Kontingent für die Ressourcen ausreicht, die Sie reservieren möchten. Andernfalls lehnt Google Cloud Ihre zukünftige Reservierungsanfrage ab.

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

Optional können Sie auch ändern, ob und wann Compute Engine die automatisch erstellten Reservierungen für eine zukünftige Reservierungsanfrage automatisch löscht. Führen Sie dazu einen der folgenden Schritte aus:

  • Damit Compute Engine die automatisch erstellten Reservierungen nach dem Ende des Reservierungszeitraums automatisch löschen kann, wählen Sie eine der folgenden Methoden aus:

    • Geben Sie das Flag --auto-delete-auto-created-reservations an, um die Reservierungen innerhalb von zwei Stunden nach der Endzeit zu löschen (Standard).

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations
      
    • Wenn Sie die automatisch erstellten Reservierungen zu einem bestimmten Zeitpunkt nach dem Ende des Reservierungszeitraums löschen möchten, geben Sie die Flags --auto-delete-auto-created-reservations und --auto-created-reservations-delete-time an.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
      

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

    • Wenn Sie die automatisch erstellten Reservierungen nach einem bestimmten Zeitpunkt nach dem Ende des Reservierungszeitraums löschen möchten, geben Sie die Flags --auto-delete-auto-created-reservations und --auto-created-reservations-duration an.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE
      

      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 1 Tag, 2 Stunden, 3 Minuten und 4 Sekunden an.

  • Mit dem Flag --no-auto-delete-auto-created-reservations können Sie verhindern, dass die Compute Engine die automatisch erstellten Reservierungen automatisch löscht.

    gcloud beta compute future-reservations update example-future-reservation \
        --no-auto-delete-auto-created-reservations
    

Betrachten Sie beispielsweise einen Entwurf einer freigegebenen zukünftigen Reservierungsanfrage namens fr-03, der sich in der Zone us-central1-a befindet. Angenommen, Sie möchten diese freigegebene zukünftige Reservierungsanfrage ändern, indem Sie die folgenden Änderungen vornehmen:

  • Wandeln Sie es in eine zukünftige Reservierungsanfrage für ein Einzelprojekt um.

  • Deaktivieren Sie die Option zum automatischen Löschen.

  • Reservieren Sie 100 VMs.

  • Senden Sie die zukünftige Reservierungsanfrage zur Genehmigung an Google Cloud.

Führen Sie den folgenden Befehl aus, um fr-03 zu ändern:

gcloud beta compute future-reservations update fr-03 \
    --clear-share-settings \
    --no-auto-delete-auto-created-reservations \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=100 \
    --zone=us-central1-a

REST

Wenn Sie Google Cloud bitten möchten, einen Entwurf für eine Entwurfsanfrage oder eine abgelehnte zukünftige Anfrage zu ändern, die durch direkte Angabe von Attributen erstellt wurde, stellen Sie eine PATCH-Anfrage an dieMethode beta.futureReservations.update. Geben Sie im Abfrageparameter updateMask alle Felder an, die Sie aktualisieren möchten. Wenn Sie ein optionales Feld aus Ihrer Reservierung löschen müssen, fügen Sie dieses Feld in den Abfrageparameter updateMask ein und lassen Sie dieses Feld im Anfragetext weg.

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

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

Ersetzen Sie 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 Entwurfs oder einer abgelehnten Reservierungsanfrage. Sie können den Namen einer zukünftigen Reservierungsanfrage nicht ändern.

  • UPDATE_FIELDS: eine durch Kommas getrennte Liste von Feldern, die in dieser PATCH-Anfrage aktualisiert werden sollen. Sie müssen jedes Komma als %2C codieren. Wenn Sie beispielsweise die Felder autoDeleteAutoCreatedReservations, totalCount und endTime in Ihrer zukünftigen Reservierungsanfrage aktualisieren möchten, geben Sie Folgendes an:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
    
  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Optional. Wenn Sie dieses Feld auf true setzen, löscht Compute Engine automatisch die automatisch erstellten Reservierungen für diese Reservierungsanfrage für eine zukünftige Reservierung. Standardmäßig wird die Löschzeit innerhalb von zwei Stunden nach dem Ende des Reservierungszeitraums liegen. Führen Sie einen der folgenden Schritte aus, um dies zu ändern:

    • 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 geben Sie das Feld autoCreatedReservationsDeleteTime an.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME"
      }
      

      Ersetzen Sie DELETE_TIME durch ein Datum und eine Uhrzeit, wenn Compute Engine Reservierungen löscht. Datum und Uhrzeit müssen als RFC 3339-Zeitstempel formatiert sein, der so aussehen muss:

      YYYY-MM-DDTHH:MM:SSOFFSET
      

      Ersetzen Sie 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 Offset verwenden möchten, geben Sie Z an.

    • 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 geben das Feld autoCreatedReservationsDuration an.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        }
      }
      

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

  • DESCRIPTION: Optional. Führen Sie einen der folgenden Schritte aus, um die Beschreibung für diese zukünftige Reservierungsanfrage zu aktualisieren:

    • Wenn Sie eine Beschreibung hinzufügen oder aktualisieren möchten, geben Sie eine Beschreibung an.

    • Wenn Sie die Beschreibung entfernen möchten, löschen Sie das Feld description aus dem Anfragetext und geben Sie es in UPDATE_FIELDS an.

  • NAME_PREFIX: Optional. Ein neues Namenspräfix für die zukünftige Reservierungsanfrage. Der Name jeder automatisch erstellten Reservierung für diese zukünftige Reservierungsanfrage beginnt mit dem Namenspräfix. Geben Sie ein eindeutiges Namenspräfix an, um die automatisch erstellten Reservierungen für diese zukünftige Reservierung zu identifizieren.

  • PLANNING_STATUS: der Planungsstatus der zukünftigen Reservierungsanfrage. Sie können nur SUBMITTED angeben. Dadurch wird die zukünftige Reservierungsanfrage zur Prüfung an Google Cloud gesendet.

  • SHARE_TYPE: Optional. Geben Sie einen der folgenden Werte an, um den Freigabetyp dieser zukünftigen Reservierungsanfrage zu ändern:

    • Geben Sie SPECIFIC_PROJECTS an, um eine zukünftige Reservierungsanfrage für ein einzelnes Projekt in eine freigegebene zukünftige Reservierungsanfrage zu ändern. Außerdem müssen Sie im Feld projects mindestens ein Nutzerprojekt angeben. Andernfalls schlägt das Ändern der zukünftigen Reservierungsanfrage fehl.

    • Andernfalls geben Sie LOCAL an. Darüber hinaus müssen Sie das Feld projects aus dem Anfragetext löschen und in UPDATE_FIELDS angeben. Andernfalls schlägt das Ändern der zukünftigen Reservierungsanfrage fehl.

  • CONSUMER_PROJECT_ID_1 und CONSUMER_PROJECT_ID_2: Optional. Die Projekt-IDs von Projekten, für die eine freigegebene zukünftige Reservierungsanfrage freigegeben werden kann. Sie können bis zu 100 Projekte angeben. Diese Projekte müssen sich in derselben Organisation wie das Projekt befinden, in dem die zukünftige Reservierungsanfrage erstellt wurde (das Inhaberprojekt). Geben Sie nicht das Inhaberprojekt an. Standardmäßig ist es zulässig, die automatisch erstellten freigegebenen Reservierungen für diese zukünftige Reservierungsanfrage zu nutzen.

  • Optional. Zum Aktualisieren der Grafikprozessoren (GPUs), die an jede reservierte VM angehängt sind, führen Sie einen der folgenden Schritte aus:

    • Geben Sie Folgendes an, um GPUs hinzuzufügen oder zu ändern:

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

      • ACCELERATOR_TYPE: der GPU-Typ, der den reservierten VMs hinzugefügt werden soll.

      Achten Sie darauf, dass der Maschinentyp, den Sie in der zukünftigen Reservierungsanfrage angeben, die von Ihnen angegebenen GPU-Typen unterstützt und die GPU in der Zone verfügbar ist, in der Sie Ressourcen reservieren möchten. Andernfalls treten Fehler auf.

    • Wenn Sie alle GPUs aus dieser zukünftigen Reservierungsanfrage entfernen möchten, lassen Sie das Feld guestAccelerators im Anfragetext weg und geben Sie es in UPDATE_FIELDS an.

  • Optional. Führen Sie einen der folgenden Schritte aus, um die lokalen SSDs zu aktualisieren, die an jede reservierte VM angehängt sind:

    • Zum Hinzufügen oder Bearbeiten des Schnittstellentyps, den die lokalen SSDs für jede VM verwenden sollen, ersetzen Sie INTERFACE_1 und INTERFACE_2. Der Wert muss einer der folgenden sein:

      Wiederholen Sie die Felder diskSizeGb und interface für jede lokale SSD, die Sie hinzufügen oder aktualisieren möchten. Es können maximal 24 lokale SSDs angegeben werden.

    • Wenn Sie alle lokalen SSDs aus dieser zukünftigen Reservierungsanfrage entfernen möchten, löschen Sie das Feld localSsds aus dem Anfragetext und geben es in UPDATE_FIELDS an.

  • MACHINE_TYPE: Optional. Ein vordefinierter oder benutzerdefinierter Maschinentyp, der für jede VM verwendet wird. Lesen Sie die Einschränkungen für VMs mit benutzerdefinierten Maschinentypen, bevor Sie einen benutzerdefinierten Maschinentyp angeben.

  • MINIMUM_CPU_PLATFORM: Optional. Führen Sie einen der folgenden Schritte aus, um die für jede VM zu verwendende Mindest-CPU-Plattform zu aktualisieren:

    • Wenn Sie die Mindest-CPU-Plattform hinzufügen oder aktualisieren möchten, geben Sie eine Mindest-CPU-Plattform an.

    • Wenn Sie zur Standard-CPU-Plattform der Zone zurückkehren möchten, löschen Sie das Feld minCpuPlatform aus dem Anfragetext und geben es in UPDATE_FIELDS an.

  • TOTAL_COUNT: Optional. Die neue Gesamtzahl der VMs, die Sie für den in dieser zukünftigen Reservierungsanfrage angegebenen Zeitraum reservieren möchten, die VM-Konfiguration und die Projekte.

    Bei der Berechnung der Anzahl der Reservierungen, die für eine genehmigte zukünftige Reservierung erstellt werden sollen, prüft Compute Engine zuerst auf vorhandene Reservierungen. Wenn bereits Reservierungen vorhanden sind, die mit der genehmigten zukünftigen Reservierung übereinstimmen, wird die Anzahl der vorhandenen Reservierungen von der angeforderten Gesamtzahl der Reservierungen in der Anfrage subtrahiert, um die Anzahl der neuen Reservierungen zu ermitteln, die Compute Engine erstellt. Weitere Informationen finden Sie unter Reservierte Ressourcen zählen und bereitstellen.

  • START_TIME: Optional. Die neue Startzeit des Reservierungszeitraums ist als RFC 3339-Zeitstempel formatiert. Die Startzeit darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie eine zukünftige Reservierungsanfrage zur Überprüfung senden. Geben Sie außerdem eine empfohlene Startzeit an, damit genügend Zeit bleibt, bevor eine zukünftige Reservierung die Sperrzeit erreicht.

  • END_TIME: Optional. Die neue Endzeit 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 eine 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.

Betrachten Sie beispielsweise einen Entwurf einer freigegebenen zukünftigen Reservierungsanfrage namens fr-03, der sich in der Zone us-central1-a befindet. Angenommen, Sie möchten diese freigegebene zukünftige Reservierungsanfrage ändern, indem Sie die folgenden Änderungen vornehmen:

  • Wandeln Sie es in eine zukünftige Reservierungsanfrage für ein Einzelprojekt um.

  • Deaktivieren Sie die Option zum automatischen Löschen.

  • Reservieren Sie 100 VMs.

  • Senden Sie die zukünftige Reservierungsanfrage zur Genehmigung an Google Cloud.

Stellen Sie die folgende PATCH-Anfrage, um fr-03 zu ändern:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount

{
  "autoDeleteAutoCreatedReservations": "false",
  "name": "fr-03",
  "planningStatus": "SUBMITTED",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "totalCount": "100"
  }
}

Nachdem Sie eine zukünftige Reservierungsanfrage zur Prüfung an Google Cloud gesendet haben, rufen Sie die Details auf, um diesen Beschaffungsstatus zu überwachen.

Genehmigte oder zukünftige Reservierung ändern

Wählen Sie eine der folgenden Methoden aus, um die Attribute einer genehmigten oder zukünftigen Beschaffungsreservierung zu ändern:

  • Ändern Sie eine genehmigte oder beschaffende zukünftige Reservierung ohne Überprüfung.

    In diesem Abschnitt wird erläutert, wie Sie die Option zum automatischen Löschen, das Beschreibungs- und Namenspräfix in einer genehmigten oder Beschaffung von zukünftigen Reservierungen ohne Überprüfung ändern. Die Änderung dieser Attribute erfolgt sofort und es gibt keine Beschränkungen für die Häufigkeit, mit der Sie sie ändern können, bis Google Cloud mit dem Erstellen der Reservierungen beginnt.

  • Anfrage zur Änderung einer genehmigten oder Beschaffung von zukünftigen Reservierungen.

    In diesem Abschnitt wird erläutert, wie Sie Google Cloud bitten, ein oder mehrere Attribute in einer genehmigten oder Beschaffung von zukünftigen Reservierungen zu ändern. Sie können nur eine Anfrage zum Ändern einer zukünftigen Reservierung mit dem Beschaffungsstatus "Beschaffen" (PROCURING) senden.

Genehmigte oder zukünftige Reservierungen ohne Überprüfung ändern

Für eine zukünftige Reservierung mit einem Beschaffungsstatus, der auf "Genehmigt" (APPROVED) oder "Beschaffung" (PROCURING) festgelegt ist, können Sie die folgenden Felder ohne Genehmigung von Google Cloud ändern:

  • Automatisch löschen

  • Beschreibung

  • Namenspräfix

Die Änderung dieser Attribute erfolgt sofort. Bis zum Beginn des Reservierungszeitraums einer zukünftigen Reservierung gibt es keine Begrenzung für die Häufigkeit, mit der Sie diese Attribute ändern können.

Sie können eine genehmigte oder im Beschaffungsstatus befindlichen zukünftige Reservierung ohne Prüfung unter Verwendung der Google Cloud Console, der gcloud CLI und REST ändern.

Console

So können Sie eine genehmigte oder beschaffende zukünftige Reservierung ohne Prüfung ändern:

  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 der zukünftigen Reservierung, die Sie ändern möchten.

    Die Seite mit den Details der ausgewählten zukünftigen Reservierung wird geöffnet.

  4. Wenn Sie die Option zum automatischen Löschen und die Beschreibung einer zukünftigen Reservierung ändern möchten, führen Sie einen oder mehrere der folgenden Schritte aus:

    • Klicken Sie in der Zeile Zeit für das automatische Löschen von Reservierungen auf Bearbeiten und führen Sie dann die folgenden Schritte aus:

      1. Führen Sie einen der folgenden Schritte aus:

        • So aktivieren Sie in Compute Engine die automatisch erstellten Reservierungen für Ihre zukünftige Reservierungsanfrage automatisch:

          1. Klicken Sie auf den Schalter Automatisches Löschen aktivieren auf "Ein".

          2. Optional: Geben Sie im Feld Zeit bis zum automatischen Löschen ein neues Datum und eine neue Uhrzeit für das Löschen der automatisch erstellten Reservierungen ein. Das Datum und die Uhrzeit müssen nach dem Ende 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.

      2. Klicken Sie auf Senden.

    • Klicken Sie in der Zeile Präfix auf Bearbeiten und gehen Sie dann so vor:

      1. Geben Sie im Feld Präfix ein neues Namenspräfix ein.

      2. Klicken Sie auf Senden.

    • Klicken Sie in der Zeile Beschreibung auf Bearbeiten und gehen Sie dann so vor:

      1. Geben Sie in das Feld Beschreibung eine neue Beschreibung ein.

      2. Klicken Sie auf Senden.

gcloud

Verwenden Sie den Befehl gcloud beta compute future-reservations update, um eine genehmigte oder zukünftige Beschaffung von Reservierungen ohne Prüfung zu ändern.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --project=PROJECT_ID \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • FUTURE_RESERVATION_NAME: der Name einer vorhandenen genehmigten oder im Beschaffungsstatus befindlichen zukünftigen Reservierungen.
  • DESCRIPTION: Optional. Eine neue Beschreibung für die zukünftige Reservierung.
  • NAME_PREFIX: Optional. Ein neues Namenspräfix für die zukünftige Reservierung. Der Name jeder automatisch erstellten Reservierung für diese zukünftige Reservierung beginnt mit dem Namenspräfix. Geben Sie ein eindeutiges Namenspräfix an, um die automatisch erstellten Reservierungen für diese zukünftige Reservierung zu identifizieren.
  • PROJECT_ID: Optional. Die ID des Projekts, in dem die zukünftige Reservierung erstellt wurde.
  • ZONE: Die Zone, in der sich die zukünftige Reservierungsanfrage befindet.

Optional können Sie auch ändern, ob und wann Compute Engine die automatisch erstellten Reservierungen für eine zukünftige Reservierung automatisch löscht. Führen Sie dazu einen der folgenden Schritte aus:

  • Damit Compute Engine die automatisch erstellten Reservierungen nach dem Ende des Reservierungszeitraums automatisch löschen kann, wählen Sie eine der folgenden Methoden aus:

    • Geben Sie das Flag --auto-delete-auto-created-reservations an, um die Reservierungen innerhalb von zwei Stunden nach der Endzeit zu löschen (Standard).

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations
      
    • Wenn Sie die automatisch erstellten Reservierungen zu einem bestimmten Zeitpunkt nach dem Ende des Reservierungszeitraums löschen möchten, geben Sie die Flags --auto-delete-auto-created-reservations und --auto-created-reservations-delete-time an.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
      

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

    • Wenn Sie die automatisch erstellten Reservierungen nach einem bestimmten Zeitpunkt nach dem Ende des Reservierungszeitraums löschen möchten, geben Sie die Flags --auto-delete-auto-created-reservations und --auto-created-reservations-duration an.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE
      

      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 1 Tag, 2 Stunden, 3 Minuten und 4 Sekunden an.

  • Mit dem Flag --no-auto-delete-auto-created-reservations können Sie verhindern, dass die Compute Engine die automatisch erstellten Reservierungen automatisch löscht.

    gcloud beta compute future-reservations update example-future-reservation \
        --no-auto-delete-auto-created-reservations
    

Betrachten Sie beispielsweise eine genehmigte zukünftige Reservierung mit dem Namen fr-04 und in der Zone us-central1-a. Angenommen, Sie möchten diese zukünftige Reservierung ändern, indem Sie die folgenden Änderungen vornehmen:

  • Aktivieren Sie die Option zum automatischen Löschen.

  • Die automatisch erstellten Reservierungen werden nach 864.000 Sekunden (10 Tage) automatisch gelöscht.

  • Geben Sie ein neues Namenspräfix an.

Führen Sie den folgenden Befehl aus, um fr-04 zu ändern:

gcloud beta compute future-reservations update fr-04 \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=864000 \
    --name-prefix=new-prefix \
    --project=example-project \
    --zone=us-central1-a

REST

Wenn Sie eine genehmigte oder zukünftige Beschaffung von Reservierungen ohne Prüfung ändern möchten, stellen Sie eine PATCH- Anfrage an die Methode beta.futureReservations.update. Geben Sie im Abfrageparameter updateMask alle Felder an, die Sie aktualisieren möchten. Wenn Sie ein optionales Feld aus Ihrer Reservierung löschen müssen, fügen Sie dieses Feld in den Abfrageparameter updateMask ein und lassen Sie dieses Feld im Anfragetext weg.

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

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX"
}

Ersetzen Sie Folgendes:

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

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

  • FUTURE_RESERVATION_NAME: der Name einer vorhandenen genehmigten oder im Beschaffungsstatus befindlichen zukünftigen Reservierungen. Sie können den Namen einer zukünftigen Reservierung nicht ändern.

  • UPDATE_FIELDS: eine durch Kommas getrennte Liste von Feldern, die in dieser PATCH-Anfrage aktualisiert werden sollen. Sie müssen jedes Komma als %2C codieren. Wenn Sie beispielsweise die Felder description und namePrefix in Ihrer zukünftigen Reservierung aktualisieren möchten, geben Sie Folgendes an:

    description%2CnamePrefix
    

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Optional. Wenn Sie dieses Feld auf true setzen, löscht Compute Engine automatisch die automatisch erstellten Reservierungen für diese Reservierung einer zukünftigen Reservierung. Standardmäßig wird die Löschzeit innerhalb von zwei Stunden nach dem Ende des Reservierungszeitraums liegen. Führen Sie einen der folgenden Schritte aus, um dies zu ändern:

    • 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 geben Sie das Feld autoCreatedReservationsDeleteTime an.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME"
      }
      

      Ersetzen Sie DELETE_TIME durch ein Datum und eine Uhrzeit, wenn Compute Engine Reservierungen löscht. Datum und Uhrzeit müssen als RFC 3339-Zeitstempel formatiert sein, der so aussehen muss:

      YYYY-MM-DDTHH:MM:SSOFFSET
      

      Ersetzen Sie 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 Offset verwenden möchten, geben Sie Z an.

    • 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 geben das Feld autoCreatedReservationsDuration an.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        }
      }
      

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

  • DESCRIPTION: Optional. Führen Sie einen der folgenden Schritte aus, um die Beschreibung für diese zukünftige Reservierung zu aktualisieren:

    • Wenn Sie eine Beschreibung hinzufügen oder aktualisieren möchten, geben Sie eine Beschreibung an.

    • Wenn Sie die Beschreibung entfernen möchten, löschen Sie das Feld description aus dem Anfragetext und geben Sie es in UPDATE_FIELDS an.

  • NAME_PREFIX: Optional. Ein neues Namenspräfix für die zukünftige Reservierung. Der Name jeder automatisch erstellten Reservierung für diese zukünftige Reservierung beginnt mit dem Namenspräfix. Geben Sie ein eindeutiges Namenspräfix an, um die automatisch erstellten Reservierungen für diese zukünftige Reservierung zu identifizieren.

Betrachten Sie beispielsweise eine genehmigte zukünftige Reservierung mit dem Namen fr-04 und in der Zone us-central1-a. Angenommen, Sie möchten diese zukünftige Reservierung ändern, indem Sie die folgenden Änderungen vornehmen:

  • Aktivieren Sie die Option zum automatischen Löschen.

  • Die automatisch erstellten Reservierungen werden nach 864.000 Sekunden (10 Tage) automatisch gelöscht.

  • Geben Sie ein neues Namenspräfix an.

Stellen Sie die folgende PATCH-Anfrage, um fr-04 zu ändern:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-04?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CnamePrefix

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "864000"
  },
  "name": "fr-04",
  "namePrefix": "new-prefix"
}

Anfrage zur Änderung einer genehmigten oder Beschaffung von zukünftigen Reservierungen

Sie können Google Cloud bitten, eine zukünftige Reservierung mit einem Beschaffungsstatus von "Genehmigt" (APPROVED) oder "Beschaffen" (PROCURING) zu ändern:

  • Wenn Sie eine genehmigte zukünftige Reservierung anfordern, führt Google Cloud einen der folgenden Schritte aus:

    • Genehmigt die Anfrage und setzt den Beschaffungsstatus auf "Genehmigt" (APPROVED). Wenn der Beginn des Reservierungszeitraums innerhalb von 56 Tagen (8 Wochen) liegt, setzt Compute Engine den Beschaffungsstatus innerhalb weniger Minuten auf Beschaffung (PROCURING).

    • Lehnt die Anfrage ab und setzt den Beschaffungsstatus auf „Abgelehnt“ (DECLINED). Wenn Sie die zukünftige Reservierung noch einmal ändern möchten, finden Sie unter Entwurf oder abgelehnte zukünftige Reservierung ändern in diesem Dokument weitere Informationen.

  • Wenn Sie eine Änderung einer zukünftigen Beschaffungsreservierung anfordern, erstellt Compute Engine den Aktualisierungsstatus in der zukünftigen Reservierung und setzt ihn auf "Ausstehende Genehmigung aktualisieren" (AMENDMENT_PENDING_APPROVAL). Dann prüft Google Cloud Ihre Anfrage und führt einen der folgenden Schritte aus:

    • Genehmigt die Anfrage und setzt den Aktualisierungsstatus auf "Aktualisierung genehmigt" (AMENDMENT_APPROVED).

    • Lehnt die Anfrage ab, setzt den Aktualisierungsstatus auf "Aktualisierung abgelehnt" (AMENDMENT_DECLINED) und verwendet weiterhin die zuvor genehmigten Attribute für die automatisch erstellten Reservierungen.

    Während Google Cloud Ihre Anfrage zur Änderung einer zukünftigen Reservierung prüft, können Sie kein beliebiges Attribut ändern. Dies gilt auch für die Attribute, die Sie normalerweise ohne Genehmigung ändern können - bis Google Cloud Ihre Anfrage genehmigt oder ablehnt.

Wählen Sie eine der folgenden Methoden aus, um Google Cloud anzufordern, die Attribute einer genehmigten oder zukünftigen Reservierung zu ändern:

Anfrage zum Ändern einer zukünftigen Reservierung, die durch Angabe einer Instanzvorlage erstellt wird

Für eine zukünftige Reservierung, die durch Angabe einer Instanzvorlage mit dem Beschaffungsstatus "Genehmigt" (APPROVED) oder "Beschaffen" (PROCURING) erstellt wird, können Sie eine Änderung der folgenden Attribute anfordern:

  • Automatisch löschen

  • Beschreibung

  • Namenspräfix

  • Freigabeeinstellungen

  • Start- und Endzeit des Reservierungszeitraums

  • Gesamtzahl (Zahl der VMs)

Wenn Sie die Gesamtzahl innerhalb von 14 Tagen nach der Startzeit der zukünftigen Reservierung stark erhöhen oder verringern möchten, lehnt Google Cloud Ihre Anfrage wahrscheinlich ab.

Sie können Google Cloud auffordern, eine zukünftige Reservierung zu ändern, die durch Angabe einer Instanzvorlage erstellt wurde. Dazu verwenden Sie gcloud CLI und REST.

Console

So können Sie Google Cloud bitten, eine genehmigte oder beschaffende Reservierung zu ändern, die durch Angabe einer Instanzvorlage erstellt wurde:

  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 der zukünftigen Reservierung, die Sie ändern möchten.

    Die Seite mit den Details der ausgewählten zukünftigen Reservierung wird geöffnet.

  4. Wenn Sie die Option zum automatischen Löschen und die Beschreibung einer zukünftigen Reservierung ändern möchten, führen Sie einen oder mehrere der folgenden Schritte aus:

    • Klicken Sie in der Zeile Zeit für das automatische Löschen von Reservierungen auf Bearbeiten und führen Sie dann die folgenden Schritte aus:

      1. Führen Sie einen der folgenden Schritte aus:

        • So aktivieren Sie in Compute Engine die automatisch erstellten Reservierungen für Ihre zukünftige Reservierungsanfrage automatisch:

          1. Klicken Sie auf den Schalter Automatisches Löschen aktivieren auf "Ein".

          2. Optional: Geben Sie im Feld Zeit bis zum automatischen Löschen ein neues Datum und eine neue Uhrzeit für das Löschen der automatisch erstellten Reservierungen ein. Das Datum und die Uhrzeit müssen nach dem Ende 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.

      2. Klicken Sie auf Senden.

    • Klicken Sie in der Zeile Präfix auf Bearbeiten und gehen Sie dann so vor:

      1. Geben Sie im Feld Präfix ein neues Namenspräfix ein.

      2. Klicken Sie auf Senden.

    • Klicken Sie in der Zeile Beschreibung auf Bearbeiten und gehen Sie dann so vor:

      1. Geben Sie in das Feld Beschreibung eine neue Beschreibung ein.

      2. Klicken Sie auf Senden.

  5. Klicken Sie auf  Bearbeiten.

    Die Seite zum Bearbeiten der ausgewählten zukünftigen Reservierung wird geöffnet.

  6. Wenn Sie andere Attribute ändern möchten, führen Sie einen oder mehrere der folgenden Schritte aus:

    • Ändern Sie den Beginn oder das Ende für Ihre zukünftige Reservierung. Folgende Punkte sollten beachtet werden:

      • Der Beginn darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie eine zukünftige Reservierung zur Prüfung einreichen.

      • Geben Sie einen empfohlenen Wert für die Startzeit an, damit genügend Zeit bleibt, bevor die zukünftige Reservierung die Sperrzeit erreicht.

      • Geben Sie einen empfohlenen Mindestreservierungszeitraum an, um die Wahrscheinlichkeit zu erhöhen, dass Google Cloud Ihre Anfrage nach der Überprüfung genehmigt.

    • Im Abschnitt Freigabetyp können Sie entweder Lokal oder Freigegeben auswählen. Wenn Sie Freigegeben auswählen, können Sie Projekte hinzufügen oder entfernen, für die die zukünftige Reservierung freigegeben werden soll.

      Sie können bis zu 100 Projekte auswählen. Diese Projekte müssen sich in derselben Organisation wie das Projekt befinden, in dem die zukünftige Reservierung erstellt wurde (das Inhaberprojekt). Geben Sie nicht das Inhaberprojekt an. Standardmäßig ist es zulässig, die freigegebenen automatisch erstellten Reservierungen für diese zukünftige Reservierung zu nutzen.

    • Geben Sie in 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 Reservierung angegeben sind, reserviert werden sollen.

      Bei der Berechnung der Anzahl der Reservierungen, die für eine genehmigte zukünftige Reservierung erstellt werden sollen, prüft Compute Engine zuerst auf vorhandene Reservierungen. Wenn bereits Reservierungen vorhanden sind, die mit der genehmigten zukünftigen Reservierung übereinstimmen, wird die Anzahl der vorhandenen Reservierungen von der angeforderten Gesamtzahl der Reservierungen in der Anfrage subtrahiert, um die Anzahl der neuen Reservierungen zu ermitteln, die Compute Engine erstellt. Weitere Informationen finden Sie unter Reservierte Ressourcen zählen und bereitstellen.

  7. Klicken Sie zum Senden einer Änderungsanfrage zur Prüfung an Google Cloud auf Senden.

    Wenn Sie eine Anfrage senden, wird die Seite Reservierungen geöffnet. Andernfalls wird die Detailseite der zukünftigen Reservierung geöffnet.

gcloud

Wenn Sie möchten, dass Google Cloud eine genehmigte oder beschaffende Reservierung reserviert, die durch Angabe einer Instanzvorlage erstellt wurde, verwenden Sie den Befehl gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • FUTURE_RESERVATION_NAME: der Name einer vorhandenen genehmigten oder im Beschaffungsstatus befindlichen zukünftigen Reservierungen.
  • DESCRIPTION: Optional. Eine neue Beschreibung für die zukünftige Reservierung.
  • NAME_PREFIX: Optional. Ein neues Namenspräfix für die zukünftige Reservierung. Der Name jeder automatisch erstellten Reservierung für diese zukünftige Reservierung beginnt mit dem Namenspräfix. Geben Sie ein eindeutiges Namenspräfix an, um die automatisch erstellten Reservierungen für diese zukünftige Reservierung zu identifizieren.
  • PLANNING_STATUS: der Planungsstatus der zukünftigen Reservierung. Sie können nur SUBMITTED angeben, wodurch die zukünftige Reservierung zur Prüfung an Google Cloud gesendet wird.

  • PROJECT_ID: Optional. Die ID des Projekts, in dem die zukünftige Reservierung erstellt wurde. Wenn Sie eine zukünftige Reservierung für ein Einzelprojekt in eine freigegebene zukünftige Reservierung ändern, wird dieses Projekt zum Inhaberprojekt der zukünftigen Reservierung. Wenn Sie das Flag --project weglassen, wird der Wert auf die ID des aktuellen Projekts festgelegt.
  • SHARE_SETTING: Optional. Geben Sie einen der folgenden Werte an, um den Typ dieser zukünftigen Reservierung zu ändern:

    • Geben Sie projects an, um eine zukünftige Reservierung für ein einzelnes Projekt in eine freigegebene zukünftige Reservierung zu ändern. Geben Sie mindestens ein Nutzerprojekt mit dem Flag --share-with an. Andernfalls schlägt das Ändern der zukünftigen Reservierungsanfrage fehl.

    • Andernfalls geben Sie local an.

  • CONSUMER_PROJECT_IDS: Optional. Eine durch Kommas getrennte Liste der Projekt-IDs von Projekten, für die diese zukünftige Reservierung freigegeben werden kann. Geben Sie beispielsweise project-1,project-2 an: Sie können bis zu 100 Projekte angeben. Diese Projekte müssen sich in derselben Organisation wie das Projekt befinden, in dem diese zukünftige Reservierung erstellt wurde (das Inhaberprojekt). Geben Sie nicht das Inhaberprojekt an. Standardmäßig ist es zulässig, die freigegebenen automatisch erstellten Reservierungen für diese zukünftige Reservierung zu nutzen.

  • START_TIME: Optional. Der neue Beginn des Reservierungszeitraums, formatiert als RFC 3339-Zeitstempel, der so aussehen muss:

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    Ersetzen Sie 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 die Pacific Standard Time (PST) verwenden möchten, geben Sie -08:00 an. Wenn Sie keinen Offset 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 Reservierung zur Prüfung einreichen. Wenn Sie genügend Zeit haben, um eine zukünftige Reservierung nach der Genehmigung oder vor der Eingabe ihrer Sperrzeit optional zu stornieren, zu löschen oder zu ändern, müssen Sie eine empfohlene Startzeit angeben.

  • END_TIME: Optional. Die neue Endzeit 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, wobei END_DURATION die Dauer des Reservierungszeitraums in Sekunden ist. 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.

  • TOTAL_COUNT: Optional. Die neue Gesamtzahl der VMs, die Sie für den in dieser zukünftigen Reservierungsanfrage angegebenen Zeitraum reservieren möchten, die VM-Konfiguration und die Projekte.

    Bei der Berechnung der Anzahl der Reservierungen, die für eine genehmigte zukünftige Reservierung erstellt werden sollen, prüft Compute Engine zuerst auf vorhandene Reservierungen. Wenn bereits Reservierungen vorhanden sind, die mit der genehmigten zukünftigen Reservierung übereinstimmen, wird die Anzahl der vorhandenen Reservierungen von der angeforderten Gesamtzahl der Reservierungen in der Anfrage subtrahiert, um die Anzahl der neuen Reservierungen zu ermitteln, die Compute Engine erstellt. Weitere Informationen dazu, wie die Compute Engine Ressourcen zählt und bereitstellt, finden Sie hier.

    Achtung: Wenn Sie die Anzahl der zu reservierenden VMs erhöhen möchten, benötigen Sie ein ausreichendes Kontingent für die zusätzlichen Ressourcen, die Sie reservieren möchten. Andernfalls lehnt Google Cloud Ihre Änderungsanfrage ab.

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

Optional können Sie auch ändern, ob und wann Compute Engine die automatisch erstellten Reservierungen für eine zukünftige Reservierung automatisch löscht. Führen Sie dazu einen der folgenden Schritte aus:

  • Damit Compute Engine die automatisch erstellten Reservierungen nach dem Ende des Reservierungszeitraums automatisch löschen kann, wählen Sie eine der folgenden Methoden aus:

    • Geben Sie das Flag --auto-delete-auto-created-reservations an, um die Reservierungen innerhalb von zwei Stunden nach der Endzeit zu löschen (Standard).

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations
      
    • Wenn Sie die automatisch erstellten Reservierungen zu einem bestimmten Zeitpunkt nach dem Ende des Reservierungszeitraums löschen möchten, geben Sie die Flags --auto-delete-auto-created-reservations und --auto-created-reservations-delete-time an.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
      

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

    • Wenn Sie die automatisch erstellten Reservierungen nach einem bestimmten Zeitpunkt nach dem Ende des Reservierungszeitraums löschen möchten, geben Sie die Flags --auto-delete-auto-created-reservations und --auto-created-reservations-duration an.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE
      

      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 1 Tag, 2 Stunden, 3 Minuten und 4 Sekunden an.

  • Mit dem Flag --no-auto-delete-auto-created-reservations können Sie verhindern, dass die Compute Engine die automatisch erstellten Reservierungen automatisch löscht.

    gcloud beta compute future-reservations update example-future-reservation \
        --no-auto-delete-auto-created-reservations
    

Betrachten Sie beispielsweise eine genehmigte zukünftige Reservierung mit dem Namen fr-05 und in der Zone us-central1-a. Angenommen, Sie möchten Google Cloud bitten, diese zukünftige Reservierung zu ändern, indem Sie die folgenden Änderungen vornehmen:

  • Ändern Sie die Endzeit des Reservierungszeitraums auf Mitternacht des 31. Dezember 2023 UTC.

  • Reservieren Sie 10 VMs.

  • Geben Sie ein neues Namenspräfix an.

Führen Sie den folgenden Befehl aus, um Google Cloud anzufordern, fr-05 zu ändern:

gcloud beta compute future-reservations update fr-05 \
    --end-time=2024-12-31T00:00:00Z \
    --name-prefix=new-prefix \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=10 \
    --zone=us-central1-a

REST

Wenn Sie Google Cloud bitten möchten, eine genehmigte oder beschaffende Reservierung zu ändern, die durch Angabe einer Instanzvorlage erstellt wurde, stellen Sie eine PATCH-Anfrage an die Methode beta.futureReservations.update. Geben Sie im Abfrageparameter updateMask alle Felder an, die Sie aktualisieren möchten. Wenn Sie ein optionales Feld aus Ihrer Reservierung löschen müssen, fügen Sie dieses Feld in den Abfrageparameter updateMask ein und lassen Sie dieses Feld im Anfragetext weg.

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

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

Ersetzen Sie Folgendes:

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

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

  • FUTURE_RESERVATION_NAME: der Name einer vorhandenen genehmigten oder im Beschaffungsstatus befindlichen zukünftigen Reservierungen. Sie können den Namen einer zukünftigen Reservierung nicht ändern.

  • UPDATE_FIELDS: eine durch Kommas getrennte Liste von Feldern, die in dieser PATCH-Anfrage aktualisiert werden sollen. Sie müssen jedes Komma als %2C codieren. Wenn Sie beispielsweise die Felder autoDeleteAutoCreatedReservations, totalCount und endTime in Ihrer zukünftigen Reservierung aktualisieren möchten, geben Sie Folgendes an:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
    
  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Optional. Wenn Sie dieses Feld auf true setzen, löscht Compute Engine automatisch die automatisch erstellten Reservierungen für diese Reservierung einer zukünftigen Reservierung. Standardmäßig wird die Löschzeit innerhalb von zwei Stunden nach dem Ende des Reservierungszeitraums liegen. Führen Sie einen der folgenden Schritte aus, um dies zu ändern:

    • 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 geben Sie das Feld autoCreatedReservationsDeleteTime an.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME"
      }
      

      Ersetzen Sie DELETE_TIME durch ein Datum und eine Uhrzeit, wenn Compute Engine Reservierungen löscht. Datum und Uhrzeit müssen als RFC 3339-Zeitstempel formatiert sein, der so aussehen muss:

      YYYY-MM-DDTHH:MM:SSOFFSET
      

      Ersetzen Sie 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 Offset verwenden möchten, geben Sie Z an.

    • 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 geben das Feld autoCreatedReservationsDuration an.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        }
      }
      

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

  • DESCRIPTION: Optional. Führen Sie einen der folgenden Schritte aus, um die Beschreibung für diese zukünftige Reservierung zu aktualisieren:

    • Wenn Sie eine Beschreibung hinzufügen oder aktualisieren möchten, geben Sie eine Beschreibung an.

    • Wenn Sie die Beschreibung entfernen möchten, löschen Sie das Feld description aus dem Anfragetext und geben Sie es in UPDATE_FIELDS an.

  • NAME_PREFIX: Optional. Ein neues Namenspräfix für die zukünftige Reservierung. Der Name jeder automatisch erstellten Reservierung für diese zukünftige Reservierung beginnt mit dem Namenspräfix. Geben Sie ein eindeutiges Namenspräfix an, um die automatisch erstellten Reservierungen für diese zukünftige Reservierung zu identifizieren.

  • PLANNING_STATUS: der Planungsstatus der zukünftigen Reservierung. Sie können nur SUBMITTED angeben, wodurch die zukünftige Reservierung zur Prüfung an Google Cloud gesendet wird.

  • SHARE_TYPE: Optional. Geben Sie einen der folgenden Werte an, um den Freigabetyp dieser zukünftigen Reservierung zu ändern:

    • Geben Sie SPECIFIC_PROJECTS an, um eine zukünftige Reservierung für ein einzelnes Projekt in eine freigegebene zukünftige Reservierung zu ändern. Außerdem müssen Sie im Feld projects mindestens ein Nutzerprojekt angeben. Andernfalls schlägt das Ändern der zukünftigen Reservierung fehl.

    • Andernfalls geben Sie LOCAL an. Darüber hinaus müssen Sie das Feld projects aus dem Anfragetext löschen und in UPDATE_FIELDS angeben. Andernfalls schlägt das Ändern der zukünftigen Reservierung fehl.

  • CONSUMER_PROJECT_ID_1 und CONSUMER_PROJECT_ID_2: Optional. Die Projekt-IDs von Projekten, für die eine freigegebene zukünftige Reservierung freigegeben werden kann. Sie können bis zu 100 Projekte angeben. Diese Projekte müssen sich in derselben Organisation wie das Projekt befinden, in dem die zukünftige Reservierung erstellt wurde (das Inhaberprojekt). Geben Sie nicht das Inhaberprojekt an. Standardmäßig ist es zulässig, die freigegebenen automatisch erstellten Reservierungen für diese zukünftige Reservierung zu nutzen.

  • TOTAL_COUNT: Optional. Die neue Gesamtzahl der VMs, die Sie für den in dieser zukünftigen Reservierungsanfrage angegebenen Zeitraum reservieren möchten, die VM-Konfiguration und die Projekte.

    Bei der Berechnung der Anzahl der Reservierungen, die für eine genehmigte zukünftige Reservierung erstellt werden sollen, prüft Compute Engine zuerst auf vorhandene Reservierungen. Wenn bereits Reservierungen vorhanden sind, die mit der genehmigten zukünftigen Reservierung übereinstimmen, wird die Anzahl der vorhandenen Reservierungen von der angeforderten Gesamtzahl der Reservierungen in der Anfrage subtrahiert, um die Anzahl der neuen Reservierungen zu ermitteln, die Compute Engine erstellt. Weitere Informationen finden Sie unter Reservierte Ressourcen zählen und bereitstellen.

  • START_TIME: Optional. Die neue Startzeit des Reservierungszeitraums ist als RFC 3339-Zeitstempel formatiert. Der Beginn darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie eine zukünftige Reservierung zur Prüfung einreichen. Geben Sie außerdem eine empfohlene Startzeit an, damit genügend Zeit bleibt, bevor eine zukünftige Reservierung die Sperrzeit erreicht.

  • END_TIME: Optional. Die neue Endzeit 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 eine 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.

Betrachten Sie beispielsweise eine genehmigte zukünftige Reservierung mit dem Namen fr-05 und in der Zone us-central1-a. Angenommen, Sie möchten Google Cloud bitten, diese zukünftige Reservierung zu ändern, indem Sie die folgenden Änderungen vornehmen:

  • Ändern Sie die Endzeit des Reservierungszeitraums auf Mitternacht des 31. Dezember 2023 UTC.

  • Reservieren Sie 10 VMs.

  • Geben Sie ein neues Namenspräfix an.

Wenn Sie Google Cloud bitten möchten, fr-05 zu ändern, stellen Sie die folgende PATCH-Anfrage:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

{
  "name": "fr-05",
  "namePrefix": "new-prefix",
  "planningStatus": "SUBMITTED",
  "specificSkuProperties": {
    "totalCount": "10"
  },
  "timeWindow": {
    "endTime": "2023-12-31T00:00:00Z"
  }
}

Nachdem Sie eine Anfrage zum Ändern einer zukünftigen Reservierung an Google Cloud gesendet haben, können Sie den Status der Anfrage überwachen. Rufen Sie dazu die Details der zukünftigen Reservierung auf.

Anfrage zur Änderung einer zukünftigen Reservierung, die durch direkte Angabe von Attributen erstellt wird

Für eine zukünftige Reservierung, die durch direkte Angabe der Attribute mit dem Beschaffungsstatus "Genehmigt" (APPROVED) oder "Beschaffen" (Procuring) erstellt wird, können Sie eine Änderung der folgenden Attribute anfordern:

  • Automatisch löschen

  • Beschreibung

  • Namenspräfix

  • GPUs

  • Lokale SSDs und der Typ der Laufwerkschnittstelle

  • Maschinenserie und Maschinentyp

  • Mindest-CPU-Plattform

  • Freigabeeinstellungen

  • Start- und Endzeit des Reservierungszeitraums

  • Gesamtzahl (Zahl der VMs)

Wenn Sie eine Änderung von VM-Attributen anfordern oder die Gesamtzahl innerhalb von 14 Tagen nach Beginn der zukünftigen Reservierung stark erhöhen oder verringern. dann lehnt Google Cloud Ihre Anfrage wahrscheinlich ab.

Sie können Google Cloud anfordern, eine zukünftige Reservierung zu ändern, die durch Angabe von Attributen direkt erstellt wurde. Dazu verwenden Sie Google Cloud Console, die gcloud CLI und REST.

Console

So beantragen Sie Google Cloud, eine genehmigte oder beschaffende zukünftige Reservierung zu ändern, die durch direkte Angabe von Attributen erstellt wurde:

  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 der zukünftigen Reservierung, die Sie ändern möchten.

    Die Seite mit den Details der ausgewählten zukünftigen Reservierung wird geöffnet.

  4. Wenn Sie die Option zum automatischen Löschen und die Beschreibung einer zukünftigen Reservierung ändern möchten, führen Sie einen oder mehrere der folgenden Schritte aus:

    • Klicken Sie in der Zeile Zeit für das automatische Löschen von Reservierungen auf Bearbeiten und führen Sie dann die folgenden Schritte aus:

      1. Führen Sie einen der folgenden Schritte aus:

        • So aktivieren Sie in Compute Engine die automatisch erstellten Reservierungen für Ihre zukünftige Reservierungsanfrage automatisch:

          1. Klicken Sie auf den Schalter Automatisches Löschen aktivieren auf "Ein".

          2. Optional: Geben Sie im Feld Zeit bis zum automatischen Löschen ein neues Datum und eine neue Uhrzeit für das Löschen der automatisch erstellten Reservierungen ein. Das Datum und die Uhrzeit müssen nach dem Ende 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.

      2. Klicken Sie auf Senden.

    • Klicken Sie in der Zeile Präfix auf Bearbeiten und gehen Sie dann so vor:

      1. Geben Sie im Feld Präfix ein neues Namenspräfix ein.

      2. Klicken Sie auf Senden.

    • Klicken Sie in der Zeile Beschreibung auf Bearbeiten und gehen Sie dann so vor:

      1. Geben Sie in das Feld Beschreibung eine neue Beschreibung ein.

      2. Klicken Sie auf Senden.

  5. Klicken Sie auf  Bearbeiten.

    Die Seite zum Bearbeiten der ausgewählten zukünftigen Reservierung wird geöffnet.

  6. Wenn Sie andere Attribute ändern möchten, führen Sie einen oder mehrere der folgenden Schritte aus:

    • Ändern Sie den Beginn oder das Ende für Ihre zukünftige Reservierung. Folgende Punkte sollten beachtet werden:

      • Der Beginn darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie eine zukünftige Reservierung zur Prüfung einreichen.

      • Geben Sie einen empfohlenen Wert für die Startzeit an, damit genügend Zeit bleibt, bevor die zukünftige Reservierung die Sperrzeit erreicht.

      • Geben Sie einen empfohlenen Mindestreservierungszeitraum an, um die Wahrscheinlichkeit zu erhöhen, dass Google Cloud Ihre Anfrage nach der Überprüfung genehmigt.

    • Im Abschnitt Freigabetyp können Sie entweder Lokal oder Freigegeben auswählen. Wenn Sie Freigegeben auswählen, können Sie Projekte hinzufügen oder entfernen, für die die zukünftige Reservierung freigegeben werden soll.

      Sie können bis zu 100 Projekte auswählen. Diese Projekte müssen sich in derselben Organisation wie das Projekt befinden, in dem die zukünftige Reservierung erstellt wurde (das Inhaberprojekt). Geben Sie nicht das Inhaberprojekt an. Standardmäßig ist es zulässig, die freigegebenen automatisch erstellten Reservierungen für diese zukünftige Reservierung zu nutzen.

    • Geben Sie in 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 Reservierung angegeben sind, reserviert werden sollen.

      Bei der Berechnung der Anzahl der Reservierungen, die für eine genehmigte zukünftige Reservierung erstellt werden sollen, prüft Compute Engine zuerst auf vorhandene Reservierungen. Wenn bereits Reservierungen vorhanden sind, die mit der genehmigten zukünftigen Reservierung übereinstimmen, wird die Anzahl der vorhandenen Reservierungen von der angeforderten Gesamtzahl der Reservierungen in der Anfrage subtrahiert, um die Anzahl der neuen Reservierungen zu ermitteln, die Compute Engine erstellt. Weitere Informationen finden Sie unter Reservierte Ressourcen zählen und bereitstellen.

    • Im Abschnitt Maschinenkonfiguration können Sie Folgendes ändern:

      • Die Maschinenserie und der Maschinentyp, die in den reservierten VMs verwendet werden.

      • Die GPUs, die an die reservierten VMs angehängt werden.

      • Die lokalen SSDs und der Laufwerkschnittstellentyp der reservierten VMs.

  7. Klicken Sie zum Senden einer Änderungsanfrage zur Prüfung an Google Cloud auf Senden.

    Wenn Sie eine Anfrage senden, wird die Seite Reservierungen geöffnet. Andernfalls wird die Detailseite der zukünftigen Reservierung geöffnet.

gcloud

Wenn Sie Google Cloud bitten möchten, eine genehmigte oder beschaffende Reservierung zu ändern, die direkt durch Angabe von Attributen erstellt wird, verwenden Sie den Befehlgcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --description="DESCRIPTION" \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • FUTURE_RESERVATION_NAME: der Name einer vorhandenen genehmigten oder im Beschaffungsstatus befindlichen zukünftigen Reservierungen.
  • Optional. Führen Sie einen der folgenden Schritte aus:

    • Geben Sie Folgendes an, um jeder reservierten VM Grafikprozessoren (GPUs) hinzuzufügen:

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

      • ACCELERATOR_TYPE: der GPU-Typ, der den reservierten VMs hinzugefügt werden soll.

      Achten Sie darauf, dass der Maschinentyp, den Sie in der zukünftigen Reservierung angeben, die von Ihnen angegebenen GPUs unterstützt und die GPU in der Zone verfügbar ist, in der Sie Ressourcen reservieren möchten. Andernfalls treten Fehler auf.

    • Um alle GPUs aus dieser zukünftigen Anfrage zu entfernen, ersetzen Sie das Flag --accelerator durch das Flag --clear-accelerator.

  • DESCRIPTION: Optional. Eine neue Beschreibung für die zukünftige Reservierung.
  • Optional. Führen Sie einen der folgenden Schritte aus:

    • Zum Hinzufügen oder Bearbeiten des Schnittstellentyps, den die lokalen SSDs für jede VM verwenden sollen, ersetzen Sie INTERFACE_1 und INTERFACE_2. Der Wert muss einer der folgenden sein:

      Jede lokale SSD ist 375 GB groß. Wiederholen Sie das Flag --local-ssd für jede lokale SSD, die Sie hinzufügen möchten. Es können maximal 24 lokale SSDs angegeben werden.

    • Wenn Sie alle lokalen SSDs aus dieser zukünftigen Reservierung entfernen möchten, entfernen Sie alle --local-ssd-Flags und geben Sie das Flag --clear-local-ssd an.

  • MACHINE_TYPE: Optional. Ein vordefinierter oder benutzerdefinierter Maschinentyp, der für jede VM verwendet wird. Lesen Sie die Einschränkungen für VMs mit benutzerdefinierten Maschinentypen, bevor Sie einen benutzerdefinierten Maschinentyp angeben.

  • MINIMUM_CPU_PLATFORM: Optional. Die für jede VM zu verwendende Mindest-CPU-Plattform. Wenn Sie das Flag --min-cpu-platform ausschließen, wird der Wert auf die Standard-CPU-Plattform der Zone festgelegt.

  • NAME_PREFIX: Optional. Ein neues Namenspräfix für die zukünftige Reservierung. Der Name jeder automatisch erstellten Reservierung für diese zukünftige Reservierung beginnt mit dem Namenspräfix. Geben Sie ein eindeutiges Namenspräfix an, um die automatisch erstellten Reservierungen für diese zukünftige Reservierung zu identifizieren.
  • PLANNING_STATUS: der Planungsstatus der zukünftigen Reservierung. Sie können nur SUBMITTED angeben, wodurch die zukünftige Reservierung zur Prüfung an Google Cloud gesendet wird.

  • PROJECT_ID: Optional. Die ID des Projekts, in dem die zukünftige Reservierung erstellt wurde. Wenn Sie eine zukünftige Reservierung für ein Einzelprojekt in eine freigegebene zukünftige Reservierung ändern, wird dieses Projekt zum Inhaberprojekt der zukünftigen Reservierung. Wenn Sie das Flag --project weglassen, wird der Wert auf die ID des aktuellen Projekts festgelegt.
  • SHARE_SETTING: Optional. Geben Sie einen der folgenden Werte an, um den Typ dieser zukünftigen Reservierung zu ändern:

    • Geben Sie projects an, um eine zukünftige Reservierung für ein einzelnes Projekt in eine freigegebene zukünftige Reservierung zu ändern. Geben Sie mindestens ein Nutzerprojekt mit dem Flag --share-with an. Andernfalls schlägt das Ändern der zukünftigen Reservierungsanfrage fehl.

    • Andernfalls geben Sie local an.

  • CONSUMER_PROJECT_IDS: Optional. Eine durch Kommas getrennte Liste der Projekt-IDs von Projekten, für die diese zukünftige Reservierung freigegeben werden kann. Geben Sie beispielsweise project-1,project-2 an: Sie können bis zu 100 Projekte angeben. Diese Projekte müssen sich in derselben Organisation wie das Projekt befinden, in dem diese zukünftige Reservierung erstellt wurde (das Inhaberprojekt). Geben Sie nicht das Inhaberprojekt an. Standardmäßig ist es zulässig, die freigegebenen automatisch erstellten Reservierungen für diese zukünftige Reservierung zu nutzen.

  • START_TIME: Optional. Der neue Beginn des Reservierungszeitraums, formatiert als RFC 3339-Zeitstempel, der so aussehen muss:

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    Ersetzen Sie 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 die Pacific Standard Time (PST) verwenden möchten, geben Sie -08:00 an. Wenn Sie keinen Offset 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 Reservierung zur Prüfung einreichen. Wenn Sie genügend Zeit haben, um eine zukünftige Reservierung nach der Genehmigung oder vor der Eingabe ihrer Sperrzeit optional zu stornieren, zu löschen oder zu ändern, müssen Sie eine empfohlene Startzeit angeben.

  • END_TIME: Optional. Die neue Endzeit 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, wobei END_DURATION die Dauer des Reservierungszeitraums in Sekunden ist. 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.

  • TOTAL_COUNT: Optional. Die neue Gesamtzahl der VMs, die Sie für den in dieser zukünftigen Reservierungsanfrage angegebenen Zeitraum reservieren möchten, die VM-Konfiguration und die Projekte.

    Bei der Berechnung der Anzahl der Reservierungen, die für eine genehmigte zukünftige Reservierung erstellt werden sollen, prüft Compute Engine zuerst auf vorhandene Reservierungen. Wenn bereits Reservierungen vorhanden sind, die mit der genehmigten zukünftigen Reservierung übereinstimmen, wird die Anzahl der vorhandenen Reservierungen von der angeforderten Gesamtzahl der Reservierungen in der Anfrage subtrahiert, um die Anzahl der neuen Reservierungen zu ermitteln, die Compute Engine erstellt. Weitere Informationen dazu, wie die Compute Engine Ressourcen zählt und bereitstellt, finden Sie hier.

    Achtung: Wenn Sie die Anzahl der zu reservierenden VMs erhöhen möchten, benötigen Sie ein ausreichendes Kontingent für die zusätzlichen Ressourcen, die Sie reservieren möchten. Andernfalls lehnt Google Cloud Ihre Änderungsanfrage ab.

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

Optional können Sie auch ändern, ob und wann Compute Engine die automatisch erstellten Reservierungen für eine zukünftige Reservierung automatisch löscht. Führen Sie dazu einen der folgenden Schritte aus:

  • Damit Compute Engine die automatisch erstellten Reservierungen nach dem Ende des Reservierungszeitraums automatisch löschen kann, wählen Sie eine der folgenden Methoden aus:

    • Geben Sie das Flag --auto-delete-auto-created-reservations an, um die Reservierungen innerhalb von zwei Stunden nach der Endzeit zu löschen (Standard).

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations
      
    • Wenn Sie die automatisch erstellten Reservierungen zu einem bestimmten Zeitpunkt nach dem Ende des Reservierungszeitraums löschen möchten, geben Sie die Flags --auto-delete-auto-created-reservations und --auto-created-reservations-delete-time an.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
      

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

    • Wenn Sie die automatisch erstellten Reservierungen nach einem bestimmten Zeitpunkt nach dem Ende des Reservierungszeitraums löschen möchten, geben Sie die Flags --auto-delete-auto-created-reservations und --auto-created-reservations-duration an.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE
      

      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 1 Tag, 2 Stunden, 3 Minuten und 4 Sekunden an.

  • Mit dem Flag --no-auto-delete-auto-created-reservations können Sie verhindern, dass die Compute Engine die automatisch erstellten Reservierungen automatisch löscht.

    gcloud beta compute future-reservations update example-future-reservation \
        --no-auto-delete-auto-created-reservations
    

Betrachten Sie beispielsweise eine genehmigte zukünftige Reservierung mit dem Namen fr-05 und in der Zone us-central1-a. Angenommen, Sie möchten Google Cloud bitten, diese zukünftige Reservierung zu ändern, indem Sie die folgenden Änderungen vornehmen:

  • Ändern Sie die Endzeit des Reservierungszeitraums auf Mitternacht des 31. Dezember 2023 UTC.

  • Reservieren Sie 10 VMs.

  • Geben Sie ein neues Namenspräfix an.

Führen Sie den folgenden Befehl aus, um Google Cloud anzufordern, fr-05 zu ändern:

gcloud beta compute future-reservations update fr-05 \
    --end-time=2024-12-31T00:00:00Z \
    --name-prefix=new-prefix \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=10 \
    --zone=us-central1-a

REST

Wenn Sie Google Cloud bitten möchten, eine genehmigte oder beschaffte zukünftige Reservierung zu ändern, die durch direkte Angabe von Attributen erstellt wurde, stellen Sie eine PATCH Anfrage an die Methode beta.futureReservations.update. Geben Sie im Abfrageparameter updateMask alle Felder an, die Sie aktualisieren möchten. Wenn Sie ein optionales Feld aus Ihrer Reservierung löschen müssen, fügen Sie dieses Feld in den Abfrageparameter updateMask ein und lassen Sie dieses Feld im Anfragetext weg.

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

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

Ersetzen Sie Folgendes:

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

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

  • FUTURE_RESERVATION_NAME: der Name einer vorhandenen genehmigten oder im Beschaffungsstatus befindlichen zukünftigen Reservierungen. Sie können den Namen einer zukünftigen Reservierung nicht ändern.

  • UPDATE_FIELDS: eine durch Kommas getrennte Liste von Feldern, die in dieser PATCH-Anfrage aktualisiert werden sollen. Sie müssen jedes Komma als %2C codieren. Wenn Sie beispielsweise die Felder autoDeleteAutoCreatedReservations, totalCount und endTime in Ihrer zukünftigen Reservierung aktualisieren möchten, geben Sie Folgendes an:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
    
  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Optional. Wenn Sie dieses Feld auf true setzen, löscht Compute Engine automatisch die automatisch erstellten Reservierungen für diese Reservierung einer zukünftigen Reservierung. Standardmäßig wird die Löschzeit innerhalb von zwei Stunden nach dem Ende des Reservierungszeitraums liegen. Führen Sie einen der folgenden Schritte aus, um dies zu ändern:

    • 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 geben Sie das Feld autoCreatedReservationsDeleteTime an.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME"
      }
      

      Ersetzen Sie DELETE_TIME durch ein Datum und eine Uhrzeit, wenn Compute Engine Reservierungen löscht. Datum und Uhrzeit müssen als RFC 3339-Zeitstempel formatiert sein, der so aussehen muss:

      YYYY-MM-DDTHH:MM:SSOFFSET
      

      Ersetzen Sie 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 Offset verwenden möchten, geben Sie Z an.

    • 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 geben das Feld autoCreatedReservationsDuration an.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        }
      }
      

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

  • DESCRIPTION: Optional. Führen Sie einen der folgenden Schritte aus, um die Beschreibung für diese zukünftige Reservierung zu aktualisieren:

    • Wenn Sie eine Beschreibung hinzufügen oder aktualisieren möchten, geben Sie eine Beschreibung an.

    • Wenn Sie die Beschreibung entfernen möchten, löschen Sie das Feld description aus dem Anfragetext und geben Sie es in UPDATE_FIELDS an.

  • NAME_PREFIX: Optional. Ein neues Namenspräfix für die zukünftige Reservierung. Der Name jeder automatisch erstellten Reservierung für diese zukünftige Reservierung beginnt mit dem Namenspräfix. Geben Sie ein eindeutiges Namenspräfix an, um die automatisch erstellten Reservierungen für diese zukünftige Reservierung zu identifizieren.

  • PLANNING_STATUS: der Planungsstatus der zukünftigen Reservierung. Sie können nur SUBMITTED angeben, wodurch die zukünftige Reservierung zur Prüfung an Google Cloud gesendet wird.

  • SHARE_TYPE: Optional. Geben Sie einen der folgenden Werte an, um den Freigabetyp dieser zukünftigen Reservierung zu ändern:

    • Geben Sie SPECIFIC_PROJECTS an, um eine zukünftige Reservierung für ein einzelnes Projekt in eine freigegebene zukünftige Reservierung zu ändern. Außerdem müssen Sie im Feld projects mindestens ein Nutzerprojekt angeben. Andernfalls schlägt das Ändern der zukünftigen Reservierung fehl.

    • Andernfalls geben Sie LOCAL an. Darüber hinaus müssen Sie das Feld projects aus dem Anfragetext löschen und in UPDATE_FIELDS angeben. Andernfalls schlägt das Ändern der zukünftigen Reservierung fehl.

  • CONSUMER_PROJECT_ID_1 und CONSUMER_PROJECT_ID_2: Optional. Die Projekt-IDs von Projekten, für die eine freigegebene zukünftige Reservierung freigegeben werden kann. Sie können bis zu 100 Projekte angeben. Diese Projekte müssen sich in derselben Organisation wie das Projekt befinden, in dem die zukünftige Reservierung erstellt wurde (das Inhaberprojekt). Geben Sie nicht das Inhaberprojekt an. Standardmäßig ist es zulässig, die freigegebenen automatisch erstellten Reservierungen für diese zukünftige Reservierung zu nutzen.

  • Optional. Zum Aktualisieren der Grafikprozessoren (GPUs), die an jede reservierte VM angehängt sind, führen Sie einen der folgenden Schritte aus:

    • Geben Sie Folgendes an, um GPUs hinzuzufügen oder zu ändern:

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

      • ACCELERATOR_TYPE: der GPU-Typ, der den reservierten VMs hinzugefügt werden soll.

      Achten Sie darauf, dass der Maschinentyp, den Sie in der zukünftigen Reservierung angeben, die von Ihnen angegebenen GPUs unterstützt und die GPU in der Zone verfügbar ist, in der Sie Ressourcen reservieren möchten. Andernfalls treten Fehler auf.

    • Wenn Sie alle GPUs aus dieser zukünftigen Anfrage entfernen möchten, lassen Sie das Feld guestAccelerators im Anfragetext weg und geben Sie es in UPDATE_FIELDS an.

  • Optional. Führen Sie einen der folgenden Schritte aus, um die lokalen SSDs zu aktualisieren, die an jede reservierte VM angehängt sind:

    • Zum Hinzufügen oder Bearbeiten des Schnittstellentyps, den die lokalen SSDs für jede VM verwenden sollen, ersetzen Sie INTERFACE_1 und INTERFACE_2. Der Wert muss einer der folgenden sein:

      Wiederholen Sie die Felder diskSizeGb und interface für jede lokale SSD, die Sie hinzufügen oder aktualisieren möchten. Es können maximal 24 lokale SSDs angegeben werden.

    • Wenn Sie alle lokalen SSDs aus dieser zukünftigen Reservierung entfernen möchten, löschen Sie das Feld localSsds aus dem Anfragetext und geben Sie es in UPDATE_FIELDS an.

  • MACHINE_TYPE: Optional. Ein vordefinierter oder benutzerdefinierter Maschinentyp, der für jede VM verwendet wird. Lesen Sie die Einschränkungen für VMs mit benutzerdefinierten Maschinentypen, bevor Sie einen benutzerdefinierten Maschinentyp angeben.

  • MINIMUM_CPU_PLATFORM: Optional. Führen Sie einen der folgenden Schritte aus, um die für jede VM zu verwendende Mindest-CPU-Plattform zu aktualisieren:

    • Wenn Sie die Mindest-CPU-Plattform hinzufügen oder aktualisieren möchten, geben Sie eine Mindest-CPU-Plattform an.

    • Wenn Sie zur Standard-CPU-Plattform der Zone zurückkehren möchten, löschen Sie das Feld minCpuPlatform aus dem Anfragetext und geben es in UPDATE_FIELDS an.

  • TOTAL_COUNT: Optional. Die neue Gesamtzahl der VMs, die Sie für den in dieser zukünftigen Reservierungsanfrage angegebenen Zeitraum reservieren möchten, die VM-Konfiguration und die Projekte.

    Bei der Berechnung der Anzahl der Reservierungen, die für eine genehmigte zukünftige Reservierung erstellt werden sollen, prüft Compute Engine zuerst auf vorhandene Reservierungen. Wenn bereits Reservierungen vorhanden sind, die mit der genehmigten zukünftigen Reservierung übereinstimmen, wird die Anzahl der vorhandenen Reservierungen von der angeforderten Gesamtzahl der Reservierungen in der Anfrage subtrahiert, um die Anzahl der neuen Reservierungen zu ermitteln, die Compute Engine erstellt. Weitere Informationen finden Sie unter Reservierte Ressourcen zählen und bereitstellen.

  • START_TIME: Optional. Die neue Startzeit des Reservierungszeitraums ist als RFC 3339-Zeitstempel formatiert. Der Beginn darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie eine zukünftige Reservierung zur Prüfung einreichen. Geben Sie außerdem eine empfohlene Startzeit an, damit genügend Zeit bleibt, bevor eine zukünftige Reservierung die Sperrzeit erreicht.

  • END_TIME: Optional. Die neue Endzeit 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 eine 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.

Betrachten Sie beispielsweise eine genehmigte zukünftige Reservierung mit dem Namen fr-05 und in der Zone us-central1-a. Angenommen, Sie möchten Google Cloud bitten, diese zukünftige Reservierung zu ändern, indem Sie die folgenden Änderungen vornehmen:

  • Ändern Sie die Endzeit des Reservierungszeitraums auf Mitternacht des 31. Dezember 2023 UTC.

  • Reservieren Sie 10 VMs.

  • Geben Sie ein neues Namenspräfix an.

Wenn Sie Google Cloud bitten möchten, fr-05 zu ändern, stellen Sie die folgende PATCH-Anfrage:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

{
  "name": "fr-05",
  "namePrefix": "new-prefix",
  "planningStatus": "SUBMITTED",
  "specificSkuProperties": {
    "totalCount": "10"
  },
  "timeWindow": {
    "endTime": "2023-12-31T00:00:00Z"
  }
}

Nachdem Sie eine Anfrage zum Ändern einer zukünftigen Reservierung an Google Cloud gesendet haben, können Sie den Status der Anfrage überwachen. Rufen Sie dazu die Details der zukünftigen Reservierung auf.

Alle anderen Attribute in einer zukünftigen Reservierungsanfrage ändern

Wenn Sie andere Attribute in einer zukünftigen Reservierungsanfrage ändern möchten, bevor sie den Beschaffungsstatus erreichen (PROCURING), führen Sie folgende Schritte aus:

  1. Führen Sie einen oder mehrere der folgenden Schritte aus:

  2. Erstellen Sie ein neues Einzelprojekt oder eine freigegebene zukünftige Reservierungsanfrage mit den gewünschten Aktualisierungen.

Fehlerbehebung

Wenn beim Ändern 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 Kundenbetreuer oder an den Google Cloud-Support.

Zukünftige Reservierungsanfragen abbrechen

Sie können eine genehmigte, abgelehnte oder ausstehende Genehmigung einer zukünftigen Reservierung abbrechen, um Google Cloud daran zu hindern, die angeforderte Kapazität bereitzustellen. Wenn Sie eine zukünftige Reservierungsanfrage abbrechen, können Sie nur die Details ansehen oder sie löschen.

Sie können eine zukünftige Reservierungsanfrage mit der gcloud CLI und REST abbrechen.

gcloud

Verwenden Sie den Befehl gcloud beta compute future-reservations cancel, um eine zukünftige Reservierungsanfrage abzubrechen.

gcloud beta compute future-reservations cancel FUTURE_RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • FUTURE_RESERVATION_NAME: Den Name einer vorhandenen zukünftigen Reservierungsanfrage.

  • PROJECT_ID: Optional. Die ID des Projekts, in dem sich die zukünftige Reservierungsanfrage befindet. Wenn Sie das --project-Flag weglassen, wird die ID des aktuellen Projekts verwendet.

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

REST

Wenn Sie eine zukünftige Reservierungsanfrage abbrechen möchten, senden Sie eine POST-Anfrage an die Methode beta.futureReservations.cancel.

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

Ersetzen Sie 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: Den Name einer vorhandenen zukünftigen Reservierungsanfrage.

Zukünftige Reservierungsanfragen löschen

Sie können eine zukünftige Reservierungsanfrage nur in einem der folgenden Fälle löschen:

  • Die zukünftige Reservierungsanfrage wurde abgebrochen.

  • Bevor die zukünftige Reservierung die Startzeit des Reservierungszeitraums erreicht hat.

  • Nachdem die zukünftige Reservierung das Ende des Reservierungszeitraums erreicht hat.

Durch das Löschen einer zukünftigen Reservierung werden die automatisch erstellten Reservierungen für die zukünftige Reservierung nicht gelöscht. Wenn Sie eine automatisch erstellte Reservierung nach Ablauf des Reservierungszeitraums löschen möchten, lesen Sie stattdessen die Informationen unter Reservierungen löschen.

Sie können eine zukünftige Reservierungsanfrage mit der Google Cloud Console, der gcloud CLI und REST löschen.

Console

So löschen Sie eine zukünftige Reservierungsanfrage:

  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 das Kästchen neben jeder zukünftigen Reservierungsanfrage an, die Sie löschen möchten.

  4. Klicken Sie auf Reservierung löschen.

  5. Klicken Sie zur Bestätigung auf Löschen.

    Das Löschen einer zukünftigen Reservierungsanfrage kann bis zu einer Minute dauern.

gcloud

Verwenden Sie zum Löschen einer zukünftigen Reservierungsanfrage den Befehl gcloud beta compute future-reservations delete.

gcloud beta compute future-reservations delete FUTURE_RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • FUTURE_RESERVATION_NAME: Den Name einer vorhandenen zukünftigen Reservierungsanfrage.

  • PROJECT_ID: Optional. Die ID des Projekts, in dem sich die zukünftige Reservierungsanfrage befindet. Wenn Sie das --project-Flag weglassen, wird die ID des aktuellen Projekts verwendet.

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

REST

Wenn Sie eine zukünftige Reservierungsanfrage löschen möchten, senden Sie eine DELETE-Anfrage an die Methode beta.futureReservations.delete.

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

Ersetzen Sie 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: Den Name einer vorhandenen zukünftigen Reservierungsanfrage.

Nächste Schritte