Questa guida fornisce tutti i passaggi di configurazione richiesti per iniziare a utilizzare l'API Cloud Billing Budget.
Prima di iniziare
Prima di leggere questa guida, effettua le seguenti operazioni:
- 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 (consulta la documentazione, console aperta) è una UI web utilizzata per eseguire il provisioning, la configurazione, la gestione e il monitoraggio dei sistemi che utilizzano i prodotti Google Cloud. La console Google Cloud permette di configurare e gestire le risorse di fatturazione Google Cloud e Google 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 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 risorse Google Cloud in una gerarchia di risorse. Per ulteriori informazioni sui progetti, consulta la documentazione di Resource Manager.
Suggerimento: ti consigliamo di configurare un singolo progetto Google Cloud separato per soddisfare tutte le tue esigenze di amministrazione della fatturazione, inclusa l'API Cloud Billing Budget. Il tuo progetto Google Cloud di amministrazione della fatturazione può essere utilizzato anche per attività quali l'accesso all'API Cloud Billing Account, i dati esportati di Cloud Billing, i canali Pub/Sub per le notifiche del budget programmatiche e così via.
Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.
2. Abilita fatturazione
Devi assicurarti che la fatturazione sia abilitata nel progetto che stai utilizzando per chiamare l'API Cloud Billing Budget. Se hai seguito il suggerimento nella sezione progetto, questo è il tuo progetto Google Cloud di amministrazione della fatturazione.
Un account di fatturazione Cloud viene utilizzato per definire chi paga per un determinato insieme di 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 quando crei un progetto. Per ulteriori informazioni, consulta la documentazione di fatturazione.
Puoi configurare i budget di fatturazione Cloud per monitorare 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 è gratuitamente per i clienti di Google Cloud. Se scegli di configurare le notifiche del budget programmatiche, ti verranno addebitati i prezzi standard di Pub/Sub.
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
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 suggerimento nella sezione progetto, questo è il tuo progetto Google Cloud di amministrazione della fatturazione.
Per ulteriori informazioni sull'abilitazione delle API, consulta la documentazione sull'utilizzo dei servizi.
Attiva Cloud Billing Budget API.
4. Configura autenticazione e autorizzazione
Se prevedi di utilizzare l'API Cloud Billing Budget, devi configurare l'autenticazione. Qualsiasi applicazione client che utilizza l'API deve confermare la sua identità tramite l'autenticazione. Per maggiori dettagli, consulta Autenticazione in Cloud Billing.
Ti autentica come entità specifica, ad esempio un Account Google o un account di servizio. L'entità deve avere ruoli Identity and Access Management (IAM) che contengono le autorizzazioni richieste per l'API Cloud Billing Budget.
Per assicurarti che l'entità disponga delle autorizzazioni
necessarie per gestire i budget,
chiedi all'amministratore di concederle 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.
L'amministratore potrebbe anche essere in grado di concedere all'entità le autorizzazioni richieste tramite ruoli personalizzati o altri ruoli predefiniti.
Per scoprire come concedere i 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 è una serie di strumenti che puoi utilizzare per gestire le risorse e le applicazioni ospitate su Google Cloud. Questo include gcloud CLI. Al link seguente vengono fornite le istruzioni:
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
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 vengano restituite le credenziali:
gcloud auth print-access-token
Questo comando è 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 è basata su HTTP e JSON, pertanto qualsiasi client HTTP standard può inviare richieste e analizzare le risposte.
Hai a disposizione tre opzioni per chiamare l'API:
Librerie client supportate da Google (opzione consigliata)
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 si tratta dell'opzione consigliata.