← Cloudflare Queues / queues / reference
Коды ошибок
На этой странице описаны коды ошибок, возвращаемые Queues при использовании Cloudflare API для Queues.
Как возвращаются ошибки
Для JavaScript API, операции Queues выбрасывают исключения, которые можно перехватить. Код ошибки указывается в конце 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 через HTTP, ответ будет включать errors объект, у которого есть как message и code поле:
{
"errors": [
{
"code": 7003,
"message": "No route for the URI",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"messages": [
"string"
],
"success": true
}Справочник кодов ошибок
Ошибки на стороне клиента
| Код ошибки | Ошибка | Подробности | Рекомендуемые действия |
|---|---|---|---|
| 10104 | QueueNotFound | Очередь не существует | Проверка наличия queue_id в Эндпойнт List Queues |
| 10106 | Unauthorized | Неавторизованный запрос | Убедитесь, что у текущего пользователя есть право на отправку сообщений в эту очередь. |
| 10107 | QueueIDMalformed | Идентификатор очереди в URL запроса не является допустимым идентификатором очереди | Убедитесь, что queue_id содержит только буквенно-цифровые символы. |
| 10201 | ClientDisconnected | Клиент отключился во время обработки запроса | Рассмотрите возможность увеличения тайм-аута и повторной отправки сообщения. |
| 10202 | BatchDelayInvalid | Недопустимая задержка пакета | Убедитесь, что batch_delay находится в диапазоне от 1 до 86400 секунд |
| 10203 | MessageMetadataInvalid | Недопустимые метаданные сообщения (включая недопустимый тип содержимого и недопустимую задержку) | Убедитесь contentType является одним из text, bytes, json, или v8. Убедитесь, что задержка сообщения не превышает максимум 24 часа |
| 10204 | MessageSizeOutOfBounds | Размер сообщения вне допустимых пределов | Убедитесь, что размер сообщения находится в диапазоне от 0 до 128 КБ |
| 10205 | BatchSizeOutOfBounds | Размер пакета вне допустимого диапазона | Убедитесь, что размер пакета находится в диапазоне от 0 до 256 КБ |
| 10206 | BatchCountOutOfBounds | Количество сообщений в пакете вне допустимого диапазона | Убедитесь, что количество сообщений в пакете находится в диапазоне от 0 до 100 |
| 10207 | JSONRequestBodyInvalid | Тело запроса JSON не соответствует ожидаемой схеме | Убедитесь, что тело JSON соответствует ожидаемой схеме |
| 10208 | JSONRequestBodyMalformed | Тело запроса не является допустимым JSON | REST API тело запроса недействительно. Дополнительные сведения см. в сообщении об ошибке. |
ошибки типа 429
| Код ошибки | Ошибка | Подробности | Рекомендуемые действия |
|---|---|---|---|
| 10250 | QueueOverloaded | Очередь перегружена | Временно приостановить отправку сообщений в очередь. |
| 10251 | QueueStorageLimitExceeded | Превышен лимит хранилища очереди | Очистка очереди либо дождаться, пока очередь обработает накопившиеся сообщения |
| 10252 | QueueDisabled | Очередь отключена | Unpause queue |
| 10253 | FreeTierLimitExceeded | Превышен лимит бесплатного тарифа | Перейти на Workers Paid |
ошибки типа 500
| Код ошибки | Ошибка | Подробности |
|---|---|---|
| 15000 | UnknownInternalError | Неизвестная ошибка |