AWS EmulatorのS3で消したファイルをバージョニングで戻す方法

​​AWS Emulator​Amazon S3,AWS CLI

S3 のバケットでバージョニングを有効にしておくと、aws s3 rm で消したファイルや、上書きしてしまったファイルを、あとから戻せます。誤って消したファイルの復元や、上書き前の古い版へのロールバックを、AWS のアカウントを使わずに手元の AWS Emulator で試し、コマンドと出力をそのまま載せます。

補足

検証環境は Ubuntu 24.04(x86_64)、AWS Emulator 1.0.487(2026年11月17日リリース)、AWS CLI 2.40.4 です。AWS のアカウントと認証情報は使っていません。本物の S3 での動き(料金、ライフサイクルルールで古い版を自動で消す設定、MFA Delete、コンソールでの操作など)は確かめていません。本物の S3 について書いているところは、公式ドキュメントを出どころにしています。AWS Emulator の公式ドキュメントによると、AWS がエミュレーターの動きを本物と照らし合わせているのは、米国西部(オレゴン、us-west-2)リージョンだけです(グローバルなサービスは us-east-1)。この記事で使った us-east-1 の S3 は、その対象外です。

エミュレーターを起動して、バケットを作る

AWS Emulator は、AWS の API を手元で受け付けるエミュレーターです。公式ドキュメントによると、AWS のアカウントは要らず、リクエストは AWS に送られません。入れ方と、AWS CLI をエミュレーターに向ける環境変数は、別の記事「AWS EmulatorをUbuntuに入れて使い始める方法」と「AWS EmulatorでS3にファイルを置いて取り出す方法」で扱っています。ここでは、公式ドキュメントにある環境変数を設定したシェルで、aws-emulator -t off で起動したエミュレーターを相手にします。-t off は、エミュレーターが既定で AWS に送る利用状況のデータ(テレメトリー)を切る指定です。

繋がっていれば、aws sts get-caller-identity の ARN のユーザー名が emulator になります(12桁のアカウントIDは置き換えています)。

text
$ aws sts get-caller-identity --query Arn --output text
arn:aws:iam::<12桁のアカウントID>:user/emulator

バケットを作り、バージョニングの状態を get-bucket-versioning で見ました。作った直後は何も表示されません。GetBucketVersioning の API リファレンスによると、一度も有効にも一時停止にもしていないバケットでは、状態(Status)の入っていない応答が返ります。

text
$ aws s3 mb s3://example-bucket
make_bucket: example-bucket
$ aws s3api get-bucket-versioning --bucket example-bucket
$ aws s3api put-object --bucket example-bucket --key before.txt --body before.txt --query VersionId
null

最後の before.txt は、有効にする前に置いたファイルです。あとで、このファイルがどう扱われるかを見ます。

バージョニングを有効にする

有効にするのは put-bucket-versioning です。Status=Enabled を指定すると、get-bucket-versioning で Enabled が返りました。

text
$ aws s3api put-bucket-versioning --bucket example-bucket --versioning-configuration Status=Enabled
$ aws s3api get-bucket-versioning --bucket example-bucket
{
    "Status": "Enabled"
}

S3 のバージョニングの説明によると、バケットのバージョニングは既定では無効で、明示して有効にする必要があります。また、本物の S3 では、保存しているすべての版に通常の料金がかかります。それぞれの版は差分ではなくオブジェクト全体なので、3つの版があれば3つ分の料金です。

上書きすると、前の版が残る

同じキー memo.txt に、中身の違うファイルを2回置きました。有効にしたあとは、put-object の応答に VersionId(版のID)が付きます。

text
$ aws s3api put-object --bucket example-bucket --key memo.txt --body memo-v1.txt
{
    "ETag": "\"402bfe6e3169aec721953986b4f308f2\"",
    "ChecksumCRC64NVME": "lcuxVaWSjsU=",
    "ChecksumType": "FULL_OBJECT",
    "ServerSideEncryption": "AES256",
    "VersionId": "35b6803699f54c75a567326a8689c193"
}
$ aws s3api put-object --bucket example-bucket --key memo.txt --body memo-v2.txt
{
    "ETag": "\"84af6b515089808ec8e5c7ac122ac576\"",
    "ChecksumCRC64NVME": "KIlsgWnDfBU=",
    "ChecksumType": "FULL_OBJECT",
    "ServerSideEncryption": "AES256",
    "VersionId": "5103ecfd88f7396958fc48247b7780f8"
}

