HTTP 429 Too Many Requests Retry とは?

HTTP 429 Too Many Requests Retry の解説と、CI/CD やデプロイで見かけたときの意味。

HTTP 429 は、一定のウィンドウ内にリクエストを送りすぎてレート制限を受けていることを意味します。

意味するところ

429 は、サーバーがペースを落とすよう求めるもので、多くの場合どれだけ待つべきかを示す Retry-After header を伴います。本質的に一時的です。

CI/CD で見かけるとき

CI は、負荷のかかったパッケージレジストリ、Docker Hub、API から 429 を受け取ります。Retry-After を尊重して backoff してください。Latchkey のような自己修復型の managed runner は、レート制限を受けた step を auto-retry するため、短時間の 429 で build が失敗することはありません。

重要なポイント

• 429 はレート制限を受けていることを意味する。
• Retry-After header を尊重する。
• 一時的なもの。auto-retry/backoff で解決する。

関連ガイド