tcb storage objects upload
把本地文件上传到 Storage bucket。
v3.4.0+
PG 模式存储命令自 @cloudbase/cli@3.4.0 起提供。
语法
tcb storage objects upload <localPath> <key> -b <bucketId> [options]
参数
| 参数 | 必填 | 说明 | 默认值 |
|---|---|---|---|
<localPath> | 是 | 本地文件路径，必须是文件 | — |
<key> | 是 | 远端对象名，不能以 / 开头 | — |
-b, --bucket <bucketId> | 是 | Bucket ID，可用环境变量 TCB_BUCKET_ID 替代 | — |
--content-type <mime> | 否 | 显式 MIME，不传则按扩展名与 magic bytes 推断 | 自动推断 |
--cache-control <value> | 否 | 整数自动转为 max-age=<n>，字符串原样写入 Cache-Control | — |
--metadata <json> | 否 | 自定义 metadata JSON，内部 Base64 编码到 X-Metadata | — |
--robots-tag <value> | 否 | X-Robots-Tag 头 | — |
--upsert | 否 | POST 模式下允许覆盖已存在对象 | false |
--use-put | 否 | 使用 PUT 方法，始终覆盖 | false |
--json | 否 | 输出 SDK 原始返回 { Id, Key } | — |
示例
tcb storage objects upload ./hello.txt test/hello.txt -b my-bucket
tcb storage objects upload ./hello.txt test/hello.txt -b my-bucket --content-type text/plain --upsert