このページは、Queues Cloudflare API を使うときに Queues が返すエラーコードをまとめています。
JavaScript APIs では、Queues の操作は catch できる例外を投げます。エラーコードは message プロパティの末尾に含まれます。
try {
await env.MY_QUEUE.send("message", { delaySeconds: 999999 });
return new Response("Sent message to the queue");
} catch (error) {
console.error(error);
return new Response("Failed to send message to the queue", { status: 500 });
}Cloudflare API via HTTP では、レスポンスに message と code の両方を持つ errors オブジェクトが含まれます。
{
"errors": [
{
"code": 7003,
"message": "No route for the URI",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"messages": [
"string"
],
"success": true
}| エラーコード | エラー | 詳細 | 推奨する対応 |
|---|---|---|---|
| 10104 | QueueNotFound | キューが存在しません | List Queues エンドポイント で queue_id の存在を確認します |
| 10106 | Unauthorized | 権限のないリクエストです | 現在のユーザーに、そのキューへプッシュする権限があることを確認します。 |
| 10107 | QueueIDMalformed | リクエスト URL のキュー ID が、有効なキュー識別子ではありません | queue_id が英数字だけであることを確認します。 |
| 10201 | ClientDisconnected | リクエスト処理中にクライアントが切断しました | タイムアウトを延ばし、メッセージ送信をリトライしてください。 |
| 10202 | BatchDelayInvalid | バッチ遅延が無効です | batch_delay が 1 秒から 86400 秒の範囲内であることを確認します |
| 10203 | MessageMetadataInvalid | メッセージメタデータが無効です(無効なコンテンツタイプと無効な遅延を含みます) | contentType が text、bytes、json、v8 のいずれかであることを確認します。メッセージ遅延が 最大 24 時間 を超えないことを確認します |
| 10204 | MessageSizeOutOfBounds | メッセージサイズが範囲外です | メッセージサイズが 0 から 128 KB の範囲内であることを確認します |
| 10205 | BatchSizeOutOfBounds | バッチサイズが範囲外です | バッチサイズが 0 から 256 KB の範囲内であることを確認します |
| 10206 | BatchCountOutOfBounds | バッチ件数が範囲外です | バッチ件数が 0 から 100 メッセージの範囲内であることを確認します |
| 10207 | JSONRequestBodyInvalid | リクエストの JSON 本体が想定スキーマと一致しません | JSON 本体が想定スキーマと一致することを確認します |
| 10208 | JSONRequestBodyMalformed | リクエスト本体が有効な JSON ではありません | REST API のリクエスト本体が無効です。追加の詳細はエラーメッセージを確認します。 |
| エラーコード | エラー | 詳細 | 推奨する対応 |
|---|---|---|---|
| 10250 | QueueOverloaded | キューが過負荷です | キューへのメッセージ送信を一時的に控えます。 |
| 10251 | QueueStorageLimitExceeded | キューのストレージ上限を超えました | キューをパージ するか、バックログの処理が終わるまで待ちます |
| 10252 | QueueDisabled | キューが無効です | キューの一時停止を解除 します |
| 10253 | FreeTierLimitExceeded | Free プランの上限を超えました | Workers Paid にアップグレードします |
| エラーコード | エラー | 詳細 |
|---|---|---|
| 15000 | UnknownInternalError | 不明なエラーです |