配達ポリシーとは？
ハトは配達を担当する従業員です。配達ポリシーは、ハトが従うタイムアウト・再試行・HTTPの設定・サイズ上限をまとめた共有設定です。各Letterで使用するポリシーを選択します。
ハトの配達方法を決める
HTTPバージョン
初期設定はHTTP/2です。HTTP/1.1への切り替えが可能です。HTTP/3ではQUICを有効にし、対応する旧バージョンへの切り替えも可能です。希望設定どおりのバージョンをサーバーが使うとは限りません。
2つのタイムアウト
接続タイムアウトはサーバーへの接続待ちを制限します。レスポンスタイムアウトは応答待ちを制限します。遅い配達を無期限に待たず、送信先に合った値を選びましょう。
再試行ポリシー
追加の試行を最大3回まで選び、再試行の対象となる接続エラーやHTTPステータスを指定します。再試行回数はリダイレクトを含むLetter全体で共有され、失敗したホップだけを再試行します。
ペイロードの上限
リクエストとレスポンスのヘッダー・ボディの上限を設定します。配達ポリシーのボディ上限はプランより小さくできますが、プランの最大値を超えることはできません。
一度作って、上手に再利用
- 配達ポリシーを作成します。
ダッシュボードの配達ポリシー欄で作成します。特定のURLではなく、「検証用API」などの用途が分かる名前を付けましょう。
- Letterに割り当てる。
各Letterflowコンポーネントで配達ポリシーを選択します。配達ポリシーはリージョンに依存せず、各Letterで実行場所を選びます。
- 編集前に共有設定を確認する。
変更は今後の配達に適用されます。受理済み実行は記録済み設定を保持します。ポリシーを削除してもLetterflowコンポーネントは残ります。再実行前に別のポリシーを選択してください。
配達ポリシーのバッジは選択したHTTPバージョンを示します。Letterboxで結果を開くと、最終レスポンスで交渉された「使用したHTTPバージョン」を確認できます。
状態を変更するリクエストの再試行は、処理の重複を起こすことがあります。利用できる場合は送信先の冪等性の仕組みを使いましょう。