副作用を重複させずにZapを再試行する

Zapierのタスクが失敗しても、dosyaが書き込みを拒否したとは限りません。受け付け後にネットワークが失敗した場合、再実行で冪等でない操作が重複することがあります。安全な判断は個々のdosya操作によって異なります。

手順

1. 失敗した実行を開き、実行ID、dosyaのステップ、入力ファイルまたは対象ID、時刻、ステータス、機密情報を除いたエラーを記録してください。まだZap全体を再試行しないでください。
2. 送信先ワークスペースで期待した結果を確認してください。失敗した実行の時間帯において、名前だけでなく安定したファイルID、名前、対象フォルダー、または返された共有URLを照合してください。
3. Upload Fileでは同じZap実行の再実行は決定的なUUIDのIdempotency-Keyによって保護されます。ワンショットアップロードルートは別のバージョンを作らず同じ結果を再取得します。
4. この保証を新しいZap実行やCreate Share Linkに適用しないでください。共有の作成には同等のZap実行の冪等性保護がないため、成否が不明な最初のリクエストですでに有効なリンクが作成されている可能性があります。
5. 結果がすでにある場合は作成を再実行せず、記録したIDまたはURLで後続に進んでください。結果がなく、エラーで拒否が証明できる場合は失敗したステップだけを再試行してください。
6. 復旧後は意図した成果物が1つであることを確認し、余分なものがないか調べてください。意図しない共有リンクは失効させてください。重複ファイルは、後続ステップがそのIDを参照していないことを確認するまで削除しないでください。

直接のUpload File操作は50 MiB（52,428,800バイト）までです。大きい入力はUpload File From URLの使用を案内して失敗します。容量による拒否は確定しているため安全に修正できますが、書き込み後のタイムアウトでは成否が不明なままです。

期待される結果

復旧したワークフローは意図した副作用を1つ生成します。同じ実行のUpload File再試行は冪等性キーを再利用し、成否が不明な共有の作成や新しい実行の書き込みは手動再実行前にdosyaで確認します。

関連ガイド

• dosyaをZapierに接続する
• Zapierの問題を解決する