Skip to content
Latchkey

Idempotency Key - CI/CD用語集の定義

idempotency key は、クライアントが指定する一意な識別子 (多くはIdempotency-Keyヘッダー内) で、サーバーが重複したリクエストを検知して無視できるようにします。これにより、リトライされたPOSTは高々1回だけ処理されます。

なぜ重要か

CI jobがtimeout後にdeployや決済のようなAPI呼び出しをリトライする際、idempotency keyは、元のリクエストが実際には成功していた場合に同じアクションが2回起きるのを防ぎます。

関連ガイド