Motore per suggerimenti di progetti non previsti

Il motore per suggerimenti di progetto inattivo analizza l'attività di utilizzo dei progetti nella tua organizzazione e fornisce consigli che ti aiutano a scoprire, ripristinare o rimuovere i progetti non previsti.

Panoramica

Nelle organizzazioni in rapida evoluzione, non è raro che le risorse cloud, inclusi interi progetti, vengano dimenticate di tanto in tanto. Queste risorse non attive possono essere difficili da identificare e tendono a generare sprechi e rischi per la sicurezza non necessari.

Il motore per suggerimenti di progetti non previsti analizza l'attività di utilizzo in tutti i progetti della tua organizzazione e fornisce le seguenti funzionalità per aiutarti a scoprire, recuperare e arrestare i progetti non previsti:

• Approfondimenti sull'utilizzo per ogni progetto (networking, API, proprietario del progetto, attività di servizio e altro ancora).
• Consigli per disattivare i progetti con un'attività di utilizzo ridotta.
• Suggerimenti per assegnare un nuovo proprietario ai progetti con un'attività di utilizzo elevata, ma senza un proprietario attivo.

L'interruzione o il recupero dei progetti non monitorati può avere i seguenti risultati e vantaggi per la tua organizzazione:

• Riduzione dei rischi per la sicurezza (SECURITY)
• Riduzione della spesa non necessaria (COST)
• Riduzione dell'impronta di carbonio associata ai tuoi carichi di lavoro (SUSTAINABILITY)

Nota: il Recommender progetto inattivo può essere utilizzato solo per i progetti assegnati alle organizzazioni Google Cloud.

Come funziona

Il motore per suggerimenti di progetto inattivo analizza l'utilizzo del progetto negli ultimi 30 giorni. La tabella seguente elenca i consigli e gli approfondimenti che il Recommender per i progetti unattended può generare in base all'attività di utilizzo bassa o elevata .

Utilizzo/tipo di progetto	Sottotipo di insight	Consiglio	Sottotipo di consiglio
Progetti con: Utilizzo ridotto negli ultimi 30 giorni	PROJECT_ACTIVITY	Rivedi o elimina il progetto.	CLEANUP_PROJECT
Progetti con: Utilizzo elevato negli ultimi 30 giorni Proprietari utente assegnati, ma nessuno dei quali è attivo nel progetto.	PROJECT_ACTIVITY	Recupera il progetto assegnando un nuovo proprietario.	RECLAIM_PROJECT
Tutti gli altri progetti non Apps Script.	PROJECT_ACTIVITY	-	-

Nota: il Recommender progetto inattivo non genera approfondimenti o consigli per i progetti Apps Scripts poiché questi progetti vengono eliminati automaticamente con l'eliminazione degli script associati.

I consigli e gli approfondimenti sono disponibili a diversi livelli della gerarchia dell'organizzazione Cloud. Per accedere a questi suggerimenti e approfondimenti è necessaria un'associazione del ruolo IAM al livello corrispondente:

• A livello di progetto: i proprietari del progetto possono scoprire e utilizzare approfondimenti e consigli per i progetti a cui hanno accesso.
• A livello di organizzazione: gli amministratori dell'organizzazione possono scoprire e utilizzare informazioni e consigli per i progetti all'interno di un'organizzazione cloud.
• A livello di account di fatturazione: gli amministratori della fatturazione possono scoprire e utilizzare approfondimenti e consigli per i progetti associati a un determinato account di fatturazione.

Nota: il numero di approfondimenti e consigli per organizzazione o account di fatturazione è attualmente limitato a 10.000. Se la tua organizzazione o il tuo account di fatturazione include più di 10.000 progetti e vuoi esaminare l'intero insieme di suggerimenti e approfondimenti, ti consigliamo di utilizzare gli approfondimenti e i suggerimenti a livello di progetto o di esportare gli approfondimenti e i suggerimenti in BigQuery.

Classificare l'attività di utilizzo di un progetto

Un progetto può essere classificato come avente un'attività di utilizzo ridotta o elevata, in base alla quale vengono forniti i consigli. Il ranking dell'attività di utilizzo di un progetto viene calcolato in base ai contenuti inclusi nell'approfondimento sull'utilizzo del progetto.

