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:
|
PROJECT_ACTIVITY |
Rivedi o elimina il progetto. | CLEANUP_PROJECT |
Progetti con:
|
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 |
|
Organizzazioni con meno di 50 progetti |
|
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
eSUSTAINABILITY
. La riduzione dei costi ($) e delle emissioni sostenibili (kgCO2e) 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 (kgCO2e).
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.
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.
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 inrecommender-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 darecommender-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 incurl 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 daCURL 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.
Passaggi successivi
- Arrestare (eliminare) progetti
- Eliminare i progetti in un'organizzazione
- Metodologia per la generazione di report di Carbon Footprint
- Tutorial interattivo (apri in Cloud Shell)