S3のキーとバージョニング — フォルダは存在しない

S3のキーとバージョニング。ストレージのバケットとオブジェクトのカード、重なった世代別データ。

S3にフォルダは存在しません。キーの付け方とバージョニングを押さえて、消したはずのものが残る仕組みを確かめます。

前回: ロードバランサとオートスケール — 台数を増やしたのに全部落ちる

これは【深掘り】の記事です。本線の順路ではありません。 本線の EC2は立てて壊す教材 — AWSの最初の1台 で「サーバーを1台借りる」ところまでは行きました。 その1台に置いてはいけないものを、どこに置くのか。それがこの記事です。飛ばしても本線は進めます。

このシリーズは、読者にアカウントを作らせません。 触るのは LocalStack と、aws CLI の --endpoint-url だけです。 課金が発生する操作は一切しません。 料金は具体的な金額を書きません(変わるため)。 何に対して課金されるかという構造だけを書き、数字は公式の料金ページを見てください。 コマンドは VM の中(Ubuntu Server)で打ちます。 最後に全部消します。 LocalStack のコミュニティ版で動かないところは、その場で正直に書きます。 なお LocalStack は2026年3月23日から1つのイメージに統合され、それ以降の版は起動に auth token(LocalStack のアカウントで取得。無料プランあり)が必要になりました。 この記事では、更新が止まった旧系統の localstack/localstack:3 を固定して使い、アカウントを作らずに進めます。旧イメージの固定は練習用の短期的な手段です(更新が来ず、修正済みの脆弱性が残りうるため)。新しい版を使う場合は、取得した token を LOCALSTACK_AUTH_TOKEN 環境変数に設定します。


S3 は、この深掘りシリーズで一番「動かして確かめられる」回です。

前回までの EC2 や VPC は、LocalStack の上では返事だけが返ってくる張りぼてでした。インスタンスIDは発行されるけれど、その中で Linux が動いているわけではありません。

S3 は違います。 ファイルを置けば本当に保存されるし、取り出せば本当に中身が返ってきます。一覧すれば、本物と同じ形の応答が返ります。

だからこの回は、読むより打ったほうが早いです。


対象レベル: 中級〜上級 / 区分: 発展

目次

私が壊した思い込み

WordPress を動かしているサーバーの、画像フォルダが重くなってきました。「画像は S3 に逃がすといい」と読んだので、素直にやろうとしました。

そして最初の30分で詰まりました。

私が S3 に対して持っていたイメージは、こうでした。

バケット
├── photos/
│   ├── 2026/
│   │   ├── a.jpg
│   │   └── b.jpg
│   └── 2025/
└── backups/

「ネット上にあるフォルダ」です。 管理画面がまさにこう見えるので、疑いませんでした。

やりたかったことは単純です。photos/ というフォルダを images/ に名前変更したい。

探しました。「名前の変更」がどこにもありません。

右クリックしても、メニューを開いても、CLI のヘルプを引いても、フォルダをリネームするコマンドが存在しません。

このとき、はじめて疑いました。

もしかして、photos/ というものは、そもそも存在していないのでは。

存在していませんでした。

S3 にあるのは、photos/2026/a.jpg という1本の文字列と、その中身だけです。 / は、ただの文字です。 区切りとしての意味を持っているのは表示する側であって、S3 側ではありません。

フォルダが無いのだから、フォルダの名前は変えられません。

この1点を分かっていなかったせいで、私は「機能が足りない」と勘違いして、S3 を諦めかけました。足りなかったのは私の理解のほうでした。

この記事では、それを画面の説明ではなく、生の応答で確かめます。

この記事でわかること

  • S3 にフォルダは存在しない。 あるのはキーという1本の文字列だけで、/ は名前に含まれる普通の文字であること
  • だから「フォルダ名を変える」ができない。 全オブジェクトをコピーして元を消す以外に方法が無いこと
  • バケット名は全世界で一意。 誰かが使っている名前は、自分のアカウントでは作れないこと
  • Content-Type を間違えると、ブラウザがページを表示せずダウンロードを始めること
  • 「S3が公開されていた」事故は、既定を自分の手で外したときにしか起きないこと。既定は非公開であること
  • バージョニングを有効にすると、削除は「削除マーカーを載せる」だけになり、実体は消えずに課金され続けること
  • 安いストレージクラスには最低保存期間があり、早く消すとかえって高くつくこと
  • ライフサイクルルールを設定しないと、ログや一時ファイルが永久に貯まること
  • 失敗したマルチパートアップロードの断片は、一覧に出ないまま課金されること
  • いまの S3 は書き込み後の読み取りが強整合であること。ただし一覧はそれとは別の話であること

この記事でやること

  1. ~/awslab/s3 を作り、LocalStack を S3 だけで立てる
  2. オブジェクトを1個置いて、photos/ が作られていないことを生の応答で確かめる
  3. head-object でメタデータを見て、Content-Type をわざと間違えて実演する
  4. 署名付きURLを発行し、有効期限が切れて 403 になるところまで見る
  5. バージョニングを有効にして、削除マーカーと実体を切り分ける
  6. ライフサイクルルールを設定し、読み返して確認する
  7. 未完了のマルチパートアップロードを一覧して、消す
  8. 全部消して、LocalStack を落とす

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
オブジェクトストレージファイルを丸ごと1個の塊として置く保存方式。途中だけ書き換えることができない
バケットオブジェクトを入れる一番外側の入れ物。名前は全世界で一意
オブジェクト置いたもの1個。キー・値・メタデータの3点セット
キーオブジェクトの名前。photos/2026/a.jpg で1本の文字列。フォルダではない
プレフィックスキーの先頭部分。photos/ のような「フォルダに見えているもの」の正体
Content-Type中身が何かをブラウザに伝えるメタデータ。間違えると表示されない
ETag中身から作られた指紋のような文字列。同じ中身か比べるのに使う
署名付きURLバケットを公開せずに、期限付きで1個だけ渡すURL
バージョニング上書きのたびに古いものを残す設定。消しても残る
削除マーカー「消したことにする」ための目印。実体は下に残っている
ストレージクラス保管の等級。安いほど取り出しに制約が付く
ライフサイクルルール日数で自動的にクラスを移す・消す設定
マルチパートアップロード大きいファイルを分割して送る方式。失敗すると断片が残る

① 準備 — LocalStack を S3 だけで立てる

作業場所を作ります。 最後にフォルダごと消します。

bash
$ mkdir -p ~/awslab/s3
$ cd ~/awslab/s3
$ nano docker-compose.yml
services:
  localstack:
    image: localstack/localstack:3
    ports:
      - "4566:4566"
    environment:
      - SERVICES=s3
      - DEBUG=0
    volumes:
      - "./volume:/var/lib/localstack"

SERVICES=s3 だけにしています。 前回の EC2 と混ぜると起動が遅くなるので、分けます。