キーだけを指定して取り出すと、あとから置いた「その2」が返ります。古い版も含めて一覧を出すのは list-object-versions です。応答には持ち主の ID(Owner)なども入るので、--query で版のID、最新かどうか(IsLatest)、ETag だけを出しています。

text
$ aws s3 cp s3://example-bucket/memo.txt -
その2
$ aws s3api list-object-versions --bucket example-bucket --prefix memo.txt --query "Versions[].{VersionId: VersionId, IsLatest: IsLatest, ETag: ETag}"
[
    {
        "VersionId": "5103ecfd88f7396958fc48247b7780f8",
        "IsLatest": true,
        "ETag": "\"84af6b515089808ec8e5c7ac122ac576\""
    },
    {
        "VersionId": "35b6803699f54c75a567326a8689c193",
        "IsLatest": false,
        "ETag": "\"402bfe6e3169aec721953986b4f308f2\""
    }
]

上書きする前の「その1」が、IsLatest: false の版として残っています。

消すと、削除マーカーが最新の版になる

aws s3 rm で memo.txt を消しました。aws s3 ls には出てこなくなり、キーだけで取り出すと NoSuchKey になります。

text
$ aws s3 rm s3://example-bucket/memo.txt
delete: s3://example-bucket/memo.txt
$ aws s3 ls s3://example-bucket/
2026-11-17 08:33:12          7 before.txt
$ aws s3api get-object --bucket example-bucket --key memo.txt out.txt

aws: [ERROR]: An error occurred (NoSuchKey) when calling the GetObject operation: The specified key does not exist.

ところが、list-object-versions で見ると、2つの版はどちらも残っていて、DeleteMarkers に新しい版が1つ増えていました。これが削除マーカーです。

text
$ aws s3api list-object-versions --bucket example-bucket --prefix memo.txt --query "{Versions: Versions[].[VersionId, IsLatest], DeleteMarkers: DeleteMarkers[].[VersionId, IsLatest]}"
{
    "Versions": [
        [
            "5103ecfd88f7396958fc48247b7780f8",
            false
        ],
        [
            "35b6803699f54c75a567326a8689c193",
            false
        ]
    ],
    "DeleteMarkers": [
        [
            "fa70db36d93d0375850fa9b445bc15e1",
            true
        ]
    ]
}

削除マーカーの説明によると、版のIDを指定しない削除のリクエストを受けると、S3 はオブジェクトを消す代わりに削除マーカーを置き、それが最新の版になります。削除マーカーには中身がありません。キーだけで取り出すと NoSuchKey(HTTP の 404)になるのはこのためです。削除マーカーの版のIDを指定して取り出すと、本物の S3 では 405(Method Not Allowed)を返すと書かれています。エミュレーターでも MethodNotAllowed になりました。

text
$ aws s3api get-object --bucket example-bucket --key memo.txt --version-id fa70db36d93d0375850fa9b445bc15e1 out.txt

aws: [ERROR]: An error occurred (MethodNotAllowed) when calling the GetObject operation: The specified method is not allowed against this resource.

消したあとも、古い版の ID を指定すれば中身を取り出せます。

text
$ aws s3api get-object --bucket example-bucket --key memo.txt --version-id 5103ecfd88f7396958fc48247b7780f8 v2.txt --query VersionId && cat v2.txt
"5103ecfd88f7396958fc48247b7780f8"
その2

消したファイルを戻す(削除マーカーを消す)

消したファイルを戻すには、削除マーカーを、その版のIDを指定して消します。削除マーカーの管理についての公式ドキュメントにも、消したオブジェクトを戻すには削除マーカーを消す、と書かれています。

版の積み重なりの図。同じキーに2回置くと「その2」が最新、「その1」が古い版になる。aws s3 rm で消すと、中身のない削除マーカーが最新になり、キーだけで取り出すと NoSuchKey になる。削除マーカーを版のIDを指定して消すと、「その2」が最新に戻る
memo.txt の版の並びが、消したときと戻したときにどう変わるか
text
$ aws s3api delete-object --bucket example-bucket --key memo.txt --version-id fa70db36d93d0375850fa9b445bc15e1
{
    "DeleteMarker": true,
    "VersionId": "fa70db36d93d0375850fa9b445bc15e1"
}
$ aws s3 cp s3://example-bucket/memo.txt -
その2
$ aws s3api list-object-versions --bucket example-bucket --prefix memo.txt --query "{Versions: Versions[].[VersionId, IsLatest], DeleteMarkers: DeleteMarkers}"
{
    "Versions": [
        [
            "5103ecfd88f7396958fc48247b7780f8",
            true
        ],
        [
            "35b6803699f54c75a567326a8689c193",
            false
        ]
    ],
    "DeleteMarkers": null
}

