Motore per suggerimenti di progetti non previsti

Il motore per suggerimenti di progetto inattivo analizza l'attività di utilizzo sui progetti nella tua organizzazione e fornisce suggerimenti che ti aiutano a scoprire, recuperare o rimuovere progetti inattivi.

Panoramica

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

Il motore per suggerimenti di progetti inattivi analizza l'attività di utilizzo su tutti i progetti della tua organizzazione e ti fornisce le seguenti funzionalità per aiutarti a scoprire, recuperare e chiudere i progetti inattivi:

Insight sull'utilizzo per ogni progetto (networking, API, proprietario del progetto, attività di servizio e altro ancora).
Suggerimenti per disattivare i progetti con attività di utilizzo ridotto.
Suggerimenti per l'assegnazione di un nuovo proprietario ai progetti con attività di utilizzo elevata, ma nessun proprietario attivo.

La chiusura o il recupero di progetti inattivi può offrire i seguenti impatto e vantaggi alla tua organizzazione:

Riduzione dei rischi per la sicurezza (SECURITY)
Riduzione delle spese non necessarie (COST)
Riduzione dell'impronta di carbonio associata ai tuoi carichi di lavoro (SUSTAINABILITY)

Come funziona

Il motore per suggerimenti di progetto inattivo analizza l'utilizzo dei progetti negli ultimi 30 giorni. La seguente tabella elenca i suggerimenti e gli insight che il motore per suggerimenti di progetti inattivi può generare in base al fatto che l'attività di utilizzo sia bassa o elevata .

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

I suggerimenti e gli insight sono disponibili a diversi livelli della gerarchia delle organizzazioni Cloud. L'accesso a questi suggerimenti e insight richiede un'associazione del ruolo IAM al livello corrispondente:

A livello di progetto: i proprietari del progetto possono scoprire insight e suggerimenti per i progetti a cui hanno accesso e intervenire.
A livello di organizzazione: gli amministratori dell'organizzazione possono scoprire insight e suggerimenti per i progetti all'interno di un'organizzazione cloud e agire di conseguenza.
A livello di account di fatturazione: gli amministratori della fatturazione possono individuare insight e suggerimenti per i progetti associati a un determinato account di fatturazione e prendere provvedimenti in merito.

Ranking dell'attività di utilizzo di un progetto

Un progetto può essere classificato in modo da avere un'attività di utilizzo basso o elevato, in base ai suggerimenti forniti. Il ranking dell'attività di utilizzo di un progetto viene calcolato in base ai contenuti inclusi negli insight sull'utilizzo del progetto.

Per i progetti identificati con attività di utilizzo ridotto, 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 su tutti i contenuti inclusi negli insight sull'utilizzo del progetto. Un progetto viene classificato come inattivo se rientra nel 10% dell'attività di utilizzo rispetto a tutti gli altri progetti nell'organizzazione.
Organizzazioni con meno di 50 progetti	La media giornaliera di chiamate API utilizzate da un progetto (`consumedApiDailyCount`) è inferiore a 100. Cloud Logging è l'unico servizio utilizzato da un progetto. Tutti gli altri insight sull'utilizzo del progetto hanno un valore uguale a zero.

Priorità e impatti dei consigli

I suggerimenti di progetti inattivi contengono i seguenti campi che aiutano a dare priorità e stimare i vantaggi dell'applicazione:

priority: un valore di priorità compreso tra P1 e P4, dove P1 è la priorità più alta.
primaryImpact - SECURITY. Il numero di suggerimenti per la sicurezza ad alta priorità in un progetto inattivo.
additionalImpact(s) - COST e SUSTAINABILITY. La riduzione dei costi ($) e delle emissioni sostenibili (kgCO₂e) che si otterrebbero rimuovendo il progetto.

Priorità dei suggerimenti

La priorità dei suggerimenti per i progetto inattivo va da P1 a P4, dove P1 è la priorità più alta.

