Zukünftige Reservierungsanfragen ändern

In diesem Dokument wird erläutert, wie Sie zukünftige Reservierungsanfragen ändern.

Sie können eine zukünftige Reservierungsanfrage jederzeit vor Beginn ändern, sofern sie nicht abgebrochen wurde oder die Genehmigung aussteht. Das Ändern einer zukünftigen Reservierungsanfrage ist nützlich, wenn sich Ihre Kapazitätsanforderungen ändern, z. B. wenn Sie die Anzahl der reservierten VM-Instanzen erhöhen oder den Reservierungszeitraum ändern möchten. Wenn Sie eine Anfrage für eine freigegebene zukünftige Reservierung ändern möchten, müssen Sie die Anfrage über das Inhaberprojekt ändern.

Informationen zum Ändern einer automatisch erstellten Reservierung nach Ablauf des Reservierungszeitraums finden Sie unter Reservierungen ändern.

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. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute Future Reservation Admin (roles/compute.futureReservationAdmin) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ändern zukünftiger Reservierungsanfragen benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung compute.futureReservations.update, die zum Ändern zukünftiger Reservierungsanfragen erforderlich ist.

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

Modifizierbare Attribute

Eine Anfrage für eine zukünftige Reservierung hat mehrere Eigenschaften, die die Reservierung definieren, ihr Verhalten bestimmen und die zu reservierenden Ressourcen angeben. Sie können diese Properties wie in den folgenden Abschnitten beschrieben ändern.

Nach der Erstellung

Nachdem Sie eine Anfrage für eine zukünftige Reservierung erstellt haben, können Sie die folgenden Attribute nicht mehr ändern:

Der Name der Anfrage für eine zukünftige Reservierung.
Das Projekt, in dem die zukünftige Reservierungsanfrage erstellt wurde.
Die Zone, in der sich die zukünftige Reservierungsanfrage befindet.
Die zu verwendende Instanzvorlage und die in der Instanzvorlage angegebenen VM-Attribute.

Wenn Sie eines dieser Attribute ändern möchten, bevor eine Anfrage für eine zukünftige Reservierung ihre Sperrzeit erreicht, erstellen Sie eine neue Anfrage.

Vor dem Einreichen

Bevor Sie eine Anfrage für eine zukünftige Reservierung zur Prüfung an Google Cloud senden oder nachdem die Anfrage abgelehnt wurde, können Sie die folgenden Properties ändern:

Option zum automatischen Löschen
Beschreibung
GPUs und der GPU-Typ
Lokale SSDs und der Typ der Laufwerkschnittstelle
Maschinenreihe und Maschinentyp
Mindest-CPU-Plattform
Namenspräfix
Freigabeeinstellungen
Start- und Endzeit des Reservierungszeitraums
Gesamtzahl (Zahl der VMs)

Die Änderung des Status einer Entwurfsanfrage für eine zukünftige Reservierung erfolgt sofort und es gibt keine Beschränkungen für die Häufigkeit, mit der Sie sie ändern können. Wenn Sie eine abgelehnte (DECLINED) Anfrage für eine zukünftige Reservierung ändern möchten, können Sie die Anfrage nur ändern, wenn Sie sie noch einmal zur Überprüfung einreichen.

Nach der Genehmigung

Nachdem Google Cloud eine zukünftige Reservierung genehmigt hat, können Sie sie ändern, bevor sie den Beschaffungsstatus „Bereitstellung“ (PROVISIONING) erreicht. Insbesondere können Sie die folgenden Properties ändern:

Sie können die zukünftige Reservierung jederzeit ändern:
- Option zum automatischen Löschen
- Beschreibung
- Namenspräfix
Wenn Sie mindestens 72 Stunden vor Beginn einen Änderungsantrag einreichen,:
- GPUs und der GPU-Typ^*
- 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.

Zukünftige Reservierungsanfragen ändern

Bevor Sie eine Anfrage für eine zukünftige Reservierung ändern, sollten Sie sich die Attribute ansehen, die Sie ändern können, falls Sie das noch nicht getan haben.

Wenn Sie eine Anfrage für eine zukünftige Reservierung für ein einzelnes Projekt, die über eine Instanzvorlage erstellt wurde, in eine freigegebene Anfrage für eine zukünftige Reservierung ändern möchten, können Sie nicht dieselbe Vorlage verwenden, um VMs zu erstellen, die die automatisch erstellten Reservierungen außerhalb des Projekts nutzen können, das die freigegebene Anfrage für eine zukünftige Reservierung erstellt hat. Für die Projekte, für die die zukünftige Reservierung freigegeben ist, müssen Sie ähnliche Vorlagen in diesen Projekten erstellen oder VMs erstellen, indem Sie Attribute direkt angeben.

