Коды состояния HTTP (поиск ИИ Azure)
На этой странице описываются коды состояния HTTP, которые часто возвращаются при использовании API поиска ИИ Azure.
Основные коды состояния HTTP
| Код | Описание |
|---|---|
| 200 ОК | Успешное выполнение GET, PUT или POST. Возвращается для успешного ответа. Во время индексирования этот код указывает, что все элементы были сохранены в надежном виде и начнут индексироваться. Индексирование выполняется в фоновом режиме и делает новые документы доступны для запроса и поиска через несколько секунд после завершения операции индексирования. |
| 201 Создано | Успешное выполнение PUT или POST. Объект успешно создан или обновлен. |
| 204 — Принято | Успешное выполнение PUT или POST. Индекс или документы успешно отправлены. |
| 207 — Множественное состояние | Частичное выполнение PUT или POST. Некоторые документы выполнены успешно, но хотя бы один — со сбоем. |
| 400 — недопустимый запрос | Возвращается при возникновении ошибки в универсальном коде ресурса (URI), заголовках или тексте запроса. Текст ответа содержит сообщение об ошибке с объяснением конкретной проблемы. |
| 403. Запрещено | Возвращается, если передан недопустимый ключ api. |
| 404 — не найдено | Возвращается, если ресурс не существует на сервере. Если вы управляете индексом или запрашиваете его, проверка синтаксис и убедитесь, что имя индекса указано правильно. |
| Метод 405 не поддерживается | Возвращается, если запрос указывает метод, который распознается, но не поддерживается. Если вы запрашиваете индекс, формулировка этого запроса включает в себя конечную точку, коллекцию индексов и индекс, а также коллекцию документов и метод поиска (например, https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2020-06-30). |
| 409. Конфликт | Возвращается при конфликте операций записи. Эта ошибка возвращается при обновлении ресурсов или во время индексирования, когда два процесса пытаются одновременно обновить один и тот же документ. Поиск ИИ Azure обеспечивает управление параллелизмом для обновлений ресурсов. Дополнительные сведения см. в статье Управление параллелизмом в поиске ИИ Azure. |
| 412 — Необходимое условие не выполнено | Возвращается, если условие заголовка If-Match или If-None-Match принимает значение false. Связано с использованием управления оптимистическим параллелизмом при отправке HTTP-запросов для определений индексов, индексаторов или источников данных. |
| 429 — слишком много запросов | Если эта ошибка возникает при попытке создать индекс, это означает, что у вас уже есть максимально допустимое количество индексов для вашей ценовой категории. Количество индексов, хранящихся в поиске ИИ Azure, отображается на панели мониторинга службы поиска на портал Azure. Чтобы просмотреть индексы по имени, выберите плитку Индекс . Кроме того, можно также получить список индексов по имени с помощью операции Перечисление индексов . Более подробные сведения см. в разделе Получение списка индексов. Если эта ошибка возникает во время отправки документа, это означает, что превышена квота на количество документов на индекс. В этом случае нужно создать новый индекс или повысить предельную емкость. |
| Закрытый запрос клиента 499 | Эта ошибка никогда не возвращается в ответе, но она может отображаться в записях журнала, записанных аналитикой трафика поиска и Azure Monitor. Это означает, что клиент закрыл подключение до того, как служба возвратила ответ. Когда поиск ИИ Azure обнаруживает отмену, которая не была запрошена кодом на стороне службы или что клиент больше не существует, регистрируется ошибка 499. |
| 502 — Недопустимый шлюз | Эта ошибка возникает при вводе HTTP вместо HTTPS в соединении. |
| 503 — Служба недоступна | Эта ошибка означает, что система перегружена и запрос не может быть обработан в данный момент. Важно: В этом случае настоятельно рекомендуется откатить клиентский код и подождать, прежде чем повторить попытку. За это время система восстановится, что повысит вероятность успешной обработки будущих запросов. Непрерывные повторные попытки выполнить запрос только усугубят проблему. Дополнительные сведения о регулировании и предотвращении этого условия см. в статье Анализ производительности . |
| 504: время ожидания шлюза | Поиск ИИ Azure прослушивает HTTPS-порт 443. Если URL-адрес службы поиска содержит HTTP вместо HTTPS, возвращается код состояния 504. |