Облачная платформаAdvanced

Коды ошибок

Эта статья полезна?
Язык статьи: Русский
Показать оригинал
Страница переведена автоматически и может содержать неточности. Рекомендуем сверяться с английской версией.

В следующей таблице перечислены коды ошибок, которые вы можете встретить при вызове API. Если код ошибки начинается с APIGW возвращается после вызова API, устраните ошибку, обратившись к инструкциям, приведённым в разделе "Error Codes" в Руководство по подписанию запросов API.

Note
  • Для получения подробной информации о кодах ошибок, которые могут возникнуть при управлении API, см. раздел "Error Codes" в API Gateway Справочник API.
  • Если ошибка происходит при использовании APIG, найдите сообщение об ошибке и описание в следующей таблице согласно коду ошибки, например, APIG.0101. Сообщения об ошибках могут измениться без предварительного уведомления.
Таблица 1 Коды ошибок

Код ошибки

Сообщение об ошибке

HTTP Код состояния

Описание

Решение

APIG.0101

API не существует или не был опубликован в окружении.

404

API не существует или не был опубликован в окружении.

  1. Проверьте, корректны ли имя домена, метод запроса или путь, используемые для вызова API.
  2. Проверьте, опубликован ли API.
  3. Проверьте, корректно ли разрешение имени домена.
  4. Проверьте, разрешает ли API OPTIONS запросы между регионами. Если да, включите кросс‑доменные запросы (CORS) для API.

Для получения подробностей см. FAQ.

APIG.0101

API не существует.

404

Метод запроса API не существует.

Проверьте, совпадает ли метод запроса API с методом, определённым в API.

APIG.0103

Бэкенд не существует.

500

Сервис бэкенда не найден.

Обратитесь в техническую поддержку.

APIG.0104

Плагины не существуют.

500

Конфигурации плагинов не найдены.

Обратитесь в техническую поддержку.

APIG.0105

Конфигурации бэкенда не существуют.

500

Конфигурации бэкенда не найдены.

Обратитесь в техническую поддержку.

APIG.0106

Ошибка оркестрации.

400

Произошла ошибка оркестрации.

Проверьте, правильны ли параметры frontend и backend API.

APIG.0107

Пользовательский скрипт lua вызвал неожиданную ошибку.

500

В скрипте Lua произошла неизвестная ошибка.

Обратитесь в техническую поддержку.

APIG.0201

API ошибка запроса.

400

Недействительные параметры запроса.

Проверьте, корректен ли формат запроса.

APIG.0201

Сущность запроса слишком велика.

413

Тело запроса превышает 12 МБ.

Уменьшите размер тела запроса.

APIG.0201

URI запроса слишком велик.

414

URI запроса превышает 32 КБ.

Уменьшите размер URI запроса.

APIG.0201

Заголовки запроса слишком большие.

494

Заголовки запроса слишком большие, потому что один из них превышает 32 KB, или общая длина превышает 128 KB.

Уменьшите размер заголовков запроса.

APIG.0201

Бэкенд недоступен.

502

Бэкенд‑сервис недоступен.

  • Проверьте, доступен ли адрес бэкенда, настроенный для API.
  • Если бэкенд‑сервис — ECS, проверьте, не блокируют ли настроенные правила группы безопасности для ECS запросы API.
  • Проверьте, корректен ли протокол запроса.
  • Проверьте, доступен ли URL бэкенд‑сервиса.

Для подробностей см Вопросы и ответы.

APIG.0201

Тайм‑аут бэкенда.

504

Служба бэкэнда не ответила в течение отведённого времени.

Увеличьте длительность тайм‑аута службы бэкэнда или сократите время обработки.

APIG.0201

Произошла непредвиденная ошибка

500

Произошла внутренняя ошибка.

Обратитесь в техническую поддержку.

APIG.0202

Бэкэнд недоступен

502

Бэкэнд недоступен.

Проверьте, совпадает ли протокол запроса бэкэнда, настроенный для API, с протоколом запроса, используемым службой бэкэнда.

APIG.0203

Тайм‑аут бэкэнда

504

Служба бэкэнда не ответила в течение отведённого времени.

Увеличьте длительность тайм‑аута службы бэкэнда или сократите время обработки.

APIG.0204

Протокол SSL не поддерживается: TLSv1.1

400

Версия протокола SSL не поддерживается.

Используйте поддерживаемые TLS 1.1 и TLS 1.2 (рекомендовано).

APIG.0205

Проверка клиентского сертификата не удалась

400

Не удалось проверить клиентский сертификат.

Проверьте, корректен ли клиентский сертификат.