Wählen Sie eine der folgenden Optionen aus, um eine zukünftige Reservierungsanfrage zu ändern:

Console

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

Zu „Reservierungen“
Klicken Sie auf den Tab Zukünftige Reservierungen.
Klicken Sie in der Spalte Name auf den Namen der zukünftigen Reservierungsanfrage, die Sie ändern möchten.

Die Seite mit den Details der zukünftigen Reservierungsanfrage wird geöffnet.
Wenn Sie die Option zum automatischen Löschen, die Beschreibung oder das Namenspräfix einer genehmigten zukünftigen Reservierung ändern möchten, haben Sie folgende Möglichkeiten:
- Wenn Sie die Option zum automatischen Löschen ändern möchten, 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. Geben Sie an, ob Sie die Option zum automatischen Löschen aktivieren, deaktivieren oder ändern möchten. Gehen Sie dazu so vor:
    - So aktivieren Sie die Option zum automatischen Löschen oder ändern den Zeitpunkt, zu dem Compute Engine die automatisch erstellten Reservierungen automatisch löscht:
      1. Klicken Sie auf die Ein/Aus-Schaltfläche Automatisches Löschen aktivieren, um die Position „Ein“ festzulegen.
      2. Optional: Geben Sie unter 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 Enddatum des Reservierungszeitraums liegen. Wenn Sie dieses Feld leer lassen, werden die automatisch erstellten Reservierungen innerhalb von zwei Stunden nach dem Ende des Reservierungszeitraums gelöscht.
    - Klicken Sie andernfalls auf die Ein/Aus-Schaltfläche Automatisches Löschen aktivieren, um die Position „Aus“ festzulegen.
  2. Klicken Sie auf Senden.
- Wenn Sie das Präfix ändern möchten, klicken Sie in der Zeile Präfix auf Bearbeiten und gehen Sie dann so vor:
  1. Geben Sie unter Präfix ein neues Namenspräfix ein.
  2. Klicken Sie auf Senden.
- Wenn Sie die Beschreibung ändern möchten, klicken Sie in der Zeile Beschreibung auf Bearbeiten und gehen Sie dann so vor:
  1. Geben Sie unter Beschreibung eine neue Beschreibung ein.
  2. Klicken Sie auf Senden.
Klicken Sie auf Bearbeiten oder auf Entwurf bearbeiten.

Die Seite zum Bearbeiten der ausgewählten Anfrage für eine zukünftige Reservierung wird geöffnet.
Wenn Sie eine Anfrage für eine zukünftige Reservierung ändern und zur Prüfung an Google Cloud senden oder den Entwurf speichern möchten, führen Sie einen oder mehrere der folgenden Schritte aus:
- Geben Sie unter Präfix ein neues Namenspräfix für die automatisch erstellten Reservierungen ein, die für diese zukünftige Reservierungsanfrage bereitgestellt werden.
- Geben Sie unter Beschreibung eine neue Beschreibung ein.
- Ä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 Reservierungsanfrage zur Prüfung einreichen.
  - Geben Sie einen empfohlenen Wert für den Beginn an, damit genügend Zeit bleibt, bevor Ihre 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.
- Wählen Sie im Bereich Freigabetyp entweder Lokal oder Gemeinsam genutzt aus. Wenn Sie Freigegeben auswählen, können Sie Projekte hinzufügen oder entfernen, für die Sie die Anfrage für eine zukünftige Reservierung freigeben möchten. Sie können bis zu 100 Projekte hinzufügen.
- Geben Sie unter Anzahl der VM-Instanzen die Gesamtzahl der VMs ein, die Sie reservieren möchten.
  
  Achtung: Wenn Sie die Anzahl der VMs erhöhen möchten, die reserviert werden sollen, müssen Sie für die zusätzlichen Ressourcen, die Sie anfordern möchten, ein ausreichendes Kontingent haben. Andernfalls lehnt Google Cloud Ihren Änderungsantrag ab.
- Wenn Sie eine zukünftige Reservierung ändern, die nicht über eine Instanzvorlage erstellt wurde, können Sie im Abschnitt Rechnerkonfiguration Folgendes ändern:
  - Die Maschinenreihe und der Maschinentyp, die in den reservierten VMs verwendet werden.
  - Die GPUs, die an die reservierten VMs angehängt werden sollen.
  - Die lokalen SSDs und der Laufwerkschnittstellentyp der reservierten VMs.