Per i progetti identificati come aventi un'attività di utilizzo ridotta, si applicano le seguenti condizioni:

Classificazione dell'utilizzo	Condizione
Organizzazioni con più di 50 progetti	Un progetto viene classificato in base al livello di attività di utilizzo in tutti i contenuti inclusi nell'approfondimento sull'utilizzo del progetto. Un progetto viene classificato come non supervisionato se rientra nel 10% dell'attività di utilizzo rispetto a tutti gli altri progetti dell'organizzazione.
Organizzazioni con meno di 50 progetti	La media giornaliera delle chiamate API consumate da un progetto (consumedApiDailyCount) è inferiore a 100. Cloud Logging è l'unico servizio utilizzato da un progetto. Tutti gli altri approfondimenti sull'utilizzo del progetto hanno un valore pari a zero.

Nota: i consigli vengono forniti solo per i progetti precedenti a 30 giorni.

Priorità e impatti dei consigli

I consigli per i progetti non supervisionati contengono i seguenti campi che aiutano a dare la priorità e a stimare i vantaggi della loro applicazione:

• priority: un valore di priorità compreso tra P1 e P4, dove P1 è la priorità più elevata.
• primaryImpact - SECURITY. Il conteggio dei suggerimenti di sicurezza con priorità elevata in un progetto inattivo.
• additionalImpact(s) - COST e SUSTAINABILITY. La riduzione del costo (in $) e delle emissioni di sostenibilità (kgCO₂e) che si realizzerebbe se il progetto venisse rimosso.

Priorità del consiglio

La priorità del suggerimento relativo a un progetto inattivo va da P1 a P4, dove P1 è la priorità più alta.

Il recommender inizia esaminando i consigli sulla sicurezza in ogni progetto unattended. Da qui, imposta la priorità del suggerimento per il progetto inattivo uguale a quella del suggerimento con la priorità più alta trovato all'interno del progetto. Ad esempio, se un progetto inattivo contiene 10 consigli di sicurezza, otto consigli P2 e due consigli P1, al consiglio relativo al progetto inattivo verrà assegnato un valore di priorità P1.

I consigli per la sicurezza più frequenti trovati nei progetti unattended provengono dal motore per suggerimenti IAM. Un suggerimento relativo a un progetto inattivo con priorità P1 probabilmente indica che nel progetto inattivo è presente un bucket spazio di archiviazione sul cloud accessibile pubblicamente (scopri di più su come IAM Recommender imposta le priorità).

Impatto sulla sicurezza

Il campo primaryImpact - SECURITY offre un valore securityProjection uguale al numero di suggerimenti di sicurezza con priorità elevata (P2 e versioni successive) nel progetto inattivo. Ad esempio, quando un progetto ha un consiglio per sostituire il ruolo generico Editor con un ruolo più granulare, questo consiglio ha una priorità P2 e viene conteggiato in priorityRecommendationCount.

Impatto sui costi

Il campo additionalImpact - COST offre un valore costProjection che rappresenta una stima del risparmio sui costi se il progetto inattivo è stato rimosso. Si basa sui costi sostenuti per le risorse in esecuzione nel progetto inattivo negli ultimi 30 giorni.

Nota: per visualizzare i prezzi personalizzati nelle proiezioni dei costi, l'account di fatturazione cloud associato non deve essere cambiato negli ultimi 30 giorni e l'utente deve disporre delle autorizzazioni di fatturazione.

Impatto in termini di sostenibilità

Il campo additionalImpact - SUSTAINABILITY offre un valore sustainabilityProjection che è una stima delle emissioni di anidride carbonica generate dalle risorse in esecuzione nel progetto inattivo negli ultimi 30 giorni. La stima viene misurata in chilogrammi di anidride carbonica equivalente (kgCO₂e).

Contenuti di un insight sull'utilizzo del progetto

I contenuti dell'analisi di utilizzo di un progetto sono valori di campo utilizzati per classificare l'attività di utilizzo del progetto e generare consigli CLEANUP_PROJECT e/o RECLAIM_PROJECT.

