Questa pagina è stata tradotta dall'API Cloud Translation.

Utilizzo dell'API Cloud Billing Budget

Scopri come inviare alcune semplici richieste all'API Cloud Billing Budget.

Per un elenco completo dei metodi, consulta API REST o l'API RPC.

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.
Esegui la procedura di configurazione.

Identifica l'ID account di fatturazione Cloud

Per ogni chiamata all'API Cloud Billing Budget, avrai bisogno ID account di fatturazione Cloud.

Vai alla pagina Pagina Gestisci account di fatturazione della console Google Cloud.
Nella scheda I miei account di fatturazione, vedrai l'elenco di Account di fatturazione Cloud per nome e ID. Individua il ID account di fatturazione per l'account in cui gestirai i budget.

Screenshot della pagina Gestisci fatturazione che mostra la posizione del tuo ID account di fatturazione.

Concetti chiave sul budget

Un budget può essere applicato a un intero account di fatturazione oppure con ambito (filtrato) utilizzando filtri granulari del budget per monitorare sezioni specifiche dei costi.
Un budget applicato a un intero account di fatturazione Cloud include i costi derivanti da tutte le Progetti Google Cloud pagati da quell'account di fatturazione.
Se l'accesso all'account di fatturazione Cloud è limitato o nullo, puoi creare budget per singoli progetti per i progetti di tua proprietà. Se sei un Utente a livello di account di fatturazione Cloud, puoi creare un progetto singolo I budget che non possono essere modificati dagli utenti a livello di progetto utilizzando OwnershipScope nel campo del budget.
Puoi restringere il campo ambito utilizzando i filtri, come un sottoinsieme di organizzazioni, cartelle, progetti, servizi e altri i filtri budget applicabili al tuo account di fatturazione Cloud.
Puoi specificare il periodo di tempo del budget. Per impostazione predefinita, un budget monitora i costi sostenuti durante un mese di calendario. Utilizzo del filtro usage_period che è disponibile nell'API Cloud Billing Budget, puoi configurare il budget in un periodo di tempo di CalendarPeriod o un CustomPeriod, consentendoti di creare budget per monitorare gli intervalli di tempo oltre quelli predefiniti mese di calendario, ad esempio un trimestre, un anno o un intervallo di date specificare.
Puoi impostare importo del budget su un totale specificato o basare l'importo del budget sulla spesa periodo di calendario precedente.
Puoi impostare regole per le soglie di budget per attivare le notifiche di avviso via email. Quando i tuoi costi (costi effettivi (costi previsti) superano una percentuale del budget (in base alle regole scelte impostata), le email di avviso vengono inviate al destinatari da te specificati.
Puoi impostare il valore regole di notifica, per specificare i destinatari dell'email di avvisi relativi al budget e per abilitare notifiche programmatiche tramite Pub/Sub.
Puoi utilizzare gli argomenti Pub/Sub per le notifiche di pubblicità programmatica (ad esempio, per inoltrare i messaggi relativi al budget ad altri mezzi come Slack, o per automatizzare le attività di gestione dei costi).

Limite di quota: ogni singolo account di fatturazione Cloud può avere varie migliaia di budget associate alla volta. Consulta Quote e limiti per conoscere i limiti attuali e informazioni aggiuntive.

Chiamata all'API

I seguenti esempi mostrano come inviare alcune semplici richieste ai l'API Cloud Billing Budget.

Elenco budget

Questo metodo API elenca tutti i budget disponibili per una determinata fatturazione Cloud .

REST

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

billing-account-id: l'ID dell'account di fatturazione Cloud e i budget si applicano.
project-id: il progetto Google Cloud in cui è abilitata l'API Cloud Billing Budget.

Metodo HTTP e URL:

GET https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: project-id" \
     "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets"

PowerShell (Windows)

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "budgets": [
   {
      "name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777",
      "displayName": "Forecasted spend budget with Service Filter",
      "budgetFilter": {
        "projects": [
          "projects/123456789"
        ],
        "services": [
          "services/A1E8-BE35-7EBC"
        ],
        "creditTypesTreatment": "EXCLUDE_ALL_CREDITS",
        "calendarPeriod": "MONTH"
      },
      "amount": {
        "lastPeriodAmount": {}
      },
      "thresholdRules": [
        {
          "thresholdPercent": 0.9,
          "spendBasis": "FORECASTED_SPEND"
        }
      ],
      "allUpdatesRule": {},
      "etag": "c9d6c011f6fa6b5c"
    }
  ]
}

Ottieni il budget

Questo metodo API recupera i dettagli per un determinato budget.

REST

Per chiamare questo metodo, è necessario il budget-id del che vuoi aggiornare. Puoi ottenere l'ID budget dal createBudget output quando crei il budget oppure Output listBudgets se elenchi tutti i tuoi budget.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

billing-account-id: l'ID account di fatturazione Cloud di questo budget a cui si applica.
budget-id: l'ID del budget che vuoi ricevere.
project-id: il progetto Google Cloud in cui è abilitata l'API Cloud Billing Budget.

