跳到主要内容

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 / descasc
--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