アカウントロックを削除する
DELETE /v1/attack-protection/lockouts/{lockout_id} · 権限 attack-protection:write
未解除のアカウントロックを 1 件削除します。ユーザーはその経路で再びサインインできるようになり、その経路の失敗カウントは最初からやり直しになります。user.unlocked イベント(by = admin)と管理監査記録(user.unlocked、対象はユーザー)が、同じトランザクション内で書き込まれます。実行者はお客様の認証情報です。ユーザーのロックをすべて一度に削除する場合は、POST /v1/users/{user_id}:unlock を使用してください。
リクエスト
| パラメータ | 入力 | 必須 | 説明 |
|---|---|---|---|
lockout_id |
path | はい | ロック ID。lck_ で始まります。 |
レスポンス
204 No Content。ボディはありません。
エラー
すべてのエラーは、安定した code を含む application/problem+json ボディとして返されます。
| HTTP | code |
発生条件 |
|---|---|---|
| 404 | not_found |
この環境に未解除のロックがこの ID で存在しません。存在しなかったか、すでに削除されたか、期限切れになっています(または ID の形式が不正です)。 |
| 401 | unauthenticated |
API キーがない、無効、または失効しています。 |
| 403 | insufficient_permissions |
キーに attack-protection:write 権限がありません。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After に従ってください。 |
| 503 | service_unavailable |
依存先が一時的に利用できません。後で再試行してください。 |
例
curl -X DELETE https://api.eu.keenauth.com/v1/attack-protection/lockouts/lck_01jaz8m5c3f6t9w2y4b7d0g3k6 \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
CLI: keenauth attack-protection lockouts delete lck_01jaz8m5c3f6t9w2y4b7d0g3k6