Configura suggerimenti per le prenotazioni inattive

In questa pagina viene descritto come visualizzare e modificare la configurazione del dispositivo, consigli su prenotazioni on demand. 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 già fatto, configura l'autenticazione. Autenticazione è la procedura di verifica dell'identità per l'accesso ai servizi e alle API di 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. Installa Google Cloud CLI, quindi initialize eseguendo questo comando: 

      gcloud init
    2. Set a default region and zone.

      3. 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, quindi initialize eseguendo questo comando: 

        gcloud init

      Per maggiori informazioni, consulta Autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Configura i suggerimenti

Per configurare i suggerimenti relativi alle prenotazioni inattive:

  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 inattive per il tuo progetto utilizzando Google Cloud CLI o REST.

gcloud

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

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

Sostituisci ZONE con la zona che vuoi recuperare la configurazione attuale.

Ad esempio:

gcloud recommender recommender-config describe google.compute.IdleResourceRecommender \
  --location=us-central1-c

Il comando restituisce la configurazione del motore per suggerimenti, inclusa la campo secondario params.observation_period.

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

REST

Per recuperare la configurazione corrente, utilizza recommenders.getConfig e specifica google.compute.IdleResourceRecommender come ID motore per suggerimenti:

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

Sostituisci ZONE con la zona contenente 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.IdleResourceRecommender/config

Il comando restituisce la configurazione del motore per suggerimenti, incluso il sottocampo che puoi modificare: params.observation_period.

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

Aggiorna la configurazione di un progetto

Per aggiornare la configurazione dei suggerimenti relativi alle prenotazioni inattive, modifica il per observation_period e carica la nuova configurazione per il progetto.

Puoi impostare il periodo di osservazione su un valore compreso tra 1 e 14 giorni, utilizzando una stringa con il numero totale di secondi, seguiti dalla lettera s.

  • Per un periodo di osservazione di 7 giorni, utilizza "604800s".
  • Per un periodo di osservazione di 30 giorni, utilizza "2592000s".

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.

gcloud

Per aggiornare i parametri di configurazione, utilizza la classe Comando gcloud recommender recommender-config update e usa google.compute.IdleResourceRecommender come ID motore per suggerimenti:

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

Sostituisci quanto segue:

  • ZONE: la zona per cui vuoi ottenere il configurazione attuale
  • CONFIG_FILE_PATH: il percorso del file JSON con la configurazione attuale
  • ETAG: il valore dell'etag della configurazione attuale

Nel file di configurazione, specifica solo il valore recommenderGenerationConfig con i parametri di configurazione aggiornati. Ad esempio, per specificare un periodo di osservazione di 21 giorni, utilizza il seguente file di configurazione:

{
  "params": {
    "observation_period": "1814400s"
  }
}

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.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "observation_period": "1814400s"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

REST

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

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": {
      "observation_period": "1814400s"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\""
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto per il quale 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. Potrai 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.IdleResourceRecommender/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.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "observation_period": "1814400s"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

Passaggi successivi