bash
$ docker compose up -d
$ docker compose ps
NAME         IMAGE                     STATUS                   PORTS
localstack   localstack/localstack:3   Up 12 seconds (healthy)   0.0.0.0:4566->4566/tcp

(healthy) になるまで待ちます。 starting のまま打つと、繋がらないエラーが出ます。

CLI の設定をします。

bash
$ aws configure set aws_access_key_id test
$ aws configure set aws_secret_access_key test
$ aws configure set region ap-northeast-1
$ alias awsl='aws --endpoint-url=http://localhost:4566'

本物のアクセスキーを絶対にここに入れないでください。 LocalStack は認証情報を検査しません。test で通ります。 本物の鍵を打つと、間違えて本物に向けたときに課金が発生します。

繋がったか確認します。

bash
$ awsl s3 ls

何も出なければ成功です。 バケットが1個も無い状態です。

ここでエラーが出る場合、alias を貼り忘れているか、docker compose ps がまだ healthy になっていません。

Could not connect to the endpoint URL: "http://localhost:4566/"

この文字列が出たら、少し待ってからもう一度打ちます。


② S3 にフォルダは存在しない

先に山場をやります。 ここが分かれば、残りは全部その帰結です。

バケットを作る

bash
$ awsl s3 mb s3://obmes-lab-2026
make_bucket: obmes-lab-2026

バケット名は全世界で一意です。 「自分のアカウントの中で一意」ではありません。地球上の誰かが photos というバケットを作っていたら、あなたは photos を作れません。 本物の AWS では BucketAlreadyExists が返ります。 だから実運用では サイト名-用途-年 のような、被らない名前を付けます。 LocalStack は自分の中にしかバケットが無いので、ここは再現されません。 これは LocalStack の限界です。

ファイルを1個置く

まず、置くファイルを手元に作ります。

bash
$ mkdir -p ~/awslab/s3/src/photos/2026
$ echo "これは写真のつもりのテキストです" > ~/awslab/s3/src/photos/2026/a.jpg

置きます。

bash
$ awsl s3 cp ~/awslab/s3/src/photos/2026/a.jpg s3://obmes-lab-2026/photos/2026/a.jpg
upload: src/photos/2026/a.jpg to s3://obmes-lab-2026/photos/2026/a.jpg

ここで、生の応答を見る

aws s3 ls は使いません。 あれはフォルダがあるように整形して見せる側だからです。

S3 が実際に何を返しているかを見ます。

bash
$ awsl s3api list-objects-v2 --bucket obmes-lab-2026
{
    "IsTruncated": false,
    "Contents": [
        {
            "Key": "photos/2026/a.jpg",
            "LastModified": "2026-10-06T02:14:33+00:00",
            "ETag": "\"5f2b8a1c9d47e30f6a8b2c4d1e9f0a73\"",
            "Size": 49,
            "StorageClass": "STANDARD"
        }
    ],
    "Name": "obmes-lab-2026",
    "Prefix": "",
    "MaxKeys": 1000,
    "EncodingType": "url",
    "KeyCount": 1
}

よく見てください。

Contents の中に、オブジェクトが1個しかありません。 photos/ も photos/2026/ も、どこにもありません。

Key は "photos/2026/a.jpg" という、1本の文字列です。

/ は、a や j と同じ、ただの文字です。

S3 側には、階層という概念がありません。 バケットの中は、キーが名前順に並んだ巨大な一覧表です。

[スクリーンショット: 01_list-objects-v2の生の応答.png] awsl s3api list-objects-v2 --bucket obmes-lab-2026 を実行し、Key が photos/2026/a.jpg という1本の文字列で返っている画面を撮ってください。photos/ という項目が存在しないことが見えるように、Contents 全体が入るように撮ります。

では、なぜフォルダに見えるのか

--delimiter / を付けて、もう一度呼びます。

bash
$ awsl s3api list-objects-v2 --bucket obmes-lab-2026 --delimiter /
{
    "IsTruncated": false,
    "Name": "obmes-lab-2026",
    "Prefix": "",
    "Delimiter": "/",
    "MaxKeys": 1000,
    "CommonPrefixes": [
        {
            "Prefix": "photos/"
        }
    ],
    "EncodingType": "url",
    "KeyCount": 1
}

Contents が消えて、CommonPrefixes が出てきました。

CommonPrefixes は「フォルダの一覧」ではありません。 「/ までで区切って頭を揃えたら、こういう塊になりました」という集計結果です。 S3 がその場で計算して返しているだけで、photos/ という実体はどこにも保存されていません。

もう一段下ります。

bash
$ awsl s3api list-objects-v2 --bucket obmes-lab-2026 --delimiter / --prefix photos/
{
    "IsTruncated": false,
    "Name": "obmes-lab-2026",
    "Prefix": "photos/",
    "Delimiter": "/",
    "MaxKeys": 1000,
    "CommonPrefixes": [
        {
            "Prefix": "photos/2026/"
        }
    ],
    "EncodingType": "url",
    "KeyCount": 1
}

管理画面の「フォルダを開く」は、これを繰り返しているだけです。

管理画面も aws s3 ls も、--delimiter / を毎回付けて、結果をフォルダ風に描いています。 フォルダは、道具が作っている錯覚です。

比べてみます。

bash
$ awsl s3 ls s3://obmes-lab-2026/
                           PRE photos/

PRE は PREFIX の略です。 道具自身が「これはフォルダではなくプレフィックスだ」と表示していました。 私はこの出力を何十回も見ていて、一度も読んでいませんでした。

だから「フォルダ名を変える」ができない

やってみます。 photos/ を images/ にしたい。

S3 には、そういう API がありません。

あるのは「コピー」と「削除」だけです。 CLI の mv は、その2つを裏で順番にやっているだけです。

まず、中身を増やしておきます。

bash
$ echo "2枚目" > ~/awslab/s3/src/photos/2026/b.jpg
$ mkdir -p ~/awslab/s3/src/photos/2025
$ echo "去年の1枚" > ~/awslab/s3/src/photos/2025/c.jpg
$ awsl s3 cp ~/awslab/s3/src/photos/2026/b.jpg s3://obmes-lab-2026/photos/2026/b.jpg
$ awsl s3 cp ~/awslab/s3/src/photos/2025/c.jpg s3://obmes-lab-2026/photos/2025/c.jpg
upload: src/photos/2026/b.jpg to s3://obmes-lab-2026/photos/2026/b.jpg
upload: src/photos/2025/c.jpg to s3://obmes-lab-2026/photos/2025/c.jpg

いまキーは3本です。

bash
$ awsl s3api list-objects-v2 --bucket obmes-lab-2026 --query 'Contents[*].Key' --output text
photos/2025/c.jpg   photos/2026/a.jpg   photos/2026/b.jpg