Avviso: le informazioni sull'utilizzo dei progetti vengono generate per tutti i progetti, indipendentemente dal fatto che siano o meno unattended. Questi insight vengono generati su base giornaliera. Un singolo insight non è un indicatore affidabile per considerare un progetto come inattivo. Evita di rimuovere i progetti in base alle informazioni di un solo giorno.

La seguente tabella elenca i vari campi visualizzati dal recommender nell'ambito dell'approfondimento PROJECT_ACTIVITY:

Campo	Descrizione
Livello di utilizzo
usagePercentile	Percentile del livello di utilizzo di questo progetto rispetto ad altri progetti all'interno della stessa organizzazione. Se il percentile è -1, significa che il valore non è stato calcolato. Il valore non viene calcolato quando le organizzazioni hanno meno di 50 progetti.
Attività API
activeServiceAccountDailyCount	Media giornaliera degli account di servizio con attività di autenticazione in questo progetto.
apiClientDailyCount	Media giornaliera di client distinti di chiamate API prodotte da questo progetto.
consumedApiDailyCount	Media giornaliera delle chiamate API consumate da questo progetto.
datastoreApiDailyCount	Media giornaliera delle chiamate all'API Datastore consumate da questo progetto
Attività di networking
vpcEgressDailyBytes	Media giornaliera dei byte VPC in uscita di questo progetto.
vpcIngressDailyBytes	Media giornaliera dei byte VPC in entrata in questo progetto
Utilizzo della fatturazione
hasBillingAccount	Controlla se al termine dell'osservazione il progetto ha un account di fatturazione
serviceWithBillableUsage	Nomi dei servizi fatturabili utilizzati negli ultimi 30 giorni.
Utilizzo dei servizi cloud
activeAppengineInstanceDailyCount: system/instance_count	Media giornaliera del numero di istanze App Engine attivate in questo progetto
activeCloudsqlInstanceDailyCount	Media giornaliera del numero di istanze Cloud SQL attivate in questo progetto.
activeGceInstanceDailyCount	Media giornaliera del numero di istanze Compute Engine attivo in questo progetto.
bigqueryInflightJobDailyCount	Media giornaliera dei job BigQuery in esecuzione in questo progetto.
bigqueryInflightQueryDailyCount	Media giornaliera del numero di query BigQuery in esecuzione in questo progetto.
bigqueryStorageDailyBytes	Media giornaliera dello spazio di archiviazione BigQuery in transito in questo progetto.
bigqueryTableDailyCount	Media giornaliera del conteggio delle tabelle BigQuery in questo progetto.
gcsObjectDailyCount	Media giornaliera del numero di oggetti Cloud Storage in questo progetto.
gcsRequestDailyCount	Media giornaliera del numero di API Cloud Storage in questo progetto.
gcsStorageDailyBytes	Media giornaliera dei byte di spazio di archiviazione utilizzati da Cloud Storage in questo progetto.
Attività utente
numActiveUserOwners	Il numero di proprietari di progetti di tipo utente attivi alla fine del periodo di osservazione. Con attivo si intende che l'account utente non è disattivato e che è stata identificata qualche attività in questo progetto durante il periodo di osservazione.
owners	Elenco dei proprietari dei progetti e delle relative attività
Altri campi
hasActiveOauthTokens	Controlla se il progetto ha token OAuth attivi utilizzati negli ultimi 180 giorni.
carbonFootprintDailyKgCO2	Media giornaliera delle emissioni di carbonio generate da questo progetto in base ai dati disponibili degli ultimi 30 giorni.
costProjection	Risparmio di costi previsto per la durata specificata se il progetto dovesse essere rimosso. Viene mostrato un prezzo personalizzato o di listino in base alle autorizzazioni dell'account di fatturazione. Si tratta di una stima basata sugli ultimi 30 giorni di dati disponibili e non costituisce una fattura.
severity	severity è impostato sul valore corrispondente della informazione sulla sicurezza con gravità più elevata trovata nel progetto. Ad esempio, in base a come IAM Recommender imposta le severità per le sue informazioni, una severità CRITICAL nell'approfondimento del progetto unattended probabilmente indica che nel progetto inattivo è presente un bucket spazio di archiviazione sul cloud accessibile pubblicamente.

