この記事では、AWS を使っているときに表示される 429 というエラーの意味と、その直し方を順を追って説明します。

AWS の 429 とは何か？（公式の定義）

429 は、HTTP標準仕様（RFC 9110）で定められているステータスコードの一つです。

AWS の文脈では、このコードは次のことを意味します。

単位時間あたりのAPIリクエスト数がサービスの上限を超えた。

このエラーが出たときは、慌てずに次の「原因」の節を確認してください。 多くの場合、設定の見直しや手順の確認だけで解決できます。

このエラーが発生する主な原因（起きる理由の整理）

AWS で 429 が出るときに、最もよく見られる原因を挙げます。 自分の状況に当てはまるものを探してみてください。

  • ループ処理の中でAPIを呼び出す間隔を設けていない
  • 複数のプロセスが同時に同じAPIを叩いている

具体的な解決手順とチェックリスト（順番どおりに試す）

上の原因ごとの対処法を、実行できる手順の形でまとめました。 上から順番に試すことで、多くの場合は解決に近づけます。

  1. リトライ処理に「指数バックオフ（待機時間を徐々に延ばす方法）」を組み込む
  2. AWS SDKの標準リトライ機能を有効化する
  3. Service Quotasコンソールから上限の引き上げを申請する

まとめ

AWS の 429 エラーは、上記のいずれかの原因によって発生するケースがほとんどです。 チェックリストを一つずつ確認することで、大半の問題は自力で解決できます。

それでも解決しない場合は、次の方法を試してください。

  • AWS の公式ドキュメントで最新の情報を確認する
  • エラーメッセージの全文をコピーして検索エンジンで調べる
  • 公式のコミュニティフォーラムやサポートに問い合わせる

免責事項：本記事の内容は、執筆時点の公開情報をもとに作成したものです。ソフトウェアの仕様は予告なく変更されることがあります。最新の情報は各ツールの公式サポートページをご確認ください。本記事の情報を利用した結果生じたいかなる損害についても、著者および運営者は責任を負いかねます。