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:
|
PROJECT_ACTIVITY |
Rivedi o elimina il progetto. | CLEANUP_PROJECT |
Progetti con:
|
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 |
|
| Organizzazioni con meno di 50 progetti |
|
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)-COSTeSUSTAINABILITY. 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.Recommendergoogle.resourcemanager.projectUtilization.Insight
Autorizzazioni IAM obbligatorie
Per accedere all'elenco di consigli e approfondimenti, sono necessarie le seguenti autorizzazioni:
recommender.resourcemanagerProjectUtilizationRecommendations.getrecommender.resourcemanagerProjectUtilizationRecommendations.listrecommender.resourcemanagerProjectUtilizationInsights.getrecommender.resourcemanagerProjectUtilizationInsights.list
Per aggiornare i suggerimenti e gli approfondimenti (ad esempio, per ignorare un suggerimento), sono necessarie le seguenti autorizzazioni:
recommender.resourcemanagerProjectUtilizationRecommendations.updaterecommender.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
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.
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.
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.
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
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.
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.
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.
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
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.
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.
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.
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
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.
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.
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.
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
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.
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 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"
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 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
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.
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 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 daCURL 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.
Passaggi successivi
- Chiusura (eliminazione) di progetti
- Eliminare progetti in un'organizzazione
- Metodologia di report di Carbon Footprint
- Tutorial interattivo (apri in Cloud Shell)