公式ドキュメントによると、応答の "DeleteMarker": true は、消したものが削除マーカーだったことを表します。削除マーカーがなくなり、「その2」の版が IsLatest: true に戻りました。

注意

--version-id を付け忘れて delete-object を実行すると、削除マーカーは消えません。公式ドキュメントによると、最新の版が削除マーカーになっているキーに、版のIDを付けずに削除を送ると、もう1つ削除マーカーが積まれます。戻すときは、list-object-versions で IsLatest が true の削除マーカーの ID を確かめてから指定してください。

まとめて消したファイルを、まとめて戻す

aws s3 rm --recursive でプレフィックスの下をまとめて消すと、ファイルごとに削除マーカーができます。photos/ に3つのファイルを置いてから消しました。aws s3 ls は何も表示せず、終了コード 1 で終わりました。

text
$ aws s3 cp --no-progress photos/ s3://example-bucket/photos/ --recursive
upload: photos/cat2.jpg to s3://example-bucket/photos/cat2.jpg
upload: photos/cat1.jpg to s3://example-bucket/photos/cat1.jpg
upload: photos/cat3.jpg to s3://example-bucket/photos/cat3.jpg
$ aws s3 rm s3://example-bucket/photos/ --recursive
delete: s3://example-bucket/photos/cat2.jpg
delete: s3://example-bucket/photos/cat1.jpg
delete: s3://example-bucket/photos/cat3.jpg
$ aws s3 ls s3://example-bucket/photos/

最新の版が削除マーカーになっているものは、JMESPath の DeleteMarkers[?IsLatest] で選べます。

text
$ aws s3api list-object-versions --bucket example-bucket --prefix photos/ --query "DeleteMarkers[?IsLatest].{Key: Key, VersionId: VersionId}"
[
    {
        "Key": "photos/cat1.jpg",
        "VersionId": "503847d937df5ec0008ad19f473502e3"
    },
    {
        "Key": "photos/cat2.jpg",
        "VersionId": "b30fdbc7ae9f5810ee1120d132f952e5"
    },
    {
        "Key": "photos/cat3.jpg",
        "VersionId": "7b14214bed50dcd1b1cc8b29102a4ed6"
    }
]

この一覧を {"Objects": [...]} の形にして、複数のオブジェクトをまとめて消す delete-objects に渡すと、削除マーカーを一度に消せます。3つとも戻り、取り出したファイルは置いたものと同じでした。

text
$ aws s3api delete-objects --bucket example-bucket --delete "$(aws s3api list-object-versions --bucket example-bucket --prefix photos/ --query "{Objects: DeleteMarkers[?IsLatest].{Key: Key, VersionId: VersionId}}")" --query "Deleted[].{Key: Key, DeleteMarker: DeleteMarker}"
[
    {
        "Key": "photos/cat1.jpg",
        "DeleteMarker": true
    },
    {
        "Key": "photos/cat2.jpg",
        "DeleteMarker": true
    },
    {
        "Key": "photos/cat3.jpg",
        "DeleteMarker": true
    }
]
$ aws s3 ls s3://example-bucket/photos/
2026-11-17 08:33:29       1000 cat1.jpg
2026-11-17 08:33:29       1000 cat2.jpg
2026-11-17 08:33:29       1000 cat3.jpg
$ mkdir dl && aws s3 cp --no-progress s3://example-bucket/photos/ dl/ --recursive >/dev/null && cmp photos/cat1.jpg dl/cat1.jpg && cmp photos/cat2.jpg dl/cat2.jpg && cmp photos/cat3.jpg dl/cat3.jpg && echo same
same

DeleteObjects の API リファレンスによると、1回のリクエストで指定できるキーは 1,000 個までです。削除マーカーがそれより多いときは、分けて送る必要があります。

上書きする前の版に戻す(古い版をコピーする)

