自前のリトライ関数(Invoke-KsApiパターン)

ステータスコードごとの扱い分け、指数バックオフ、冪等性に応じた再試行可否の判定、エラー本文のログ記録を行うために自前で実装するAPI呼び出しラッパー関数。

概念URI

https://comcomponent.com/knowledge/custom-retry-function/

別名・表記

Invoke-KsApi

最終確認日

2026-08-01

機械可読データ

JSON-LD

この概念が関わる関係

• 自前のリトライ関数(Invoke-KsApiパターン)は指数バックオフを利用します。自前のリトライ関数は、Retry-Afterがない通信エラー時に指数バックオフで待機時間を広げる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• 自前のリトライ関数(Invoke-KsApiパターン)はRetry-Afterヘッダーを利用します。自前のリトライ関数は429応答のRetry-Afterヘッダーを解析し、秒数とHTTP日付形式の両方に対応して待機時間を切り上げて求める / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• 自前のリトライ関数(Invoke-KsApiパターン)はHTTPメソッドの冪等性を前提とします。自前のリトライ関数は、冪等なメソッドか冪等キーがある場合だけ自動再試行を許可し、POSTのような非冪等な要求は再送しない / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• 自前のリトライ関数(Invoke-KsApiパターン)は恒久的なHTTPエラー(401/403/404など)に対する本記事の推奨です。恒久的エラーで即座に止めたい場合や、コード別の扱い・指数バックオフが必要な場合は組み込み機能ではなく自前のリトライ関数が必要になる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• カーソル/オフセット方式のページングは自前のリトライ関数(Invoke-KsApiパターン)を利用します。本記事の実装例のように自前ループで書く場合、カーソル/オフセット方式のページングは自前のリトライ関数Invoke-KsApiを使っている / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典

この概念を扱う記事

• PowerShellでREST APIと連携する ── Invoke-RestMethodの実務(言及)

このページはサイトの知識グラフ(_data/knowledge/)から自動生成されています。誤りの指摘はお問い合わせからお願いします。