Auf dieser Seite wird beschrieben, wie Sie die Konfiguration Ihrer Empfehlungen zu inaktiven On-Demand-Reservierungen aufrufen und ändern. Sie können die Konfiguration ändern, um die Anzahl der erhaltenen Empfehlungen zu erhöhen oder weniger Empfehlungen zum Löschen von Reservierungen zu erhalten, die Sie verwenden möchten.
- Weitere Informationen zu den Parametern, mit denen Sie die Empfehlungen anpassen können, finden Sie unter Die richtigen Konfigurationsparameter auswählen.
- Weitere Informationen zum Ermitteln einer inaktiven On-Demand-Reservierung und zum Ergreifen von Maßnahmen finden Sie unter Empfehlungen zu inaktiven Reservierungen ansehen und anwenden.
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 Trusted Cloud 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:
Select the tab for how you plan to use the samples on this page:
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 folgendem Befehl:
gcloud init
- Set a default region and zone.
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. Nach der Anmeldung initialisieren Sie die Google Cloud CLI mit folgendem Befehl:
gcloud init
Weitere Informationen finden Sie in der Dokumentation zur Trusted Cloud -Authentifizierung unter Für die Verwendung von REST authentifizieren.
Empfehlungen konfigurieren
So konfigurieren Sie die Empfehlungen für inaktive Reservierungen:
- Rufen Sie die aktuelle Konfiguration ab, um die JSON-Datei der Konfiguration zu erhalten.
- Bearbeiten Sie die Konfigurationsdatei im JSON-Format.
- Neue Konfigurationsdatei hochladen um die Änderungen zu übernehmen.
Aktuelle Konfiguration abrufen
Sie können die aktuelle Konfiguration der Empfehlungen zu inaktiven Reservierungen für Ihr Projekt über die Google Cloud CLI oder REST abrufen.
Führen Sie diese Aufgabe mit einer der folgenden Methoden aus.
gcloud
Verwenden Sie den Befehl
gcloud recommender recommender-config describe
und geben Siegoogle.compute.IdleResourceRecommender
als Recommender-ID an, um die aktuellen Konfigurationsparameter abzurufen:gcloud recommender recommender-config describe google.compute.IdleResourceRecommender \ --location=ZONE --billing-account=BILLING_ACCOUNT_ID
Ersetzen Sie
ZONE
durch die Zone, für die Sie die aktuelle Konfiguration abrufen möchten.Beispiel:
gcloud recommender recommender-config describe google.compute.IdleResourceRecommender \ --location=us-central1-c --billing-account=my-billing-account-id
Der Befehl gibt die Recommender-Konfiguration zurück, einschließlich des änderbaren Unterfelds
params.idle_reservation_lookback_period
.{ "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config", "recommenderGenerationConfig": { "params": { "idle_reservation_lookback_period": "P7D" } }, "etag": "\"2f3c9b65cda6a4ba\"", "updateTime": "2024-06-03T04:41:15.330351Z" }
REST
Verwenden Sie zum Abrufen der aktuellen Konfiguration die Methode
recommenders.getConfig
und geben Siegoogle.compute.IdleResourceRecommender
als Recommender-ID an:GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config
Ersetzen Sie
ZONE
durch die Zone, die Ihr Projekt enthält.Führen Sie in der Befehlszeile den folgenden Befehl aus, um die Recommender-Konfiguration für ein Projekt abzurufen:
PROJECT_ID=PROJECT_ID ZONE=ZONE curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-user-project: ${PROJECT_ID}" \ https://recommender.googleapis.com/v1/projects/$PROJECT_ID/locations/$ZONE/recommenders/google.compute.IdleResourceRecommender/config
Der Befehl gibt die Recommender-Konfiguration zurück, einschließlich des Unterfelds, das Sie ändern können:
params.idle_reservation_lookback_period
.{ "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config", "recommenderGenerationConfig": { "params": { "idle_reservation_lookback_period": "P7D" } }, "etag": "\"2f3c9b65cda6a4ba\"", "updateTime": "2024-06-03T04:41:15.330351Z" }
Konfiguration für ein Projekt aktualisieren
Ändern Sie den Wert für
idle_reservation_lookback_period
und laden Sie die neue Konfiguration für Ihr Projekt hoch, um die Konfiguration der Empfehlungen zu inaktiven Reservierungsempfehlungen zu aktualisieren.Sie können den Beobachtungszeitraum auf einen Wert zwischen 7 und 30 Tagen festlegen. Dazu verwenden Sie einen String, der mit
P
beginnt, gefolgt von einer Ganzzahl für die Anzahl der Tage (7
als Minimum und30
als Maximum) und dann vonD
, z. B.:- Verwenden Sie
"P7D"
für einen Beobachtungszeitraum von 7 Tagen. - Verwenden Sie
"P30D"
für einen Beobachtungszeitraum von 30 Tagen.
Nachdem Sie die neue Konfiguration hochgeladen haben, dauert es etwa 48 Stunden, bis sie wirksam wird. Bis dahin verwenden alle generierten Empfehlungen die vorherige Konfiguration.
gcloud
Verwenden Sie zum Aktualisieren der Konfigurationsparameter den Befehl
gcloud recommender recommender-config update
und geben Siegoogle.compute.IdleResourceRecommender
als Recommender-ID an:gcloud recommender recommender-config update google.compute.IdleResourceRecommender\ --location=ZONE \ --config-file=CONFIG_FILE_PATH \ --etag=ETAG \ --billing-account=BILLING_ACCOUNT_ID
Ersetzen Sie Folgendes:
ZONE
: die Zone, für die Sie die aktuelle Konfiguration abrufen möchtenCONFIG_FILE_PATH
: der Pfad zur JSON-Datei mit der aktuellen KonfigurationETAG
: der ETag-Wert der aktuellen KonfigurationBILLING_ACCOUNT_ID
: die ID des Rechnungskontos
Geben Sie in Ihrer Konfigurationsdatei nur das Objekt
recommenderGenerationConfig
mit den aktualisierten Konfigurationsparametern an. Verwenden Sie beispielsweise die folgende Konfigurationsdatei, um einen Beobachtungszeitraum von 21 Tagen anzugeben:{ "params": { "idle_reservation_lookback_period": "P21D" } }
Wenn der Befehl erfolgreich ausgeführt wurde, wird ein Antworttext ähnlich dem folgenden zurückgegeben. Dieser enthält die neue Konfiguration mit den soeben geänderten Parametern.
{ "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config", "recommenderGenerationConfig": { "params": { "idle_reservation_lookback_period": "P21D" } }, "etag": "\"1245f9435cd01ea8\"", "updateTime": "2024-06-03T05:00:05Z" }
REST
Stellen Sie zum Aktualisieren der Konfiguration eine
PATCH
-Anfrage an die Methoderecommenders.updateConfig
und geben Siegoogle.compute.IdleResourceRecommender
als Recommender-ID an:PATCH https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config { "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config", "recommenderGenerationConfig": { "params": { "idle_reservation_lookback_period": "P21D" } }, "etag": "\"2f3c9b65cda6a4ba\"" }
Ersetzen Sie Folgendes:
PROJECT_ID
: die ID des Projekts, für das Sie die Recommender-Konfiguration ändern möchten.ZONE
: die Zone, die Ihr Projekt enthält.
Speichern Sie den Anfragetext in einer Datei, z. B.
config.json
. Sie können dann auf die Datei verweisen, wenn Sie die Recommender-Konfiguration für Ihr Projekt aktualisieren. Verwenden Sie dazu einen Befehl wie diesen:curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -H "x-goog-user-project: ${PROJECT_ID}" \ -d @config.json \ https://recommender.googleapis.com/v1/projects/$PROJECT_ID/locations/$ZONE/recommenders/google.compute.IdleResourceRecommender/config
Der Befehl
POST
gibt einen Antworttext wie den folgenden zurück, der die neue Konfiguration mit den soeben geänderten Parametern zeigt.{ "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config", "recommenderGenerationConfig": { "params": { "idle_reservation_lookback_period": "P21D" } }, "etag": "\"1245f9435cd01ea8\"", "updateTime": "2024-06-03T05:00:05Z" }
Nächste Schritte
- Empfehlungen zu inaktiven VMs ansehen und anwenden
- Empfehlungen zu nicht ausgelasteten VMs ansehen und anwenden
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-18 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-18 (UTC)."],[[["\u003cp\u003eThis document explains how to view and modify the configuration for idle, on-demand reservation recommendations, which is a pre-GA offering subject to specific terms and limited support.\u003c/p\u003e\n"],["\u003cp\u003eYou can adjust the number of idle reservation recommendations you receive by modifying the configuration parameters, with detailed instructions provided on selecting the right parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe configuration process involves obtaining the current configuration, editing the JSON file to change the \u003ccode\u003eidle_reservation_lookback_period\u003c/code\u003e parameter within the 7 to 30 day range, and then uploading the new configuration.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication is required, and this can be done via the gcloud CLI or the REST API, with specific instructions for each method included in this document.\u003c/p\u003e\n"],["\u003cp\u003eAfter updating the configuration, it takes about 48 hours for the changes to take effect on generated recommendations, and the \u003ccode\u003eetag\u003c/code\u003e value changes each time you update the configuration.\u003c/p\u003e\n"]]],[],null,[]] -