Обновление индексатора (REST API поиска Azure ИИ)
Вы можете обновить существующее определение индексатора с помощью HTTP-запроса PUT. Укажите имя индексатора для обновления в URI запроса:
PUT https://[service name].search.windows.net/indexers/[indexer name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
Обновление определения индексатора не запускает его автоматически, но в зависимости от изменений и связанного источника данных может потребоваться сброс и повторный запуск.
Параметры URI
Параметр | Описание |
---|---|
имя службы | Обязательный. Задайте уникальное, определяемое пользователем имя службы поиска. |
имя индексатора | Обязательный. Универсальный код ресурса (URI) запроса указывает имя индексатора для обновления. |
api-version | Обязательный. Текущая стабильная версия — api-version=2020-06-30 . Дополнительные версии см. в разделе Версии API . |
Заголовки запросов
Таблица ниже содержит обязательные и необязательные заголовки запроса.
Поля | Описание |
---|---|
Content-Type | Обязательный. Для этого заголовка необходимо задать значение application/json |
api-key | Необязательно, если вы используете роли Azure и в запросе предоставляется маркер носителя, в противном случае требуется ключ. Ключ API — это уникальная, созданная системой строка, которая проверяет подлинность запроса к службе поиска. Запросы на обновление должны содержать api-key заголовок, заданный для ключа администратора (в отличие от ключа запроса). Дополнительные сведения см. в статье Подключение к поиску ИИ Azure с помощью проверки подлинности по ключу . |
Текст запроса
Синтаксис текста запроса аналогичен синтаксису для создания индексатора.
При обновлении существующего индексатора все определение заменяется содержимым текста запроса. Как правило, лучший шаблон для обновлений — получить определение индексатора с помощью GET, изменить его, а затем обновить с помощью PUT.
Ответ
Для успешного запроса: возвращается код состояния "201 — Создан ресурс", если индексатор был создан, и "204 — Нет содержимого", если был обновлен существующий индексатор.