Suggerimenti per eliminare un progetto

Ti consigliamo di eliminare un progetto quando ha un utilizzo ridotto negli ultimi 30 giorni e non sono stati utilizzati token OAuth negli ultimi 180 giorni.

Avviso: esamina attentamente le informazioni sull'utilizzo associate a un progetto. L'eliminazione di un progetto potrebbe comportare una perdita irreversibile dei dati. Per ulteriori informazioni, consulta la sezione Chiusura (eliminazione) dei progetti.

Attenzione: i consigli vengono forniti per i progetti tenant. L'eliminazione di questo progetto potrebbe comportare la perdita di dati a causa di ulteriori campi di utilizzo del progetto che non vengono acquisiti per questi progetti.

Consigli per assegnare un nuovo proprietario a un progetto

Ti consigliamo di assegnare un nuovo proprietario a un progetto quando soddisfa tutte le condizioni elencate di seguito:

• Tutti i proprietari assegnati non sono attivi nel progetto negli ultimi 90 giorni o non fanno più parte della società.
• Il progetto ha un'attività di utilizzo elevata.

Nota: se a un progetto non è stato assegnato un proprietario utente, si tratta di un comportamento previsto se il consiglio RECLAIM_PROJECT non viene fornito.

Prezzi

Per maggiori dettagli sui prezzi di Active Assist, consulta i prezzi del recommender.

Prima di iniziare

Prima di poter visualizzare gli approfondimenti e i consigli, devi:

• Devi abilitare l'API Recommender. Devi abilitare l'API in un unico progetto di fatturazione. Puoi quindi utilizzare lo stesso progetto di fatturazione per esaminare consigli e approfondimenti per altri progetti, l'intera organizzazione o l'account di fatturazione utilizzando la funzionalità --billing-project di gcloud/API.
• Assicurati di avere uno di questi ruoli obbligatori assegnati:

Descrizione	Ruoli
Visualizza i suggerimenti	recommender.projectUtilViewer
Visualizzare e aggiornare i consigli	recommender.projectUtilAdmin
Disattivare gli approfondimenti e i consigli nel Centro trasparenza e controllo	dataprocessing.admin

Questi ruoli forniscono un insieme di autorizzazioni che ti consentono di accedere a approfondimenti e consigli. Per saperne di più sui ruoli, consulta la sezione Informazioni sui ruoli e Concedere autorizzazioni IAM.

La concessione di questi ruoli a livello di organizzazione ti consente di accedere ai consigli e alle informazioni per i progetti dell'organizzazione singolarmente o collettivamente (tutti i progetti non supervisionati dell'organizzazione) utilizzando l'API a livello di organizzazione.

La concessione di questi ruoli a livello di account di fatturazione ti consente di accedere ai consigli e alle informazioni per i progetti che utilizzano l'account di fatturazione specificato.

Per saperne di più sulla disattivazione, consulta la sezione relativa alla disattivazione di insight e suggerimenti.

ID consigliatore

Di seguito sono riportati l'ID del motore per suggerimenti di progetto inattivo e il tipo di informazioni:

• google.resourcemanager.projectUtilization.Recommender
• google.resourcemanager.projectUtilization.Insight

Autorizzazioni IAM richieste

Per accedere all'elenco di consigli e approfondimenti, sono necessarie le seguenti autorizzazioni:

• recommender.resourcemanagerProjectUtilizationRecommendations.get
• recommender.resourcemanagerProjectUtilizationRecommendations.list
• recommender.resourcemanagerProjectUtilizationInsights.get
• recommender.resourcemanagerProjectUtilizationInsights.list

Per aggiornare i consigli e le statistiche (ad esempio per ignorare un consiglio), sono necessarie le seguenti autorizzazioni:

• recommender.resourcemanagerProjectUtilizationRecommendations.update
• recommender.resourcemanagerProjectUtilizationInsights.update

Visualizzazione dei suggerimenti per progetto inattivo

Questa sezione descrive come verificare la presenza di approfondimenti e consigli non supervisionati utilizzando gcloud e curl per inviare richieste all'API del motore per suggerimenti.

