PRESIGN

通过您提供的 Stage 名称和文件路径生成预签名的 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：列出 Stage 中的文件。
• REMOVE STAGE FILES：从 Stage 中移除文件。

语法

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 进行上传

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

PRESIGN UPLOAD @my_stage/books.csv

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

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