billing.costs.resourceWhat one resource costs: this month, last month, per hour now, monthly cap
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-costQuery parameters
kindRequiredenum
instance, database, cache, vpn, volume, distribution (CDN) or webAcl (WAF)
One of:
instance,database,cache,vpn,volume,distribution,webAclidRequiredstring
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 examplecurl -X GET "https://console.platform.deutschecloud.app/billing/api/resource-cost" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY"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.