Configurare i consigli per le prenotazioni inattive

Questa pagina descrive come visualizzare e modificare la configurazione dei consigli per le prenotazioni on demand inutilizzate. Ti consigliamo di modificare la configurazione per aumentare il numero di consigli che ricevi o per ricevere meno consigli in modo da eliminare le prenotazioni che prevedi di utilizzare.

• Per ulteriori informazioni sui parametri che puoi utilizzare per personalizzare i consigli, consulta Scegliere i parametri di configurazione giusti.
• Per saperne di più su come identificare le prenotazioni on demand inattive e intervenire, consulta Visualizzare e applicare i consigli per le prenotazioni inattive.

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 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. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

  2. Set a default region and zone.

  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, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Configurare i consigli

Per configurare i consigli per le prenotazioni inutilizzate:

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

Ottenere la configurazione attuale

Puoi ottenere la configurazione corrente per i consigli sulle prenotazioni inattive per il tuo progetto utilizzando Google Cloud CLI o REST.

Completa questa operazione utilizzando uno dei seguenti metodi.

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

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

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P7D"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-06-03T04:41:15.330351Z"
}

GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/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.IdleResourceRecommender/config

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P7D"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-06-03T04:41:15.330351Z"
}

Aggiornare la configurazione di un progetto

Per aggiornare la configurazione dei consigli per le prenotazioni inutilizzate, modifica il valore di idle_reservation_lookback_period e carica la nuova configurazione per il 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 (7 minimo 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".

Dopo aver caricato la nuova configurazione, sono necessarie circa 48 ore per l'applicazione. Fino a quel momento, tutti i consigli generati utilizzeranno la configurazione precedente.

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

{
  "params": {
    "idle_reservation_lookback_period": "P21D"
  }
}

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P21D"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

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

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P21D"
    }
  },
  "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.IdleResourceRecommender/config

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P21D"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

Passaggi successivi

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