Motore per suggerimenti di progetti inattivi

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

Panoramica

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

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

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

La chiusura o il recupero dei progetti non monitorati può fornire i seguenti impatti e vantaggi alla tua organizzazione:

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

Come funziona

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

Utilizzo/tipo di progetto Sottotipo di insight Suggerimento 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 utente assegnati, ma nessuno di loro è attivo nel progetto.
PROJECT_ACTIVITY Recupera il progetto assegnando un nuovo proprietario. RECLAIM_PROJECT
Tutti gli altri progetti non Apps Script. PROJECT_ACTIVITY - -

Suggerimenti e approfondimenti sono disponibili a diversi livelli della gerarchia dell'organizzazione Cloud. Per accedere a questi consigli e approfondimenti è necessario un binding del ruolo IAM al livello corrispondente:

  • A livello di progetto: i proprietari del progetto possono scoprire e agire in base a approfondimenti e consigli per i progetti a cui hanno accesso.
  • A livello organizzativo: gli amministratori dell'organizzazione possono scoprire e agire su approfondimenti e suggerimenti per i progetti all'interno di un'organizzazione cloud.
  • A livello di account di fatturazione: gli amministratori della fatturazione possono scoprire e agire in base a 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 in base a un'attività di utilizzo bassa o elevata, in base alle raccomandazioni fornite. 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 con 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 di tutti i contenuti inclusi nell'approfondimento sull'utilizzo del progetto.
  • Un progetto viene classificato come automatico 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 suggerimenti per i progetti inattivi contengono i seguenti campi che aiutano a dare la priorità e stimare i vantaggi della loro applicazione:

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

Priorità del consiglio

La priorità del suggerimento relativo a un progetto inattivo varia 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 relativo al progetto inattivo in modo che sia uguale a quella del suggerimento con la priorità più alta trovato all'interno del progetto. Ad esempio, se un progetto inattivo ha 10 suggerimenti di sicurezza, otto suggerimenti P2 e due suggerimenti P1, al suggerimento relativo al progetto inattivo verrà assegnato un valore di priorità P1.

I consigli per la sicurezza più frequenti nei progetti senza proprietario provengono dal motore per suggerimenti IAM. Un suggerimento relativo a un progetto inattivo con priorità P1 probabilmente significa 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 pari al conteggio dei suggerimenti di sicurezza con priorità elevata (P2 e superiore) nel progetto inattivo. Ad esempio, quando un progetto ha un consiglio per sostituire il ruolo Editor generico 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 che è una stima del risparmio sui costi se il progetto inattivo venisse rimosso. Si basa sui costi sostenuti dalle risorse in esecuzione nel progetto inattivo negli ultimi 30 giorni.

Impatto in termini di sostenibilità

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

Contenuti di un insight sull'utilizzo del progetto

I contenuti di un insight sull'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 che il motore per suggerimenti mostra nell'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 è stato calcolato. Il valore non viene calcolato quando le organizzazioni hanno meno di 50 progetti.

Attività API
activeServiceAccountDailyCount Media giornaliera dei service account 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 consumate da questo progetto.
datastoreApiDailyCount Media giornaliera delle chiamate all'API Datastore utilizzate da questo progetto
Attività di networking
vpcEgressDailyBytes Media giornaliera di byte in uscita VPC da questo progetto.
vpcIngressDailyBytes Media giornaliera di byte in entrata VPC in questo progetto
Utilizzo della fatturazione
hasBillingAccount Controlla se il progetto ha un account di fatturazione alla fine 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 in questo progetto.
bigqueryInflightQueryDailyCount Media giornaliera del conteggio delle query BigQuery in corso in questo progetto.
bigqueryStorageDailyBytes Media giornaliera dello spazio di archiviazione BigQuery 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 Storage Cloud 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. Attivo significa che l'account utente non è disattivato e che è stata identificata un'attività in questo progetto durante il periodo di osservazione.
owners Elenco dei proprietari del progetto e delle loro 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 agli ultimi 30 giorni di dati disponibili.
costProjection Risparmio costi previsto per la durata specificata se il progetto venisse rimosso. Viene visualizzato 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 dell'insight sulla sicurezza con la gravità più elevata trovato nel progetto. Ad esempio, in base a come IAM Recommender imposta i livelli di gravità per i suoi approfondimenti, un livello di gravità CRITICAL nell'approfondimento del progetto incustodito probabilmente significa che nel progetto inattivo è presente un bucket spazio di archiviazione sul cloud accessibile pubblicamente.

