Skip to main content

okustera_billing_overview (Data Source)

The okustera_billing_overview data source retrieves real-time read-only billing telemetry for the authenticated tenant project. It reports accumulated Month-to-Date (MTD) spending, forecasted end-of-month costs, spending trend percentages, and active budget consumption.

Read-Only Security Boundary

To safeguard financial operations, billing data in Okustera is strictly read-only for tenant workflows and Terraform runs. Payment method management (adding, replacing, or deleting credit cards) and checkout sessions are reserved exclusively for platform administrators. Tenant users may configure spending budget alert thresholds using the okustera_billing_budget resource.

Example Usage​

data "okustera_billing_overview" "current" {}

output "mtd_spend" {
  value       = "${data.okustera_billing_overview.current.currency} ${data.okustera_billing_overview.current.month_to_date_spend}"
  description = "Month-to-Date accumulated spend"
}

output "projected_spend" {
  value       = "${data.okustera_billing_overview.current.currency} ${data.okustera_billing_overview.current.forecasted_month_spend}"
  description = "Forecasted spend by end of billing cycle"
}

output "budget_utilization" {
  value       = "${data.okustera_billing_overview.current.budget_utilized_pct}% of budget consumed"
  description = "Current percentage of active budget cap used"
}

Schema​

Read-Only Attributes​

  • id (String) Data source identifier (billing-overview).
  • currency (String) Denomination currency code (e.g., USD).
  • month_to_date_spend (Number) Total accumulated spend for the active billing cycle.
  • previous_month_spend (Number) Final settled spend for the preceding billing period.
  • forecasted_month_spend (Number) Statistical projected spend by the end of the billing period.
  • spending_trend_pct (Number) Month-over-month trend percentage change (+/-).
  • current_balance_due (Number) Outstanding balance due on account.
  • active_budget_limit (Number) Current tenant-configured monthly spending limit in USD.
  • budget_utilized_pct (Number) Percentage of active budget cap consumed.
  • billing_cycle_start (String) Start timestamp of current billing cycle.
  • billing_cycle_end (String) End timestamp of current billing cycle.
  • payment_status (String) Account payment health status (active, past_due).
  • default_payment_method (String) Masked identifier for the default payment source.