Il motore per suggerimenti inizia esaminando i suggerimenti per la sicurezza in ogni progetto inattivo. Da qui, imposta la priorità del suggerimento di progetto inattivo uguale a quella del suggerimento con la priorità più alta trovata all'interno del progetto. Ad esempio, se un progetto inattivo ha 10 suggerimenti per la sicurezza, otto suggerimenti P2 e due suggerimenti P1, al progetto inattivo viene assegnato un valore di priorità P1.

I suggerimenti per la sicurezza che si verificano più di frequente nei progetti inattivi sono quelli del motore per suggerimenti IAM. Un suggerimento per 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 il motore per suggerimenti IAM imposta le priorità).

Impatto sulla sicurezza

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

Impatto sui costi

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

Impatto sulla sostenibilità

Il campo additionalImpact - SUSTAINABILITY offre un sustainabilityProjection, ovvero 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 uno insight sull'utilizzo del progetto

I contenuti degli insight sull'utilizzo di un progetto sono valori di campo utilizzati per classificare l'attività di utilizzo del progetto e generare suggerimenti CLEANUP_PROJECT e/o RECLAIM_PROJECT.

La seguente tabella elenca i vari campi visualizzati dal motore per suggerimenti nell'ambito dell'insight 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 viene calcolato. Il valore non viene calcolato se le organizzazioni hanno meno di 50 progetti.
Attività dell'API
`activeServiceAccountDailyCount`	Media giornaliera di 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 di chiamate API utilizzate da questo progetto.
`datastoreApiDailyCount`	Media giornaliera di chiamate all'API Datastore utilizzate da questo progetto
Attività di rete
`vpcEgressDailyBytes`	Media giornaliera di byte VPC in uscita da questo progetto.
`vpcIngressDailyBytes`	Media giornaliera di byte VPC in entrata in questo progetto
Utilizzo della fatturazione
`hasBillingAccount`	Verifica se il progetto dispone di un account di fatturazione al termine dell'osservazione
`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 attive in questo progetto
`activeCloudsqlInstanceDailyCount`	Media giornaliera del numero di istanze Cloud SQL attive in questo progetto.
`activeGceInstanceDailyCount`	Media giornaliera del numero di istanze di Compute Engine attive in questo progetto.
`bigqueryInflightJobDailyCount`	Media giornaliera dei job BigQuery in corso nell'ambito di questo progetto.
`bigqueryInflightQueryDailyCount`	Media giornaliera del conteggio di query BigQuery in corso in questo progetto.
`bigqueryStorageDailyBytes`	Media giornaliera dello spazio di archiviazione BigQuery in corso nell'ambito di 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 di byte di archiviazione utilizzati da Cloud Storage in questo progetto.
Attività utente
`numActiveUserOwners`	Il numero di proprietari di progetti di tipo utente attivi al termine del periodo di osservazione. Attivo significa che l'account utente non è disabilitato e sono state identificate attività in questo progetto durante il periodo di osservazione.
`owners`	Elenco dei proprietari del progetto e delle loro attività
Altri campi
`hasActiveOauthTokens`	Verifica se nel progetto sono stati utilizzati token OAuth attivi negli ultimi 180 giorni.
`carbonFootprintDailyKgCO2`	Media giornaliera delle emissioni di anidride carbonica fornite da questo progetto in base ai dati disponibili degli ultimi 30 giorni.
`costProjection`	Risparmi sui costi previsti per la durata specificata in caso di rimozione del progetto. Viene mostrato un prezzo di listino o un prezzo personalizzato in base alle autorizzazioni dell'account di fatturazione. È una stima basata sui dati disponibili degli ultimi 30 giorni e non costituisce una fattura.
`severity`	Il valore `severity` è impostato sul valore corrispondente all'insight sulla sicurezza con la massima gravità trovato nel progetto. Ad esempio, in base al modo in cui il motore per suggerimenti IAM imposta le gravità per gli insight, un livello di gravità `CRITICAL` per gli insight sul progetto inattivo probabilmente indica la presenza di un bucket di spazio di archiviazione sul cloud accessibile pubblicamente nel progetto inattivo.

Suggerimenti per l'eliminazione di un progetto

È consigliabile eliminare un progetto quando è basso utilizzo negli ultimi 30 giorni e non sono stati utilizzati token OAuth negli ultimi 180 giorni.

Suggerimenti per assegnare un nuovo proprietario a un progetto

È consigliabile assegnare un nuovo proprietario a un progetto quando questo soddisfa tutte le condizioni elencate di seguito:

Tutti i proprietari assegnati sono inattivi nel progetto negli ultimi 90 giorni o non sono più associati all'azienda.
Il progetto ha un'attività di utilizzo elevata.

Prezzi

Per ulteriori dettagli sui prezzi di Active Assist, consulta i pricing del motore per suggerimenti.

Prima di iniziare

Prima di poter visualizzare gli approfondimenti e i consigli, devi eseguire le seguenti operazioni:

Devi abilitare l'API Recommender. Devi abilitare l'API solo su un singolo progetto di fatturazione. Puoi quindi utilizzare lo stesso progetto di fatturazione per esaminare suggerimenti e insight per altri progetti, per l'intera organizzazione o per l'account di fatturazione utilizzando la funzionalità --billing-project di gcloud/API.
Assicurati di aver assegnato uno di questi ruoli obbligatori:

Descrizione	Ruoli
Visualizza i suggerimenti	`recommender.projectUtilViewer`
Visualizza e aggiorna i consigli	`recommender.projectUtilAdmin`
Disattivazione di approfondimenti e consigli nel Centro trasparenza e controllo	`dataprocessing.admin`

Questi ruoli forniscono un insieme di autorizzazioni che ti consentono di accedere agli insight e ai suggerimenti. Per ulteriori informazioni sui ruoli, consulta Comprendere i ruoli e concedere le autorizzazioni IAM.

La concessione di questi ruoli a livello di organizzazione ti consente di accedere ai suggerimenti e agli insight per i progetti dell'organizzazione individualmente o collettivamente (tutti i progetti inattivi nell'organizzazione) utilizzando l'API a livello di organizzazione.

La concessione di questi ruoli a livello di account di fatturazione ti consente di accedere ai suggerimenti e agli insight per i progetti che utilizzano l'account di fatturazione specificato.

Per ulteriori informazioni sulla disattivazione, consulta la pagina sulla disattivazione di insight e consigli.

ID motore per suggerimenti

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

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

Autorizzazioni IAM richieste

Per accedere all'elenco di suggerimenti e insight, sono necessarie le seguenti autorizzazioni:

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

Per aggiornare suggerimenti e approfondimenti (ad esempio, per ignorare un suggerimento), sono necessarie le seguenti autorizzazioni:

recommender.resourcemanagerProjectUtilizationRecommendations.update
recommender.resourcemanagerProjectUtilizationInsights.update

Visualizzazione dei suggerimenti progetto inattivo

Questa sezione descrive come verificare la presenza di insight e suggerimenti automatici utilizzando gcloud e l'utilizzo di 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 gli articoli Utilizzo dell'API - Approfondimenti e Utilizzo dell'API - Consigli.

Suggerimenti

Per elencare i suggerimenti di progetto inattivo per il progetto in cui hai abilitato l'API Recommender, esegui questo comando:
```
  gcloud recommender recommendations list \
  --project=PROJECT_ID \
  --location=global \
  --recommender=google.resourcemanager.projectUtilization.Recommender
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID progetto.
Per elencare i suggerimenti di progetto inattivo in un altro progetto durante l'utilizzo di un progetto in cui hai abilitato l'API Recommender (come nel passaggio precedente), esegui questo 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 abilitato con l'API Recommender (valore equivalente a PROJECT_ID) indicato nel passaggio precedente.
- PROJECT_ID: l'ID di un altro progetto per il quale vuoi visualizzare i suggerimenti relativi ai progetto inattivo.
Nota: se il comando non restituisce alcun suggerimento, il progetto non è inattivo o non è attivo da almeno 30 giorni.
Per elencare i suggerimenti di progetto inattivo per l'intera organizzazione, mentre utilizzi un progetto in cui hai abilitato l'API Recommender (come nel passaggio precedente), esegui questo 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 abilitato con l'API Recommender (è lo stesso PROJECT_ID indicato nel passaggio precedente).
- ORGANIZATION_ID: l'ID dell'organizzazione per la quale vuoi visualizzare i suggerimenti relativi ai progetto inattivo.
Per elencare i suggerimenti di progetto inattivo che utilizzano un account di fatturazione specifico, durante l'utilizzo di un progetto in cui hai abilitato l'API Recommender (come nel passaggio precedente), esegui il comando seguente:
```
  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 abilitato con l'API Recommender (è lo stesso PROJECT_ID indicato nel passaggio precedente).
- BILLING_ACCOUNT_ID: l'ID del tuo account di fatturazione Google Cloud.

Insight

Per elencare gli insight sull'utilizzo per un determinato progetto, esegui questo comando:

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

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto.

Per elencare gli insight sull'utilizzo per un altro progetto, utilizzando un progetto in cui hai abilitato l'API Recommender (come nel passaggio precedente), esegui questo 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 abilitato con l'API Recommender (è lo stesso PROJECT_ID indicato nel passaggio precedente).
- PROJECT_ID: l'ID di un altro progetto per il quale vuoi visualizzare gli insight del motore per suggerimenti automatici.
Per elencare gli insight sull'utilizzo per l'intera organizzazione, utilizzando un progetto in cui hai abilitato l'API Recommender (come nel passaggio precedente), esegui questo 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 abilitato con l'API Recommender (è lo stesso PROJECT_ID indicato nel passaggio precedente).
- ORGANIZATION_ID: l'ID dell'organizzazione per la quale vuoi visualizzare le informazioni sull'utilizzo.
Per elencare gli insight sull'utilizzo che usano uno specifico account di fatturazione, mentre usi un progetto in cui hai abilitato l'API Recommender (come nel passaggio precedente), esegui il comando seguente:
```
  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 abilitato con l'API Recommender (è lo stesso PROJECT_ID indicato nel passaggio precedente).
