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.

Prima di iniziare

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

    Seleziona la scheda relativa a come intendi utilizzare i campioni in questa pagina:

    gcloud

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

      gcloud init

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

  • Imposta una regione e una zona predefinite.

    • REST

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

      Installa Google Cloud CLI.

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

    Per saperne di più, consulta Autenticati per usare 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

Per recuperare i parametri della configurazione attuale, utilizza il comando gcloud recommender recommender-config describe e inserisci google.compute.RightSizeResourceRecommender come ID del motore per suggerimenti:

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

Sostituisci quanto segue:

  • ZONE: la zona contenente le prenotazioni per le quali elencare i suggerimenti.
  • BILLING_ACCOUNT_ID: l'ID del tuo account di fatturazione.

Ad esempio:

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

Il comando restituisce la configurazione del motore per suggerimenti, inclusi i campi secondari modificabili params.under_utilized_reservation_lookback_period e 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

Per recuperare la configurazione attuale, utilizza il metodo recommenders.getConfig e specifica google.compute.RightSizeResourceRecommender come ID del motore per suggerimenti:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto per cui vuoi modificare la configurazione del motore per suggerimenti.
  • ZONE: la zona che contiene il progetto.

Dalla riga di comando, esegui questo comando per recuperare la configurazione del motore per suggerimenti di un progetto:

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

Il comando restituisce la configurazione del motore per suggerimenti, inclusi i campi secondari che puoi modificare: params.under_utilized_reservation_lookback_period e 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"
}

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

Per aggiornare i parametri di configurazione, utilizza il comando gcloud recommender recommender-config update e inserisci google.compute.RightSizeResourceRecommender come ID del motore per suggerimenti:

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

Sostituisci quanto segue:

  • ZONE: la zona per la quale vuoi recuperare la configurazione attuale
  • CONFIG_FILE_PATH: il percorso del file JSON con la configurazione attuale
  • ETAG: il valore etag della configurazione attuale
  • BILLING_ACCOUNT_ID: l'ID dell'account di fatturazione

Nel file di configurazione, specifica solo l'oggetto recommenderGenerationConfig con i parametri di configurazione aggiornati. Ad esempio, per specificare un periodo di osservazione di 21 giorni e la soglia per le prenotazioni sottoutilizzate all'80%, utilizza il seguente file di configurazione:

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

Se il comando ha esito positivo, restituisce un corpo della risposta simile al seguente, che mostra la nuova configurazione con i parametri appena modificati.

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

Per aggiornare la configurazione, invia una richiesta PATCH al metodo recommenders.updateConfig e specifica google.compute.RightSizeResourceRecommender come ID del motore per suggerimenti:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto per cui vuoi modificare la configurazione del motore per suggerimenti.
  • ZONE: la zona che contiene il progetto.

Salva il corpo della richiesta in un file, ad esempio config.json. Puoi quindi fare riferimento al file quando aggiorni la configurazione del motore per suggerimenti per il tuo progetto utilizzando un comando simile al seguente:

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

Il comando POST restituisce un corpo della risposta simile al seguente, che mostra la nuova configurazione con i parametri appena modificati.

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