tcb routes list
List the gateway routes of the current environment, with paging and field filtering.
v3.0.0+
tcb routes has been available since v3.0.0.
Usage
tcb routes list [options]
Parameters
| Parameter | Required | Description | Default |
|---|---|---|---|
-e, --env-id <envId> | No | Environment ID | envId in the configuration |
--limit <n> | No | Page size | — |
--offset <n> | No | Page offset | 0 |
--filter <expr> | No | Filter expression, join conditions with &, separate multiple values with commas | — |
--json | No | Output JSON | false |
--filter fields:
| Field | Description | Values |
|---|---|---|
Domain | Domain | Any domain string, several comma-separated (OR) |
Path | Route path | Any path string |
UpstreamResourceType | Upstream type | SCF, CBR, STATIC_STORE, WEB_SCF, LH |
The table includes an upstream version column showing the bound function version, - when unbound (v3.8.10+).
Examples
# Paged query
tcb routes list -e <envId> --limit 50 --offset 0
# Filter by domain
tcb routes list -e <envId> --filter "Domain=api.example.com"
# Filter by upstream type
tcb routes list -e <envId> --filter "UpstreamResourceType=CBR"
# Combine conditions (AND with &, OR with commas)
tcb routes list -e <envId> --filter "UpstreamResourceType=SCF&Domain=api.example.com,api2.example.com"