- BILLING_ACCOUNT_ID: l'ID del tuo account di fatturazione Google Cloud.

API

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

Suggerimenti

Per elencare i suggerimenti di progetto inattivo per il progetto in cui hai abilitato l'API Recommender, esegui questo 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 API non restituisce alcun suggerimento, il progetto non è inattivo o non è attivo da almeno 30 giorni.
Per elencare i suggerimenti di progetto inattivo in un altro progetto durante l'utilizzo di un progetto in cui hai abilitato l'API Recommender (come nel passaggio precedente), esegui questo 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 abilitato con l'API Recommender (valore equivalente a PROJECT_ID) indicato nel passaggio precedente.
- PROJECT_ID: l'ID di un altro progetto per il quale vuoi visualizzare i suggerimenti relativi ai progetto inattivo.
Per elencare i suggerimenti di progetto inattivo per l'intera organizzazione, mentre utilizzi un progetto in cui hai abilitato l'API Recommender (come nel passaggio precedente), esegui questo 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 abilitato con l'API Recommender (è lo stesso PROJECT_ID indicato nel passaggio precedente).
- ORGANIZATION_ID: l'ID dell'organizzazione per la quale vuoi visualizzare i suggerimenti relativi ai progetto inattivo.
Per elencare i suggerimenti di progetto inattivo che utilizzano un account di fatturazione specifico, durante l'utilizzo di un progetto in cui hai abilitato l'API Recommender (come nel passaggio precedente), esegui il comando seguente:
```
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 abilitato con l'API Recommender (è lo stesso PROJECT_ID indicato nel passaggio precedente).
- BILLING_ACCOUNT_ID: l'ID del tuo account di fatturazione Google Cloud.

Insight

Per elencare gli insight sull'utilizzo per un determinato progetto, esegui questo 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.

Per elencare gli insight sull'utilizzo per un altro progetto, utilizzando un progetto in cui hai abilitato l'API Recommender (come nel passaggio precedente), esegui questo 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 abilitato con l'API Recommender (è lo stesso PROJECT_ID indicato nel passaggio precedente).
- PROJECT_ID: l'ID di un altro progetto per il quale vuoi visualizzare gli insight del motore per suggerimenti automatici.
Per elencare gli insight sull'utilizzo per l'intera organizzazione, utilizzando un progetto in cui hai abilitato l'API Recommender (come nel passaggio precedente), esegui questo 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 abilitato con l'API Recommender (è lo stesso PROJECT_ID indicato nel passaggio precedente).
- ORGANIZATION_ID: l'ID dell'organizzazione per la quale vuoi visualizzare i suggerimenti relativi ai progetto inattivo.
Per elencare gli insight sull'utilizzo che usano uno specifico account di fatturazione, mentre usi un progetto in cui hai abilitato l'API Recommender (come nel passaggio precedente), esegui il comando seguente:
```
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 abilitato con l'API Recommender (è lo stesso PROJECT_ID indicato nel passaggio precedente).
- BILLING_ACCOUNT_ID: l'ID del tuo account di fatturazione Google Cloud.

