用於檔案與上傳的物件儲存。
專案的 S3 相容儲存空間:如何新增儲存貯體、應用程式會取得的 S3_* 變數,以及儲存空間與操作的計價方式。
物件儲存將檔案存放在應用程式之外:使用者上傳的檔案、產生的報表、媒體、您自己的備份。它可搭配任何支援 S3 協定的程式庫或工具使用——AWS SDK、Laravel 的 s3 磁碟、django-storages、boto3、rclone 等等。
新增儲存空間
應用程式的總覽 → 服務 → 物件儲存 → 新增儲存空間。為儲存貯體命名——小寫英文字母、數字與連字號,以字母開頭——然後確認。儲存貯體片刻即可就緒。
一個專案最多可有 3 個儲存貯體。
應用程式取得的變數
存取資訊會自動加入專案的變數;應用程式會在下次部署時取得:
| 變數 | 說明 |
|---|---|
S3_ENDPOINT | 儲存空間的網址 |
S3_REGION | 在 S3 用戶端中使用的區域 |
S3_BUCKET | 儲存貯體名稱 |
S3_KEY | 存取金鑰 |
S3_SECRET | 私密金鑰 |
金鑰僅適用於這個儲存貯體。專案的第二個儲存貯體會取得以其名稱為前綴的變數:<NAME>_S3_ENDPOINT、<NAME>_S3_BUCKET 等。
您自己同名的變數會保留不變——若應用程式的部分功能需繼續使用其他地方的儲存空間,這會很有用。請參閱環境變數。
範例:Laravel
在 config/filesystems.php 中,將 s3 磁碟指向這些變數:
's3' => [
'driver' => 's3',
'key' => env('S3_KEY'),
'secret' => env('S3_SECRET'),
'region' => env('S3_REGION'),
'bucket' => env('S3_BUCKET'),
'endpoint' => env('S3_ENDPOINT'),
'use_path_style_endpoint' => true,
],接著在變數分頁設定 FILESYSTEM_DISK=s3。
範例:Node.js
import { S3Client } from '@aws-sdk/client-s3'
const s3 = new S3Client({
endpoint: process.env.S3_ENDPOINT,
region: process.env.S3_REGION,
credentials: { accessKeyId: process.env.S3_KEY, secretAccessKey: process.env.S3_SECRET },
})價格
| 價格 | |
|---|---|
| 儲存空間 | 每月每 GB US$0.025 |
| 流量 | 免費——從儲存空間下載不收費 |
| 寫入 | 每百萬次操作 US$6.00 |
| 讀取 | 每百萬次操作 US$0.50 |
儲存空間每天測量一次並計算當月平均,因此保存半個月的檔案只需支付一半費用。一個日曆月的用量會以一個項目加到專案的下一筆付款中;沒有另外的訂閱。
移入檔案
已存放在 Amazon S3、Google Cloud Storage、其他 S3 相容儲存空間或您伺服器資料夾中的檔案,可以移入儲存貯體——一次全部移入,或逐步移入且不中斷服務。請參閱將檔案移入物件儲存。
刪除儲存貯體
刪除儲存貯體會移除其中的所有檔案;檔案無法還原,其變數也會從專案中移除。帳戶擁有者與應用程式的管理員可以刪除儲存貯體。