hub
list_datasets
List datasets from the selected StrataHub.
strata hub list-datasetsdb.hub.list_datasets(*, tasks: 'Union[str, Iterable[str], None]' = None, tags: 'Union[str, Iterable[str], None]' = None, primitives: 'Union[str, Iterable[str], None]' = None, license: 'Optional[str]' = None, size_min_bytes: 'Optional[int]' = None, size_max_bytes: 'Optional[int]' = None, sort: 'Any' = None, limit: 'Optional[int]' = None, offset: 'Optional[int]' = None, hub_url: 'Optional[str]' = None) -> 'Any'wire hub_list_datasets
Reads `GET /v1/datasets` from the effective hub URL. Repeatable task, tag, and primitive filters preserve the StrataHub V1 query shape.
Status commands return a scalar or compact status payload and do not mutate database state.
To see the complete help for this command, run:
strata hub list-datasets --helphelp(db.hub.list_datasets)
Example
No CLI example in this release.
page = db.hub.list_datasets(tasks="classification", sort="downloads", limit=5) # doctest: +SKIP[dataset.name for dataset in page.items] # doctest: +SKIP
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| hub_url | string or null | no | Explicit hub URL; when absent the 5-layer resolver runs. |
| license | string or null | no | License filter. |
| limit | integer or null | no | Page size. |
| offset | integer or null | no | Zero-based page offset. |
| primitives | array | no | Primitive filters. |
| size_max_bytes | integer or null | no | Maximum dataset size in bytes. |
| size_min_bytes | integer or null | no | Minimum dataset size in bytes. |
| sort | any | no | Sort key. |
| tags | array | no | Tag filters. |
| tasks | array | no | Task filters. |
Returns
StatusResponse<HubDatasetPage>
- dataHubDatasetPage
- typestring
Errors
Recover by code. Retry policy and commit outcome come from the shipped error registry.
| Code | Retry | Commit outcome |
|---|---|---|
| failed_precondition.engine.runtime_closed | never | not_started |
| not_found.engine.branch | never | not_applicable |
| unsupported.executor.hub_feature_disabled | after_state_change | not_started |
| invalid_argument.executor.hub_url | never | not_started |
| unavailable.executor.hub_transport | same_request | not_started |
| invalid_argument.executor.hub_filter | never | not_started |