RequestThrottledは要求が抑制されたことを示すエラーです。ただし、このページの旧PA-APIの文言と、S3等の一般AWSサービスの例は別です。対象API、正式なエラーコード、SDKの再試行回数を確認してから負荷を下げます。
対象APIと提供状況を先に確認
2026年10月確認。PA-API 5も公式の廃止案内の対象です。旧キーの変更や再試行だけで利用を再開する案内ではありません。現在の連携はCreators APIの移行ガイドを確認し、専用資格情報とOAuth、要求/応答の変更を照合します。一般AWSサービスの署名/SDKと混用しないでください。
親のエラー一覧から他の個別症状を選択できます。以下の旧サンプルを現行APIの完成実装や実通信済みの例とは扱いません。
SDKの回数を増やす前の確認
- 旧PA-APIか一般AWSサービスかを特定し、秒/日/アカウント/リソースのどの制限かを確認する。
- 初回込みの試行数を記録する。3試行は初回1回と最大2再送であり、必ず3回追加送信する意味ではない。
- adaptiveはクライアントを共有する他リソースの初回送信にも影響し得る。すべての用途の既定推奨にしない。
- SDKと独自ループのどちらが再送するかを決め、操作の冪等性・全体期限と失敗時の扱いを確認する。
公式資料: AWS SDK再試行(2026年の新挙動はopt-in条件も確認)、JavaのRetryStrategy、Boto3の試行数。
性能値はS3、DynamoDB、Lambda、増枠はService Quotasの対象条件を確認します。DynamoDBの表の容量値は項目サイズ・読取整合性・物理パーティション等を伴う値で、表全体の一律TPSではありません。
通信せず確認できる再試行の判断例
次はPHP 8系の学習用ポリシー関数です。HTTP通信・sleepは行わず、返す整数は待機秒数、nullは停止または後回しを意味します。0秒も有効なのでif ($delay)ではなく、$delay !== nullで判定します。この例はGET/HEADの429/503だけを候補とし、初回を含む最大3試行、待機は30秒以内に制限します。AWS SDKのすべてのエラー分類を置き換える関数ではありません。
<?php
// Policy only: no HTTP calls, sleep, credentials or framework configuration.
// null means stop/defer; an integer is a delay in seconds, including zero.
function retryDelay(string $method, int $status, ?string $retryAfter, int $attempt, int $now): ?int
{
if (!in_array(strtoupper($method), ['GET', 'HEAD'], true)
|| !in_array($status, [429, 503], true) || $attempt < 1 || $attempt >= 3) {
return null;
}
if ($retryAfter === null) {
return random_int(1, 2 ** ($attempt - 1));
}
if (strlen($retryAfter) > 128 || preg_match('/[\x00-\x08\x0a-\x1f\x7f]/', $retryAfter)) {
return null;
}
$value = trim($retryAfter, " \t");
if (preg_match('/^[0-9]+$/D', $value)) {
$digits = ltrim($value, '0');
if (strlen($digits) > 2 || (int) $digits > 30) { return null; }
return (int) $digits;
}
// This example accepts IMF-fixdate only. Other date forms are deferred.
$date = DateTimeImmutable::createFromFormat('!D, d M Y H:i:s \G\M\T', $value, new DateTimeZone('UTC'));
if (!$date || $date->format('D, d M Y H:i:s \G\M\T') !== $value) { return null; }
$delay = max(0, $date->getTimestamp() - $now);
return $delay <= 30 ? $delay : null;
}
Retry-Afterが30秒を超えたら30秒へ短縮して再送せず、停止/延期します。HTTP-dateはIMF-fixdateだけ受理し、旧形式の日付や不正値は安全側に停止します。ヘッダーなしの小さなジッターは説明用で、実運用には接続/応答タイムアウト・全体期限・キュー・SDK自身の再試行との調整が必要です。POST等はこの関数では再送しません。安全に再送できる更新操作はサービスの冪等性仕様を別途設計してください。
待機値の根拠: RFC 9110のRetry-After。外部APIへの実通信やSDKの内部動作を検証した例ではありません。
| この記事の要点 |
|
エラー内容
RequestThrottled: Request was throttled.
AWS Access Key ID: AKIAXXXXXXXXXXXXXXXX
You are submitting requests too quickly. Please slow down.
Error Code: Throttling / ThrottlingException / TooManyRequestsException / RequestLimitExceeded
HTTP Status: 400 / 429 / 503
上は複数サービスのエラー名/HTTP状態を並べた説明用資料で、1つの実応答ではありません。抑制の粒度・増枠可否・再試行分類はAPIごとに異なるため、すべて同じ対処とはしません。
原因の切り分け
| 原因 | 確認 | 対処 |
|---|---|---|
| 短時間バースト | CloudWatch でリクエスト数のスパイク確認 | 指数バックオフリトライ |
| 並列度過多 | ECS / Lambda 同時実行数を確認 | 並列度制限 / バッチ化 |
| アカウント上限到達 | Service Quotas で現在値確認 | 上限緩和申請 |
| 特定 API の制限(例: STS AssumeRole) | 該当 API ドキュメントの TPS 確認 | キャッシュ / 集約 |
| 他テナント・他リソースとの共有 | S3 / DynamoDB のホットパーティション | キー分散 / リシャード |
対処1: AWS SDK のリトライ設定を強化
SDKの再試行機能は、使用言語・版・モード・設定の優先順位を確認してから調整します。回数を増やすほどよいとは限りません。SDK側と独自ループを重ねると要求数と待機が増幅します。
AWS SDK for Java (v2)
次は旧設定例として保持する未実行断片です。 RetryPolicyのbuilder APIや版との互換性は実コンパイルしていません。元コメントの「既定3→10」「ADAPTIVE推奨」を一律の推奨としないでください。現行版は公式のRetryStrategy資料を確認します。
import software.amazon.awssdk.core.retry.RetryPolicy;
import software.amazon.awssdk.core.retry.RetryMode;
import software.amazon.awssdk.core.client.config.ClientOverrideConfiguration;
S3Client.builder()
.overrideConfiguration(ClientOverrideConfiguration.builder()
.retryPolicy(RetryPolicy.builder()
.numRetries(10) // 既定 3 → 10
.retryMode(RetryMode.ADAPTIVE) // ★ 推奨
.build())
.build())
.build();
// RetryMode:
// LEGACY - 旧デフォルト
// STANDARD - 新デフォルト(指数バックオフ + ジッター)
// ADAPTIVE - スロットリング検知時に自動でレート抑制
AWS SDK for Python (boto3)
Config内のmax_attemptsは追加リトライ数ですが、設定ファイルや環境変数の同名設定は初回を含む総試行数です。Configではtotal_max_attemptsを使うと初回込みを明示できます。下のadaptiveを一律の既定にせず、対象版の公式仕様を確認してください。ここではSDK通信を実行していません。
import boto3
from botocore.config import Config
config = Config(
retries = {
'max_attempts': 10,
'mode': 'adaptive', # standard / adaptive / legacy
}
)
s3 = boto3.client('s3', config=config)
AWS SDK for JavaScript (v3)
次は旧設定例の比較資料です。maxAttemptsの数は初回を含む試行数で、元コメントの「最大リトライ」とは区別します。下の遅延式は線形で、指数バックオフやジッターそのものではありません。SDK/配布版の実行は未検証です。
import { S3Client } from '@aws-sdk/client-s3';
import { ConfiguredRetryStrategy } from '@aws-sdk/util-retry';
const client = new S3Client({
maxAttempts: 10,
retryStrategy: new ConfiguredRetryStrategy(
10, // 最大リトライ
(attempt) => 100 + attempt * 1000 // バックオフ ms
),
});
対処2: 自前で指数バックオフ実装
下の旧PythonループはSDKの自動再試行に外側の再送を重ねます。要求増幅、全体期限、操作の冪等性を確認せず追加しないでください。旧コードは実行せず比較用に保持します:
import time
import random
from botocore.exceptions import ClientError
def call_aws_with_backoff(fn, max_retries=5):
"""指数バックオフ + ジッター付きリトライ"""
for attempt in range(max_retries):
try:
return fn()
except ClientError as e:
code = e.response['Error']['Code']
if code in ('Throttling', 'ThrottlingException',
'TooManyRequestsException', 'RequestLimitExceeded',
'RequestThrottled'):
if attempt == max_retries - 1:
raise
# 指数バックオフ + フルジッター
base = 0.5 * (2 ** attempt)
sleep = random.uniform(0, base)
time.sleep(sleep)
continue
raise
raise RuntimeError("max retries exceeded")
# 利用
result = call_aws_with_backoff(lambda: s3.list_objects_v2(Bucket='mybucket'))
対処3: 並列度を制限
次はS3オブジェクトを削除する旧例です。診断のために実行しないでください。 1000並列で必ず失敗/10なら安全/バッチが最強というコメントは保証ではありません。バッチも部分失敗や対象全件の処理を別途確認します。
from concurrent.futures import ThreadPoolExecutor
import boto3
s3 = boto3.client('s3')
# ❌ 1000 並列でスロットリング確定
with ThreadPoolExecutor(max_workers=1000) as ex:
list(ex.map(lambda key: s3.delete_object(Bucket='b', Key=key), keys))
# ✅ 10 並列に制限
with ThreadPoolExecutor(max_workers=10) as ex:
list(ex.map(lambda key: s3.delete_object(Bucket='b', Key=key), keys))
# ✅ バッチ API を使う(最強)
batch = [{'Key': k} for k in keys[:1000]]
s3.delete_objects(Bucket='b', Delete={'Objects': batch})
対処4: Service Quotas で上限緩和
一般AWSサービスでは、対象クォータが調整可能な場合にだけ増枠を検討します。旧PA-APIやCreators APIの枠をService Quotasで必ず増やせるわけではありません。以下は一般的な画面手順の参考です:
- AWS コンソール → Service Quotas を開く
- 該当サービス(例: EC2)を選択
- 該当クォータ(例: API requests per second)を選択
- 「クォータの引き上げをリクエスト」
- 可否・承認時間はサービス/対象クォータ次第で、所要時間を保証しない
サービス別の主な制限
| サービス | 制限の例 | 緩和方法 |
|---|---|---|
| S3 | 少なくとも3,500書込系/5,500 GET・HEAD毎秒/prefixという性能案内。固定上限ではない | 段階的なスケール中の503 SlowDownやアクセス分布を確認 |
| DynamoDB | WCU/RCU、パーティション 1000 WCU 制限 | キー設計でホット回避 + Auto Scaling |
| STS AssumeRole | アカウント単位の TPS | ★ 認証情報キャッシュ |
| EC2 API | API ごとに別個の TPS | バッチ API / 並列度制限 |
| SES | 送信レート(秒間)+ 日次クォータ | SQS でキューイング |
| Lambda | 同時実行の既定案内1,000。新規アカウント等は低い枠の場合もある | 上限緩和申請 / リザーブド同時実行 |
監視: CloudWatch でスロットリングを可視化
下は旧メトリクスメモで、すべてがスロットリング専用指標ではありません。4XXErrorやBounce等をそのまま原因確定に使わず、サービス/操作別の指標とSDK応答コード、再送回数を照合してください。
# 主要サービスのスロットリングメトリクス
DynamoDB : UserErrors, SystemErrors, ThrottledRequests
Lambda : Throttles
API Gateway : 4XXError (429含む)
SQS : NumberOfMessagesSent + エラー
SES : Bounce / Complaint / Send
CloudWatch アラームを設定して通知:
- ThrottledRequests > 0 → Slack 通知
- Lambda Throttles > 10/min → 上限緩和検討
FAQ
Q: リトライしてもずっとスロットリングする
A: アカウント枠だけでなく対象リソースの集中・並列数・他クライアントとの共有・提供状況を確認します。調整可能な一般AWSクォータだけをService Quotasで確認し、再試行数増加を初手にしません。
Q: 並列度を 1 にしてもスロットリングする
A: 他のシステム(同じアカウントの別 Lambda 等)が API を使っていませんか? アカウント全体で共有する制限もあります。
Q: 429 と 503 の違いは?
A: HTTP状態だけで同じ再送対象とは判断できません。AWSは本文内の正式なエラーコードも分類に使います。対象操作の安全な再送可否、待機指示、期限/試行数を確認し、廃止APIや認証不備を無条件に再送しません。
子ページはありません
- Error 400 : Bad Request Parameter Operation is missing
- MissingParameter. The request must contain the parameter Signature.
- RequestThrottled. AWS Access Key ID: ... . You are submitting requests too quickly
- SignatureDoesNotMatch. The request signature we calculated does not match the signature you provided. Check your AWS Secret Access Key and signing method. Consult the service documentation for details.
- failed to open stream: HTTP request failed! HTTP/1.1 503 Service Unavailable
人気ページ
- 1 Eclipseで「サーバーに追加または除去できるリソースがありません。」の原因と対処法
- 2 tomcat の起動 / 停止ログと catalina.log・catalina.out の違い
- 3 JavaScript で base URL を取得する方法|window.location.origin
- 4 YouTube Data API v3 エラー一覧|403・400・404 の原因と対処
- 5 Laravel エラー一覧|500/Blade/DB 接続/ルーティングの代表エラー
- 6 3Dグラフィックスのソフト一覧|Blender・Metasequoiaと用途別の選び方
- 7 Spring Frameworkのアノテーション一覧
- 8 【Spring】@Valueアノテーションとは
- 9 CATALINA_HOME の確認方法 (Linux / Mac)
- 10 【Spring】@Autowiredアノテーションとは
最近更新/作成されたページ
- Visual Studio「デザイナーを表示できません」エラーの原因と対処 2026-10-28 12:06:00
- SSH 認証に失敗しました。再試行してください の対処 2026-10-28 12:06:00
- SSH2 秘密鍵の読み込みに失敗しました の原因と対処 2026-10-28 12:06:00
- TeraTerm のよくあるエラーと対処法完全ガイド — Connection refused / 2026-10-28 12:06:00
- Visual Studio エラー一覧|コンパイルエラー・警告の確認方法と対処 2026-10-28 11:39:57
- Whitelabel Error Page の原因と消し方|Spring Boot のエラーページ 2026-10-28 11:39:57
- Eclipseで「サーバーに追加または除去できるリソースがありません。」の原因と対処法 2026-10-28 11:39:57
- SQL WHERE 句完全ガイド 2026-10-28 11:39:57
- SQL JOIN 完全ガイド (INNER/LEFT/RIGHT/FULL OUTER) 2026-10-28 11:39:57
- tomcat の起動 / 停止ログと catalina.log・catalina.out の違い 2026-10-28 10:24:23
- Tomcat の起動確認方法 5 つ|localhost:8080・ポート・プロセス・ログ 2026-10-28 10:24:23
- Oracle 19c COMMITの使い方: 暗黙コミット・自動確定・応答不明時の確認 2026-10-28 09:59:09
- Oracle 19c DELETE文|削除対象の確認・COMMIT前の判断・ROLLBACKの条件 2026-10-28 09:59:09
- Oracle 19c INSERT文|INSERT ALL・SELECT・RETURNINGとMERGEの使い分け 2026-10-28 09:59:09
- Oracle 19cのトランザクション制御|COMMIT・ROLLBACK・分離レベルと接続設定 2026-10-28 09:59:09