- 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.
Führen Sie je nach dem Beschaffungsstatus der zukünftigen Reservierungsanfrage, die Sie ändern, einen der folgenden Schritte aus:
- Wenn Sie einen Entwurf für eine Anfrage für eine zukünftige Reservierung ändern, gehen Sie so vor:
  - Klicken Sie zum Speichern der Änderungen auf Entwurf speichern.
  - Klicken Sie auf Senden, um den Entwurf der zukünftigen Reservierungsanfrage zur Prüfung an Google Cloud zu senden.
- Klicken Sie andernfalls auf Senden.

Wenn Sie einen Änderungsantrag senden, wird die Seite Reservierungen geöffnet. Andernfalls wird die Detailseite der zukünftigen Reservierung geöffnet.

gcloud

Verwenden Sie zum Ändern einer zukünftigen Reservierungsanfrage 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 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --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 der zukünftigen Reservierungsanfrage.
PLANNING_STATUS: der Planungsstatus der zukünftigen Reservierung. Geben Sie einen der folgenden Werte an:
- So ändern Sie einen Entwurf einer zukünftigen Reservierungsanfrage, ohne ihn zur Überprüfung einzureichen: DRAFT.
- So reichen Sie die zukünftige Reservierungsanfrage zur Prüfung ein: SUBMITTED.
ZONE: Die Zone, in der sich die zukünftige Reservierungsanfrage befindet.

Ersetzen Sie einen oder mehrere der folgenden Platzhalter oder entfernen Sie sie zusammen mit den entsprechenden Flags:

So aktivieren Sie in Compute Engine das automatische Löschen der automatisch erstellten Reservierungen nach dem Ende des Reservierungszeitraums:
- Wenn die Reservierungen innerhalb von zwei Stunden nach dem Endzeitpunkt gelöscht werden sollen (Standard), fügen Sie das Flag --auto-delete-auto-created-reservations ein.
```
gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --planning-status=PLANNING_STATUS \
    --zone=ZONE
```
- Wenn Sie die automatisch erstellten Reservierungen nach einer bestimmten Dauer 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 FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --planning-status=PLANNING_STATUS \
    --zone=ZONE
```
  Ersetzen Sie AUTO_CREATED_RESERVATIONS_DELETE_TIME durch ein Datum und eine Uhrzeit im RFC 3339-Zeitstempel.
- Wenn Sie die automatisch erstellten Reservierungen nach 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 FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --planning-status=PLANNING_STATUS \
    --zone=ZONE
```
  Ersetzen Sie DURATION_BEFORE_DELETE durch eine Dauer in Tagen, Stunden, Minuten oder Sekunden. Geben Sie beispielsweise 30m für 30 Minuten oder 1d2h3m4s für 1 Tag, 2 Stunden, 3 Minuten und 4 Sekunden an.
Wenn Sie verhindern möchten, dass die Compute Engine die automatisch erstellten Reservierungen, die für diese zukünftige Reservierungsanfrage bereitgestellt werden, automatisch löscht, fügen Sie das Flag --no-auto-delete-auto-created-reservations hinzu.
```
gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --planning-status=PLANNING_STATUS \
    --zone=ZONE
```
Wenn Sie GPUs hinzufügen oder entfernen möchten, die mit reservierten N1-VMs verbunden sind, oder den GPU-Typ aktualisieren möchten, gehen Sie so vor:
- Wenn Sie die Anzahl und den Typ der GPUs ändern möchten, ersetzen Sie Folgendes:
  - 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. Die GPU muss in der Zone verfügbar sein, in der sich die Anfrage für die zukünftige Reservierung befindet. Andernfalls schlägt die Änderung der Anfrage fehl.
- Wenn Sie alle GPUs entfernen möchten, die an reservierte N1-VMs angehängt sind, ersetzen Sie das Flag --accelerator durch das Flag --clear-accelerator.
DESCRIPTION: Eine neue Beschreibung für die zukünftige Reservierungsanfrage.
Wenn Sie lokalen SSD-Laufwerken Ihrer reservierten VMs hinzufügen oder sie daraus entfernen oder den Laufwerkschnittstellentyp für lokale SSDs bearbeiten möchten, gehen Sie so vor:
- Wenn Sie lokale SSDs hinzufügen oder den Typ der Laufwerkschnittstelle bearbeiten möchten, ersetzen Sie INTERFACE durch einen der folgenden Werte:
  - Wenn das Bootlaufwerk-Image optimierte NVMe-Treiber hat: nvme.
  - Andernfalls: scsi.
  Fügen Sie das Flag --local-ssd für so viele lokale SSD-Laufwerke hinzu, wie Sie hinzufügen möchten. Sie können maximal 24 lokale SSD-Laufwerke angeben.
