今すぐ始める

ファイルとアップロードのためのオブジェクトストレージ。

プロジェクト用のS3互換ストレージ:バケットの追加方法、アプリに渡されるS3_*変数、ストレージと操作の料金について説明します。

1 分で読めます

オブジェクトストレージは、ユーザーのアップロードファイル、生成したレポート、メディア、独自のバックアップなどのファイルを、アプリの外に保存します。S3プロトコルに対応したライブラリやツールで使えます。AWS SDK、Laravelのs3ディスク、django-storages、boto3、rcloneなどです。

ストレージの追加

アプリの概要 → サービス → オブジェクトストレージ → ストレージを追加を開きます。バケット名(半角英小文字、数字、ハイフンで、先頭は英字)を入力して確定します。バケットはすぐに使えるようになります。

1つのプロジェクトで最大3つのバケットを作成できます。

アプリに渡される変数

アクセス情報はプロジェクトの変数に自動で追加され、次回のデプロイでアプリに反映されます。

変数内容
S3_ENDPOINTストレージのアドレス
S3_REGIONS3クライアントで使うリージョン
S3_BUCKETバケット名
S3_KEYアクセスキー
S3_SECRETシークレットキー

キーはこのバケット専用です。プロジェクトの2つ目のバケットでは、変数名の先頭にバケット名が付きます:<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 },
})

料金

料金
ストレージ1GBあたり月額$0.025
トラフィック無料:ストレージからのダウンロードに料金はかかりません
書き込み100万回あたり$6
読み取り100万回あたり$0.50

ストレージ容量は毎日計測され、月平均で計算されます。半月だけ保存したファイルの料金は半分です。暦月の使用量は、プロジェクトの次回のお支払いに1行で加算されます。別途のサブスクリプションはありません。

ファイルの移行

Amazon S3、Google Cloud Storage、他のS3互換ストレージ、サーバー上のフォルダーにあるファイルは、バケットに移行できます。一度にまとめて、またはダウンタイムなしで段階的に移行できます。詳しくはオブジェクトストレージへのファイル移行をご覧ください。

バケットの削除

バケットを削除すると、中のファイルはすべて削除され、復元できません。バケットの変数もプロジェクトから削除されます。バケットを削除できるのは、アカウントオーナーとアプリの管理者です。

解決しませんか?

チャットでご相談ください。AIがすぐに回答し、必要なときはエンジニアが加わります。時間帯は問いません。

サポートに問い合わせる