冪等性（べきとうせい） とは？

例えば「名前を田中にする」は、1回でも3回でも最終的な名前が田中になるよ。一方、「注文を1件追加する」は、重複を防ぐ仕組みがなければ繰り返すたびに増える。同じ操作を何回しても、意図した効果が1回と同じかどうかを見るんだ。

そこは別だよ。削除の1回目に成功、2回目に見つからないと返っても、対象がなくなるという効果は同じ。HTTPの冪等性は、リクエストが意図するサーバーへの効果の話で、記録用のログなどまで同じにする性質ではないんだ。

応答が届かなくても、サーバーでは操作が終わっているかもしれないよ。冪等な操作なら、同じリクエストを再送しても意図した効果が増えない。HTTPではPUTとDELETE、およびGETなどの安全なメソッドを冪等と定義している。ただし、実装がその意味を守る必要があるよ。

APIが冪等キーなどの仕組みを提供していれば、同じ処理の再送を識別できるよ。例えばStripeでは同じキーの再送に保存した結果を返し、パラメーターも照合する。ただしキーを保持する期間などの条件がある。別の注文には新しいキーを使い、APIの仕様を確認しよう。

宣言した状態に近づける考え方は冪等性と関係するけれど、実行のたびに無条件で同じとは限らないよ。設定や実際の状態が変われば計画も変わる。途中の失敗もあるので、Terraformでは変更計画を確認し、失敗の原因を直してから再実行するんだ。