- Wenn Sie alle lokalen SSDs entfernen möchten, die mit den reservierten VMs verbunden sind, entfernen Sie alle --local-ssd-Flags und fügen Sie das Flag --clear-local-ssd hinzu.
MACHINE_TYPE: Der neue Maschinentyp, der für jede reservierte VM verwendet werden soll. Wenn Sie den Maschinentyp ändern, müssen Sie auch einen empfohlenen Mindestreservierungszeitraum für die neue Maschinenreihe angeben. Andernfalls wird Ihre Änderungsanfrage von Google Cloud wahrscheinlich abgelehnt.
MINIMUM_CPU_PLATFORM: Eine neue Mindest-CPU-Plattform, die für jede reservierte VM verwendet werden soll.
NAME_PREFIX: Ein neues Namenspräfix für die automatisch erstellten Reservierungen, die für Ihre zukünftige Reservierungsanfrage bereitgestellt werden.
SHARE_SETTING: Ein neuer Freigabetyp für Ihre zukünftige Reservierungsanfrage. Geben Sie einen der folgenden Werte an:
- Vorausschauende Reservierung für ein einzelnes Projekt: local. Um Fehler zu vermeiden, müssen Sie auch das Flag --share-with durch das Flag --clear-share-settings ersetzen.
- Für eine Anfrage für freigegebene zukünftige Reservierungen: projects. Um Fehler zu vermeiden, müssen Sie im Flag --share-with mindestens ein Nutzerprojekt angeben.
CONSUMER_PROJECT_IDS: Eine durch Kommas getrennte Liste der IDs von Projekten, für die Sie Ihre zukünftige Reservierungsanfrage freigeben möchten, z. B. project-1,project-2. Sie können bis zu 100 Nutzerprojekte angeben.
START_TIME: der Beginn des Reservierungszeitraums, formatiert als RFC 3339-Zeitstempel. Der Beginn darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie den Änderungsantrag zur Prüfung einreichen. Damit genügend Zeit bleibt, um eine zukünftige Reservierung nach der Genehmigung oder vor Eingabe der Sperrzeit optional zu stornieren, zu löschen oder zu ändern, müssen Sie einen empfohlenen Wert für die Startzeit angeben.
END_TIME: 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. Ersetzen Sie END_DURATION durch die Dauer der Reservierungsdauer in Sekunden. 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 empfohlenen Reservierungszeitraum an.

Wichtig: Achten Sie darauf, dass sich der Reservierungszeitraum nicht mit dem Reservierungszeitraum einer anderen bestehenden vorausschauenden Reservierungsanfrage überschneidet, deren VM-Attribute und Zone übereinstimmen und die in Ihrem aktuellen Projekt erstellt oder für dieses freigegeben wurde. Andernfalls wird das Ändern der vorausschauenden Reservierungsanfrage fehlschlagen
.
TOTAL_COUNT: die Gesamtzahl der VMs, die für den Zeitraum, die VM-Konfiguration und die Projekte, die in dieser zukünftigen Reservierungsanfrage angegeben sind, reserviert werden sollen. Wenn Sie die Gesamtzahl erhöhen möchten, müssen Sie für die Ressourcen, die Sie reservieren, ein ausreichendes Kontingent haben. Andernfalls lehnt Google Cloud Ihren Änderungsantrag ab.

Angenommen, Sie haben einen Entwurf für eine freigegebene Anfrage für eine zukünftige Reservierung namens fr-03 in Zone us-central1-a. Angenommen, Sie möchten diese Anfrage für eine freigegebene zukünftige Reservierung ändern, indem Sie die folgenden Änderungen vornehmen:

Wandeln Sie die Anfrage in eine Anfrage für eine zukünftige Reservierung für ein einzelnes Projekt um.
Deaktivieren Sie die Option zum automatischen Löschen.
Reservieren Sie 100 VMs.
Senden Sie die zukünftige Reservierungsanfrage zur Überprüfung 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 \
    --share-setting=local \
    --total-count=100 \
    --zone=us-central1-a

REST

