tcb env usage
Shows the resource usage summary of an environment over a time range.
Usage
tcb env usage [options] -e <envId>
Flags
| Flag | Required | Description | Default |
|---|---|---|---|
-e, --env-id <envId> | Yes | Environment ID | — |
--platform-id <platformId> | No | Platform edition resource pool ID, queries usage of a platform edition environment | — |
--start-date <date> | No | Start date, YYYY-MM-DD | — |
--end-date <date> | No | End date, YYYY-MM-DD | — |
--resource-types <types> | No | Comma separated resource types: Database / Function / Storage / HOSTING / Log / Gateway / Cloudrun / Token / EO | All |
--need-details | No | Show usage details | — |
Example
# Usage of the environment
tcb env usage -e my-env-id
# Platform edition: storage and functions only, JSON output
tcb env usage --platform-id <platformId> -e my-env-id --resource-types Storage,Function --json --yes
# A specific time range with details
tcb env usage --platform-id <platformId> -e my-env-id \
--start-date 2026-09-01 --end-date 2026-09-15 --need-details
Versions
tcb env usage has been available since v3.0.0, --platform-id since v3.8.3.
Related commands
- Resource configuration: which resources the environment has
- Metric details: metric trends over a time range