APIG.0301

Неправильная информация аутентификации IAM.

401

Сведения об аутентификации IAM неверны.

Проверьте, соответствуют ли метод запроса, путь, параметры запроса и тело запроса тем, которые использовались для подписи. Проверьте, правильное ли время клиента. Для подробностей см FAQs.

APIG.0302

Пользователь IAM не уполномочен для доступа к API.

403

Пользователю IAM не разрешено доступ к API.

Проверьте, ограничен ли пользователь черным или белым списком.

APIG.0303

Неверная информация аутентификации приложения.

401

Данные аутентификации приложения неверны.

Проверьте, соответствует ли метод запроса, путь, строка запроса и тело запроса тем, что использовались для подписи; проверьте, правильны ли дата и время на клиенте; For details, see FAQs.

APIG.0304

Приложение не авторизовано для доступа к API.

403

Приложению не разрешено доступ к API.

Проверьте, привязаны ли учетные данные к API/авторизованы ли они.

APIG.0305

Неправильная информация об аутентификации.

401

Информация об аутентификации неверна.

Проверьте, правильна ли информация об аутентификации.

APIG.0306

Доступ к API отклонён.

403

Доступ к API не разрешён.

Проверьте, авторизованы ли вы для доступа к API.

APIG.0307

Токен должен быть обновлён.

401

Токен необходимо обновить.

Получите новый токен из IAM.

APIG.0308

Достигнут порог ограничения.

429

Достигнут порог ограничения.

Повторите попытку после возобновления ограничения. Если достигнуто количество запросов отладочного домена за день, привяжите отдельное доменное имя к сервису, к которому относится API.

APIG.0310

Проект недоступен.

403

Проект в настоящее время недоступен.

Выберите другой проект и повторите попытку.

APIG.0311

Неверная информация об аутентификации отладки.

401

Сведения об аутентификации отладки неверны.

Обратитесь в техническую поддержку.

APIG.0312

Неверная информация об аутентификации сторонних сервисов, сбой аутентификации.

401

Аутентификация не прошла, потому что информация об аутентификации сторонних сервисов неверна.

Проверьте, правильна ли информация об идентификации.

APIG.0313

Неверная информация сторонней аутентификации, ошибки идентичностей

401

Идентичность, включённая в информацию сторонней аутентификации, неверна.

Проверьте, соответствует ли информация об идентичности источнику идентичности в плагине сторонней аутентификации.

APIG.0314

Неверная информация сторонней аутентификации, отказ в доступе

403

Доступ отказан, потому что информация сторонней аутентификации неверна.

Обратитесь в техническую поддержку, чтобы проверить, является ли запрос сервисным запросом. Если да, увеличьте порог brute force для плагина сторонней аутентификации.

APIG.0401

Неизвестный IP-адрес клиента.

403

IP-адрес клиента не может быть определён.

Обратитесь в техническую поддержку.

APIG.0402

IP-адрес не авторизован для доступа к API.

403

IP-адрес не разрешён для доступа к API.

Проверьте, ограничен ли IP-адрес контролем доступа API.

APIG.0403

IP-адрес недоступен.

403

IP-адрес не разрешён для доступа к API.

Проверьте, ограничен ли IP-адрес контролем доступа шлюза.

APIG.0404

Доступ к IP-адресу бекенда запрещён.

403

IP-адрес бекенда недоступен.

Проверьте, доступен ли IP-адрес бекенда или IP-адрес, соответствующий доменному имени бекенда.

APIG.0405

Приложение недоступно с доверенного IP-адреса.

403

Приложение недоступно с доверенного IP‑адреса.

Проверьте, разрешён ли исходный IP‑адрес или отклонён в политике контроля доступа.

APIG.0501

Квота приложения исчерпана.

405

Квота приложения достигнута.

Увеличьте квоту приложения.

APIG.0502

Приложение заморожено.

405

Приложение заморожено.

Проверьте, достаточно ли средств на вашем счёте.

APIG.0601

Внутренняя ошибка сервера.

500

Произошла внутренняя ошибка.

Обратитесь в техническую поддержку.

APIG.0602

Некорректный запрос.

400

Неверный запрос.

Проверьте, является ли запрос действительным.

APIG.0605

Разрешение имени домена не удалось.

500

Разрешение имени домена не удалось.

Проверьте, правильное ли имя домена и привязано ли оно к правильному бэкэнд‑адресу.

APIG.0606

Не удалось загрузить конфигурации API.

500

Конфигурации API не могут быть загружены.

Обратитесь в техническую поддержку.

APIG.0607