Configurazione dei parametri dei suggerimenti

Questa sezione descrive come visualizzare e configure questo motore per suggerimenti utilizzando gcloud e curl.

La seguente tabella 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 che venga generato un suggerimento. L'impostazione di questo valore al momento è supportata solo a livello di organizzazione.	"P30D"[DEFAULT], "P60D", "P90D", "P180D", "P270D", "P365D"

gcloud

Per visualizzare e aggiornare le configurazioni del motore per suggerimenti utilizzando gcloud, procedi nel seguente modo.

Visualizzazione delle configurazioni

Per visualizzare le configurazioni del motore per suggerimenti di progetti inattivi per una determinata organizzazione, esegui questo 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.

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

Per aggiornare le configurazioni del motore per suggerimenti di progetti inattivi per una determinata organizzazione, scegli un progetto appartenente all'organizzazione in cui hai abilitato l'API Recommender, crea un file config.gcloud:
```
{
 "params": {
    "minimum_observation_period": DURATION
  }
}
```
Sostituisci quanto segue:
- DURATION: un valore tra "P30D", "P60D", "P90D", "P180D", "P270D", "P365D"

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 del motore per suggerimenti, puoi utilizzare curl per inviare una richiesta alle API del motore per suggerimenti. Per autorizzare le richieste dalla riga di comando, usa i token di accesso OAuth. Un token di accesso OAuth è una stringa che concede accesso temporaneo a un'API.