上書きしてしまったファイルを前の内容に戻すときは、古い版を同じキーにコピーします。以前の版を戻す方法の説明にある copy-object の書き方で、--copy-source の末尾に ?versionId= で戻したい版を指定します。

text
$ aws s3api copy-object --bucket example-bucket --key memo.txt --copy-source "example-bucket/memo.txt?versionId=35b6803699f54c75a567326a8689c193" --query "{VersionId: VersionId, CopySourceVersionId: CopySourceVersionId}"
{
    "VersionId": "970317df2faad86951497fa095b668cd",
    "CopySourceVersionId": "35b6803699f54c75a567326a8689c193"
}
$ aws s3 cp s3://example-bucket/memo.txt -
その1
$ aws s3api list-object-versions --bucket example-bucket --prefix memo.txt --query "Versions[].[VersionId, IsLatest, ETag]" --output text
970317df2faad86951497fa095b668cd	True	"402bfe6e3169aec721953986b4f308f2"
5103ecfd88f7396958fc48247b7780f8	False	"84af6b515089808ec8e5c7ac122ac576"
35b6803699f54c75a567326a8689c193	False	"402bfe6e3169aec721953986b4f308f2"

「その1」と同じ ETag を持つ新しい版ができて、最新になりました。「その2」の版も残っているので、あとで「その2」に戻したくなっても、同じ手順で戻せます。公式ドキュメントでは、新しい方の版を版のIDを指定して消し、1つ前の版を最新にするやり方も紹介されています。ただし、次に書くとおり、版を指定して消すと、その版は戻せません。

版のIDを指定して消すと、もう戻せない

delete-object に --version-id を付けると、その版そのものが消えます。応答に DeleteMarker はなく、消した版の ID だけが返りました。そのあと同じ ID で取り出すと NoSuchVersion になります。

text
$ aws s3api delete-object --bucket example-bucket --key memo.txt --version-id 5103ecfd88f7396958fc48247b7780f8
{
    "VersionId": "5103ecfd88f7396958fc48247b7780f8"
}
$ aws s3api get-object --bucket example-bucket --key memo.txt --version-id 5103ecfd88f7396958fc48247b7780f8 out.txt

aws: [ERROR]: An error occurred (NoSuchVersion) when calling the GetObject operation: The specified version does not exist.

版を消すときの説明でも、版のIDを指定した削除は、その版を完全に消すと書かれています。バージョニングで戻せるのは、削除マーカーが積まれただけの「消した」ファイルと、残っている古い版だけです。

有効にする前に置いたファイルは、版のIDが null になる

バージョニングを有効にする前に置いた before.txt は、版のIDが null でした。消すと削除マーカーができ、--version-id null を指定すれば中身を取り出せました。

text
$ aws s3api list-object-versions --bucket example-bucket --prefix before.txt --query "Versions[].[VersionId, IsLatest]" --output text
null	True
$ aws s3 rm s3://example-bucket/before.txt
delete: s3://example-bucket/before.txt
$ aws s3api get-object --bucket example-bucket --key before.txt --version-id null b.txt --query VersionId && cat b.txt
"null"
まえ

有効にする前に置いたファイルでも、有効にしたあとに消したのであれば、削除マーカーを消して戻せました。

text
$ aws s3api delete-object --bucket example-bucket --key before.txt --version-id 9c9ae12a3e22226c543eddd6b0735dce
{
    "DeleteMarker": true,
    "VersionId": "9c9ae12a3e22226c543eddd6b0735dce"
}
$ aws s3 cp s3://example-bucket/before.txt -
まえ

公式ドキュメントのバージョニングの説明にも、有効にする前から置いてあったオブジェクトは版のIDが null で、有効にしても既存のオブジェクトは変わらないと書かれています。

無効には戻せず、一時停止になる

一度有効にしたバケットは、バージョニングのない状態に戻せません。公式ドキュメントでは、バケットの状態は「バージョニングなし(既定)」「有効」「一時停止」の3つで、有効にしたあとは一時停止しかできないと書かれています。エミュレーターで Status=Disabled を指定すると、MalformedXML で断られました。Suspended は受け付けられました。

text
$ aws s3api put-bucket-versioning --bucket example-bucket --versioning-configuration Status=Disabled

