Configura i suggerimenti per le prenotazioni inattive

Questa pagina descrive come visualizzare e modificare la configurazione dei suggerimenti per le prenotazioni on demand inattive. 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 ulteriori informazioni sui parametri che puoi utilizzare per personalizzare i suggerimenti, consulta Scegli i parametri di configurazione giusti.
• Per ulteriori informazioni su come identificare le prenotazioni on demand inattive e intervenire, consulta Visualizza e applica i suggerimenti per le prenotazioni inattive.

Prima di iniziare

• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso ai Google Cloud servizi e alle 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. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  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.

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Configura i suggerimenti

Per configurare i suggerimenti per le prenotazioni inutilizzate:

1. Ottieni 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.

Ottieni la configurazione attuale

Puoi ottenere la configurazione corrente dei suggerimenti sulle prenotazioni inattive 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.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"
}

Aggiorna la configurazione di un progetto

Per aggiornare la configurazione dei suggerimenti per le prenotazioni inattive, modifica il valore di idle_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".

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.

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 suggerimenti per le prenotazioni inattive.
• Scopri come visualizzare e applicare i suggerimenti per le prenotazioni sottoutilizzate.