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 prodottiGoogle 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 risorseGoogle 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.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
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 .
Make sure that billing is enabled for your Google Cloud project.
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 ulteriori informazioni, 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 è gratuita 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 di Service Usage.
Enable the Cloud Billing Budget API.
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 Autenticarsi in Fatturazione Cloud.
L'autenticazione viene eseguita come entità specifica, ad esempio un Account Google o un account di servizio. Questa entità deve disporre di ruoli Identity and Access Management (IAM) che contengano le autorizzazioni richieste per l'API Cloud Billing Budget.
Per assicurarti che il principal disponga delle autorizzazioni necessarie per gestire i budget, chiedi all'amministratore di concedere al principal il ruolo IAM Amministratore account di fatturazione (roles/billing.admin) nel 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 all'entità le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Per scoprire come concedere ruoli a un account di fatturazione, consulta Aggiornare le autorizzazioni per la 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:
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud initIf you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
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 verifichi alcun errore e che vengano restituite le credenziali:
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 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.