「名前を変える」をやります。

bash
$ awsl s3 mv s3://obmes-lab-2026/photos/ s3://obmes-lab-2026/images/ --recursive
move: s3://obmes-lab-2026/photos/2025/c.jpg to s3://obmes-lab-2026/images/2025/c.jpg
move: s3://obmes-lab-2026/photos/2026/a.jpg to s3://obmes-lab-2026/images/2026/a.jpg
move: s3://obmes-lab-2026/photos/2026/b.jpg to s3://obmes-lab-2026/images/2026/b.jpg

1行で終わったように見えますが、中で起きたのは「3個コピーして、3個消した」です。 オブジェクトが100万個あれば、100万回のコピーと100万回の削除が走ります。 リクエスト回数に課金されるので、「フォルダ名を変えるだけ」が請求書に出ます。

確認します。

bash
$ awsl s3api list-objects-v2 --bucket obmes-lab-2026 --query 'Contents[*].Key' --output text
images/2025/c.jpg   images/2026/a.jpg   images/2026/b.jpg

キーの文字列が丸ごと書き換わっただけです。

ここから導かれる実務上の結論 キーの設計は、後から直せないつもりで決める。 日付を頭に置くか、IDを頭に置くかは、最初に決める。 「あとでフォルダ分けを整理しよう」は、S3 では「あとで全件コピーしよう」と同じ意味です。


③ オブジェクトは「キー・値・メタデータ」の3点セット

中身を取り出してみます。

bash
$ awsl s3 cp s3://obmes-lab-2026/images/2026/a.jpg ~/awslab/s3/dl-a.jpg
$ cat ~/awslab/s3/dl-a.jpg
download: s3://obmes-lab-2026/images/2026/a.jpg to ./dl-a.jpg
これは写真のつもりのテキストです

中身は本当に保存されていました。 ここが EC2 の張りぼてと違うところです。

メタデータを見る

bash
$ awsl s3api head-object --bucket obmes-lab-2026 --key images/2026/a.jpg
{
    "AcceptRanges": "bytes",
    "LastModified": "2026-10-06T02:19:41+00:00",
    "ContentLength": 49,
    "ETag": "\"5f2b8a1c9d47e30f6a8b2c4d1e9f0a73\"",
    "ContentType": "image/jpeg",
    "ServerSideEncryption": "AES256",
    "Metadata": {}
}
項目何か
ContentTypeブラウザに「これは何か」を伝える。間違えると表示されない
ETag中身から作られた指紋。同じ中身なら同じ値になる(分割送信だと形が変わる)
LastModified最後に置いた時刻
ContentLengthバイト数
ServerSideEncryption保管時の暗号化。いまは既定で有効
Metadata自分で付ける任意の情報。空なら何も付けていない

ContentType が image/jpeg になっているのは、CLI が拡張子から推測したからです。 S3 は中身を見ていません。 中身はテキストなのに image/jpeg になっています。 拡張子と中身が食い違っても、S3 は何も言いません。

Content-Type を間違えると、ブラウザがダウンロードを始める

これは私が実際にやらかした事故です。

HTMLファイルを置きます。 わざと間違った Content-Type を指定します。

bash
$ cat > ~/awslab/s3/src/index.html <<'EOF'
  <h1>obmes lab</h1>
  <p>このページが表示されれば成功です。</p>
  EOF
bash
$ awsl s3 cp ~/awslab/s3/src/index.html s3://obmes-lab-2026/site/index.html \
    --content-type application/octet-stream
upload: src/index.html to s3://obmes-lab-2026/site/index.html
bash
$ awsl s3api head-object --bucket obmes-lab-2026 --key site/index.html \
    --query 'ContentType' --output text
application/octet-stream

application/octet-stream は「何だか分からないバイト列」という意味です。 ブラウザはこれを受け取ると、表示せずに「保存しますか」を出します。 HTMLの中身は完全に正しいのに、画面には何も出ません。

私はこれで半日溶かしました。 「S3 の設定が悪い」「公開されていない」と疑って、公開設定をいじろうとしました。 危うく、いじってはいけないものをいじるところでした。

直します。 メタデータだけを直す API はありません。同じキーに置き直します。

bash
$ awsl s3 cp ~/awslab/s3/src/index.html s3://obmes-lab-2026/site/index.html \
    --content-type text/html
bash
$ awsl s3api head-object --bucket obmes-lab-2026 --key site/index.html \
    --query 'ContentType' --output text
text/html

「表示されない」を見たら、公開設定より先に Content-Type を疑ってください。 公開設定をいじるのは、取り返しがつかない側の操作です。

まとめると、オブジェクトはこの3つです。

要素例注意
キーimages/2026/a.jpg1本の文字列。後から変えられない
値ファイルの中身途中だけの書き換えができない。丸ごと置き直す
メタデータContent-Type などこれだけ直す方法は無い。置き直す

④ 公開設定 — ここが守る側の最重要事項

ニュースで「S3 が公開されていて情報が漏れた」というのを見たことがあると思います。

先に結論を書きます。

S3 の既定は非公開です。 何もしなければ、外から1バイトも読めません。 事故が起きるのは、この既定を人が自分の手で外したときだけです。

確認します。

bash
$ awsl s3api get-public-access-block --bucket obmes-lab-2026
{
    "PublicAccessBlockConfiguration": {
        "BlockPublicAcls": true,
        "IgnorePublicAcls": true,
        "BlockPublicPolicy": true,
        "RestrictPublicBuckets": true
    }
}

4つとも true。これが「ブロックパブリックアクセス」です。

設定何を止めるか
BlockPublicAclsこれから「公開」の ACL を付けさせない
IgnorePublicAclsすでに付いている公開 ACL を無視する
BlockPublicPolicyこれから公開のバケットポリシーを付けさせない
RestrictPublicBucketsすでに付いている公開ポリシーの効き目を落とす

「これから」と「すでに」で2組あるのがポイントです。 付けさせない側だけ有効にしても、過去に付いたものは残ります。 だから4つセットで true にします。

この記事では、この4つを外しません

外し方は書きません。

理由は2つです。

  1. 外す必要が無いから。 静的サイトを出したいなら、バケットを公開するのではなく CloudFront 経由にするのが今の作法です
  2. 手順として書いてしまうと、意味を分からずコピーする人が出るから

「公開されているバケットの探し方」も、この記事には一切書きません。 扱うのは守る側の設定だけです。

LocalStack のコミュニティ版について、正直に書きます。 LocalStack は既定で IAM ポリシーやバケットポリシーを強制しません。 つまり LocalStack 上では「非公開のはずのオブジェクトが読めてしまう」ことがあります。 これは LocalStack がそう作られているだけで、本物の挙動ではありません。 「LocalStack で読めたから本物でも読める」とは絶対に考えないでください。 権限の話そのものは AccessDeniedに全権限で答えない — AWS深掘り で扱っています。