Consigli per eliminare un progetto

Un progetto viene consigliato per l'eliminazione quando ha registrato 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 sono inattivi nel progetto negli ultimi 90 giorni o non lavorano più per l'azienda.
  • Il progetto ha un'attività di utilizzo elevata.

Prezzi

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

Prima di iniziare

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

  • Devi abilitare l'API Recommender. Devi abilitare l'API in un solo progetto di fatturazione. Puoi quindi utilizzare questo stesso progetto di fatturazione per esaminare consigli e approfondimenti per altri progetti, l'intera organizzazione o l'account di fatturazione, utilizzando la funzionalità --billing-projectdi gcloud/API.
  • Assicurati di disporre di uno di questi ruoli obbligatori assegnati:
Descrizione Ruoli
Visualizza i suggerimenti recommender.projectUtilViewer
Visualizzare e aggiornare i consigli recommender.projectUtilAdmin
Disattivazione di insight e suggerimenti nel Centro trasparenza e controllo dataprocessing.admin

Questi ruoli forniscono un insieme di autorizzazioni che ti consentono di accedere agli approfondimenti e ai consigli. Per saperne di più sui ruoli, consulta Informazioni sui ruoli e Concessione delle autorizzazioni IAM.

La concessione di questi ruoli a livello di organizzazione consente di accedere ai suggerimenti e agli approfondimenti per i progetti dell'organizzazione singolarmente o collettivamente (tutti i progetti non monitorati dell'organizzazione) utilizzando l'API a livello di organizzazione.

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

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

ID Recommender

Ecco l'ID del motore per suggerimenti di progetto inattivo e il tipo di insight:

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

Autorizzazioni IAM obbligatorie

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 suggerimenti e gli approfondimenti (ad esempio, per ignorare un suggerimento), 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 monitorati utilizzando gcloud e curl per inviare richieste all'API Recommender.

gcloud

Per visualizzare consigli e approfondimenti utilizzando gcloud, segui questi passaggi. Per saperne di più, consulta Utilizzo dell'API - Approfondimenti e Utilizzo dell'API - Suggerimenti.

Consigli

  1. Per elencare i suggerimenti per 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.
  2. Per elencare i suggerimenti per progetto inattivo in un progetto diverso 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 \
      --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 (corrisponde a PROJECT_ID indicato nel passaggio precedente).
    • PROJECT_ID: L'ID di un altro progetto per il quale vuoi visualizzare i suggerimenti per progetto inattivo.
  3. Per elencare i suggerimenti per i progetto inattivo per l'intera organizzazione, utilizzando 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 per cui hai abilitato l'API Recommender (corrisponde all'ID progetto fornito nel passaggio precedente).
    • ORGANIZATION_ID: l'ID dell'organizzazione per cui vuoi visualizzare i suggerimenti per progetto inattivo.
  4. Per elencare i suggerimenti per 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 per cui hai abilitato l'API Recommender (corrisponde all'ID progetto fornito nel passaggio precedente).
    • BILLING_ACCOUNT_ID: l'ID del tuo Google Cloud account di fatturazione.

