tcb storage objects list
列出 bucket 中的对象,支持前缀过滤、分页与排序。
v3.4.0+
PG 模式存储命令自 @cloudbase/cli@3.4.0 起提供。
语法
tcb storage objects list -b <bucketId> [options]
参数
| 参数 | 必填 | 说明 | 默认值 |
|---|---|---|---|
-b, --bucket <bucketId> | 是 | Bucket ID | — |
--prefix <prefix> | 否 | 路径前缀过滤 | — |
--limit <n> | 否 | 分页大小,1~1000;超出范围以 INVALID_PARAM(exit 3)拒绝 | 20 |
--cursor <cursor> | 否 | 翻页游标,取上一次响应的 nextCursor | — |
--with-delimiter | 否 | 使用 / 分隔文件夹 | false |
--sort-by <column> | 否 | 排序列,可选 name / created_at / updated_at | — |
--sort-order <order> | 否 | 排序方向,可选 asc / desc | asc |
--json | 否 | 输出 SDK 原始返回,含 folders / objects / hasNext / nextCursor | — |
list 需要登录态,未登录时以 AUTH_FAILED 失败。
示例
tcb storage objects list -b my-bucket --prefix test/
tcb storage objects list -b my-bucket --limit 50 --sort-by created_at --sort-order desc