Empfehlungen für nicht ausgelastete Reservierungen konfigurieren

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.

Hinweise

Empfehlungen konfigurieren

So konfigurieren Sie die Empfehlungen für nicht optimal genutzte Reservierungen:

  1. Rufen Sie die aktuelle Konfiguration ab, um die JSON-Datei der Konfiguration zu erhalten.
  2. Bearbeiten Sie die Konfigurationsdatei im JSON-Format.
  3. 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 Sie google.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 und params.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 Sie google.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 und params.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 und 30 als Maximum) und dann von D, 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 Sie google.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öchten
  • CONFIG_FILE_PATH: der Pfad zur JSON-Datei mit der aktuellen Konfiguration
  • ETAG: der ETag-Wert der aktuellen Konfiguration
  • BILLING_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 Methode recommenders.updateConfig und geben Sie google.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