Approfondimenti

  1. Per elencare gli approfondimenti 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.
  2. Per elencare gli approfondimenti sull'utilizzo per un altro progetto, utilizzando un progetto in cui hai abilitato 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 abilitato con l'API Recommender (corrisponde a PROJECT_ID indicato nel passaggio precedente).
    • PROJECT_ID: L'ID di un altro progetto per cui vuoi visualizzare gli approfondimenti del motore per suggerimenti automatico.
  3. Per elencare gli approfondimenti 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 per cui hai abilitato l'API Recommender (corrisponde all'ID progetto fornito nel passaggio precedente).
    • ORGANIZATION_ID: l'ID dell'organizzazione per cui vuoi visualizzare gli approfondimenti sull'utilizzo.
  4. Per elencare gli approfondimenti sull'utilizzo 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 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 per cui hai abilitato l'API Recommender (corrisponde all'ID progetto fornito nel passaggio precedente).
    • BILLING_ACCOUNT_ID: l'ID del tuo Google Cloud account di fatturazione.

API

Per visualizzare consigli e approfondimenti, puoi utilizzare curl per inviare una richiesta alle API Recommender. 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

  1. Per elencare i suggerimenti per 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.
  2. Per elencare i suggerimenti per progetto inattivo in un progetto diverso 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/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 (corrisponde a PROJECT_ID indicato nel passaggio precedente).
    • PROJECT_ID: L'ID di un altro progetto per il quale vuoi visualizzare i suggerimenti per progetto inattivo.
  3. Per elencare i suggerimenti per i progetto inattivo 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: 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 (corrisponde a PROJECT_ID indicato nel passaggio precedente).
    • ORGANIZATION_ID: l'ID dell'organizzazione per cui vuoi visualizzare i suggerimenti per progetto inattivo.
  4. Per elencare i suggerimenti per 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 abilitato con l'API Recommender (corrisponde a PROJECT_ID indicato nel passaggio precedente).
    • BILLING_ACCOUNT_ID: l'ID del tuo Google Cloud account di fatturazione.

Approfondimenti

  1. Per elencare gli approfondimenti 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.
  2. Per elencare gli approfondimenti sull'utilizzo per un altro progetto, utilizzando un progetto in cui hai abilitato 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 abilitato con l'API Recommender (corrisponde a PROJECT_ID indicato nel passaggio precedente).
    • PROJECT_ID: L'ID di un altro progetto per cui vuoi visualizzare gli approfondimenti del motore per suggerimenti automatico.
  3. Per elencare gli approfondimenti 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 (corrisponde a PROJECT_ID indicato nel passaggio precedente).
    • ORGANIZATION_ID: l'ID dell'organizzazione per cui vuoi visualizzare i suggerimenti per progetto inattivo.
  4. Per elencare gli approfondimenti sull'utilizzo 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: 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 (corrisponde a PROJECT_ID indicato nel passaggio precedente).
    • BILLING_ACCOUNT_ID: l'ID del tuo Google Cloud account di fatturazione.

Configurare i parametri dei suggerimenti

Questa sezione descrive come visualizzare e configurare questo motore per suggerimenti 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 che venga generata una raccomandazione.

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 di Recommender utilizzando gcloud, segui questi passaggi.

Visualizzazione delle configurazioni

  1. Per visualizzare le configurazioni del motore per suggerimenti per progetti non presidiati per una determinata organizzazione, esegui il seguente comando da un progetto appartenente a quell'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 di Unattended Project Recommender per una determinata organizzazione, scegli un progetto appartenente a quell'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"
  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 motori per suggerimenti, puoi utilizzare curl per inviare una richiesta alle API Recommender. 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.

Visualizzazione delle configurazioni

  1. Per visualizzare le configurazioni del motore per suggerimenti per progetti non presidiati per una determinata organizzazione, esegui il seguente comando da un progetto appartenente a quell'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 di Unattended Project Recommender per una determinata organizzazione, scegli un 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 tra "P30D", "P60D", "P90D", "P180D", "P270D", "P365D"
    • ETAG: il valore etag restituito da CURL get.
  2. 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.

Passaggi successivi