Auf dieser Seite wird beschrieben, wie Sie die Konfiguration Ihrer inaktiven VM-Empfehlungen aufrufen und ändern. Sie können die Konfiguration ändern, um die Anzahl der erhaltenen Empfehlungen zu erhöhen oder zu vermeiden, dass VMs mit absichtlich kleinen Arbeitslasten als inaktive VMs falsch klassifiziert werden.
- 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 inaktiver VMs und zu Maßnahmen finden Sie unter Empfehlungen zu inaktiven VMs 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.
Preise
Konfigurierbare Empfehlungen sind kostenlos verfügbar. Die Verwendung von Empfehlungen zur Reduzierung der Ressourcennutzung kann zu Kosteneinsparungen führen.
Empfehlungen konfigurieren
Führen Sie die folgenden Schritte aus, um Empfehlungen zu inaktiven VMs zu konfigurieren:
- 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 VM für Ihr Projekt über die Google Cloud CLI oder REST abrufen.
gcloud
Verwenden Sie den Befehl
gcloud recommender recommender-config describe
und geben Siegoogle.compute.instance.IdleResourceRecommender
als Recommender-ID an, um die aktuellen Konfigurationsparameter abzurufen:gcloud recommender recommender-config describe google.compute.instance.IdleResourceRecommender \ --project=PROJECT_ID \ --location=ZONE
Dabei gilt:
PROJECT_ID
: die Projekt-IDZONE
: die Zone, für die Sie die aktuelle Konfiguration abrufen möchten
Beispiel:
gcloud recommender recommender-config describe google.compute.instance.IdleResourceRecommender \ --project=my-project \ --location=us-central1-c
Der Befehl gibt die Recommender-Konfiguration zurück, einschließlich des änderbaren Unterfelds
params.observation_period
.{ "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.IdleResourceRecommender/config", "recommenderGenerationConfig": { "params": { "observation_period": "1209600s" } }, "etag": "\"2f3c9b65cda6a4ba\"", "updateTime": "2021-02-03T04:41:15.330351Z" }
REST
Verwenden Sie zum Abrufen der aktuellen Konfiguration die Methode
recommenders.getConfig
und geben Siegoogle.compute.instance.IdleResourceRecommender
als Recommender-ID an:GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.IdleResourceRecommender/config
Dabei gilt:
PROJECT_ID
: die ID des Projekts, für das Sie die Recommender-Konfiguration abrufen möchten.ZONE
: 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.instance.IdleResourceRecommender/config
Der Befehl gibt die Recommender-Konfiguration zurück, einschließlich des Unterfelds, das Sie ändern können:
params.observation_period
.{ "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.IdleResourceRecommender/config", "recommenderGenerationConfig": { "params": { "observation_period": "1209600s" } }, "etag": "\"2f3c9b65cda6a4ba\"", "updateTime": "2021-02-03T04:41:15.330351Z" }
Konfiguration für ein Projekt aktualisieren
Ändern Sie den Wert für
observation_period
und laden Sie die neue Konfiguration für Ihr Projekt hoch, um die Konfiguration der Empfehlungen zu inaktiven VMs zu aktualisieren.Sie können den Beobachtungszeitraum auf einen Wert zwischen 1 Tag und 14 Tagen festlegen. Dazu verwenden Sie einen String mit der Gesamtzahl von Sekunden gefolgt vom Buchstaben
s
.- Verwenden Sie
"86400s"
für einen Beobachtungszeitraum von 1 Tag. - Verwenden Sie
"1209600s"
für einen Beobachtungszeitraum von 14 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.instance.IdleResourceRecommender
als Recommender-ID an:gcloud recommender recommender-config update google.compute.instance.IdleResourceRecommender\ --project=PROJECT_ID \ --location=ZONE \ --config-file=CONFIG_FILE_PATH \ --etag=ETAG
Dabei gilt:
PROJECT_ID
: die Projekt-IDZONE
: 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 Konfiguration
Geben Sie in Ihrer Konfigurationsdatei nur das Objekt
recommenderGenerationConfig
mit den aktualisierten Konfigurationsparametern an. Verwenden Sie beispielsweise die folgende Konfigurationsdatei, um einen Beobachtungszeitraum von fünf Tagen anzugeben:{ "params": { "observation_period": "432000s" } }
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.instance.IdleResourceRecommender/config", "recommenderGenerationConfig": { "params": { "observation_period": "432000s" } }, "etag": "\"1245f9435cd01ea8\"", "updateTime": "2021-02-03T05:00:05Z" }
REST
Verwenden Sie zum Aktualisieren der Konfiguration die Methode
recommenders.updateConfig
und geben Siegoogle.compute.instance.IdleResourceRecommender
als Recommender-ID an:PATCH https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.IdleResourceRecommender/config { "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.IdleResourceRecommender/config", "recommenderGenerationConfig": { "params": { "observation_period": "1209600s" } }, "etag": "\"2f3c9b65cda6a4ba\"" }
Dabei gilt:
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.instance.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.instance.IdleResourceRecommender/config", "recommenderGenerationConfig": { "params": { "observation_period": "432000s" } }, "etag": "\"1245f9435cd01ea8\"", "updateTime": "2021-02-03T05:00:05Z" }
Nächste Schritte
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-19 (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-19 (UTC)."],[[["This document outlines the process for viewing and modifying the configuration of idle VM recommendations, allowing users to customize these settings to better suit their needs."],["Idle VM recommendations are available as a Pre-GA offering, which means they are provided \"as is\" with potentially limited support, subject to the \"Pre-GA Offerings Terms\"."],["Users can adjust the `observation_period` parameter to determine the time frame used to identify idle VMs, with a range from 1 to 14 days."],["Configuring recommendations involves retrieving the current settings, editing the configuration file in JSON format, and then uploading the modified file, which takes up to 48 hours to implement."],["Authentication through gcloud CLI is required to interact with REST API samples, by installing, initializing and setting a region and zone for the project."]]],[]] -