Wenn Sie eine zukünftige Reservierungsanfrage ändern möchten, senden Sie eine PATCH-Anfrage an die Methode beta.futureReservations.update.

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 der zukünftigen Reservierungsanfrage.
UPDATE_FIELDS: eine durch Kommas getrennte Liste von Feldern, die im Anfragetext aktualisiert werden sollen. Sie müssen jedes Komma als %2C codieren. Wenn Sie ein Feld im Abfrageparameter updateMask und im Anfragetext angeben, wird der Wert des Felds aktualisiert. Wenn Sie das Feld nur im Abfrageparameter updateMask angeben, wird es gelöscht.

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
```
PLANNING_STATUS: der Planungsstatus der zukünftigen Reservierung. Geben Sie einen der folgenden Werte an:
- So ändern Sie einen Entwurf einer zukünftigen Reservierungsanfrage, ohne ihn zur Überprüfung einzureichen: DRAFT.
- So reichen Sie den Änderungsantrag zur Überprüfung ein: SUBMITTED.

Ersetzen Sie einen oder mehrere der folgenden Platzhalter oder entfernen Sie sie zusammen mit den entsprechenden Feldern:

AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Wenn Sie dieses Feld auf true setzen, löscht die Compute Engine automatisch die automatisch erstellten Reservierungen, die für Ihre zukünftige Reservierungsanfrage bereitgestellt wurden. Standardmäßig erfolgt das Löschen innerhalb von zwei Stunden nach dem Ende des Reservierungszeitraums. 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/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime%2CplanningStatus

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "PLANNING_STATUS"
}
```
  Ersetzen Sie DELETE_TIME durch ein Datum und eine Uhrzeit, zu der Compute Engine Reservierungen löscht. Datum und Uhrzeit müssen als RFC 3339-Zeitstempel formatiert sein.
- Wenn Sie die automatisch erstellten Reservierungen nach einer bestimmten Dauer ab dem Beginn des Reservierungszeitraums löschen möchten, setzen Sie autoDeleteAutoCreatedReservations auf true und geben das Feld autoCreatedReservationsDuration an.
```
PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CplanningStatus

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "PLANNING_STATUS"
}
```
  Ersetzen Sie DURATION_BEFORE_DELETE durch die Dauer in Sekunden. Geben Sie beispielsweise 604800 für 604.800 Sekunden (7 Tage) an.
DESCRIPTION: Eine neue Beschreibung für die zukünftige Reservierungsanfrage.
NAME_PREFIX: Ein neues Namenspräfix für die automatisch erstellten Reservierungen, die für Ihre zukünftige Reservierungsanfrage bereitgestellt werden.
CONSUMER_PROJECT_ID_1 und CONSUMER_PROJECT_ID_2: die IDs der Projekte, für die Sie die zukünftige Reservierungsanfrage freigeben möchten. Diese Projekte müssen sich in derselben Organisation wie das Inhaberprojekt befinden. Sie können bis zu 100 Nutzerprojekte angeben.
SHARE_TYPE: Ein neuer Freigabetyp für Ihre zukünftige Reservierungsanfrage. Führen Sie einen der folgenden Schritte aus:
- So geben Sie eine zukünftige Reservierungsanfrage für ein einzelnes Projekt an:
  - Geben Sie LOCAL an.
  - Entfernen Sie das Feld shareSettings.projects.
- So geben Sie eine Anfrage für eine freigegebene zukünftige Reservierung an:
  - Geben Sie SPECIFIC_PROJECTS an.
  - Geben Sie im Feld shareSettings.projects mindestens ein Nutzerprojekt an. Die Nutzerprojekte müssen sich in derselben Organisation wie das Inhaberprojekt befinden. Sie können bis zu 100 Nutzerprojekte angeben.
Wenn Sie die Anzahl und den Typ der GPUs ändern möchten, die an Ihre reservierten N1-VMs angehängt werden sollen, ersetzen Sie Folgendes:
- 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. Die GPU muss in der Zone verfügbar sein, in der sich die Anfrage für die zukünftige Reservierung befindet. Andernfalls schlägt die Änderung der Anfrage fehl.
INTERFACE_1 und INTERFACE_2: Der Laufwerkschnittstellentyp für die lokalen SSDs, die mit jeder reservierten VM verbunden sind. Geben Sie einen der folgenden Werte an:
- Wenn das Bootlaufwerk-Image optimierte NVMe-Treiber hat: NVME.
- Andernfalls: SCSI.
  
  Sie können maximal 24 lokale SSD-Laufwerke angeben.
