Questa pagina è stata tradotta dall'API Cloud Translation.

Motore per suggerimenti di progetti non previsti

Il motore per suggerimenti di progetti non previsti 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, come progetti interi, da dimenticare occasionalmente. 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 sui progetti inattivi analizza l'attività di utilizzo in tutti i progetti in la tua organizzazione e ti offre le seguenti funzionalità per aiutarti Scopri, recupera e arresta i progetti inattivi:

Insight sull'utilizzo per ogni progetto (networking, API, proprietario del progetto, attività di servizio e altro ancora).
Consigli per ridurre i progetti con attività di utilizzo ridotta.
Consigli 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 effetti e vantaggi per la tua organizzazione:

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

Come funziona

Il motore per suggerimenti di progetti non previsti analizza l'utilizzo del progetto negli ultimi 30 giorni. Nella tabella seguente sono elencati i consigli e gli insight relativi all'incustodito il motore per suggerimenti di progetto può generare a seconda che l'attività di utilizzo sia bassa o alta .

Utilizzo/tipo di progetto	Sottotipo di insight	Consiglio	Sottotipo di suggerimento
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 utenti assegnati, ma nessuno dei quali è attivo sul progetto.	`PROJECT_ACTIVITY`	Rivendica il progetto assegnando un nuovo proprietario.	`RECLAIM_PROJECT`
Tutti gli altri progetti non Apps Script.	`PROJECT_ACTIVITY`	-	-

Suggerimenti e insight 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 applicare approfondimenti e consigli per i progetti a cui hanno accesso.
A livello di organizzazione: gli amministratori dell'organizzazione possono rilevare contenuti e intervenire di conseguenza insight e suggerimenti 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.

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. Viene calcolato il ranking dell'attività di utilizzo di un progetto in base ai contenuti inclusi negli insight sull'utilizzo del progetto.

Per i progetti identificati con un'attività di utilizzo ridotta, quanto segue 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 inclusi nei insight sull'utilizzo del progetto. Un progetto viene classificato come inattivo se rientra nel 10% dell'utilizzo rispetto a tutti gli altri progetti nell'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.

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 delle priorità elevate di sicurezza in un progetto inattivo.
additionalImpact(s) - COST e SUSTAINABILITY. La riduzione di costo ($) e delle emissioni sostenibili (kgCO₂e) che 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 ha 10 otto raccomandazioni P2 e due P1, al suggerimento del progetto inattivo verrebbe assegnato il valore di priorità P1.

I suggerimenti per la sicurezza più frequenti che si trovano negli che i progetti provengono Motore per suggerimenti IAM. Un suggerimento su un progetto inattivo con priorità P1 indica probabilmente un bucket spazio di archiviazione sul cloud accessibile pubblicamente nel progetto inattivo (scopri di più su come il motore per suggerimenti IAM imposta le priorità).

Impatto sulla sicurezza

Il campo primaryImpact - SECURITY offre un securityProjection uguale al conteggio della priorità alta (P2 e livelli successivi) 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 costProjection, ovvero una stima del risparmio sui costi se il progetto inattivo è stato rimosso. sulla base dei costi sostenuti da in esecuzione nel progetto inattivo negli ultimi 30 giorni.

Impatto in termini di sostenibilità

Il campo additionalImpact - SUSTAINABILITY offre sustainabilityProjection, ovvero una stima emissioni di anidride carbonica generate in esecuzione nel progetto inattivo negli ultimi 30 giorni. La stima è misurato 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.

La tabella seguente elenca i vari campi visualizzati dal motore per suggerimenti nell'ambito dell'insight su 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 la percentuale è -1, significa che il valore non è stato calcolato. Il valore non viene calcolato quando le organizzazioni hanno meno di 50 progetti.
Attività delle 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 il progetto ha 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 attivate in questo progetto
`activeCloudsqlInstanceDailyCount`	Media giornaliera del numero di istanze Cloud SQL attive in questo progetto.
`activeGceInstanceDailyCount`	Media giornaliera del numero di istanze Compute Engine attivo in questo progetto.
`bigqueryInflightJobDailyCount`	Media giornaliera dei job BigQuery in corso in questo progetto.
`bigqueryInflightQueryDailyCount`	Media giornaliera del conteggio delle query BigQuery inflight in questo progetto.
`bigqueryStorageDailyBytes`	Media giornaliera dello spazio di archiviazione BigQuery inflight 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 del progetto attivi per il tipo di utente al termine 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 nel progetto sono stati utilizzati token OAuth attivi negli ultimi 180 giorni.
`carbonFootprintDailyKgCO2`	Media giornaliera delle emissioni di anidride carbonica ottenute da questo progetto in base ai dati disponibili degli ultimi 30 giorni.
`costProjection`	Risparmio sui costi previsto per la durata specificata se il progetto dovesse essere rimosso. Viene mostrato un prezzo di listino o personalizzato 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 unattended è presente un bucket Cloud Storage 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.

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.

Prezzi

Per maggiori dettagli sui prezzi di Active Assist, consulta il motore per suggerimenti determinati del prezzo.

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 che ti sia stato assegnato uno di questi ruoli obbligatori:

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 ulteriori informazioni sui ruoli, consulta la comprensione dei 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 suggerimenti e insight 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 e il tipo di informazioni del motore per suggerimenti di progetti non previsti:

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

