
Amazon Cognito のポイントインタイムリカバリ(PITR)で削除したユーザーを復旧してみた
はじめに
2026年11月18日に、Amazon Cognito がポイントインタイムリカバリ(PITR)に対応しました。
PITR は、ユーザープールのユーザーデータを過去の時点の状態へ戻す機能です。この記事では、Essentials プランのユーザープールでユーザーとグループを削除・変更し、AWS CLI で復旧しました。
前提
PITR は Essentials と Plus のユーザープールで自動的に有効になります。復旧ポイントに指定できる範囲は、Essentials が過去1日、Plus が過去14日です。
AWS CLI は 2.41.1 を使いました。
IAM ポリシーでは、ユーザープールのリソースに対する次の5つのアクションを許可する必要があります。AmazonCognitoPowerUser マネージドポリシーにはすべて含まれています。
cognito-idp:InitiatePointInTimeRecovery
cognito-idp:DescribePointInTimeRecovery
cognito-idp:StartPointInTimeRecovery
cognito-idp:CancelPointInTimeRecovery
cognito-idp:ListPointInTimeRecoveries
検証用データ
ユーザー alice、bob、carol、dave をグループ admins、editors とともに作成し、その後に次の操作をしました。
| ユーザー | 作成時の状態 | 作成後の操作 |
|---|---|---|
| alice | グループ admins、TOTP MFA | 削除 |
| bob | グループ editors | 削除 |
| carol | グループなし | name を carol-updated に更新、パスワードを変更 |
| dave | グループなし | 変更なし |
| eve | 存在しない | 作成(グループ temp) |
| frank | 存在しない | 作成 |
グループは、その後 editors を削除し、temp を作成しました。
プールとアプリクライアントの作成コマンド
Essentials を指定してユーザープールを作成し、TOTP MFA を OPTIONAL で有効にしました。
aws cognito-idp create-user-pool --pool-name pitr-verify-1119 --user-pool-tier ESSENTIALS --deletion-protection INACTIVE
aws cognito-idp set-user-pool-mfa-config --user-pool-id <USER_POOL_ID> --mfa-configuration OPTIONAL --software-token-mfa-configuration Enabled=true
aws cognito-idp create-user-pool-client --user-pool-id <USER_POOL_ID> --client-name pitr-client --no-generate-secret --explicit-auth-flows ALLOW_USER_PASSWORD_AUTH ALLOW_REFRESH_TOKEN_AUTH
復旧の手順
復旧ポイントの指定とプレビュー
initiate には、復旧ポイントを UTC(末尾 Z)のタイムスタンプで渡します。現在から15分以上前の時刻を指定する必要があります。今回は、ユーザー4名とグループの作成直後の時刻を指定しました。
aws cognito-idp initiate-point-in-time-recovery --user-pool-id <USER_POOL_ID> --restore-timestamp <RESTORE_TIMESTAMP_UTC>
{
"Restoration": {
"RestoreId": "<RESTORE_ID>",
"RestoreStatus": "PREVIEW_GENERATING",
"RestoreTimestamp": "2026-11-19T11:25:10+09:00",
"TriggerTimestamp": "2026-11-19T11:51:12.629000+09:00"
}
}
以降の describe、start には、この応答の RestoreId を渡します。
RestoreStatus が PREVIEW_GENERATED になるまで、initiate から約16分かかりました。
describe で、プレビューの件数を確認します。
aws cognito-idp describe-point-in-time-recovery --user-pool-id <USER_POOL_ID> --restore-id <RESTORE_ID>
{
"Restoration": {
"RestoreId": "<RESTORE_ID>",
"RestoreStatus": "PREVIEW_GENERATED",
"RestoreTimestamp": "2026-11-19T11:25:10+09:00",
"TriggerTimestamp": "2026-11-19T11:51:12.629000+09:00",
"RestorePreview": [
{
"Entity": "Passkeys",
"CreateCount": 0,
"UpdateCount": 0,
"DeleteCount": 0
},
{
"Entity": "User MFAs",
"CreateCount": 1,
"UpdateCount": 0,
"DeleteCount": 0
},
{
"Entity": "Users",
"CreateCount": 2,
"UpdateCount": 1,
"DeleteCount": 2
},
{
"Entity": "Groups",
"CreateCount": 1,
"UpdateCount": 0,
"DeleteCount": 1
}
]
}
}
Users の CreateCount は削除済みユーザーの再作成、DeleteCount は復旧ポイント後に作ったユーザーの削除の件数です。実際の差分は次のとおりです。
| 項目 | 件数 | 実際の差分 |
|---|---|---|
| Users 作成 | 2 | alice、bob の再作成 |
| Users 更新 | 1 | carol |
| Users 削除 | 2 | eve、frank |
| Groups 作成 | 1 | editors |
| Groups 削除 | 1 | temp |
| User MFAs 作成 | 1 | alice の TOTP |
| Passkeys | すべて 0 | なし |
admins は alice の削除でメンバーが減りましたが、Groups の UpdateCount は 0 です。
プレビュー確認中の動作
PREVIEW_GENERATED の間に、ユーザープールへの書き込み、読み取り、サインインを実行した結果です。
| 操作 | リクエストの種類 | 結果 |
|---|---|---|
| AdminCreateUser、AdminUpdateUserAttributes、CreateGroup | 署名付きリクエスト | ValidationException: Cannot modify user pool resources while point-in-time recovery is in progress. |
| ListUsers、AdminGetUser | 署名付きリクエスト | 成功 |
| InitiateAuth(MFA を設定していない dave) | ユーザーからのリクエスト | 成功 |
| UpdateUserAttributes、ChangePassword、SignUp | ユーザーからのリクエスト | ForbiddenException: A required service is currently unavailable. If this issue persists, contact your administrator. |
ユーザーからのリクエストのエラーメッセージからは、復旧中であることが分かりません。
復旧の開始
プレビューを確認したら、start を実行します。
aws cognito-idp start-point-in-time-recovery --user-pool-id <USER_POOL_ID> --restore-id <RESTORE_ID>
start の応答で RestoreStatus は RESTORING でした。RESTORE_COMPLETED を初めて確認したのは、start から約70秒後です。
復旧結果
戻ったもの
| 項目 | 復旧ポイント時点 | 復旧直前(変更後) | 復旧後 |
|---|---|---|---|
| alice の sub | 5774ead8… | ユーザーなし | 5774ead8… |
| bob の sub | 47342a18… | ユーザーなし | 47342a18… |
| alice のサインイン | 成功(TOTP のチャレンジあり) | UserNotFoundException | 元のパスワードで成功。復旧ポイント前に登録した TOTP のコードでチャレンジを完了 |
| bob のサインイン | 成功 | UserNotFoundException | 元のパスワードで成功 |
| グループ所属 | alice は admins、bob は editors | alice、bob とも存在しない | alice は admins、bob は editors |
| グループ一覧 | admins、editors | admins、temp | admins、editors |
| carol の name | carol | carol-updated | carol |
| eve | 存在しない | 存在する | UserNotFoundException |
| frank | 存在しない | 存在する | UserNotFoundException |
| dave | 存在する | 変更なし | 変更なし |
変更したパスワードは維持される
Developer Guide の記載どおり、PITR はパスワードの変更を元に戻しません。パスワードを変更したユーザー(carol)は、変更後のパスワードでサインインできました。
まとめ
Amazon Cognito のユーザープールが PITR に対応しました。
従来、操作ミスなどでユーザーデータを復旧するには、独自に用意したバックアップと復旧の仕組みを使うほかありませんでした。復旧したユーザーはパスワードを再設定する必要があり、sub も新しいものになっていました。PITR では、パスワードや sub を維持したまま、指定した時点に戻せるようになりました。
本番環境のユーザーデータの復旧手段として有効ですが、プール設定、アプリクライアント、IdP などは対象外です。また、プレビューの確認中はユーザープールへの書き込みが拒否され、プレビューの生成には今回約16分かかりました。
事前に評価環境などで復旧を試し、影響や所要時間を把握したうえで使うことをおすすめします。