gcloud

Per visualizzare consigli e approfondimenti utilizzando gcloud, segui i passaggi riportati di seguito. Per ulteriori informazioni, consulta Utilizzo dell'API - Approfondimenti e Utilizzo dell'API - Suggerimenti.

Consigli

1. Per elencare i consigli per progetto inattivo per il progetto in cui hai attivato l'API Recommender, esegui il seguente comando:

     gcloud recommender recommendations list \
     --project=PROJECT_ID \
     --location=global \
     --recommender=google.resourcemanager.projectUtilization.Recommender
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID progetto.

2. Per elencare i consigli per progetto inattivo in un altro progetto mentre utilizzi un progetto in cui hai attivato l'API Recommender (come nel passaggio precedente), esegui il seguente comando:

     gcloud recommender recommendations list \
     --billing-project=BILLING_PROJECT_ID \
     --project=PROJECT_ID \
     --location=global \
     --recommender=google.resourcemanager.projectUtilization.Recommender
   

   Sostituisci quanto segue:

   • BILLING_PROJECT_ID: l'ID del progetto che hai attivato con l'API Recommender (dovrebbe essere lo stesso PROJECT_ID indicato nel passaggio precedente).
   • PROJECT_ID: l'ID di un altro progetto per il quale vuoi visualizzare i consigli per progetto inattivo.
   Nota: se il comando non restituisce alcun consiglio, il progetto non è senza supervisione o non esiste da almeno 30 giorni.

3. Per elencare i consigli per i progetto inattivo per l'intera organizzazione, utilizzando un progetto in cui hai attivato l'API Recommender (come nel passaggio precedente), esegui il seguente comando:

     gcloud recommender recommendations list \
     --billing-project=BILLING_PROJECT_ID \
     --organization=ORGANIZATION_ID \
     --location=global \
     --recommender=google.resourcemanager.projectUtilization.Recommender
   

   Sostituisci quanto segue:

   • BILLING_PROJECT_ID: l'ID del progetto che hai attivato con l'API Recommender (dovrebbe essere lo stesso PROJECT_ID indicato nel passaggio precedente).
   • ORGANIZATION_ID: l'ID dell'organizzazione per la quale vuoi visualizzare i consigli per progetto inattivo.

4. Per elencare i consigli per progetto inattivo che utilizzano un account di fatturazione specifico, mentre utilizzi un progetto in cui hai attivato l'API Recommender (come nel passaggio precedente), esegui il seguente comando:

     gcloud recommender recommendations list \
     --billing-project=BILLING_PROJECT_ID \
     --billing-account=BILLING_ACCOUNT_ID \
     --location=global \
     --recommender=google.resourcemanager.projectUtilization.Recommender
   

   Sostituisci quanto segue:

   • BILLING_PROJECT_ID: l'ID del progetto che hai attivato con l'API Recommender (dovrebbe essere lo stesso PROJECT_ID indicato nel passaggio precedente).
   • BILLING_ACCOUNT_ID: l'ID del tuo account di fatturazione Google Cloud.

Nota: puoi espandere i dettagli dei consigli dal comando list aggiungendo alla fine un flag --format=yaml.

Approfondimenti

1. Per elencare gli approfondimenti sull'utilizzo per un determinato progetto, esegui il seguente comando:

     gcloud recommender insights list \
     --project=PROJECT_ID \
     --location=global \
     --insight-type=google.resourcemanager.projectUtilization.Insight
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID progetto.

2. Per elencare gli approfondimenti sull'utilizzo per un progetto diverso, mentre utilizzi un progetto in cui hai attivato l'API Recommender (come nel passaggio precedente), esegui il seguente comando:

     gcloud recommender insights list \
     --billing-project=BILLING_PROJECT_ID \
     --project=PROJECT_ID \
     --location=global \
     --insight-type=google.resourcemanager.projectUtilization.Insight
   

   Sostituisci quanto segue:

   • BILLING_PROJECT_ID: l'ID del progetto che hai attivato con l'API Recommender (dovrebbe essere lo stesso PROJECT_ID indicato nel passaggio precedente).
   • PROJECT_ID: l'ID di un altro progetto per il quale vuoi visualizzare gli approfondimenti del motore per suggerimenti non presidiato.

