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)

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 - -

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.

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.

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à (kgCO2e) 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.

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 (kgCO2e).

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

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

  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.

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.

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.

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.

  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.

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