In diesem Dokument wird erläutert, wie Sie Reservierungen in Compute Engine ändern. Informationen zum Ändern von Reservierungen, die mit Zusicherungen verbunden sind, finden Sie unter Reservierungen ersetzen, die mit Zusicherungen verbunden sind.
Sie können eine Reservierung ändern, wenn sich Ihre Kapazitätsanforderungen ändern oder wenn Sie aktualisieren möchten, welche Arbeitslasten reservierte Kapazität nutzen können.
Beschränkungen
Wenn Sie eine Reservierung ändern, gelten die folgenden Einschränkungen:
Freigegebene Reservierungen können nur in dem Projekt geändert werden, in dem sich die Reservierung befindet.
Sie können eine automatisch erstellte (auto-created) Reservierung für eine vorausschauende Reservierung im Kalendermodus oder eine vorausschauende Reservierung für Kapazitätsblöcke jederzeit und nur so ändern:
Sie können eine automatisch erstellte Reservierung für eine vorausschauende Reservierung nur so ändern:
Nach dem Startzeitpunkt haben Sie folgende Möglichkeiten:
Nach dem Endzeitpunkt können Sie Folgendes tun:
Hinweis
-
Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben.
Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Cloud de Confiance by S3NS Dienste und APIs überprüft. Zum Ausführen von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei der Compute Engine authentifizieren:
Wählen Sie den Tab für die geplante Verwendung der Beispiele auf dieser Seite aus:
Console
Wenn Sie über die Cloud de Confiance Console auf Dienste und APIs von Cloud de Confiance by S3NS zugreifen, müssen Sie die Authentifizierung nicht einrichten.
gcloud
-
Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an. Nach der Anmeldung initialisieren Sie die Google Cloud CLI mit dem folgenden Befehl:
gcloud init
-
- Legen Sie eine Standardregion und -zone fest.
REST
Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.
Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an.
Weitere Informationen finden Sie in der Dokumentation zur Cloud de Confiance -Authentifizierung unter Für die Verwendung von REST authentifizieren.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute-Administrator (roles/compute.admin) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ändern von Reservierungen benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierte Rolle enthält die Berechtigungen, die zum Ändern von Reservierungen erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind zum Ändern von Reservierungen erforderlich:
-
Option zum automatischen Löschen in einer Reservierung, den Verbrauchstyp oder Freigabetyp in einer Reservierung ändern oder festlegen, ob Vertex AI-Jobs eine Reservierung von Compute-Instanzen mit angehängten GPUs nutzen können:
compute.reservations.updatefür das Projekt -
So ändern Sie die Anzahl der Compute Engine-Instanzen in einer Reservierung:
compute.reservations.resizefür das Projekt
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Reservierungen ändern
Verwenden Sie je nach den Attributen, die Sie in einer Reservierung ändern möchten, eine der folgenden Methoden. Wenn Sie ein Attribut ändern möchten, das nicht in der folgenden Liste aufgeführt ist, müssen Sie eine neue Reservierung mit den gewünschten Änderungen erstellen und dann die ursprüngliche Reservierung löschen, wenn Sie sie nicht mehr benötigen.
Wenn Sie die Anzahl der reservierten Compute-Instanzen in einer Reservierung erhöhen oder verringern möchten, ändern Sie die Anzahl der reservierten Compute-Instanzen in einer Reservierung.
Wenn Sie zwischen einer Reservierung für ein einzelnes Projekt und einer freigegebenen Reservierung wechseln möchten, ändern Sie den Freigabetyp einer Reservierung.
Wenn Sie Nutzerprojekte hinzufügen oder entfernen möchten, die eine freigegebene Reservierung nutzen können, ändern Sie die Nutzerprojekte in einer freigegebenen Reservierung.
Wenn Sie zulassen oder verhindern möchten, dass eine Reservierung von GPU-Instanzen von benutzerdefinierten Trainings- oder Vorhersagejobs in Vertex AI genutzt wird, ändern Sie die Freigaberichtlinie einer Reservierung.
Wenn Sie das automatische Löschen einer Reservierung aktivieren oder deaktivieren oder das Datum und die Uhrzeit ändern möchten, zu der Compute Engine die Reservierung automatisch löscht, ändern Sie das automatische Löschen einer Reservierung.
Anzahl der reservierten Compute-Instanzen in einer Reservierung ändern
Sie können die Anzahl der reservierten Compute-Instanzen in einer Reservierung erhöhen oder verringern. Bevor Sie die Anzahl der Compute-Instanzen ändern, sollten Sie jedoch Folgendes beachten, um Fehler zu vermeiden:
Wenn Sie die Anzahl der Compute-Instanzen in einer Reservierung erhöhen möchten, müssen die folgenden Bedingungen erfüllt sein:
Sie können die maximale Anzahl von Compute-Instanzen für eine Reservierung nicht überschreiten.
Sie müssen in Ihrem Projekt ein ausreichendes ungenutztes Kontingent für die zusätzlichen Ressourcen haben, die Sie reservieren. Informationen zum Erhöhen des Kontingents finden Sie unter Kontingente aufrufen und verwalten.
In der Zone der Reservierung müssen genügend Ressourcen verfügbar sein. Andernfalls schlägt Ihre Änderungsanfrage mit einem Ressourcenverfügbarkeitsfehler fehl. Informationen zur Fehlerbehebung bei dieser Art von Fehler finden Sie unter Fehlerbehebung bei Fehlern bei der Ressourcenverfügbarkeit.
Wenn Sie die Anzahl der Compute-Instanzen in einer Reservierung mit spezifischer Ausrichtung verringern möchten, prüfen Sie, ob die Anzahl der Compute-Instanzen, die die Reservierung nutzen, die neue, kleinere Anzahl nicht überschreitet. Falls ja, haben Sie folgende Möglichkeiten für die Compute-Instanzen, die über die neue Anzahl hinausgehen:
Wählen Sie eine der folgenden Optionen aus, um die Anzahl der reservierten Compute-Instanzen in einer Reservierung zu ändern:
Console
Rufen Sie in der Cloud de Confiance Console die Seite Reservierungen auf.
Klicken Sie auf dem Tab On-Demand-Reservierungen (Standard) in der Spalte Name auf den Namen der Reservierung, die Sie ändern möchten. Eine Seite mit den Details der Reservierung wird geöffnet.
Klicken Sie auf Bearbeiten.
Geben Sie im Feld Anzahl der VM-Instanzen die aktualisierte Anzahl der zu reservierenden Compute-Instanzen ein.
Klicken Sie zur Bestätigung auf Speichern.
gcloud
Verwenden Sie den Befehl gcloud compute reservations update, um die Anzahl der reservierten Compute-Instanzen in einer Reservierung zu ändern.
gcloud compute reservations update RESERVATION_NAME \
--vm-count=NUMBER_OF_VMS \
--zone=ZONE
Ersetzen Sie Folgendes:
RESERVATION_NAME: der Name der Reservierung.NUMBER_OF_VMS: die neue Anzahl der zu reservierenden Compute-Instanzen.ZONE: die Zone, in der die Reservierung vorhanden ist.
REST
Wenn Sie die Anzahl der reservierten Compute-Instanzen in einer Reservierung ändern möchten, senden Sie eine POST-Anfrage an die Methode reservations.resize.
POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/resize
{
"specificSkuCount": "NUMBER_OF_VMS"
}
Ersetzen Sie Folgendes:
PROJECT_ID: die ID des Projekts, in dem die Reservierung vorhanden ist.ZONE: die Zone, in der die Reservierung vorhanden ist.RESERVATION_NAME: der Name der Reservierung.NUMBER_OF_VMS: die neue Anzahl der zu reservierenden Compute-Instanzen.
Freigabetyp für eine Reservierung ändern
Sie können eine Reservierung für ein Einzelprojekt in eine freigegebene Reservierung oder eine freigegebene Reservierung in eine Reservierung für ein Einzelprojekt umwandeln. Wenn Sie den Freigabetyp für eine Reservierung ändern, können Sie reservierte Ressourcen für bis zu 100 Projekte in Ihrer Organisation freigeben oder den Zugriff auf das Inhaberprojekt beschränken.
Beachten Sie Folgendes, bevor Sie mit der Änderung beginnen, um Fehler beim Ändern des Freigabetyps für eine Reservierung zu vermeiden:
Wenn Sie eine Reservierung für ein Einzelprojekt in eine freigegebene Reservierung umwandeln möchten, prüfen Sie Folgendes:
Projektberechtigungen: Prüfen Sie, ob in Ihrem Projekt freigegebene Reservierungen erstellt werden können. Eine Anleitung finden Sie unter Erstellen von freigegebenen Reservierungen für Projekte zulassen oder beschränken.
Kontingentlimits: Wenn für den Reservierungstyp ein Kontingent erforderlich ist, benötigen Sie möglicherweise zusätzliches Kontingent für Ihre reservierten Ressourcen. Für freigegebene Reservierungen und Reservierungen für ein einzelnes Projekt gelten unterschiedliche Kontingentanforderungen. Weitere Informationen finden Sie unter Zusätzliche Kontingentanforderungen für freigegebene Reservierungen.
So wandeln Sie eine freigegebene Reservierung in eine Reservierung für ein einzelnes Projekt um:
Nutzer-Compute-Instanzen: Wenn Sie eine spezifisch ausgerichtete Reservierung ändern möchten, müssen Sie alle Compute-Instanzen beenden, sperren oder löschen, die die Reservierung in jedem Nutzerprojekt nutzen, für das die Reservierung freigegeben ist. Diese Anforderung gilt nicht für die Compute-Instanzen im Eigentümerprojekt.
Wählen Sie eine der folgenden Optionen aus, um den Freigabetyp für eine Reservierung zu ändern:
gcloud
Verwenden Sie den Befehl gcloud compute reservations update, um den Freigabetyp für eine Reservierung zu ändern.
Geben Sie je nachdem, wie Sie Ihre Reservierung ändern möchten, eines der folgenden Flags an:
Wenn Sie eine Reservierung für ein einzelnes Projekt in eine freigegebene Reservierung umwandeln möchten, fügen Sie die Flags
--add-share-withund--share-setting=projectsein:gcloud compute reservations update RESERVATION_NAME \ --add-share-with=CONSUMER_PROJECT_IDS \ --share-setting=projects \ --zone=ZONEWenn Sie eine freigegebene Reservierung in eine Reservierung für ein Einzelprojekt umwandeln möchten, fügen Sie das Flag
--share-setting=localhinzu:gcloud compute reservations update RESERVATION_NAME \ --share-setting=local \ --zone=ZONE
Ersetzen Sie Folgendes:
RESERVATION_NAME: der Name der Reservierung, die Sie ändern möchten.CONSUMER_PROJECT_IDS: eine durch Kommas getrennte Liste von IDs von Projekten, für die die Reservierung freigegeben werden soll, z. B.project-1,project-2. Sie können eine Reservierung für bis zu 100 Projekte freigeben, die sich in derselben Organisation wie das Inhaberprojekt befinden.ZONE: die Zone, in der die Reservierung vorhanden ist.
REST
Wenn Sie den Freigabetyp für eine Reservierung ändern möchten, stellen Sie eine PATCH-Anfrage an die Methode reservations.update.
Stellen Sie je nachdem, wie Sie Ihre Reservierung ändern möchten, eine der folgenden Anfragen:
So wandeln Sie eine Reservierung für ein einzelnes Projekt in eine freigegebene Reservierung um: Fügen Sie in der Anfrage-URL den Abfrageparameter
paths=shareSettings.projectMap.PROJECT_ID_OR_NUMBERfür jedes Projekt ein, für das Sie die Reservierung freigeben möchten.Wenn Sie beispielsweise eine Reservierung für zwei Projekte freigeben möchten, stellen Sie eine Anfrage wie folgt. Sie können eine Reservierung für bis zu 100 Projekte freigeben, die sich in derselben Organisation wie das Inhaberprojekt befinden.
PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.shareType&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2 { "name": "RESERVATION_NAME", "shareSettings": { "shareType": "SPECIFIC_PROJECTS", "projectMap": { "CONSUMER_PROJECT_ID_OR_NUMBER_1": { "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_1" }, "CONSUMER_PROJECT_ID_OR_NUMBER_2": { "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_2" } } } }So wandeln Sie eine freigegebene Reservierung in eine Reservierung für ein einzelnes Projekt um:
PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.shareType { "name": "RESERVATION_NAME", "shareSettings": { "shareType": "LOCAL" } }
Ersetzen Sie Folgendes:
PROJECT_ID: die ID des Projekts, in dem die Reservierung vorhanden ist (das Inhaberprojekt).ZONE: die Zone, in der die Reservierung vorhanden ist.RESERVATION_NAME: der Name der Reservierung, die Sie ändern möchten.CONSUMER_PROJECT_ID_OR_NUMBER_1undCONSUMER_PROJECT_ID_OR_NUMBER_2: die ID oder Nummer der beiden Projekte, für die Sie die Reservierung freigeben möchten.
Nutzerprojekte in einer freigegebenen Reservierung ändern
Beachten Sie Folgendes, um Fehler beim Ändern der Nutzerprojekte zu vermeiden, die eine freigegebene Reservierung nutzen können:
Entfernen von Projekten: Sie können Nutzerprojekten die Nutzung einer freigegebenen Reservierung nur dann untersagen, wenn in diesen Projekten keine Compute-Instanzen die Reservierung nutzen. Wenn Sie verhindern möchten, dass Compute-Instanzen eine Reservierung nutzen, beenden, pausieren oder löschen Sie die Compute-Instanzen.
Projekte hinzufügen: Sie können Nutzerprojekten erlauben, eine freigegebene Reservierung nur dann zu nutzen, wenn sich diese Projekte in derselben Organisation wie das Inhaberprojekt befinden. Informationen zum Migrieren eines Projekts in die Organisation des Inhaberprojekts finden Sie unter Projekte zwischen Ressourcen einer Organisation migrieren.
Nachdem Sie die Nutzerprojekte für eine freigegebene Reservierung geändert haben, kann sich die Nutzung der Reservierung ändern. Wenn Sie die Reservierung beispielsweise so konfiguriert haben, dass sie von allen übereinstimmenden Compute-Instanzen genutzt werden kann (Standardkonfiguration), können alle neu hinzugefügten Nutzerprojekte die Reservierung sofort nutzen. Weitere Informationen dazu, welche übereinstimmenden Reservierungen von Projekten zuerst genutzt werden, finden Sie unter Nutzungsreihenfolge von Reservierungen.
Wählen Sie eine der folgenden Optionen aus, um die Nutzerprojekte zu ändern, die eine freigegebene Reservierung nutzen können:
Console
Rufen Sie in der Cloud de Confiance Console die Seite Reservierungen auf.
Klicken Sie auf dem Tab On-Demand-Reservierungen (Standard) in der Spalte Name auf den Namen der Reservierung, die Sie beschreiben möchten.
Die Detailseite für die Reservierung wird geöffnet.
Klicken Sie auf Bearbeiten.
Führen Sie im Abschnitt Ausgewählte Projekte einen der folgenden Schritte aus:
Um die Freigabe der Reservierung für ein bestimmtes Nutzerprojekt zu beenden, klicken Sie auf Löschen.
So geben Sie die Reservierung für ein oder mehrere bestimmte Projekte frei:
Klicken Sie auf Projekte hinzufügen.
Klicken Sie auf das Kästchen für jedes Projekt aus der Organisation des Inhaberprojekts, für das Sie die Reservierung freigeben möchten. Sie können eine freigegebene Reservierung für bis zu 100 Nutzerprojekte freigeben.
Klicken Sie auf Auswählen.
Klicken Sie zum Bestätigen der Änderungen auf Speichern.
Das Ändern der Reservierung kann einige Sekunden dauern.
gcloud
Wenn Sie die Nutzerprojekte für eine freigegebene Reservierung ändern, müssen Sie eine durch Kommas getrennte Liste von IDs von Projekten angeben, die Sie für die Nutzung der freigegebenen Reservierung zulassen oder nicht mehr zulassen möchten. Alle Nutzerprojekte müssen derselben Organisation wie das Inhaberprojekt angehören. Geben Sie das Inhaberprojekt nicht an. Standardmäßig kann das Inhaberprojekt einer freigegebenen Reservierung diese immer nutzen.
Führen Sie einen der folgenden Schritte aus, um die Nutzerprojekte für eine freigegebene Reservierung zu ändern:
Damit ein oder mehrere Projekte eine freigegebene Reservierung nutzen können, verwenden Sie den Befehl
gcloud compute reservations updatemit dem Flag--add-share-with.gcloud compute reservations update RESERVATION_NAME \ --add-share-with=CONSUMER_PROJECT_IDS \ --zone=ZONEErsetzen Sie Folgendes:
RESERVATION_NAME: der Name einer vorhandenen freigegebenen Reservierung.CONSUMER_PROJECT_IDS: eine durch Kommas getrennte Liste von IDs von Projekten, für die die Reservierung freigegeben werden soll, z. B.project-1,project-2. Sie können eine freigegebene Reservierung für bis zu 100 Nutzerprojekte freigeben.ZONE: die Zone, in der sich die freigegebene Reservierungsanfrage befindet.
Wenn Sie die Nutzung einer freigegebenen Reservierung durch ein oder mehrere Projekte nicht mehr erlauben möchten, verwenden Sie den Befehl
gcloud compute reservations updatemit dem Flag--remove-share-with.gcloud compute reservations update RESERVATION_NAME \ --remove-share-with=CONSUMER_PROJECT_IDS \ --zone=ZONEErsetzen Sie Folgendes:
RESERVATION_NAME: der Name einer vorhandenen freigegebenen Reservierung.CONSUMER_PROJECT_IDS: eine durch Kommas getrennte Liste von IDs von Projekten, für die Sie die Reservierung nicht mehr freigeben möchten, z. B.project-1,project-2.ZONE: die Zone, in der sich die freigegebene Reservierungsanfrage befindet.
Um die Liste der Projekte zu ersetzen, die eine freigegebene Reservierung nutzen können, verwenden Sie den Befehl
gcloud beta compute reservations updatemit dem Flag--share-with.gcloud beta compute reservations update RESERVATION_NAME \ --share-with=CONSUMER_PROJECT_IDS \ --zone=ZONEErsetzen Sie Folgendes:
RESERVATION_NAME: der Name einer vorhandenen freigegebenen Reservierung.ZONE: die Zone, in der sich die freigegebene Reservierungsanfrage befindet.CONSUMER_PROJECT_IDS: eine durch Kommas getrennte Liste von IDs von Projekten, für die die Reservierung freigegeben werden soll, z. B.project-1,project-2. Sie können eine freigegebene Reservierung für bis zu 100 Nutzerprojekte freigeben.
REST
Wenn Sie die Nutzerprojekte für eine freigegebene Reservierung ändern, müssen Sie die Projekte angeben, die Sie hinzufügen oder entfernen möchten. Wenn Sie einem Projekt die Nutzung der Reservierung erlauben möchten, geben Sie entweder die Projekt-ID oder die Projektnummer an. Wenn Sie verhindern möchten, dass ein Projekt die Reservierung nutzt, müssen Sie die Projektnummer angeben. Alle Nutzerprojekte müssen zur selben Organisation wie das Inhaberprojekt gehören. Geben Sie das Inhaberprojekt nicht an. Standardmäßig kann das Inhaberprojekt einer freigegebenen Reservierung diese immer nutzen.
So ändern Sie die Nutzerprojekte für eine freigegebene Reservierung:
Wenn Sie einem oder mehreren Projekten die Nutzung einer freigegebenen Reservierung erlauben möchten, senden Sie eine
PATCH-Anfrage an die Methodereservations.update. Fügen Sie in der Anfrage-URL den Abfrageparameterpaths=shareSettings.projectMap.PROJECT_ID_OR_NUMBERfür jedes Projekt ein, für das Sie die Reservierung freigeben möchten.Wenn Sie beispielsweise zwei Projekten die Nutzung einer freigegebenen Reservierung erlauben möchten, stellen Sie eine
PATCH-Anfrage wie unten beschrieben. Sie können eine freigegebene Reservierung für bis zu 100 Nutzerprojekte freigeben.PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2 { "name": "RESERVATION_NAME", "shareSetting": { "projectMap": { "CONSUMER_PROJECT_ID_OR_NUMBER_1": { "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_1" }, "CONSUMER_PROJECT_ID_OR_NUMBER_2": { "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_2" } } } }Ersetzen Sie Folgendes:
PROJECT_ID: die ID des Projekts, in dem die freigegebene Reservierung vorhanden ist (das Inhaberprojekt).ZONE: die Zone, in der sich die freigegebene Reservierung befindet.RESERVATION_NAME: der Name einer vorhandenen freigegebenen Reservierung.CONSUMER_PROJECT_ID_OR_NUMBER_1undCONSUMER_PROJECT_ID_OR_NUMBER_2: die ID oder Nummer der beiden Projekte, für die Sie die Reservierung freigeben möchten.
Wenn Sie die Nutzung einer freigegebenen Reservierung durch ein oder mehrere Projekte nicht mehr erlauben möchten, senden Sie eine
PATCH-Anfrage an die Methodereservations.update. Fügen Sie in der Anfrage-URL den Abfrageparameterpaths=shareSettings.projectMap.PROJECT_NUMBERfür jedes Projekt ein, für das Sie die Freigabe der Reservierung beenden möchten. Außerdem müssen Sie das FeldshareSettingim Anfragetext weglassen.Wenn Sie beispielsweise zwei Projekten die Nutzung einer freigegebenen Reservierung nicht mehr erlauben möchten, stellen Sie eine
PATCH-Anfrage:PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2 { "name": "RESERVATION_NAME" }Ersetzen Sie Folgendes:
PROJECT_ID: die ID des Projekts, in dem die freigegebene Reservierung vorhanden ist (das Inhaberprojekt).ZONE: die Zone, in der sich die freigegebene Reservierung befindet.RESERVATION_NAME: der Name einer vorhandenen freigegebenen Reservierung.CONSUMER_PROJECT_NUMBER_1undCONSUMER_PROJECT_NUMBER_2: die Nummern der beiden Projekte, für die Sie die Reservierung nicht mehr freigeben möchten.
Freigaberichtlinie einer Reservierung ändern
Wenn Sie die Freigaberichtlinie einer Reservierung von GPU-Compute-Instanzen ändern, legen Sie fest, ob Vertex AI-Trainings- oder Vorhersagejobs die Reservierung nutzen.
Bevor Sie Vertex AI-Jobs die Nutzung einer Reservierung untersagen, beenden Sie alle Vertex AI-Jobs, die diese Reservierung verwenden. Andernfalls treten Fehler auf.
Wählen Sie eine der folgenden Optionen aus, um die Freigaberichtlinie für eine Reservierung von GPU-Instanzen zu ändern:
Console
Rufen Sie in der Cloud de Confiance Console die Seite Reservierungen auf.
Klicken Sie auf dem Tab On-Demand-Reservierungen (Standard) in der Spalte Name auf den Namen der Reservierung von GPU-Instanzen, die Sie ändern möchten. Eine Seite mit den Details der Reservierung wird angezeigt.
Klicken Sie in der Zeile Für andere Google Cloud-Dienste freigeben auf Einstellungen für die Dienstfreigabe bearbeiten.
Führen Sie im Bereich Reservierung teilen einen der folgenden Schritte aus:
Wenn Sie Vertex AI-Jobs erlauben möchten, die Reservierung zu nutzen, wählen Sie Reservierung freigeben aus.
Wenn Sie Vertex AI-Jobs die Nutzung der Reservierung untersagen möchten, wählen Sie Reservierung nicht freigeben aus.
Klicken Sie auf Speichern.
Das Ändern der Reservierung kann einige Sekunden dauern.
gcloud
Verwenden Sie den Befehl gcloud compute reservations update mit dem Flag --reservation-sharing-policy, um die Freigaberichtlinie für eine Reservierung von GPU-Instanzen zu ändern.
gcloud compute reservations update RESERVATION_NAME \
--reservation-sharing-policy=SHARING_POLICY \
--zone=ZONE
Ersetzen Sie Folgendes:
RESERVATION_NAME: der Name einer vorhandenen Reservierung.SHARING_POLICY: die Freigaberichtlinie der Reservierung. Geben Sie einen der folgenden Werte an:So erlauben Sie Vertex AI-Jobs, die Reservierung zu nutzen:
ALLOW_ALLSo untersagen Sie Vertex AI-Jobs die Nutzung der Reservierung:
DISALLOW_ALL
ZONE: die Zone, in der die Reservierung vorhanden ist
REST
Wenn Sie die Freigaberichtlinie für eine Reservierung von GPU-Instanzen ändern möchten, senden Sie eine PATCH-Anfrage an die Methode reservations.update.
Fügen Sie in der Anfrage-URL den Abfrageparameter paths ein, wobei dieser auf reservationSharingPolicy.serviceShareType gesetzt ist.
PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=reservationSharingPolicy.serviceShareType
{
"name": "RESERVATION_NAME",
"reservationSharingPolicy": {
"serviceShareType": "SHARING_POLICY"
}
}
Ersetzen Sie Folgendes:
PROJECT_ID: die ID des Projekts, in dem die Reservierung vorhanden ist.ZONE: die Zone, in der die Reservierung vorhanden ist.RESERVATION_NAME: der Name einer vorhandenen Reservierung.SHARING_POLICY: die Freigaberichtlinie der Reservierung. Geben Sie einen der folgenden Werte an:So erlauben Sie Vertex AI-Jobs, die Reservierung zu nutzen:
ALLOW_ALLSo untersagen Sie Vertex AI-Jobs die Nutzung der Reservierung:
DISALLOW_ALL
Automatisches Löschen einer Reservierung ändern
Sie können ändern, wann Compute Engine eine vorhandene Reservierung automatisch löscht. Führen Sie dazu einen der folgenden Schritte aus:
Aktivieren Sie die Option zum automatischen Löschen oder ändern Sie den Zeitpunkt, zu dem die Reservierung automatisch gelöscht wird.
Deaktivieren Sie die Option zum automatischen Löschen.
Wählen Sie eine der folgenden Optionen aus, um das automatische Löschen einer Reservierung zu ändern:
Console
Rufen Sie in der Cloud de Confiance Console die Seite Reservierungen auf.
Klicken Sie auf dem Tab On-Demand-Reservierungen (Standard) in der Spalte Name auf den Namen der Reservierung, die Sie ändern möchten.
Die Seite mit den Details der ausgewählten Reservierung wird geöffnet.
Klicken Sie in der Zeile Zeit bis zum automatischen Löschen auf Zeit bis zum automatischen Löschen bearbeiten.
Führen Sie im Bereich Reservierung aktualisieren einen der folgenden Schritte aus:
So löschen Sie die Reservierung zu einem bestimmten Datum und einer bestimmten Uhrzeit:
Wenn die Option zum automatischen Löschen noch nicht aktiviert ist, klicken Sie auf den Ein/Aus-Button Automatisches Löschen aktivieren, um ihn auf "Ein" zu setzen.
Geben Sie im Feld Zeit bis zum automatischen Löschen ein Datum und eine Uhrzeit ein, zu der Compute Engine die Reservierung automatisch löschen soll.
Klicken Sie andernfalls auf den Ein/Aus-Button Automatisches Löschen aktivieren, um sie auf „Aus“ zu setzen.
Klicken Sie auf Senden.
Das Ändern der Reservierung kann einige Sekunden dauern.
gcloud
Wenn Sie die Option zum automatischen Löschen in einer Reservierung aktivieren, können Sie ein Datum und eine Uhrzeit für das Löschen der Reservierung oder eine Dauer, nach der die Reservierung gelöscht werden soll, angeben.
Führen Sie einen der folgenden Schritte aus, um die Option zum automatischen Löschen zu aktivieren oder zu ändern, wann die Reservierung gelöscht werden soll:
Verwenden Sie den Befehl
gcloud beta compute reservations updatemit dem Flag--delete-at-time, um die Reservierung zu einem bestimmten Datum und einer bestimmten Uhrzeit zu löschen.gcloud beta compute reservations update RESERVATION_NAME \ --delete-at-time=DELETE_AT_TIME \ --zone=ZONEErsetzen Sie Folgendes:
RESERVATION_NAME: der Name einer vorhandenen Reservierung.DELETE_AT_TIME: ein Datum und eine Uhrzeit, die als ein RFC 3339-Zeitstempel formatiert sind.ZONE: die Zone, in der sich die Reservierung befindet.
Verwenden Sie den Befehl
gcloud beta compute reservations updatemit dem Flag--delete-after-duration, um die Reservierung nach einer bestimmten Dauer zu löschen.gcloud beta compute reservations update RESERVATION_NAME \ --delete-after-duration=DELETE_AFTER_DURATION \ --zone=ZONEErsetzen Sie Folgendes:
RESERVATION_NAME: der Name einer vorhandenen Reservierung.DELETE_AFTER_DURATION: eine Dauer in Tagen, Stunden, Minuten oder Sekunden, nach der die Reservierung automatisch gelöscht wird. Geben Sie beispielsweise30mfür 30 Minuten oder1d2h3m4sfür 1 Tag, 2 Stunden, 3 Minuten und 4 Sekunden an.ZONE: die Zone, in der sich die Reservierung befindet.
Verwenden Sie zum Deaktivieren der Option zum automatischen Löschen den Befehl gcloud beta compute reservations update mit dem Flag --disable-auto-delete.
gcloud beta compute reservations update RESERVATION_NAME \
--disable-auto-delete \
--zone=ZONE
Ersetzen Sie Folgendes:
RESERVATION_NAME: der Name einer vorhandenen Reservierung.ZONE: die Zone, in der sich die Reservierung befindet.
REST
Wenn Sie die Option zum automatischen Löschen in einer Reservierung aktivieren, können Sie ein Datum und eine Uhrzeit für das Löschen der Reservierung oder eine Dauer, nach der die Reservierung gelöscht werden soll, angeben.
Führen Sie einen der folgenden Schritte aus, um die Option zum automatischen Löschen zu aktivieren oder zu ändern, wann die Reservierung gelöscht werden soll:
Wenn Sie die Reservierung zu einem bestimmten Datum und einer bestimmten Uhrzeit löschen möchten, stellen Sie eine
PATCH-Anfrage an die Methodebeta.reservations.update. Fügen Sie in der Anfrage-URL den Abfrageparameterpathsein, wobei dieser aufdeleteAtTimegesetzt ist.PATCH https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime { "name": "RESERVATION_NAME", "deleteAtTime": "DELETE_AT_TIME" }Ersetzen Sie Folgendes:
PROJECT_ID: die ID des Projekts, in dem sich die Reservierung befindet.ZONE: die Zone, in der sich die Reservierung befindet.RESERVATION_NAME: der Name einer vorhandenen Reservierung.DELETE_AT_TIME: ein Datum und eine Uhrzeit, die als ein RFC 3339-Zeitstempel formatiert sind.
Wenn Sie die Reservierung nach einer bestimmten Dauer löschen möchten, senden Sie eine
PATCH-Anfrage an die Methodebeta.reservations.update. Fügen Sie in der Anfrage-URL den Abfrageparameterpathsein, wobei dieser aufdeleteAfterDuration.secondsgesetzt ist.PATCH https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAfterDuration.seconds { "name": "RESERVATION_NAME", "deleteAfterDuration": { "seconds": "DELETE_AFTER_DURATION" } }Ersetzen Sie Folgendes:
PROJECT_ID: die ID des Projekts, in dem sich die Reservierung befindet.ZONE: die Zone, in der sich die Reservierung befindet.RESERVATION_NAME: der Name einer vorhandenen Reservierung.DELETE_AFTER_DURATION: die Dauer in Sekunden, nach der die Reservierung automatisch gelöscht wird. Geben Sie beispielsweise86400für 86.400 Sekunden (1 Tag) an.
Senden Sie zum Deaktivieren der Option zum automatischen Löschen eine PATCH-Anfrage an die Methode beta.reservations.update.
Geben Sie in der Anfrage den Abfrageparameter paths=deleteAtTime&paths=deleteAfterDuration an und lassen Sie den Anfragetext weg.
PATCH https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime&paths=deleteAfterDuration
Ersetzen Sie Folgendes:
PROJECT_ID: die ID des Projekts, in dem sich die Reservierung befindet.ZONE: die Zone, in der sich die Reservierung befindet.RESERVATION_NAME: der Name einer vorhandenen Reservierung.