Azure Consumption
Azure Consumption is a Microsoft Azure service and API for viewing cloud usage, cost, budgets, reservations, and consumption details.
- Base URL:
https://management.azure.com - Auth: OAuth 2.0 (user-delegated) — attach an InTouch
oauthcredential. Mint one withitcli.py /oauth <provider>(device-code) or/google-auth(Google); the server auto-refreshes the access token before each run, so the connector never handles or stores tokens.
Operations
balances_getforbillingperiodbybillingaccount— GET /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/balances — Gets the balances for a scope by billing period and billingAccountId. Balances abalances_getbybillingaccount— GET /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/balances — Gets the balances for a scope by billingAccountId. Balances are available via threservationsdetails_listbybillingaccountid— GET /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationDetails — Lists the reservations details for provided date range.reservationssummaries_listbybillingaccountid— GET /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationSummaries — Lists the reservations summaries for daily or monthly grain.reservationtransactions_listbybillingaccountid— GET /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationTransactions — List of transactions for reserved instances on billing account scopereservationrecommendations_listbybillingaccounti— GET /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/microsoft.consumption/ReservationRecommendations — List of recommendations for purchasing reserved instances on billing account sco
Inputs
- a linked
oauthcredential (no key inputs) — the server injects a freshAuthorization: Bearerfrom it operation— one of the operations above- path parameters when an operation's path contains
{...} query— optional JSON object of query paramsbody— JSON object for create/update ops
Example
operation: balances_getforbillingperiodbybillingaccount
# (attach an 'oauth' credential to the task — no inline secrets)
Publishes
The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.
erroroperationresultstatus
Input Properties
Every property this tool accepts, from its own tool.iml.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
operation |
string | yes | — | One of: balances_getforbillingperiodbybillingaccount, balances_getbybillingaccount, reservationsdetails_listbybillingaccountid, reservationssummaries_listbybillingaccountid, reservationtransactions_listbybillingaccountid, reservationrecommendations_listbybillingaccounti |
billingAccountId |
string | no | — | Path parameter billingAccountId (required by some operations). |
billingPeriodName |
string | no | — | Path parameter billingPeriodName (required by some operations). |
query |
string | no | — | Optional query params as a JSON object string, e.g. {"limit": 10}. |