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.
- Per saperne di più sui parametri che puoi utilizzare per personalizzare i suggerimenti, consulta Scegli i parametri di configurazione giusti.
- Per saperne di più su come intervenire quando ricevi suggerimenti sulle prenotazioni inutilizzate o sottoutilizzate, consulta Visualizza e applica i suggerimenti per le prenotazioni inattive o Visualizza e applica i suggerimenti per le prenotazioni sottoutilizzate.
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 a servizi e API di Trusted Cloud by S3NS .
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
-
Install the Google Cloud CLI, and then sign in to the gcloud CLI with your federated identity. After signing in, initialize the Google Cloud CLI by running the following command:
gcloud init
- Set a default region and zone.
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.
Install the Google Cloud CLI, and then sign in to the gcloud CLI with your federated identity. After signing in, initialize the Google Cloud CLI by running the following command:
gcloud init
Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Trusted Cloud .
Configura i suggerimenti
Per configurare i suggerimenti per le prenotazioni sottoutilizzate, segui questi passaggi:
- Recupera la configurazione attuale per acquisire il relativo file JSON.
- Modifica il file di configurazione in formato JSON.
- 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 inseriscigoogle.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
eparams.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 specificagoogle.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
eparams.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 (minimo7
e massimo30
), seguito daD
, 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 inseriscigoogle.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 attualeCONFIG_FILE_PATH
: il percorso del file JSON con la configurazione attualeETAG
: il valore etag della configurazione attualeBILLING_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 metodorecommenders.updateConfig
e specificagoogle.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
- Scopri come visualizzare e applicare i suggerimenti per le prenotazioni inattive.
- Scopri come visualizzare e applicare i suggerimenti per le prenotazioni sottoutilizzate.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-18 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-08-18 UTC."],[[["\u003cp\u003eThis page explains how to configure underutilized reservation recommendations, which are Pre-GA products available "as is" with potentially limited support.\u003c/p\u003e\n"],["\u003cp\u003eYou can modify the configuration to adjust the number of recommendations received by altering parameters like the lookback period (7-30 days) and utilization threshold.\u003c/p\u003e\n"],["\u003cp\u003eConfiguration changes require getting the current configuration in JSON format, editing it, and then uploading the updated file using either the Google Cloud CLI or REST API.\u003c/p\u003e\n"],["\u003cp\u003eTo update the configuration you must have \u003ccode\u003erecommender.computeRightSizeResourceRecommender.get\u003c/code\u003e to view, and \u003ccode\u003erecommender.computeRightSizeResourceRecommender.update\u003c/code\u003e permissions to modify.\u003c/p\u003e\n"],["\u003cp\u003eAfter uploading a new configuration, it will take approximately 48 hours for the changes to become effective and to be used to generate any new recommendations.\u003c/p\u003e\n"]]],[],null,[]] -