◀ 3.

RequestThrottledの確認手順|旧PA-APIとAWS SDKの再試行

▶

RequestThrottledは要求が抑制されたことを示すエラーです。ただし、このページの旧PA-APIの文言と、S3等の一般AWSサービスの例は別です。対象API、正式なエラーコード、SDKの再試行回数を確認してから負荷を下げます。

要求不備や認証と再試行候補を分け、待機と試行数を制限する図

対象APIと提供状況を先に確認

2026年10月確認。PA-API 5も公式の廃止案内の対象です。旧キーの変更や再試行だけで利用を再開する案内ではありません。現在の連携はCreators APIの移行ガイドを確認し、専用資格情報とOAuth、要求/応答の変更を照合します。一般AWSサービスの署名/SDKと混用しないでください。

親のエラー一覧から他の個別症状を選択できます。以下の旧サンプルを現行APIの完成実装や実通信済みの例とは扱いません。

SDKの回数を増やす前の確認

  1. 旧PA-APIか一般AWSサービスかを特定し、秒/日/アカウント/リソースのどの制限かを確認する。
  2. 初回込みの試行数を記録する。3試行は初回1回と最大2再送であり、必ず3回追加送信する意味ではない。
  3. adaptiveはクライアントを共有する他リソースの初回送信にも影響し得る。すべての用途の既定推奨にしない。
  4. 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 = AWS API のレート制限に引っかかった状態
  • 原因: 短時間に大量リクエスト / アカウントレベル上限 / 特定 API のバースト制限
  • 対処: 指数バックオフ (Exponential Backoff) + ジッター付きリトライ
  • SDKの既定値は言語・版・モード・設定元で異なる。初回込みの試行数と追加リトライ数を区別する
  • 根本対策: バッチ API 利用 / 並列度制限 / Service Quotas で上限緩和申請

エラー内容

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で必ず増やせるわけではありません。以下は一般的な画面手順の参考です:

  1. AWS コンソール → Service Quotas を開く
  2. 該当サービス(例: EC2)を選択
  3. 該当クォータ(例: API requests per second)を選択
  4. 「クォータの引き上げをリクエスト」
  5. 可否・承認時間はサービス/対象クォータ次第で、所要時間を保証しない

サービス別の主な制限

サービス制限の例緩和方法
S3少なくとも3,500書込系/5,500 GET・HEAD毎秒/prefixという性能案内。固定上限ではない段階的なスケール中の503 SlowDownやアクセス分布を確認
DynamoDBWCU/RCU、パーティション 1000 WCU 制限キー設計でホット回避 + Auto Scaling
STS AssumeRoleアカウント単位の TPS★ 認証情報キャッシュ
EC2 APIAPI ごとに別個の 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や認証不備を無条件に再送しません。

子ページ

子ページはありません

同階層のページ
  1. Error 400 : Bad Request Parameter Operation is missing
  2. MissingParameter. The request must contain the parameter Signature.
  3. RequestThrottled. AWS Access Key ID: ... . You are submitting requests too quickly
  4. 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.
  5. failed to open stream: HTTP request failed! HTTP/1.1 503 Service Unavailable

最近更新/作成されたページ