レート制限
ある顧客の利用によって他の顧客に悪影響が及ばないことを保証するため、レート制限を適用しています。連携コードにバグがあると、短時間に過剰な数のリクエストが送信され、請求額が過度に高くなったり、キューでの待ち時間が長くなったりする可能性があります。
Assembly には、次の 3 つの制限があります。
- 顧客は、1 分間に最大 250 件の Assemblies を作成できます。
- デフォルトでは、各 Workspace で、リージョンごとに最大 2,500 件の Assemblies を同時に実行できます。
- デフォルトでは、1 つの Assembly は、アップロードに最大 8 時間、その後の実行にさらに最大 8 時間を費やすことができます。これらのフェーズの制限は互いに独立しているため、開始から終了までの存続期間は 16 時間近くになる場合があります。
これまでの経験では、これらの上限は最上位レベルの利用にも対応できていますが、エンタープライズアカウントでさらに高い上限が必要な場合は、お問い合わせいただけます。
これらの制限は、主に、他の顧客の「無限ループ」のようなプログラミング上のバグから顧客を保護するために設けられています。
作成数または同時実行数の上限に達した顧客には、RATE_LIMIT_REACHED エラーと HTTP ステータスコード
429 が返されます。このエラーの JSON ペイロードには info.retryIn プロパティが含まれており、リクエストを再試行する前に推奨されるバックオフの待機時間を秒数で示します。この待機時間が経過した後に、同時実行枠が利用可能になることを保証するものではありません。公式 SDK のいずれかを使用している場合は、この値に基づく適切なバックオフと再試行がすでに組み込まれています。
JSON ペイロードの例を次に示します。
{
"error": "RATE_LIMIT_REACHED",
"message": "Request limit reached",
"info": {
"retryIn": 41
}
}
Assembly のアップロードまたは実行の制限時間を超過した場合は、扱いが異なります。この場合は、Assembly Status に
ASSEMBLY_EXPIRED が記録されます。ステータスレスポンスでは HTTP 200 が使用される場合があるため、HTTP の成功を処理の成功とみなすのではなく、その error フィールドを確認してください。バックオフを行っても、期限切れの Assembly は再開されません。入力ファイルをまだ復元できる場合は、Assembly をリプレイして、新しい Assembly を開始してください。
高頻度リクエストのレート制限
上記のレート制限に加えて、過度に高頻度なリクエストを抑止するための、別のレート制限の仕組みもあります。このレート制限は、次のいずれかの場合に適用されます。
- 1 つのクライアントから同時に開かれている TCP 接続が多すぎる場合
- 1 つのクライアントから直近 10 秒間に開かれた TCP 接続が多すぎる場合
- 1 つのクライアントからのリクエストで、直近 10 秒間に HTTP エラーコードが発生した回数が多すぎる場合
- 1 つのクライアントから直近 10 秒間に送信された HTTP リクエストが多すぎる場合
これらの場合、クライアントには HTTP ステータスコード 429 が返され、レスポンスには次の JSON ペイロードが含まれます。
{
"error": "429 Too Many Requests",
"hostname": "morven.transloadit.com",
"message": "You have sent too many requests in a given amount of time. "
}