Configura suggerimenti per le prenotazioni sottoutilizzate

Questa pagina descrive come visualizzare e modificare la configurazione dei consigli per le prenotazioni on demand sottoutilizzate. Potresti voler modificare configurazione per aumentare il numero di consigli che ricevi. per ricevere meno consigli sull'eliminazione delle prenotazioni che prevedi di utilizzare.

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai servizi Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione Compute Engine come segue.

    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

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

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

        gcloud init

      Per ulteriori informazioni, vedi Esegui l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Configurare i consigli

Per configurare i consigli per le prenotazioni sottoutilizzate:

  1. Ottieni la configurazione attuale per ottenere il file JSON della configurazione.
  2. Modifica il file di configurazione in formato JSON.
  3. Caricare il nuovo file di configurazione per applicare le modifiche.

Ottieni la configurazione attuale

Puoi ottenere la configurazione attuale per i suggerimenti relativi alle prenotazioni sottoutilizzate per il tuo progetto utilizzando Google Cloud CLI o REST.

Completa questa attività utilizzando uno dei seguenti metodi.

gcloud

Per ottenere i parametri di configurazione correnti, utilizza il metodo Comando gcloud recommender recommender-config describe e usa google.compute.RightSizeResourceRecommender come ID motore per suggerimenti:

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

Sostituisci quanto segue:

  • ZONE con la zona contenente le prenotazioni per le quali elencare i consigli.
  • BILLING_ACCOUNT_ID con 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 recommender, 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 corrente, utilizza recommenders.getConfig e specifica google.compute.RightSizeResourceRecommender come ID 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 recommender.
  • ZONE: la zona che contiene il progetto.

Dalla riga di comando, esegui questo comando per ottenere il motore per suggerimenti configurazione per 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 recommender, 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 per under_utilized_reservation_lookback_period e carica il nuovo per il tuo progetto.

Puoi impostare il periodo di osservazione su un valore compreso tra 7 e 30 giorni, utilizzando una stringa che inizia con P, poi un numero intero per il numero di giorni (minimo 7 e 30 massimo), 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 consiglio 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 il caricamento della nuova configurazione, saranno necessarie circa 48 ore per applicare le modifiche. Fino a quel momento, tutti i consigli generati utilizzano i valori precedenti configurazione.

Completa questa attività utilizzando uno dei seguenti metodi.

gcloud

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

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 cui vuoi ottenere il configurazione attuale
  • CONFIG_FILE_PATH: il percorso del file JSON con la configurazione corrente
  • ETAG: il valore etag della configurazione attuale
  • BILLING_ACCOUNT_ID: l'ID dell'account di fatturazione

Nel file di configurazione, specifica solo il recommenderGenerationConfig con i parametri di configurazione aggiornati. Ad esempio, per specificare un periodo di osservazione di 21 giorni e la soglia di sottoutilizzazione delle prenotazioni 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 alla di seguito, mostrando la nuova configurazione con i parametri modificato.

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

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 recommender.
  • 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 recommender 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 di 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