MACHINE_TYPE: Der neue Maschinentyp, der für jede reservierte VM verwendet werden soll. Wenn Sie den Maschinentyp ändern, müssen Sie auch einen empfohlenen Mindestreservierungszeitraum für die neue Maschinenreihe angeben. Andernfalls sinkt die Wahrscheinlichkeit, dass Google Cloud Ihre Änderungsanfrage genehmigt.
MINIMUM_CPU_PLATFORM: Eine neue Mindest-CPU-Plattform, die für jede reservierte VM verwendet werden soll.
TOTAL_COUNT: die Gesamtzahl der VMs, die für den Zeitraum, die VM-Konfiguration und die Projekte, die in dieser zukünftigen Reservierungsanfrage angegeben sind, reserviert werden sollen. Wenn Sie die Gesamtzahl erhöhen möchten, müssen Sie für die Ressourcen, die Sie reservieren, ein ausreichendes Kontingent haben. Andernfalls lehnt Google Cloud Ihren Änderungsantrag ab.
START_TIME: der Beginn des Reservierungszeitraums, formatiert als RFC 3339-Zeitstempel. Der Beginn darf nicht mehr als ein Jahr nach dem Datum und der Uhrzeit liegen, an dem Sie den Änderungsantrag zur Prüfung einreichen. Damit genügend Zeit bleibt, um eine zukünftige Reservierung nach der Genehmigung oder vor Eingabe der Sperrzeit optional zu stornieren, zu löschen oder zu ändern, müssen Sie einen empfohlenen Wert für die Startzeit angeben.
END_TIME: 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:
```
PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=timeWindow.duration%2CplanningStatus

{
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "PLANNING_STATUS",
  "timeWindow": {
    "duration": {
      "seconds": "END_DURATION"
    }
  }
}
```
Ersetzen Sie END_DURATION durch die Dauer in Sekunden. Geben Sie beispielsweise 1209600 für 1.209.600 Sekunden (14 Tage) an. Wenn Sie die Wahrscheinlichkeit erhöhen möchten, dass Google Cloud eine zukünftige Reservierungsanfrage genehmigt, nachdem Sie sie zur Überprüfung eingereicht haben, geben Sie einen empfohlenen Reservierungszeitraum an.

Wichtig: Achten Sie darauf, dass sich der Reservierungszeitraum nicht mit dem Reservierungszeitraum einer anderen bestehenden vorausschauenden Reservierungsanfrage überschneidet, deren VM-Attribute und Zone übereinstimmen und die in Ihrem aktuellen Projekt erstellt oder für dieses freigegeben wurde. Andernfalls wird das Ändern der vorausschauenden Reservierungsanfrage fehlschlagen
.

Wandeln Sie die Anfrage in eine Anfrage für eine zukünftige Reservierung für ein einzelnes Projekt um.
Deaktivieren Sie die Option zum automatischen Löschen.
Reservieren Sie 100 VMs.
Senden Sie die zukünftige Reservierungsanfrage zur Überprüfung 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 geändert haben, können Sie den Beschaffungs- oder Aktualisierungsstatus überwachen, indem Sie die Details der zukünftigen Reservierungsanfrage aufrufen.

Alle anderen Attribute in einer zukünftigen Reservierungsanfrage ändern

So ändern Sie Attribute, die Sie nach dem Erstellen einer Anfrage für eine zukünftige Reservierung nicht mehr ändern können, bevor die Anfrage genehmigt wird und die Sperrzeit beginnt:

Wenn Sie verhindern möchten, dass die zukünftige Reservierungsanfrage die Art der zukünftigen Reservierungsanfragen einschränkt, die Sie in Ihrem aktuellen Projekt oder in den Projekten, für die die vorausschauende Reservierungsanfrage freigegeben ist, erstellen können, löschen Sie die zukünftige Reservierungsanfrage,
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 vorausschauenden Reservierungsanfragen.

Sollten nach der Fehlerbehebung weiterhin Probleme auftreten, wenden Sie sich an Ihren Kundenbetreuer oder an den Google Cloud-Support.

Nächste Schritte

Weitere Informationen zu zukünftigen Reservierungsanfragen
Weitere Informationen zum Ändern, Abbrechen oder Löschen zukünftiger Reservierungsanfragen.
Nachdem Sie die Startzeit eines Reservierungszeitraums erreicht haben, lesen Sie die Informationen zum Verwenden der automatisch erstellten Reservierungen.
Nach Ablauf des Reservierungszeitraums erfahren Sie, wie Sie die automatisch erstellten Reservierungen ändern.