Metodo HTTP e URL:

GET https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: project-id" \
     "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id"

PowerShell (Windows)

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777",
  "displayName": "Forecasted spend budget with Service Filter",
  "budgetFilter": {
    "projects": [
      "projects/123456789"
    ],
    "services": [
      "services/A1E8-BE35-7EBC"
    ],
    "creditTypesTreatment": "EXCLUDE_ALL_CREDITS",
    "calendarPeriod": "MONTH"
  },
  "amount": {
    "lastPeriodAmount": {}
  },
  "thresholdRules": [
    {
      "thresholdPercent": 0.9,
      "spendBasis": "FORECASTED_SPEND"
    }
  ],
  "allUpdatesRule": {},
  "etag": "c9d6c011f6fa6b5c"
}

Crea budget

Questo metodo API crea Budget della fatturazione Cloud applicata all'account di fatturazione Cloud specificato.

REST

Questo esempio mostra come creare un budget per un determinato account di fatturazione Cloud ovvero con ambito (filtrato) da un progetto Google Cloud da te specificato e impostato per un . di un periodo di tempo di calendario di un trimestre.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

projects/budget-scope-project-id: l'ID del progetto Google Cloud da impostare come ambito del budget (budgetFilter).
billing-account-id: l'ID account di fatturazione Cloud di questo budget a cui si applica.
api-user-project-id: il progetto Google Cloud in cui si trova l'API Cloud Billing Budget in un bucket con il controllo delle versioni attivo.

Metodo HTTP e URL:

POST https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets

Corpo JSON della richiesta:

{
  "displayName": "Keep my spending down",
  "budgetFilter": {
    "projects": [
      "projects/budget-scope-project-id"
    ],
    "calendar_period": "QUARTER"
  },
  "amount": {
    "lastPeriodAmount": {}
  },
  "thresholdRules": {
    "thresholdPercent": 0.8,
    "spendBasis": "CURRENT_SPEND"
  }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json. ed esegui questo comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: api-user-project-id" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json. ed esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "api-user-project-id" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777",
  "displayName": "Keep my spending down",
  "budgetFilter": {
    "projects": [
      "projects/123456789"
    ],
    "creditTypesTreatment": "INCLUDE_ALL_CREDITS",
    "calendar_period": "QUARTER"
  },
  "amount": {
    "lastPeriodAmount": {}
  },
  "thresholdRules": {
    "thresholdPercent": 0.8,
    "spendBasis": "CURRENT_SPEND"
  },
  "allUpdatesRule": {},
  "etag": "f7928d8010160668"
}

Aggiornare il budget

Utilizza questo metodo API per modificare budget di fatturazione Cloud esistente per modificare importo del budget, i filtri del budget (ambito del budget), il periodo di tempo del budget, o regole di soglia.

REST

Questo esempio mostra come aggiornare un budget esistente per impostare ambito (filtro) da un progetto Google Cloud da te specificato e per aggiorna il periodo di tempo del budget da mensile a trimestrale .

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

projects/budget-scope-project-id: il progetto Google Cloud I da impostare come ambito del budget (budgetFilter).
billing-account-id: l'ID account di fatturazione Cloud di questo budget a cui si applica.
budget-id: l'ID del budget da aggiornare.
api-user-project-id: il progetto Google Cloud in cui L'API Cloud Billing Budget è abilitata.

Metodo HTTP e URL:

PATCH https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id

Corpo JSON della richiesta:

{
  "budget": {
    "displayName": "My fancy budget",
    "budgetFilter": {
      "projects": [
        "projects/budget-scope-project-id"
      ],
      "calendar_period": "QUARTER"
    },
   "amount": {
      "specifiedAmount": {
        "units": 500
      }
    },
    "thresholdRules": {
      "thresholdPercent": 0.8,
      "spendBasis": "CURRENT_SPEND"
    }
  }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json. ed esegui questo comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: api-user-project-id" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json. ed esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "api-user-project-id" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777",
  "displayName": "My fancy budget",
  "budgetFilter": {
    "projects": [
      "projects/123456789"
    ],
    "creditTypesTreatment": "INCLUDE_ALL_CREDITS",
    "calendar_period": "QUARTER"
  },
  "amount": {
    "specifiedAmount": {
      "units": 500
    }
  },
  "thresholdRules": {
    "thresholdPercent": 0.8,
    "spendBasis": "CURRENT_SPEND"
  },
  "allUpdatesRule": {},
  "etag": "f7928d8010160668"
}

Eliminare un budget

Utilizza questo metodo API per eliminare budget di fatturazione Cloud esistente.

REST

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

billing-account-id: l'ID account di fatturazione Cloud di questo budget a cui si applica.
budget-id: l'ID del budget da eliminare.
project-id: il progetto Google Cloud in cui è abilitata l'API Cloud Billing Budget.

Metodo HTTP e URL:

DELETE https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: project-id" \
     "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id"

PowerShell (Windows)

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{}

Indietro

Configurazione