aws: [ERROR]: An error occurred (MalformedXML) when calling the PutBucketVersioning operation: The XML you provided was not well-formed or did not validate against our published schema
$ aws s3api put-bucket-versioning --bucket example-bucket --versioning-configuration Status=Suspended
$ aws s3api get-bucket-versioning --bucket example-bucket
{
    "Status": "Suspended"
}

一時停止したバケットに同じキーで2回置くと、どちらも版のIDは null で、残った版は1つだけでした。残った版の ETag は、2回目に置いた s2.txt の MD5 と同じです。1回目の内容は上書きされて、戻せません。

text
$ aws s3api put-object --bucket example-bucket --key suspended.txt --body s1.txt --query VersionId
null
$ aws s3api put-object --bucket example-bucket --key suspended.txt --body s2.txt --query VersionId
null
$ aws s3api list-object-versions --bucket example-bucket --prefix suspended.txt --query "Versions[].[VersionId, IsLatest, ETag]" --output text
null	True	"25aebb5dbdc4e42015acdb569c44fc16"
$ md5sum s1.txt s2.txt
9b5eda1b224332b74bc910482be7a405  s1.txt
25aebb5dbdc4e42015acdb569c44fc16  s2.txt

続けてこのキーを消すと、null の版が消えて、版のIDが null の削除マーカーだけが残りました。中身の版は1つも残っていないので、削除マーカーを消しても戻るものはありません。公式ドキュメントにも、null の版が削除マーカーに置き換わると、その内容は失われると書かれています。

text
$ aws s3api delete-object --bucket example-bucket --key suspended.txt
{
    "DeleteMarker": true,
    "VersionId": "null"
}
$ aws s3api list-object-versions --bucket example-bucket --prefix suspended.txt --query "{Versions: Versions, DeleteMarkers: DeleteMarkers[].[VersionId, IsLatest]}"
{
    "Versions": null,
    "DeleteMarkers": [
        [
            "null",
            true
        ]
    ]
}

公式ドキュメントの一時停止したバケットに置くときと一時停止したバケットで消すときの説明と、同じ結果です。なお、一時停止する前に作られた memo.txt の2つの版は、一時停止したあとも残っていました。

版が残ったバケットを消す

バージョニングを使ったバケットは、aws s3 rb --force では消しきれません。最新の版を消そうとするだけで、BucketNotEmpty で失敗しました。この時点では一時停止中なので、before.txt の null の版は消えて、削除マーカーに置き換わります。

text
$ aws s3 rb s3://example-bucket --force
delete: s3://example-bucket/photos/cat3.jpg
delete: s3://example-bucket/before.txt
delete: s3://example-bucket/memo.txt
delete: s3://example-bucket/photos/cat1.jpg
delete: s3://example-bucket/photos/cat2.jpg
remove_bucket failed: s3://example-bucket An error occurred (BucketNotEmpty) when calling the DeleteBucket operation: The bucket you tried to delete is not empty. You must delete all versions in the bucket.

バケットを消すには、版と削除マーカーをすべて、版のIDを指定して消します。ここでも delete-objects を使いました。版が5つ(memo.txt が2つ、photos/ が3つ)、削除マーカーが6つ(suspended.txt の1つと、rb --force が置いた5つ)あり、どちらも消えてから rb が通りました。

text
$ aws s3api list-object-versions --bucket example-bucket --query "{Versions: length(Versions || \`[]\`), DeleteMarkers: length(DeleteMarkers || \`[]\`)}"
{
    "Versions": 5,
    "DeleteMarkers": 6
}
$ aws s3api delete-objects --bucket example-bucket --delete "$(aws s3api list-object-versions --bucket example-bucket --query "{Objects: Versions[].{Key: Key, VersionId: VersionId}}")" --query "length(Deleted)"
5
$ aws s3api delete-objects --bucket example-bucket --delete "$(aws s3api list-object-versions --bucket example-bucket --query "{Objects: DeleteMarkers[].{Key: Key, VersionId: VersionId}}")" --query "length(Deleted)"
6
$ aws s3 rb s3://example-bucket
remove_bucket: example-bucket

エミュレーターはリソースをメモリーに置き、止めると消すので、テストのあとにこの片付けをしなくても、次に起動したときは空の状態から始まります。公式ドキュメントによると、本物の S3 でも版のIDを指定した削除は版を完全に消すので、同じコマンドを実行すると、残しておきたかった古い版まで消えます。対象のバケットとアカウントを確かめてから実行してください。

​Posted by 86