billing.costs.resource

What one resource costs: this month, last month, per hour now, monthly cap

GET /billing/api/resource-costIAM billing:GetCostAndUsageRead

From the usage records the invoice is summed from. `currentHour` is null when the resource was not metered in the last two hours (stopped, deleted, or storage). `caps` has one row per machine (a 3-node database has three): charged this month against its monthly cap; once `reached`, its hours cost €0 until the month ends.

Request syntax

GET /billing/api/resource-cost

Query parameters

  • kindRequired

    enum

    instance, database, cache, vpn, volume, distribution (CDN) or webAcl (WAF)

    One of: instance, database, cache, vpn, volume, distribution, webAcl

  • idRequired

    string

    The resource id, as its own service names it

    Constraints: 1-128 chars

Response

200 with kind, resourceId, period, previousPeriod, monthToDate, lastMonth, savedByCapThisMonth (EUR strings, 8 places, as charged), currentHour { startedAt, listPerHour, chargedPerHour } or null, storagePerMonth, caps (per machine: charged against its monthly cap, reached), usage (this month per SKU, largest first) and unbilled (CDN distributions: served since the last billed hour; null otherwise). An id with no usage in your organization answers 200 with zeros, not 404.

A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.

Errors

  • 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
  • 401No credentials, or an access key that is unknown, revoked or expired.
  • 403The caller's policies do not allow billing:GetCostAndUsage on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
  • 404The resource does not exist in your organization.

Examples

The required parameters only, with example values. Replace id and the other placeholders with your own.

dcloud billing costs resource --kind instance --id example

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_billing_costs_resource.