では、どうやって人に渡すのか — 署名付きURL

「公開しないと渡せない」は間違いです。

署名付きURL(presigned URL)を使えば、バケットを非公開のまま、1個のオブジェクトを、期限付きで渡せます。

30秒だけ有効なURLを作ります。

bash
$ URL=$(awsl s3 presign s3://obmes-lab-2026/site/index.html --expires-in 30)
$ echo "$URL"
http://localhost:4566/obmes-lab-2026/site/index.html?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=test%2F20261006%2Fap-northeast-1%2Fs3%2Faws4_request&X-Amz-Date=20261006T022411Z&X-Amz-Expires=30&X-Amz-SignedHeaders=host&X-Amz-Signature=3c9b7f1e2a8d4506bc71f9e3a2d8054176c9b3ea28f10d5c7b64a9e0f318d2b7

長いですが、読める部分があります。

パラメータ意味
X-Amz-Dateいつ発行したか
X-Amz-Expires何秒有効か(ここでは30)
X-Amz-Signature上の内容を鍵で署名した値。1文字でも変えると無効になる

URL そのものが鍵です。 このURLを知っている人は、期限内なら誰でも取れます。 チャットに貼ったら、そのチャットを見られる全員に渡したことになります。

すぐ叩きます。

bash
$ curl -s -o /dev/null -w '%{http_code}\n' "$URL"
200

取れました。バケットは非公開のままです。

35秒待って、もう一度叩きます。

bash
$ sleep 35
$ curl -s -o /dev/null -w '%{http_code}\n' "$URL"
403

中身も見てみます。

bash
$ curl -s "$URL"
<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>AccessDenied</Code>
  <Message>Request has expired</Message>
  <Expires>2026-10-06T02:24:41Z</Expires>
  <ServerTime>2026-10-06T02:25:16Z</ServerTime>
</Error>

期限が切れました。

[スクリーンショット: 02_署名付きURLが403になる.png] 同じURLに対する curl が、最初は 200、35秒後に 403 と Request has expired を返すところを、2回分が同じ画面に写るように撮ってください。

署名付きURLの期限は、必要な長さより短くします。 ダウンロードリンクなら数分で十分です。「念のため7日」にすると、7日間ばらまける鍵を配ったのと同じです。

静的サイトを公開したいときは

バケットを公開しません。

S3 は非公開のまま置き場に徹して、外に出すのは CDN 側(CloudFront)に任せます。 そうすると、外に出ている入口が1つになり、そこにだけ制限や証明書やキャッシュを掛けられます。

この「置き場と配信を分ける」という考え方そのものは、AWS 固有の話ではありません。 キャッシュは4箇所にある — Cache-ControlとCDN と 静的サイトは本当に無料で出せる — GitHub Pages で、同じ構造を扱っています。

CloudFront そのものは、この深掘りシリーズの次の回でやります。 詳しくは次の記事 CloudFrontとキャッシュ設計 — ログインページまでキャッシュされた で扱います。


⑤ バージョニング — 消しても消えていない

ここが「消したのに料金が減らない」の正体です。

有効にする

bash
$ awsl s3api put-bucket-versioning \
    --bucket obmes-lab-2026 \
    --versioning-configuration Status=Enabled
bash
$ awsl s3api get-bucket-versioning --bucket obmes-lab-2026
{
    "Status": "Enabled"
}

一度有効にすると、Disabled には戻せません。 戻せるのは Suspended(一時停止)までです。 すでに積まれたバージョンは、停止しても消えません。

同じキーに2回置く

bash
$ echo "1回目の内容" > ~/awslab/s3/src/note.txt
$ awsl s3 cp ~/awslab/s3/src/note.txt s3://obmes-lab-2026/note.txt

$ echo "2回目の内容" > ~/awslab/s3/src/note.txt
$ awsl s3 cp ~/awslab/s3/src/note.txt s3://obmes-lab-2026/note.txt
upload: src/note.txt to s3://obmes-lab-2026/note.txt
upload: src/note.txt to s3://obmes-lab-2026/note.txt

普通に見ると、1個です。

bash
$ awsl s3 ls s3://obmes-lab-2026/note.txt
2026-10-06 02:31:07         19 note.txt

中身も2回目です。

bash
$ awsl s3 cp s3://obmes-lab-2026/note.txt - 2>/dev/null
2回目の内容

では、バージョンを見ます。

bash
$ awsl s3api list-object-versions --bucket obmes-lab-2026 --prefix note.txt
{
    "Versions": [
        {
            "ETag": "\"a71c39e8b40f2d6518c7a03e94b1d2f6\"",
            "Size": 19,
            "StorageClass": "STANDARD",
            "Key": "note.txt",
            "VersionId": "3sL9xQmT0aVc7Bn2Rd8fKp1YwZ6hJe4U",
            "IsLatest": true,
            "LastModified": "2026-10-06T02:31:07+00:00"
        },
        {
            "ETag": "\"c0e4b71f8a2d39560ec18b4a72f0d9e3\"",
            "Size": 19,
            "StorageClass": "STANDARD",
            "Key": "note.txt",
            "VersionId": "7Kd2pW5nQx8Rb1Vt0Ay6Hs3Lm9Ug4Ze",
            "IsLatest": false,
            "LastModified": "2026-10-06T02:31:03+00:00"
        }
    ]
}

上書きではありませんでした。 オブジェクトが2個あります。 新しいほうに IsLatest: true が付いているだけです。 課金されるのは2個分です。「上書きしたから容量は変わらない」は間違いです。

古いほうを名指しで読めます。

bash
$ awsl s3api get-object --bucket obmes-lab-2026 --key note.txt \
    --version-id 7Kd2pW5nQx8Rb1Vt0Ay6Hs3Lm9Ug4Ze /dev/stdout 2>/dev/null
1回目の内容

これがバージョニングの利点です。 間違って上書きしても、戻せます。

削除しても、実体は残る

消します。

bash
$ awsl s3 rm s3://obmes-lab-2026/note.txt
delete: s3://obmes-lab-2026/note.txt

一覧から消えました。

bash
$ awsl s3 ls s3://obmes-lab-2026/note.txt

何も出ません。 普通に取ろうとすると 404 になります。

bash
$ awsl s3api head-object --bucket obmes-lab-2026 --key note.txt
An error occurred (404) when calling the HeadObject operation: Not Found

「消えた」ように見えます。 バージョンを見ます。

bash
$ awsl s3api list-object-versions --bucket obmes-lab-2026 --prefix note.txt
{
    "Versions": [
        {
            "ETag": "\"a71c39e8b40f2d6518c7a03e94b1d2f6\"",
            "Size": 19,
            "Key": "note.txt",
            "VersionId": "3sL9xQmT0aVc7Bn2Rd8fKp1YwZ6hJe4U",
            "IsLatest": false,
            "LastModified": "2026-10-06T02:31:07+00:00"
        },
        {
            "ETag": "\"c0e4b71f8a2d39560ec18b4a72f0d9e3\"",
            "Size": 19,
            "Key": "note.txt",
            "VersionId": "7Kd2pW5nQx8Rb1Vt0Ay6Hs3Lm9Ug4Ze",
            "IsLatest": false,
            "LastModified": "2026-10-06T02:31:03+00:00"
        }
    ],
    "DeleteMarkers": [
        {
            "Key": "note.txt",
            "VersionId": "9Fq4Zt7Ln2Wc0Ry5Bd8Ka3Mx1Hp6Vs",
            "IsLatest": true,
            "LastModified": "2026-10-06T02:33:22+00:00"
        }
    ]
}

中身は2個とも残っています。 増えたのは DeleteMarkers という、中身が0バイトの目印だけです。 「消した」の正体は、「一番上に、消えたことにする札を1枚載せた」でした。

[スクリーンショット: 03_削除マーカーの下に実体が残っている.png] awsl s3 rm したあとの list-object-versions の出力を撮ってください。DeleteMarkers と Versions が両方写っていることが要点です。

これが「消したのに料金が減らない」の答えです。

見ているもの見えるか課金されるか
削除マーカーこれが一番上にあるので「無い」ように見えるほぼ0
過去のバージョン普通の一覧には出ないされる

請求書だけが、残っていることを教えてくれます。

元に戻す

削除マーカーを消すと、復活します。

bash
$ awsl s3api delete-object --bucket obmes-lab-2026 --key note.txt \
    --version-id 9Fq4Zt7Ln2Wc0Ry5Bd8Ka3Mx1Hp6Vs
{
    "DeleteMarker": true,
    "VersionId": "9Fq4Zt7Ln2Wc0Ry5Bd8Ka3Mx1Hp6Vs"
}
bash
$ awsl s3 cp s3://obmes-lab-2026/note.txt - 2>/dev/null
2回目の内容

戻りました。 ゴミ箱から出したのと同じです。

この構造は、Linux の rm とは正反対です。 rmで消したものは戻らない — Linux深掘り と読み比べると、「戻せる」ことに何を払っているのかが分かります。払っているのは保管料です。

本当に消す

バージョンIDを指定して消すと、実体が消えます。

bash
$ awsl s3api delete-object --bucket obmes-lab-2026 --key note.txt \
    --version-id 3sL9xQmT0aVc7Bn2Rd8fKp1YwZ6hJe4U
$ awsl s3api delete-object --bucket obmes-lab-2026 --key note.txt \
    --version-id 7Kd2pW5nQx8Rb1Vt0Ay6Hs3Lm9Ug4Ze
bash
$ awsl s3api list-object-versions --bucket obmes-lab-2026 --prefix note.txt

何も出なくなりました。 これはもう戻せません。

覚えるのは1行です。 バージョンIDを付けない削除は「隠す」。付けた削除は「消す」。

⑦のライフサイクルルールで、これを自動化します。 手で消し続けるのは無理だからです。


⑥ ストレージクラス — 安いほうには必ず条件が付く

S3 は1種類ではありません。 同じ置き場に、等級があります。

現在のクラスを見ます。

bash
$ awsl s3api list-objects-v2 --bucket obmes-lab-2026 \
    --query 'Contents[*].[Key,StorageClass]' --output text
images/2025/c.jpg   STANDARD
images/2026/a.jpg   STANDARD
images/2026/b.jpg   STANDARD
site/index.html     STANDARD

何も指定しなければ STANDARD です。

1枚の表

クラス取り出しの速さ最低保存期間向いている用途
Standardすぐ無しよく読むもの。迷ったらこれ
Standard-IAすぐ30日月に数回しか読まないが、読むときはすぐ欲しい
One Zone-IAすぐ30日消えても作り直せるもの限定(1か所にしか置かれない)
Glacier Instant Retrievalすぐ90日年に数回読む。でも待てない
Glacier Flexible Retrieval分〜時間90日待てるバックアップ
Glacier Deep Archive時間単位180日法令で残すだけ。基本は読まない
Intelligent-Tieringすぐ無し読む頻度が読めないとき。自動で移してくれる

「最低保存期間」が罠です

Standard-IA に置いたものを10日で消しても、30日分の保管料を請求されます。 早く消したから安くなる、にはなりません。

だから、こうなります。

やろうとしたこと結果
一時ファイルを IA に置いて節約逆に高くなる。30日持たないものは Standard
ログを即 Glacier Deep Archive へ180日以内に読み返すなら損
画像を One Zone-IA に元が無いなら危険。1か所にしか置かれない

Glacier は取り出しに時間と別料金がかかる

Glacier 系は「置いてある」だけで、「すぐ読める」状態ではありません。

読むには「復元してください」と頼み、待ちます。

bash
$ awsl s3api restore-object --bucket obmes-lab-2026 --key images/2026/a.jpg \
    --restore-request '{"Days":1,"GlacierJobParameters":{"Tier":"Standard"}}'

LocalStack のコミュニティ版では、この API は受け付けられますが、実際の待ち時間は再現されません。 本物では、Flexible Retrieval で数分から数時間、Deep Archive では半日ほどかかることもあります。 「動いたから本物でも一瞬」ではありません。 ここは LocalStack で確かめられない部分です。

そして、取り出しそのものにも課金されます。

「保管は安い、取り出しは高い」がアーカイブ系の基本構造です。 毎日読み返すものを Glacier に入れると、保管料の節約より取り出し料が上回ります。

金額はここには書きません

クラスごとの単価も、取り出し料も、リージョンごとに違い、改定されます。

この記事に数字を書くと、必ず古くなって嘘になります。

必ず公式で確認してください。

そもそも「いくら掛かるか」を先に決める話は、本線の クラウド料金は止め忘れで膨らむ — 先に上限を作る に書いています。


⑦ ライフサイクルルール — 設定しないと永久に貯まる

⑥までで分かったことを、手で毎日やるのは無理です。

  • 30日経ったら安いクラスに移す
  • 90日経ったらアーカイブに移す
  • 1年経ったら消す
  • 古いバージョンは30日で本当に消す

これを日数で自動化するのが、ライフサイクルルールです。

これを設定しないと、どうなるか

私のサーバーで実際に起きたことです。

アクセスログを毎日 S3 に投げる設定にしました。 1日あたりは小さいので、気にしませんでした。

半年後、バケットの中身が数万オブジェクトになっていました。

誰も読み返していないログに、毎月お金を払い続けていました。

捨てる仕組みを一緒に作らなかったのが原因です。

ログや一時ファイルを S3 に置くときは、「置く設定」と「捨てる設定」を同時に書く。 片方だけ書くと、必ずこうなります。

書く

bash
$ cat > ~/awslab/s3/lifecycle.json <<'EOF'
  {
    "Rules": [
      {
        "ID": "logs-tiering-and-expire",
        "Status": "Enabled",
        "Filter": { "Prefix": "logs/" },
        "Transitions": [
          { "Days": 30, "StorageClass": "STANDARD_IA" },
          { "Days": 90, "StorageClass": "GLACIER" }
        ],
        "Expiration": { "Days": 365 }
      },
      {
        "ID": "expire-old-versions",
        "Status": "Enabled",
        "Filter": { "Prefix": "" },
        "NoncurrentVersionExpiration": { "NoncurrentDays": 30 }
      },
      {
        "ID": "abort-incomplete-multipart",
        "Status": "Enabled",
        "Filter": { "Prefix": "" },
        "AbortIncompleteMultipartUpload": { "DaysAfterInitiation": 7 }
      }
    ]
  }
  EOF

3本のルールが入っています。

IDやること
logs-tiering-and-expirelogs/ の下を 30日で IA、90日で Glacier、365日で削除
expire-old-versions⑤で見た「残り続ける過去バージョン」を30日で本当に消す
abort-incomplete-multipart失敗した分割送信の断片を7日で捨てる(⑧でやります)

適用します。

bash
$ awsl s3api put-bucket-lifecycle-configuration \
    --bucket obmes-lab-2026 \
    --lifecycle-configuration file://~/awslab/s3/lifecycle.json

何も出なければ成功です。

読み返す

設定したつもりで入っていない、が一番怖いので、必ず読み返します。

bash
$ awsl s3api get-bucket-lifecycle-configuration --bucket obmes-lab-2026
{
    "Rules": [
        {
            "Expiration": { "Days": 365 },
            "ID": "logs-tiering-and-expire",
            "Filter": { "Prefix": "logs/" },
            "Status": "Enabled",
            "Transitions": [
                { "Days": 30, "StorageClass": "STANDARD_IA" },
                { "Days": 90, "StorageClass": "GLACIER" }
            ]
        },
        {
            "ID": "expire-old-versions",
            "Filter": { "Prefix": "" },
            "Status": "Enabled",
            "NoncurrentVersionExpiration": { "NoncurrentDays": 30 }
        },
        {
            "ID": "abort-incomplete-multipart",
            "Filter": { "Prefix": "" },
            "Status": "Enabled",
            "AbortIncompleteMultipartUpload": { "DaysAfterInitiation": 7 }
        }
    ]
}

入っています。

LocalStack のコミュニティ版について、正直に書きます。 ルールは保存され、読み返せます。 しかし、日数が来ても実際にはクラスが移りませんし、削除もされません。 LocalStack には時間を進める仕組みが無いので、「設定が入ったこと」までしか確かめられません。 移動や削除が本当に起きるかは、本物でしか確認できません。 それでも、JSONの書き方を間違えていないことを確認できるだけで十分価値があります。 私はここで3回、書式エラーを直しました。

よくある書き間違い

わざと壊してみます。 日数を降順にしました。

bash
$ cat > ~/awslab/s3/bad.json <<'EOF'
  {
    "Rules": [
      {
        "ID": "bad",
        "Status": "Enabled",
        "Filter": { "Prefix": "" },
        "Transitions": [
          { "Days": 90, "StorageClass": "GLACIER" },
          { "Days": 30, "StorageClass": "STANDARD_IA" }
        ]
      }
    ]
  }
  EOF
bash
$ awsl s3api put-bucket-lifecycle-configuration \
    --bucket obmes-lab-2026 --lifecycle-configuration file://~/awslab/s3/bad.json
An error occurred (InvalidRequest) when calling the PutBucketLifecycleConfiguration operation: 'Days' in Transition action must be greater than the 'Days' in the previous Transition action

日数は昇順でなければいけません。 安いクラスから高いクラスへは戻せないからです。

元に戻します。

bash
$ awsl s3api put-bucket-lifecycle-configuration \
    --bucket obmes-lab-2026 \
    --lifecycle-configuration file://~/awslab/s3/lifecycle.json
$ awsl s3api get-bucket-lifecycle-configuration --bucket obmes-lab-2026 \
    --query 'Rules[*].ID' --output text
logs-tiering-and-expire   expire-old-versions   abort-incomplete-multipart

3本とも戻りました。


⑧ 整合性・リクエスト課金・マルチパートアップロード

いまの S3 は、書いた直後に読める

古い記事にはこう書いてあります。

「S3 は結果整合性なので、書き込んだ直後に読むと古い内容が返ることがある」

これは、いまは違います。

現在の S3 は、新規作成も上書きも削除も、書き込み後の読み取りが強整合です。 追加の設定も、待ち時間も、追加料金もありません。

確かめます。

bash
$ echo "v1" > ~/awslab/s3/src/consistency.txt
$ awsl s3 cp ~/awslab/s3/src/consistency.txt s3://obmes-lab-2026/consistency.txt >/dev/null
$ awsl s3 cp s3://obmes-lab-2026/consistency.txt - 2>/dev/null

$ echo "v2" > ~/awslab/s3/src/consistency.txt
$ awsl s3 cp ~/awslab/s3/src/consistency.txt s3://obmes-lab-2026/consistency.txt >/dev/null
$ awsl s3 cp s3://obmes-lab-2026/consistency.txt - 2>/dev/null
v1
v2

待たずに新しい内容が返ります。

ただし「一覧(list)」は別の話です。 list-objects-v2 はキーを名前順に並べて返すので、大量にあると途中で切れます。 IsTruncated: true が返ったら、続きがあります。

bash
$ awsl s3api list-objects-v2 --bucket obmes-lab-2026 --max-keys 2
{
    "IsTruncated": true,
    "Contents": [
        { "Key": "consistency.txt", "Size": 3, "StorageClass": "STANDARD" },
        { "Key": "images/2025/c.jpg", "Size": 14, "StorageClass": "STANDARD" }
    ],
    "Name": "obmes-lab-2026",
    "MaxKeys": 2,
    "KeyCount": 2,
    "NextContinuationToken": "1eyJDb250aW51YXRpb25Ub2tlbiI6IG51bGx9"
}

IsTruncated: true を見落とすのが、S3 の初歩の事故です。 「一覧を取ったら2件だった」ではなく「1ページ目が2件だった」かもしれません。 自作のスクリプトで全件処理するときは、NextContinuationToken を必ず追ってください。 aws s3 ls は裏で追ってくれますが、自分でSDKを叩くときは自分で追う必要があります。

小さいファイルを大量に置くと、リクエストで課金される

S3 の課金は、保管容量だけではありません。

課金される軸いつ効くか
保管容量大きいファイルを長く置くとき
リクエスト回数小さいファイルを大量に置く・読むとき
データ転送(外向き)たくさんダウンロードされるとき
取り出し(Glacier系)アーカイブから読み戻すとき

1KB のファイルを100万個置くと、容量はごくわずかでも、リクエスト回数は100万回です。 ②で見た「フォルダ名の変更」が、コピー100万回+削除100万回になるのは、これが理由です。

金額は書きません。 構造だけ覚えて、公式の料金ページで確認してください。

マルチパートアップロード — 失敗すると断片が残る

大きいファイルは、分割して送られます。

CLI は一定サイズを超えると、自動で切り替えます。 使う側は意識しません。失敗するまでは。

わざと、中断された状態を作ります。

bash
$ awsl s3api create-multipart-upload \
    --bucket obmes-lab-2026 --key big/archive.tar.gz
{
    "Bucket": "obmes-lab-2026",
    "Key": "big/archive.tar.gz",
    "UploadId": "Zt4Kq9Rd0Wn7Bx2Lf5Ha3Mc8Vp1Ye6S"
}

ここで、送信元のネットワークが切れたとします。 完了の合図を送っていません。

普通に一覧しても、出てきません。

bash
$ awsl s3api list-objects-v2 --bucket obmes-lab-2026 --prefix big/ \
    --query 'Contents' --output text
None

Contents に出ないのに、送り終わった分の断片は保管されていて、課金されます。 これが「請求書に理由の分からない容量が載る」よくある原因です。

専用の一覧でだけ見えます。

bash
$ awsl s3api list-multipart-uploads --bucket obmes-lab-2026
{
    "Uploads": [
        {
            "UploadId": "Zt4Kq9Rd0Wn7Bx2Lf5Ha3Mc8Vp1Ye6S",
            "Key": "big/archive.tar.gz",
            "Initiated": "2026-10-06T02:47:12+00:00",
            "StorageClass": "STANDARD"
        }
    ]
}

手で消せます。

bash
$ awsl s3api abort-multipart-upload \
    --bucket obmes-lab-2026 --key big/archive.tar.gz \
    --upload-id Zt4Kq9Rd0Wn7Bx2Lf5Ha3Mc8Vp1Ye6S
$ awsl s3api list-multipart-uploads --bucket obmes-lab-2026 \
    --query 'Uploads' --output text
None

消えました。

でも、手で消すのは間違いです。 人が気づかないから残るのであって、気づける前提の運用は破綻します。 ⑦で入れた abort-incomplete-multipart のルールが、7日で自動的にこれをやります。

入っているか確認します。

bash
$ awsl s3api get-bucket-lifecycle-configuration --bucket obmes-lab-2026 \
    --query 'Rules[?ID==`abort-incomplete-multipart`]'
[
    {
        "ID": "abort-incomplete-multipart",
        "Filter": { "Prefix": "" },
        "Status": "Enabled",
        "AbortIncompleteMultipartUpload": { "DaysAfterInitiation": 7 }
    }
]

バケットを作ったら、最初にこのルールを入れる。 これは節約ではなく、掃除の自動化です。


⑨ 何を置いて、何を置かないか

ここまでで、S3 の性質が見えました。

  • 丸ごと置いて、丸ごと取る。途中だけの書き換えができない
  • 1回ごとにリクエスト課金がある
  • 強整合だが、「安い置き場」であることを前提にした値付けになっている

この性質から、向き不向きが決まります。

置くもの

何をなぜ S3 か
アップロードされた画像・動画書いたら基本は読むだけ。サーバーのディスクを増やさなくていい
バックアップ(DBのダンプなど)書いて、しばらく置いて、たまに戻す。ライフサイクルとぴったり合う
ログの長期保管ただし必ず期限付きで(⑦のルールとセット)
静的サイトのファイルバケットは公開せず、CDN 経由で出す
配布物(インストーラ・PDF)署名付きURLで期限を切って渡せる

置いてはいけないもの

何をなぜ駄目か
頻繁に書き換えるデータ(DB的な用途)1バイト変えるのに全体を置き直す。しかも毎回リクエスト課金
カウンタ・在庫数のような「同時に増減するもの」後から書いたほうが勝つ。ロックが無いので数が狂う
アプリの一時ファイル(数分で消すもの)IA に置くと最低保存期間で損。そもそもローカルでいい
検索したいデータキーの前方一致でしか探せない。中身では探せない
秘密情報を、そのまま鍵や認証情報は専用の置き場を使う

「ファイルが置ける」と「データベースになる」は別です。 私は一度、閲覧数のカウンタを S3 の JSON でやろうとして、数が合わなくなりました。 同時に2人が読んで、両方が +1 して、両方が書いたら、+1 しか増えません。 S3 には「読んで、増やして、書く」を一息でやる仕組みがありません。

個人開発で最初に使うのは、2つだけ

全部を使いこなす必要はありません。

  1. 画像の保存先(アップロードされたファイルを、サーバーのディスクから追い出す)
  2. バックアップ置き場(DBのダンプを、サーバーとは別の場所に置く)

この2つで、S3 を使う理由の大半は満たせます。

残りは、必要になってから読めば間に合います。

「なぜ自分のサーバーの外に置くのか」という話は、借りても責任は消えない — AWS深掘り に書いています。


つまずいたところ

「フォルダの名前を変える」を探し続けた。 無いのは機能ではなく、フォルダのほうでした。 list-objects-v2 の生の応答で Key が1本の文字列だと見るまで、私は「探し方が悪いのだろう」と思っていました。画面を信じすぎていました。

aws s3 ls の PRE を、ずっと読み飛ばしていた。 PREFIX の略で、道具自身が「これはフォルダではない」と表示していました。 何十回も見ていて、一度も意味を考えていませんでした。出力の見慣れた部分ほど読んでいない、という自分の癖に気づきました。

HTMLが表示されないのを、公開設定のせいだと思った。 原因は Content-Type が application/octet-stream だっただけでした。危うくブロックパブリックアクセスを外すところでした。 「表示されない」で最初に触るべきは、絶対に公開設定ではありません。

メタデータだけ直す方法を探した。 ありません。 同じキーに置き直します。オブジェクトは「丸ごと」しか扱えない、という性質がここにも出ていました。

バケット名を photos にしようとして、意味が分からなかった。 バケット名は全世界で一意なので、ありふれた名前は取れません。LocalStack では作れてしまうので、この失敗は本物でしか起きません。 練習だけしていると、この壁の存在に気づけません。

バージョニングを有効にしたあと、s3 rm で消えたと思い込んだ。 消えていたのは表示だけで、実体は2個とも残っていました。 請求書を見て初めて気づく類の失敗です。list-object-versions を打つ習慣が無かったのが原因でした。

バージョニングを無効に戻そうとした。 Disabled には戻せません。 Suspended までです。しかも、すでに積まれたバージョンは消えません。 「あとで戻せる」と思って有効にすると、戻せません。

ライフサイクルの JSON で3回エラーを出した。 Filter の書き忘れ、Days の順番が降順、クラス名の綴り違い(GLACIER_IR を GLACIER-IR と書いた)。LocalStack で書式だけ通せるのは、ここで効きました。 本物で試行錯誤しなくて済みます。

LocalStack でライフサイクルが動かないと思って、設定を疑った。 設定は正しく、LocalStack が時間を進めないだけでした。「エミュレータで動かない=設定が間違い」ではありません。 どこまで再現されるかを、先に調べるべきでした。

未完了のマルチパートアップロードの存在を知らなかった。 list-objects-v2 に出ないのに課金される、というものがあると思っていませんでした。「一覧に出るものが全部だ」という思い込みが、ここでも間違いでした。


後片づけ

バージョニングを有効にしたバケットは、普通のやり方では消せません。 順番にやります。

まず、何が残っているか見ます。

bash
$ awsl s3api list-object-versions --bucket obmes-lab-2026 \
    --query '[length(Versions), length(DeleteMarkers)]' --output text
6   0

未完了のマルチパートも確認します。

bash
$ awsl s3api list-multipart-uploads --bucket obmes-lab-2026 \
    --query 'Uploads' --output text
None

普通にオブジェクトを消します。

bash
$ awsl s3 rm s3://obmes-lab-2026/ --recursive
delete: s3://obmes-lab-2026/consistency.txt
delete: s3://obmes-lab-2026/images/2025/c.jpg
delete: s3://obmes-lab-2026/images/2026/a.jpg
delete: s3://obmes-lab-2026/images/2026/b.jpg
delete: s3://obmes-lab-2026/site/index.html

ここで終わりにしないこと。 削除マーカーが載っただけで、実体は残っています。

bash
$ awsl s3api list-object-versions --bucket obmes-lab-2026 \
    --query '[length(Versions), length(DeleteMarkers)]' --output text
6   5

むしろ増えました。 ⑤で見たとおりです。

バージョンと削除マーカーを、IDを指定して全部消します。

bash
$ awsl s3api list-object-versions --bucket obmes-lab-2026 \
    --query 'Versions[].[Key,VersionId]' --output text | while read -r KEY VID; do
    awsl s3api delete-object --bucket obmes-lab-2026 --key "$KEY" --version-id "$VID" >/dev/null
  done
bash
$ awsl s3api list-object-versions --bucket obmes-lab-2026 \
    --query 'DeleteMarkers[].[Key,VersionId]' --output text | while read -r KEY VID; do
    awsl s3api delete-object --bucket obmes-lab-2026 --key "$KEY" --version-id "$VID" >/dev/null
  done

空になったか確認します。

bash
$ awsl s3api list-object-versions --bucket obmes-lab-2026

何も出なければ完了です。

バケットを消します。

bash
$ awsl s3 rb s3://obmes-lab-2026
remove_bucket: obmes-lab-2026
bash
$ awsl s3 ls

何も出なければ、バケットは無くなりました。

本物の AWS で、この「バージョン全消し」を手でやってはいけません。 ⑦で入れた NoncurrentVersionExpiration のルールに任せます。 手で全件回すスクリプトは、キーを取り違えると取り返しがつきません。

LocalStack を止めます。

bash
$ cd ~/awslab/s3
$ docker compose down -v
[+] Running 2/2
 ✔ Container localstack   Removed
 ✔ Network s3_default     Removed

-v を付けます。 付けないと、./volume に置いたデータが残ります。

bash
$ docker compose ps

何も出なければ止まっています。

練習用フォルダを消します。

bash
$ cd ~
$ rm -rf ~/awslab/s3
$ ls ~/awslab

./volume の中に LocalStack が書いたファイルが入っているので、一緒に消えます。

最後に、容量が戻ったことを確認します。

bash
$ df -h ~ | tail -1

本物の AWS を使っている場合は、これに加えて「バケットの数」を必ず確認してください。 空のバケットは無料ですが、空だと思っていたバケットに、未完了のマルチパートが残っていることがあります。 list-multipart-uploads を、消す前に必ず1回打ちます。


まとめ — 理解できたこと

  • S3 にフォルダは存在しない。 あるのはキーという1本の文字列で、/ はただの文字
  • CommonPrefixes はフォルダの一覧ではない。 --delimiter / を付けたときにその場で集計された結果
  • aws s3 ls の PRE は「プレフィックス」。 道具自身が「フォルダではない」と言っていた
  • フォルダ名は変えられない。 mv --recursive の正体は「全部コピーして、全部消す」。リクエスト回数に課金される
  • キーの設計は、後から直せないつもりで最初に決める
  • バケット名は全世界で一意。 ありふれた名前は取れない。LocalStack では再現されない
  • オブジェクトは「キー・値・メタデータ」の3点。 メタデータだけを直す方法は無い(置き直す)
  • Content-Type を間違えるとブラウザがダウンロードを始める。 「表示されない」で公開設定を触ってはいけない
  • 既定は非公開。 事故は自分でブロックパブリックアクセスを外したときにしか起きない
  • 公開せずに渡す方法がある。 署名付きURL。期限は短く。URL そのものが鍵
  • 静的サイトを出すなら、バケットを公開せず CDN 経由
  • バージョニングは戻せない。 Disabled にはできず、Suspended まで
  • 削除は「削除マーカーを載せる」だけ。実体は残り、課金され続ける。 これが「消したのに料金が減らない」の正体
  • バージョンIDを付けない削除は「隠す」、付けた削除は「消す」
  • 安いストレージクラスには最低保存期間がある。 早く消しても安くならない
  • Glacier は取り出しに時間と別料金がかかる。 保管が安いことと、読むのが安いことは別
  • ライフサイクルルールを設定しないと、ログは永久に貯まる。 「置く設定」と「捨てる設定」は同時に書く
  • いまの S3 は書き込み後の読み取りが強整合。 古い「結果整合」の説明はもう当てはまらない
  • ただし一覧は別。 IsTruncated: true を見落とすと、1ページ目を全件だと思い込む
  • 未完了のマルチパートは、一覧に出ないまま課金される。 バケットを作ったら最初に自動中断ルールを入れる
  • 書き換え続けるものを S3 に置かない。 同時に増やすと数が狂う
  • 個人開発で最初に使うのは「画像の保存先」と「バックアップ置き場」の2つだけでいい

参考リンク


次に読む

この記事は 【深掘り】AWS の 7 / 16 本目です。

記事
← 前の記事ロードバランサとオートスケール — 台数を増やしたのに全部落ちる
→ 次の記事CloudFrontとキャッシュ設計 — ログインページまでキャッシュされた

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

AWS›AWS — S3
  • フォルダは存在しない
  • バージョニングと削除マーカー

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次