3. Per elencare gli approfondimenti sull'utilizzo per l'intera organizzazione, mentre utilizzi un progetto in cui hai attivato l'API Recommender (come nel passaggio precedente), esegui il seguente comando:

     gcloud recommender insights list \
     --billing-project=BILLING_PROJECT_ID \
     --organization=ORGANIZATION_ID \
     --location=global \
     --insight-type=google.resourcemanager.projectUtilization.Insight
   

   Sostituisci quanto segue:

   • BILLING_PROJECT_ID: l'ID del progetto che hai attivato con l'API Recommender (dovrebbe essere lo stesso PROJECT_ID indicato nel passaggio precedente).
   • ORGANIZATION_ID: l'ID dell'organizzazione per la quale vuoi visualizzare gli approfondimenti sull'utilizzo.

4. Per elencare gli approfondimenti sull'utilizzo che utilizzano un account di fatturazione specifico, utilizzando un progetto in cui hai attivato l'API Recommender (come nel passaggio precedente), esegui il seguente comando:

     gcloud recommender insights list \
     --billing-project=BILLING_PROJECT_ID \
     --billing-account=BILLING_ACCOUNT_ID \
     --location=global \
     --insight-type=google.resourcemanager.projectUtilization.Insight
   

   Sostituisci quanto segue:

   • BILLING_PROJECT_ID: l'ID del progetto che hai attivato con l'API Recommender (dovrebbe essere lo stesso PROJECT_ID indicato nel passaggio precedente).
   • BILLING_ACCOUNT_ID: l'ID del tuo account di fatturazione Google Cloud.

Nota: puoi espandere i dettagli degli Approfondimenti dal comando di elenco aggiungendo un flag --format=yaml alla fine.

API

Per visualizzare consigli e approfondimenti, puoi utilizzare curl per inviare una richiesta alle API Recommender. Per autorizzare le richieste dalla riga di comando, utilizza i token di accesso OAuth. Un token di accesso OAuth è una stringa che concede l'accesso temporaneo a un'API.

Nota: se non hai ancora familiarità con i prerequisiti di autenticazione per chiamare le API Google Cloud, consulta la Panoramica dell'autenticazione.

Consigli

1. Per elencare i consigli per progetto inattivo per il progetto in cui hai attivato l'API Recommender, esegui il seguente comando:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/global/\
   recommenders/google.resourcemanager.projectUtilization.Recommender/recommendations"
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID progetto.
   Nota: se la chiamata all'API non restituisce alcun consiglio, il progetto non è senza supervisione o non esiste da almeno 30 giorni.

2. Per elencare i consigli per progetto inattivo in un altro progetto mentre utilizzi un progetto in cui hai attivato l'API Recommender (come nel passaggio precedente), esegui il seguente comando:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
   -H "x-goog-user-project: BILLING_PROJECT_ID" \
   "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/global/\
   recommenders/google.resourcemanager.projectUtilization.Recommender/recommendations"
   

   Sostituisci quanto segue:

   • BILLING_PROJECT_ID: l'ID del progetto che hai attivato con l'API Recommender (dovrebbe essere lo stesso PROJECT_ID indicato nel passaggio precedente).
   • PROJECT_ID: l'ID di un altro progetto per il quale vuoi visualizzare i consigli per progetto inattivo.

3. Per elencare i consigli per i progetto inattivo per l'intera organizzazione, utilizzando un progetto in cui hai attivato l'API Recommender (come nel passaggio precedente), esegui il seguente comando:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
   -H "x-goog-user-project: BILLING_PROJECT_ID" \
   "https://recommender.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/\
   recommenders/google.resourcemanager.projectUtilization.Recommender/recommendations"
   

   Sostituisci quanto segue:

   • BILLING_PROJECT_ID: l'ID del progetto che hai attivato con l'API Recommender (dovrebbe essere lo stesso PROJECT_ID indicato nel passaggio precedente).
   • ORGANIZATION_ID: l'ID dell'organizzazione per la quale vuoi visualizzare i consigli per progetto inattivo.

