Questa guida fornisce tutte le procedure di configurazione necessarie per iniziare a utilizzare l'API Cloud Billing Budget.
Prima di iniziare
Prima di leggere questa guida, devi:
- Leggi la panoramica dell'API Cloud Billing Budget.
- Leggi i prerequisiti dell'API Cloud Billing Budget.
Informazioni sulla console Google Cloud
La console Google Cloud (visita la documentazione, apri la console) è una UI web utilizzata per eseguire il provisioning, configurare, gestire e monitorare i sistemi che utilizzano i prodotti Google Cloud . Utilizzi la console Google Cloud per configurare e gestire Google Cloud le risorse delfatturazione Cloudg.
1. Seleziona o crea un progetto
Per utilizzare i servizi forniti da Google Cloud, devi creare un progetto. che organizza tutte le risorse Google Cloud . Un progetto è composto da un insieme di collaboratori, API abilitate (e altre risorse), strumenti di monitoraggio, informazioni di fatturazione e controlli di autenticazione e accesso. Puoi creare un progetto oppure più progetti e utilizzarli per organizzare le tue risorse Google Cloud in una gerarchia delle risorse. Per saperne di più sui progetti, consulta la documentazione di Resource Manager.
Consiglio sui progetti: ti consigliamo di creare e utilizzare un progetto Google Cloud separato per contenere tutte le tue esigenze di amministrazione di FinOps e della fatturazione per un account di fatturazione Cloud, incluso l'utilizzo dell'API Cloud Billing Budget. Scopri di più sui vantaggi dell'utilizzo di un progetto incentrato su FinOps per i tuoi casi d'uso di amministrazione della fatturazione.
Nella console Google Cloud , nella pagina di selezione del progetto, seleziona o crea un progetto Google Cloud .
Ruoli richiesti per selezionare o creare un progetto
- Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
-
Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto
(
roles/resourcemanager.projectCreator), che contiene l'autorizzazioneresourcemanager.projects.create. Scopri come concedere i ruoli.
2. Abilita fatturazione
Devi assicurarti che la fatturazione sia abilitata nel progetto che utilizzi per chiamare l'API Cloud Billing Budget. Se hai seguito il consiglio riportato nella sezione del progetto, questo è il tuo progetto FinOps o di amministrazione della fatturazione Google Cloud .
Verifica che la fatturazione sia abilitata per il tuo progetto Google Cloud .
Un account di fatturazione Cloud viene utilizzato per definire chi paga per un determinato insieme di risorseGoogle Cloud . Le risorse, come le API abilitate, sono organizzate in progetti. Un account di fatturazione Cloud può essere collegato a uno o più progetti. L'utilizzo del progetto viene addebitato all'account di fatturazione collegato. Nella maggior parte dei casi, la fatturazione viene configurata quando crei un progetto. Per saperne di più, consulta la documentazione sulla fatturazione Cloud.
Costo di utilizzo
Configuri i budget per la fatturazione Cloud per monitorare i costi sostenuti in un account di fatturazione Cloud. L'account di fatturazione Cloud che monitori può essere lo stesso account di fatturazione Cloud collegato al progetto che utilizzi per chiamare l'API Cloud Billing Budget. Tieni presente che l'API Cloud Billing Budget è senza costi per i clienti Google Cloud . Se scegli di configurare le notifiche di budget programmatiche, ti verranno addebitati i costi standard di Pub/Sub.
3. Abilita l'API
Devi abilitare l'API Cloud Billing Budget nel progetto che utilizzi per chiamare l'API Cloud Billing Budget. Se hai seguito il consiglio riportato nella sezione del progetto, questo è il tuo progetto FinOps o di amministrazione della fatturazione Google Cloud .
Per ulteriori informazioni sull'attivazione delle API, consulta la documentazione sull'utilizzo del servizio.
Abilita l'API Budget di fatturazione Cloud.
Ruoli richiesti per abilitare le API
Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere
i ruoli.
4. Configurare l'autenticazione e l'autorizzazione
Se prevedi di utilizzare l'API Cloud Billing Budget, devi configurare l'autenticazione. Qualsiasi applicazione client che utilizza l'API deve confermare la propria identità tramite l'autenticazione. Per maggiori dettagli, vedi Esegui l'autenticazione in Fatturazione Cloud.
L'autenticazione viene eseguita come entità specifica, ad esempio un Account Google o un account di serviziot. Questa entità deve disporre di ruoli Identity and Access Management (IAM) che contengano le autorizzazioni richieste per l'API Budget di fatturazione Cloud.
Per assicurarti che l'entità disponga delle autorizzazioni necessarie per gestire i budget, chiedi all'amministratore di concedere all'entità il ruolo IAM Amministratore account di fatturazione (roles/billing.admin) sul tuo account di fatturazione.
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
L'amministratore potrebbe anche essere in grado di concedere al principal le autorizzazioni richieste tramite ruoli personalizzati o altri ruoli predefiniti.
Per scoprire come concedere ruoli a un account di fatturazione, consulta Aggiornare le autorizzazioni di fatturazione Cloud.
5. Installa e inizializza gcloud CLI
Se prevedi di utilizzare l'API Cloud Billing Budget, devi installare e inizializzare Google Cloud CLI. Google Cloud CLI è un insieme di strumenti che puoi utilizzare per gestire le risorse e le applicazioni ospitate su Google Cloud. Ciò include la gcloud CLI. Il seguente link fornisce le istruzioni:
Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente:
gcloud initSe utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
6. Testare l'SDK e l'autenticazione
Se hai configurato l'autenticazione nei passaggi precedenti, puoi utilizzare gcloud CLI per testare l'ambiente di autenticazione. Esegui questo comando per verificare che non si verifichino errori e che le credenziali vengano restituite:
gcloud auth print-access-token
Questo comando viene utilizzato da tutti gli esempi REST della riga di comando dell'API Cloud Billing Budget per autenticare le chiamate API.
7. Installa la libreria client dell'API Cloud Billing Budget
L'API Cloud Billing Budget si basa su HTTP e JSON, pertanto qualsiasi client HTTP standard può inviare richieste all'API e analizzare le risposte.
Hai tre opzioni per chiamare l'API:
Librerie client supportate da Google (consigliate)
Le librerie client offrono una migliore integrazione del linguaggio, una maggiore sicurezza e supporto per effettuare chiamate che richiedono l'autorizzazione dell'utente. Le librerie client supportate da Google sono disponibili per diversi linguaggi diffusi e sono l'opzione consigliata.