Поддерживается следующий протокол: {xxx}

400

Протокол не поддерживается. Только xxx поддерживается.

xxx Подчиняется фактическому значению в ответе.

Используйте HTTP или HTTPS для доступа к API.

APIG.0608

Не удалось получить токен администратора.

500

Не удаётся получить сведения об учётной записи администратора.

Обратитесь в техническую поддержку.

APIG.0609

Бэкенд VPC не существует.

500

Сервис бэкенда рабочей нагрузки не найден.

Обратитесь в техническую поддержку.

APIG.0610

Бэкенд недоступен.

502

Сервисы бэкенда недоступны.

Проверьте, доступны ли все сервисы бэкенда. Например, проверьте, соответствует ли информация о вызове API фактической конфигурации.

APIG.0611

Порт бэкенда не существует.

500

Порт бэкенда не найден.

Обратитесь в техническую поддержку.

APIG.0612

API не может вызывать сам себя.

500

API не может вызывать сам себя.

Измените конфигурацию бэкенда и убедитесь, что количество уровней рекурсивных вызовов API не превышает 10.

APIG.0613

Служба IAM в данный момент недоступна.

503

IAM в данный момент недоступна.

Обратитесь в техническую поддержку.

APIG.0615

Некорректная информация VPC для сторонней аутентификации

500

Не удалось получить узлы канала балансировки нагрузки для сторонней аутентификации.

Проверьте, правильно ли настроен канал балансировки нагрузки для третьесторонней аутентификации.

APIG.0616

Некорректная информация запроса третьесторонней аутентификации

500

Не удалось подключиться к сервису третьесторонней аутентификации.

Проверьте, работает ли сервис третьесторонней аутентификации нормально.

APIG.0617

Некорректная информация ответа третьесторонней аутентификации

500

Не удалось получить ответ от сервиса третьесторонней аутентификации.

Проверьте, работает ли сервис третьесторонней аутентификации нормально.

APIG.0705

Вычисление подписи Backend не удалось.

500

Вычисление подписи Backend не удалось.

Свяжитесь со службой технической поддержки.

APIG.0802

Пользователь IAM запрещён в текущем выбранном регионе

403

Пользователь IAM отключён в текущем регионе.

Обратитесь в техническую поддержку.

APIG.2102

PublicKey имеет значение null

400

Ключ подписи не найден.

Обратитесь в техническую поддержку.

APIG.2201

Appkey или SecretKey недействительны

400

Недействительный AppKey или SecretKey.

Проверьте, правильны ли AppKey и SecretKey в запросе.

APIG.2202

Refresh token недействителен

400

Недействительный refresh token.

Проверьте, правильный ли refresh token.

APIG.2203

Токен доступа недействителен

400

Недействительный токен доступа.

Проверьте, правильный ли токен доступа.

APIG.2204

ContentType недействителен

400

Недействительный ContentType.

Проверьте, правильный ли ContentType.

APIG.2205

Параметр Auth недействителен

400

Недействительный параметр аутентификации.

Проверьте, правильны ли параметры аутентификации.

APIG.2206

Метод Auth недействителен

400

Недействительный режим аутентификации.

Проверьте, правильный ли режим аутентификации.

APIG.2208

Длина through_data находится за пределами диапазона

400

Длина through_data находится за пределами диапазона.

Максимальная длина through_data равна 300. Настройте through_data по требованию.

APIG.2209

Значение grant_type не входит в enum List

400

Значение grant_type недействительно.

Значение grant_type может быть только client_credentials или refresh_token. Измените grant_type по требованию.

APIG.2210

Отсутствие grant_type

400

Тип авторизации отсутствует.

Добавьте grant_type.

APIG.2211

Отсутствие client_id

400

Идентификатор клиента отсутствует.

Добавьте client ID.

APIG.2212

Отсутствие client_secret

400

client secret отсутствует.

Добавьте client secret.

APIG.2213

Отсутствие refresh_token

400

refresh token отсутствует.

Обратитесь в техническую поддержку.

APIG.1001

Refresh token истёк

401

Refresh token истёк.

Получите другой refresh token.

APIG.1002

Access token истёк

401

Access token истёк.

Получите другой access token.

APIG.1003

Приложение не соответствует refresh token

401

Приложение не соответствует refresh token.

Проверьте client_id правильно.

APIG.1004

Приложение не существует

401

Приложение не существует.

Проверьте, правильный ли access token.

APIG.1009

AppKey или AppSecret недействителен

400

AppKey или AppSecret недействителен.

Проверьте, соответствует ли AppKey или AppSecret в запросе ключу или секрету учетных данных.