4. Per elencare i consigli per progetto inattivo che utilizzano un account di fatturazione specifico, mentre utilizzi un progetto in cui hai attivato l'API Recommender (come nel passaggio precedente), esegui il seguente comando:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
   -H "x-goog-user-project: BILLING_PROJECT_ID" \
   "https://recommender.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/locations/global/\
   recommenders/google.resourcemanager.projectUtilization.Recommender/recommendations"
   

   Sostituisci quanto segue:

   • BILLING_PROJECT_ID: l'ID del progetto che hai attivato con l'API Recommender (dovrebbe essere lo stesso PROJECT_ID indicato nel passaggio precedente).
   • BILLING_ACCOUNT_ID: l'ID del tuo account di fatturazione Google Cloud.

Approfondimenti

1. Per elencare gli approfondimenti sull'utilizzo per un determinato progetto, esegui il seguente comando:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/global\
   /insightTypes/google.resourcemanager.projectUtilization.Insight/insights"
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID progetto.

2. Per elencare gli approfondimenti sull'utilizzo per un progetto diverso, mentre utilizzi un progetto in cui hai attivato l'API Recommender (come nel passaggio precedente), esegui il seguente comando:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "x-goog-user-project: BILLING_PROJECT_ID/" \
   "https://recommender.googleapis.com/v1/projects/PROJECT_ID//locations/global\
   /insightTypes/google.resourcemanager.projectUtilization.Insight/insights"
   

   Sostituisci quanto segue:

   • BILLING_PROJECT_ID: l'ID del progetto che hai attivato con l'API Recommender (dovrebbe essere lo stesso PROJECT_ID indicato nel passaggio precedente).
   • PROJECT_ID: l'ID di un altro progetto per il quale vuoi visualizzare gli approfondimenti del motore per suggerimenti non presidiato.

3. Per elencare gli approfondimenti sull'utilizzo per l'intera organizzazione, mentre utilizzi un progetto in cui hai attivato l'API Recommender (come nel passaggio precedente), esegui il seguente comando:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
   -H "x-goog-user-project: PROJECT_ID/" \
   "https://recommender.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/\
   insightTypes/google.resourcemanager.projectUtilization.Insight/insights"
   

   Sostituisci quanto segue:

   • BILLING_PROJECT_ID: l'ID del progetto che hai attivato con l'API Recommender (dovrebbe essere lo stesso PROJECT_ID indicato nel passaggio precedente).
   • ORGANIZATION_ID: l'ID dell'organizzazione per la quale vuoi visualizzare i consigli per progetto inattivo.

4. Per elencare gli approfondimenti sull'utilizzo che utilizzano un account di fatturazione specifico, utilizzando un progetto in cui hai attivato l'API Recommender (come nel passaggio precedente), esegui il seguente comando:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
   -H "x-goog-user-project: PROJECT_ID/" \
   "https://recommender.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/locations/global/\
   insightTypes/google.resourcemanager.projectUtilization.Insight/insights"
   

   Sostituisci quanto segue:

   • BILLING_PROJECT_ID: l'ID del progetto che hai attivato con l'API Recommender (dovrebbe essere lo stesso PROJECT_ID indicato nel passaggio precedente).
   • BILLING_ACCOUNT_ID: l'ID del tuo account di fatturazione Google Cloud.

Configurazione dei parametri dei consigli

Questa sezione descrive come visualizzare e configurare questo recommender utilizzando gcloud e curl.

La tabella seguente elenca i vari parametri che possono essere configurati:

Parametro	Descrizione	Valori previsti
minimum_observation_period	Il periodo di osservazione minimo definisce il numero di giorni di attività del progetto da analizzare prima della generazione di un consiglio. L'impostazione di questo valore è attualmente supportata solo a livello di organizzazione.	"P30D"[DEFAULT], "P60D", "P90D", "P180D", "P270D", "P365D"

gcloud

Per visualizzare e aggiornare le configurazioni dei consigli utilizzando gcloud, segui i passaggi riportati di seguito.

Visualizzazione delle configurazioni

