PRESIGN

根据您提供的阶段名称和文件路径生成预签名 URL。预签名 URL 使您能够通过 Web 浏览器或 API 请求访问文件。

提示

在使用 cURL 与非 S3 类存储交互时，请记住包含由 PRESIGN 命令生成的标头，以确保文件上传或下载的安全性。例如，

curl -H "<header-generated-by-presign>" -o books.csv <presigned-url>

curl -X PUT -T books.csv -H "<header-generated-by-presign>" <presigned-url>

另请参阅：

• LIST STAGE FILES：列出阶段中的文件。
• REMOVE STAGE FILES：从阶段中移除文件。

语法

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

其中：

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

[ EXPIRE = <expire_in_seconds> ]：指定预签名 URL 过期的时间长度（以秒为单位）。默认值为 3,600 秒。

示例

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

此示例生成用于下载阶段 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

此示例生成用于将文件上传为 books.csv 到阶段 my_stage 的预签名 URL：

PRESIGN UPLOAD @my_stage/books.csv

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

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