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:
- Leggere la panoramica dell'API Cloud Billing Budget.
- Leggere i prerequisiti dell'API Cloud Billing Budget.
Informazioni sulla Google Cloud console
La Google Cloud console (consulta la documentazione, apri la console) è un'interfaccia utente web utilizzata per il provisioning, la configurazione, la gestione e il monitoraggio dei sistemi che utilizzano Google Cloud i prodotti. Utilizzala per configurare e gestire le risorse di e di fatturazione Cloud. Google Cloud 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 Google Cloud risorse. 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 o più progetti e utilizzarli per organizzare le tue Google Cloud risorse in una gerarchia di risorse. Per ulteriori informazioni 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 della fatturazione e di FinOps per un account di fatturazione Cloud, incluso l'utilizzo di Cloud Billing Budget API. Scopri di più sui vantaggi dell'utilizzo di un progetto incentrato su FinOps per i tuoi casi d'uso di amministrazione della fatturazione.
Nella Google Cloud console, nella pagina di selezione del progetto, seleziona o crea un Google Cloud progetto.
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 su cui ti è stato concesso un ruolo.
-
Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto
(
roles/resourcemanager.projectCreator), che contiene l'resourcemanager.projects.createautorizzazione. 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 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 Google Cloud progetto.
Un account di fatturazione Cloud viene utilizzato per definire chi paga per un determinato insieme di Google Cloud risorse. 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, configuri la fatturazione quando crei un progetto. Per ulteriori informazioni, consulta la documentazione di 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 è senza costi per Google Cloud i clienti. Se scegli di configurare le notifiche di budget programmatiche, ti verranno addebitati i prezzi 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 nella sezione del progetto, questo è il tuo progetto FinOps o di amministrazione della fatturazione Google Cloud .
Per ulteriori informazioni sull'abilitazione delle API, consulta la documentazione di Service Usage.
Abilita l'API Budget di fatturazione Cloud.
Ruoli richiesti per abilitare le API
Per abilitare le API, devi disporre del ruolo IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), che
contiene l'autorizzazione serviceusage.services.enable. Scopri come concedere
i ruoli.
4. Configura 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 i dettagli, consulta Autenticarsi a fatturazione Cloud.
L'autenticazione viene eseguita come entità specifica, ad esempio un Account Google o un account di servizio. Questa entità deve disporre dei ruoli IAM (Identity and Access Management) 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 concedere il ruolo IAM Amministratore account di fatturazione (roles/billing.admin) all'entità 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 all'entità le autorizzazioni richieste tramite ruoli personalizzati o altri ruoli predefiniti.
Per scoprire come concedere i ruoli su un account di fatturazione, consulta Aggiornare le autorizzazioni di fatturazione Cloud.
5. Installa e inizializza gcloud CLI
Se prevedi di utilizzare l'API Budget di fatturazione Cloud, 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. Include the 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. 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 comando seguente per verificare che non si verifichino errori 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 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.