📣
TiDB Cloud Premium 开放公测中。为企业级工作负载提供无限扩展、即时弹性伸缩和高级安全保障。此页面由 AI 自动翻译,英文原文请见此处。

PRESIGN



根据你提供的 stage 名称和文件路径,为 stage 中的文件生成预签名 URL。预签名 URL 使你能够通过 Web 浏览器或 API 请求访问该文件。

另请参阅:

语法

PRESIGN [ { DOWNLOAD | UPLOAD }] @<stage_name>/.../<file_name> [ EXPIRE = <expire_in_seconds> ]

其中:

[ { DOWNLOAD | UPLOAD }]:指定预签名 URL 用于下载还是上传。默认值为 DOWNLOAD。

[ EXPIRE = <expire_in_seconds> ]:指定预签名 URL 过期前的时长(以秒为单位)。默认值为 3,600 秒。

示例

生成并使用用于下载的预签名 URL

以下示例为 stage my-stage 上的文件 books.csv 生成用于下载的预签名 URL:

PRESIGN @my_stage/books.csv +--------+---------+---------------------------------------------------------------------------------+ | method | headers | url | +--------+---------+---------------------------------------------------------------------------------+ | GET | {} | https://example.s3.amazonaws.com/books.csv?X-Amz-Algorithm=AWS4-HMAC-SHA256&... | +--------+---------+---------------------------------------------------------------------------------+

以下示例与前一个示例作用相同:

PRESIGN DOWNLOAD @my_stage/books.csv

要使用预签名 URL 下载文件并将其保存为 books.csv,执行以下命令:

curl <presigned-url> -o books.csv

以下示例生成一个在 7,200 秒(2 小时)后过期的预签名 URL:

PRESIGN @my_stage/books.csv EXPIRE = 7200

生成并使用用于上传的预签名 URL

以下示例生成一个预签名 URL,用于将文件以上传为 books.csv 的方式上传到 stage my_stage:

PRESIGN UPLOAD @my_stage/books.csv

要使用预签名 URL 上传文件 books.csv,执行以下命令:

curl -X PUT -T books.csv <presigned-url>

文档内容是否有帮助?