Usage

The usage events that feed metered billing, with daily and monthly snapshots and a consolidated summary.

Command	HTTP	Description
usage list	GET /v1/usage	List usage records
usage create	POST /v1/usage	Report usage (metered)
usage snapshots daily list	GET /v1/usage/snapshots/daily	List daily usage snapshots
usage snapshots daily create	POST /v1/usage/snapshots/daily	Create daily usage snapshots
usage snapshots monthly list	GET /v1/usage/snapshots/monthly	List monthly usage snapshots
usage snapshots monthly create	POST /v1/usage/snapshots/monthly	Create monthly usage snapshots
usage summary list	GET /v1/usage/summary	Usage summary for the period

Examples

--params carries query and path parameters (id, page, filters); --json carries the request body; --fields limits which fields come back — worth using on every list/get to save context. See Global flags for the full reference.

# List usage records
kobana billing usage list \
  --fields "id,public_id,external_id,subscription_item_id,quantity"

# Report usage (metered)
kobana billing usage create

Next steps

• Dashboard users
• Schema introspection — every parameter this resource accepts.