Configura i suggerimenti per le prenotazioni sottoutilizzate

Questa pagina descrive come visualizzare e modificare la configurazione dei suggerimenti per le prenotazioni on demand sottoutilizzate. Ti consigliamo di modificare la configurazione per aumentare il numero di suggerimenti che ricevi o per riceverne meno relativi alla cancellazione di prenotazioni che intendi utilizzare.

• Per saperne di più sui parametri che puoi utilizzare per personalizzare i suggerimenti, consulta Scegli i parametri di configurazione giusti.
• Per saperne di più su come intervenire quando ricevi suggerimenti sulle prenotazioni inutilizzate o sottoutilizzate, consulta Visualizza e applica i suggerimenti per le prenotazioni inattive o Visualizza e applica i suggerimenti per le prenotazioni sottoutilizzate.

Prima di iniziare

• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso a Google Cloud servizi e API. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

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

  gcloud

  1. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando:

     gcloud init

     Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  2. Set a default region and zone.

  REST

  Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali che fornisci a gcloud CLI.

  Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando:

  gcloud init

  Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Configura i suggerimenti

Per configurare i suggerimenti per le prenotazioni sottoutilizzate, segui questi passaggi:

1. Recupera la configurazione attuale per acquisire il relativo file JSON.
2. Modifica il file di configurazione in formato JSON.
3. Per applicare le modifiche, carica il nuovo file di configurazione.

Recupera la configurazione attuale

Puoi recuperare la configurazione attuale dei suggerimenti sulle prenotazioni sottoutilizzate per il tuo progetto utilizzando Google Cloud CLI o REST.

Completa questa attività utilizzando uno dei seguenti metodi.

gcloud recommender recommender-config describe google.compute.RightSizeResourceRecommender \
  --location=ZONE --billing-account=BILLING_ACCOUNT_ID

gcloud recommender recommender-config describe google.compute.RightSizeResourceRecommender \
  --location=us-central1-c --billing-account=my-billing-account-id

{
  "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"
}

GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config

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

{
  "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"
}

Aggiorna la configurazione di un progetto

Per aggiornare la configurazione dei suggerimenti per le prenotazioni sottoutilizzate, modifica il valore di under_utilized_reservation_lookback_period e carica la nuova configurazione del progetto.

Puoi impostare il periodo di osservazione su un valore compreso tra 7 e 30 giorni utilizzando una stringa che inizia con P, seguita da un numero intero per il numero di giorni (minimo 7 e massimo 30), seguito da D, ad esempio:

• Per un periodo di osservazione di 7 giorni, utilizza "P7D".
• Per un periodo di osservazione di 30 giorni, utilizza "P30D".

Analogamente, imposta la soglia di utilizzo che attiva un suggerimento per le prenotazioni sottoutilizzate modificando il valore di under_utilized_reservation_utilization_threshold e carica la nuova configurazione per il progetto, ad esempio:

• Per una soglia dell'80%, "0.8".

Dopo aver caricato la nuova configurazione, l'applicazione della modifica richiede circa 48 ore. Fino a quel momento, tutti i suggerimenti generati utilizzano la configurazione precedente.

Completa questa attività utilizzando uno dei seguenti metodi.

gcloud recommender recommender-config update google.compute.RightSizeResourceRecommender\
  --location=ZONE \
  --config-file=CONFIG_FILE_PATH \
  --etag=ETAG \
  --billing-account=BILLING_ACCOUNT_ID

{
  "params": {
    "under_utilized_reservation_lookback_period": "P21D",
    "under_utilized_reservation_utilization_threshold": "0.8"
  }
}

{
  "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"
}

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\""
}

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

{
  "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"
}

Passaggi successivi

• Scopri come visualizzare e applicare i suggerimenti per le prenotazioni inattive.
• Scopri come visualizzare e applicare i suggerimenti per le prenotazioni sottoutilizzate.