1. Per visualizzare le configurazioni del motore per suggerimenti di progetti non previsti per una determinata organizzazione, esegui il seguente comando da un progetto appartenente all'organizzazione in cui è abilitata l'API Recommender:

   gcloud beta recommender recommender-config describe \
   google.resourcemanager.projectUtilization.Recommender \
   --organization=ORGANIZATION_ID \
   --location=global
   

   Sostituisci quanto segue:

   • ORGANIZATION_ID: l'ID organizzazione.

2. Output di esempio:

   etag: ETAG
   name: organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config
   recommenderGenerationConfig:
     params:
       minimum_observation_period: P30D
   revisionId: DEFAULT
   updateTime: '2022-04-19T00:57:55Z'
   

   Prendi nota del valore ETAG:

   • ETAG: questo valore verrà utilizzato in recommender-config update.

Aggiornamento delle configurazioni

1. Per aggiornare le configurazioni del Motore per suggerimenti di progetti non previsti per una determinata organizzazione, scegli un progetto appartenente a quell'organizzazione in cui hai attivato l'API Recommender e crea un file config.gcloud:

   
   {
    "params": {
       "minimum_observation_period": DURATION
     }
   }
   

   Sostituisci quanto segue:

   • DURATION: uno dei valori "P30D", "P60D", "P90D", "P180D", "P270D", "P365D"

2. Esegui questo comando:

   gcloud beta recommender recommender-config update \
   google.resourcemanager.projectUtilization.Recommender \
   --organization=ORGANIZATION_ID \
   --location=global \
   --config-file=config.gcloud \
   --etag=ETAG
   

   Sostituisci quanto segue:

   • ORGANIZATION_ID: l'ID organizzazione.
   • ETAG: il valore etag restituito da recommender-config describe.

API

Per visualizzare e aggiornare le configurazioni dei consigli, puoi utilizzare curl per inviare una richiesta alle API Recommender. Per autorizzare le richieste dalla riga di comando, utilizza i token di accesso OAuth. Un token di accesso OAuth è una stringa che concede l'accesso temporaneo a un'API.

Nota: se non hai ancora familiarità con i prerequisiti di autenticazione per chiamare le API Google Cloud, consulta la Panoramica dell'autenticazione.

Visualizzazione delle configurazioni

1. Per visualizzare le configurazioni del motore per suggerimenti di progetti non previsti per una determinata organizzazione, esegui il seguente comando da un progetto appartenente all'organizzazione in cui è abilitata l'API Recommender:

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   -H "x-goog-user-project: PROJECT_ID" \
   https://recommender.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID progetto.
   • ORGANIZATION_ID: l'ID organizzazione.

2. Output di esempio:

   
   {
     "name": "organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config",
     "recommenderGenerationConfig": {
       "params": {
         "minimum_observation_period": "P60D"
       }
     },
     "etag": ETAG,
     "updateTime": "2022-04-21T18:51:17.407255Z",
     "revisionId": "75c3b0d7"
   }
   
   

   Prendi nota del valore ETAG:

   • ETAG: questo valore verrà utilizzato in curl PATCH.

Aggiornamento delle configurazioni

1. Per aggiornare le configurazioni del Motore per suggerimenti di progetti non previsti per una determinata organizzazione, scegli un progetto appartenente a quell'organizzazione in cui hai attivato l'API Recommender e crea un file request.json:

   
   {
     "name": "organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config",
     "recommenderGenerationConfig": {
       "params": {
         "minimum_observation_period": DURATION
       }
     },
   "etag": ETAG,
   }
   

   Sostituisci quanto segue:

   • DURATION: uno dei valori "P30D", "P60D", "P90D", "P180D", "P270D", "P365D"
   • ETAG: il valore etag restituito da CURL get.

2. Esegui la seguente riga di comando:

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   -H "x-goog-user-project: PROJECT_ID" \
   -H "Content-Type: application/json; charset=utf-8" -d @request.json \
   https://recommender.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID progetto.
   • ORGANIZATION_ID: l'ID organizzazione.

Passaggi successivi

• Chiusura (eliminazione) di progetti
• Eliminare i progetti in un'organizzazione
• Metodologia di generazione dei report sull'impronta di carbonio
• Tutorial interattivo (apri in Cloud Shell)