Auf dieser Seite wird beschrieben, wie Sie die Konfiguration Ihrer Empfehlungen zu nicht optimal genutzten 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 dazu, wie Sie vorgehen, wenn Sie Empfehlungen zu inaktiven oder nicht ausgelasteten Reservierungen erhalten, finden Sie unter Empfehlungen zu inaktiven Reservierungen ansehen und anwenden oder Empfehlungen zu nicht ausgelasteten 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 nicht optimal genutzte 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 nicht optimal genutzten 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.RightSizeResourceRecommender
als Recommender-ID an, um die aktuellen Konfigurationsparameter abzurufen:gcloud recommender recommender-config describe google.compute.RightSizeResourceRecommender \ --location=ZONE --billing-account=BILLING_ACCOUNT_ID
Ersetzen Sie Folgendes:
- Ersetzen Sie
ZONE
durch die Zone, die Reservierungen zum Auflisten von Empfehlungen enthält. BILLING_ACCOUNT_ID
durch die ID Ihres Rechnungskontos.
Beispiel:
gcloud recommender recommender-config describe google.compute.RightSizeResourceRecommender \ --location=us-central1-c --billing-account=my-billing-account-id
Der Befehl gibt die Recommender-Konfiguration zurück, einschließlich der änderbaren Unterfelder
params.under_utilized_reservation_lookback_period
undparams.under_utilized_reservation_utilization_threshold
.{ "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config", "recommenderGenerationConfig": { "params": { "under_utilized_reservation_lookback_period": "P7D", "under_utilized_reservation_utilization_threshold": "0.8" } }, "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.RightSizeResourceRecommender
als Recommender-ID an:GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config
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.
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.RightSizeResourceRecommender/config
Der Befehl gibt die Recommender-Konfiguration zurück, einschließlich der Unterfelder, die Sie ändern können:
params.under_utilized_reservation_lookback_period
undparams.under_utilized_reservation_utilization_threshold
.{ "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config", "recommenderGenerationConfig": { "params": { "under_utilized_reservation_lookback_period": "P7D", "under_utilized_reservation_utilization_threshold": "0.8" } }, "etag": "\"2f3c9b65cda6a4ba\"", "updateTime": "2024-06-03T04:41:15.330351Z" }
Konfiguration für ein Projekt aktualisieren
Ändern Sie den Wert für
under_utilized_reservation_lookback_period
und laden Sie die neue Konfiguration für Ihr Projekt hoch, um die Konfiguration der Empfehlungen zu nicht optimal genutzten 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.
Legen Sie den Nutzungsschwellenwert fest, der eine Empfehlung zu nicht optimal genutzten Reservierungen auslöst, indem Sie den Wert für
under_utilized_reservation_utilization_threshold
ändern und die neue Konfiguration für Ihr Projekt hochladen, z. B.:- Bei einem Grenzwert von 80 % gilt:
"0.8"
.
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.
Führen Sie diese Aufgabe mit einer der folgenden Methoden aus.
gcloud
Verwenden Sie zum Aktualisieren der Konfigurationsparameter den Befehl
gcloud recommender recommender-config update
und geben Siegoogle.compute.RightSizeResourceRecommender
als Recommender-ID an:gcloud recommender recommender-config update google.compute.RightSizeResourceRecommender\ --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 und den Schwellenwert für unterausgelastete Reservierungen auf 80 % festzulegen:{ "params": { "under_utilized_reservation_lookback_period": "P21D", "under_utilized_reservation_utilization_threshold": "0.8" } }
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.RightSizeResourceRecommender/config", "recommenderGenerationConfig": { "params": { "under_utilized_reservation_lookback_period": "P21D", "under_utilized_reservation_utilization_threshold": "0.8" } }, "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.RightSizeResourceRecommender
als Recommender-ID an:PATCH https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config { "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config", "recommenderGenerationConfig": { "params": { "under_utilized_reservation_lookback_period": "P21D", "under_utilized_reservation_utilization_threshold": "0.8" } }, "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.RightSizeResourceRecommender/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.RightSizeResourceRecommender/config", "recommenderGenerationConfig": { "params": { "under_utilized_reservation_lookback_period": "P21D", "under_utilized_reservation_utilization_threshold": "0.8" } }, "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-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)."],[[["\u003cp\u003eThis page explains how to configure underutilized reservation recommendations, which are Pre-GA products available "as is" with potentially limited support.\u003c/p\u003e\n"],["\u003cp\u003eYou can modify the configuration to adjust the number of recommendations received by altering parameters like the lookback period (7-30 days) and utilization threshold.\u003c/p\u003e\n"],["\u003cp\u003eConfiguration changes require getting the current configuration in JSON format, editing it, and then uploading the updated file using either the Google Cloud CLI or REST API.\u003c/p\u003e\n"],["\u003cp\u003eTo update the configuration you must have \u003ccode\u003erecommender.computeRightSizeResourceRecommender.get\u003c/code\u003e to view, and \u003ccode\u003erecommender.computeRightSizeResourceRecommender.update\u003c/code\u003e permissions to modify.\u003c/p\u003e\n"],["\u003cp\u003eAfter uploading a new configuration, it will take approximately 48 hours for the changes to become effective and to be used to generate any new recommendations.\u003c/p\u003e\n"]]],[],null,[]] -