tcb domains ls
List the custom domains bound in the current environment, with paging and field filtering.
v3.0.0+
tcb domains has been available since v3.0.0, replacing the custom domain features of tcb service domain.
Usage
tcb domains ls [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 & | — |
--platform-id <platformId> | No | Platform edition pool ID, mutually exclusive with -e (v3.8.3+) | — |
--filter fields:
| Field | Description | Values |
|---|---|---|
Domain | Domain | Any domain string |
DomainType | Domain type | HTTPSERVICE (default), CBR, ANYSERVICE, AI_AGENT, VM, INTEGRATION_CALLBACK |
AccessType | Access type | DIRECT, CDN, CUSTOM, EO |
Only manually bound HTTPSERVICE domains are listed by default; use --filter "DomainType=CBR" for other types.
Examples
# Paged query
tcb domains ls -e <envId> --limit 50 --offset 0
# Filter by domain
tcb domains ls -e <envId> --filter "Domain=api.example.com"
# Filter by access type
tcb domains ls -e <envId> --filter "AccessType=CDN"
# Combine conditions (AND with &)
tcb domains ls -e <envId> --filter "DomainType=HTTPSERVICE&AccessType=DIRECT"
# Domains in a platform edition pool (v3.8.3+)
tcb domains ls --platform-id <platformId>