Autorizzazioni IAM richieste

Per accedere all'elenco di consigli e approfondimenti: le autorizzazioni sono obbligatorie:

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

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

recommender.resourcemanagerProjectUtilizationRecommendations.update
recommender.resourcemanagerProjectUtilizationInsights.update

Visualizzazione dei suggerimenti 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: Per ulteriori informazioni, consulta gli articoli Utilizzo dell'API - Approfondimenti e Utilizzo dell'API - Consigli.

Consigli

Per elencare i consigli per i progetti non previsti 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.
Per elencare i suggerimenti progetto inattivo in un progetto diverso mentre utilizzando un progetto in cui hai abilitato l'API Recommender (ad esempio 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 che hai abilitato con l'API Recommender (sarebbe lo stesso PROJECT_ID come 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 viene non è incustodito o non è in giro da almeno 30 giorni.
Per elencare i consigli per i progetti non supervisionati 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 i progetti non previsti.
Per elencare i suggerimenti progetto inattivo che utilizzano un account di fatturazione specifico, 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 \
  --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.

Approfondimenti

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.

Per elencare gli insight sull'utilizzo per un progetto diverso mentre utilizzi un progetto in cui hai abilitato l'API Recommender (come nel passaggio precedente), esegui 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 che hai abilitato con l'API Recommender (sarebbe lo stesso PROJECT_ID come indicato nel passaggio precedente).
- PROJECT_ID: l'ID di un altro progetto per cui vuoi visualizzare gli insight sul motore per suggerimenti inattivi.
Per elencare gli insight sull'utilizzo per l'intera organizzazione durante l'utilizzo di 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 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 insight sull'utilizzo.
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.

API

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

Consigli

Per elencare i consigli per i progetti non previsti 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.
Per elencare i suggerimenti progetto inattivo in un progetto diverso mentre utilizzando un progetto in cui hai abilitato l'API Recommender (ad esempio 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 che hai abilitato con l'API Recommender (sarebbe lo stesso PROJECT_ID come indicato nel passaggio precedente).
- PROJECT_ID: l'ID di un altro progetto per il quale vuoi visualizzare i consigli per i progetti non previsti.
Per elencare i suggerimenti 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 che hai abilitato con l'API Recommender (sarebbe lo stesso PROJECT_ID come indicato nel passaggio precedente).
- ORGANIZATION_ID: l'ID dell'organizzazione per la quale vuoi visualizzare i suggerimenti progetto inattivo.
Per elencare i suggerimenti progetto inattivo che utilizzano un account di fatturazione specifico, 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/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

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.

Per elencare gli approfondimenti sull'utilizzo per 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\
/insightTypes/google.resourcemanager.projectUtilization.Insight/insights"
```
Sostituisci quanto segue:
- BILLING_PROJECT_ID: l'ID del progetto che che hai abilitato con l'API Recommender (sarebbe lo stesso PROJECT_ID come indicato nel passaggio precedente).
- PROJECT_ID: l'ID di un altro progetto per cui vuoi visualizzare gli insight sul motore per suggerimenti inattivi.
Per elencare gli insight sull'utilizzo per l'intera organizzazione 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: 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 che hai abilitato con l'API Recommender (sarebbe lo stesso PROJECT_ID come indicato nel passaggio precedente).
- ORGANIZATION_ID: l'ID dell'organizzazione per la quale vuoi visualizzare i consigli per i progetti non previsti.
Per elencare gli insight sull'utilizzo che usano uno specifico account di fatturazione: 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: 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 motore per suggerimenti utilizzando gcloud e curl.

Nella tabella seguente sono elencati 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"[PREDEFINITO], "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

Per visualizzare le configurazioni del motore per suggerimenti sui progetti inattivi per una determinata organizzazione, esegui questo comando da un progetto appartenente a tale 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 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: un valore da "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, utilizzi 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 sui progetti inattivi per una determinata organizzazione, esegui questo comando da un progetto appartenente a tale 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 sui progetti inattivi per una determinata organizzazione, scegli una progetto appartenente a quell'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 da "P30D", "P60D", "P90D", "P180D", "P270D", "P365D"
- ETAG: il valore etag restituito da CURL get.

Esegui questa 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.

Motore per suggerimenti di progetti non previsti

Panoramica

Come funziona

Classificare l'attività di utilizzo di un progetto

Priorità e impatti dei consigli

Priorità del consiglio

Impatto sulla sicurezza

Impatto sui costi

Impatto in termini di sostenibilità

Contenuti di un insight sull'utilizzo del progetto

Suggerimenti per eliminare un progetto

Consigli per assegnare un nuovo proprietario a un progetto

Prezzi

Prima di iniziare

ID consigliatore

Autorizzazioni IAM richieste

Visualizzazione dei suggerimenti progetto inattivo

gcloud

Consigli

Approfondimenti

API

Consigli

Approfondimenti

Configurazione dei parametri dei consigli

gcloud

Visualizzazione delle configurazioni

Aggiornamento delle configurazioni

API

Visualizzazione delle configurazioni

Aggiornamento delle configurazioni

Passaggi successivi