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

  • Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud-Dienste und APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich bei Compute Engine authentifizieren. Wählen Sie dazu eine der folgenden Optionen aus:

    Select the tab for how you plan to use the samples on this page:

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.

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:

  • ZONE durch die Zone ersetzen, die Reservierungen enthält, für die Empfehlungen aufgelistet werden sollen.
  • 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 auch den Nutzungsgrenzwert fest, der eine Empfehlung für eine nicht ausgelastete Reservierung auslöst. Ändern Sie dazu den Wert für under_utilized_reservation_utilization_threshold und laden Sie die neue Konfiguration für Ihr Projekt hoch. Beispiel:

  • Bei einem Grenzwert von 80 % ist das "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 Grenzwert für nicht ausgelastete 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