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 procedere nel seguente modo:
- 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) è un'interfaccia utente web utilizzata per eseguire il provisioning, configurare, gestire e monitorare i sistemi che utilizzano i prodotti Google Cloud. Puoi usare la console Google Cloud per configurare e per gestire le risorse di fatturazione Google Cloud e Cloud.
1. Seleziona o crea un progetto
Per utilizzare i servizi forniti da Google Cloud, devi creare un progetto. Un progetto organizza tutte le tue risorse Google Cloud. Un progetto è costituito di un insieme di collaboratori, API abilitate (e altre risorse), strumenti di monitoraggio, dati di fatturazione, controlli di autenticazione e accesso. Puoi creare un progetto oppure più progetti e utilizzarli per organizzare le risorse Google Cloud in una gerarchia delle risorse. Per ulteriori informazioni sui progetti, consulta 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 della fatturazione e FinOps per un account di fatturazione Cloud, incluso l'utilizzo dell'API Budget della fatturazione Cloud. Scopri di più sui vantaggi dell'utilizzo di un progetto incentrato su FinOps per i casi d'uso relativi all'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 attivata 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 Google Cloud di FinOps o amministrazione della fatturazione.
Make sure that billing is enabled for your Google Cloud project.
Un account di fatturazione Cloud viene utilizzato per definire chi deve pagare un determinato insieme di dell'accesso a specifiche risorse Google 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 al momento della creazione di un progetto. Per maggiori informazioni informazioni, consulta documentazione sulla fatturazione Cloud.
Costo di utilizzo
Configura i budget di fatturazione Cloud per monitorare i costi sostenuti in un account di fatturazione Cloud. L'account di fatturazione Cloud che stai monitorando 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 di Google Cloud. Se scegli di configurare notifiche relative al budget programmatico, ti verrà addebitato l'importo prezzi standard di Pub/Sub.
3. Abilita l'API
Devi abilitare l'API Cloud Billing Budget nel progetto che stai utilizzando per chiamare l'API Cloud Billing Budget. Se hai seguito il consiglio nella sezione del progetto, questo è il tuo progetto Google Cloud FinOps o di amministrazione della fatturazione.
Per ulteriori informazioni sull'abilitazione delle API, consulta Documentazione sull'utilizzo dei servizi.
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à entro il giorno con l'autenticazione. Per maggiori dettagli, vedi Eseguire l'autenticazione in Fatturazione Cloud.
Esegui l'autenticazione come principale specifico, ad esempio un Account Google o un account di servizio. Questo principale deve disporre di ruoli di Identity and Access Management (IAM) che contengono le autorizzazioni richieste per l'API Cloud Billing Budget.
Per assicurarti che il principale disponga delle autorizzazioni necessarie per gestire i budget,
chiedi all'amministratore di concedere al principale il ruolo IAM Amministratore account di fatturazione (roles/billing.admin) per il tuo account di fatturazione.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.
L'amministratore potrebbe anche essere in grado di fornire all'entità le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.
Per scoprire come concedere i ruoli in 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 set di strumenti che puoi utilizzare per gestire le risorse e le applicazioni ospitate su Google Cloud. Ciò include gcloud CLI. Le istruzioni sono disponibili al seguente link:
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init6. Testa l'SDK e l'autenticazione
Se hai configurato l'autenticazione nei passaggi precedenti, puoi utilizzare gcloud CLI per testare l'ambiente di autenticazione. Esegui il seguente 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 a 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 a disposizione tre opzioni per chiamare l'API:
Librerie client supportate da Google (consigliato)
Le librerie client offrono una migliore integrazione del linguaggio, una maggiore sicurezza e per effettuare chiamate che richiedono l'autorizzazione dell'utente. Il team di assistenza Google librerie client sono disponibili per alcuni dei linguaggi più diffusi e si tratta di l'opzione consigliata.