Visualizzazione delle configurazioni

Per visualizzare le configurazioni del motore per suggerimenti di progetti inattivi per una determinata organizzazione, esegui questo 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.

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

Per aggiornare le configurazioni del motore per suggerimenti di progetti inattivi per una determinata organizzazione, scegli un progetto appartenente all'organizzazione in cui hai abilitato l'API Recommender, 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: un valore tra "P30D", "P60D", "P90D", "P180D", "P270D", "P365D"
- ETAG: il valore etag restituito da CURL get.

Esegui la riga di comando seguente:

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.

Motore per suggerimenti di progetti non previsti

Panoramica

Come funziona

Ranking dell'attività di utilizzo di un progetto

Priorità e impatti dei consigli

Priorità dei suggerimenti

Impatto sulla sicurezza

Impatto sui costi

Impatto sulla sostenibilità

Contenuti di uno insight sull'utilizzo del progetto

Suggerimenti per l'eliminazione di un progetto

Suggerimenti per assegnare un nuovo proprietario a un progetto

Prezzi

Prima di iniziare

ID motore per suggerimenti

Autorizzazioni IAM richieste

Visualizzazione dei suggerimenti progetto inattivo

gcloud

Suggerimenti

Insight

API

Suggerimenti

Insight

Configurazione dei parametri dei suggerimenti

gcloud

Visualizzazione delle configurazioni

Aggiornamento delle configurazioni

API

Visualizzazione delle configurazioni

Aggiornamento delle configurazioni

Passaggi successivi