Сброс навыков (предварительная версия REST API)
применимо к: 2023-07-01-Preview. Эта версия больше не поддерживается. немедленное обновление до более новой версии.
Важный
2023-07-01-Preview (без изменений).
2021-04-30-Preview (без изменений).
2020-06-30-Preview добавляет API. Он поддерживает кэшированные обогащения и сценарии сброса .
Запрос Сброс навыков выборочно обрабатывает один или несколько навыков при следующем запуске индексатора. Для индексаторов с включенным кэшированием можно явно запрашивать обработку обновлений навыков, которые индексатор не может обнаружить. Например, при внесении внешних изменений, таких как изменения пользовательского навыка, можно использовать этот API для повторного запуска навыка. Выходные данные, такие как хранилище знаний или индекс поиска, обновляются с помощью повторно используемых данных из кэша и нового содержимого для обновленного навыка.
Можно сбросить существующий набор навыков с помощью HTTP POST, указав имя набора навыков для обновления по URI запроса.
POST https://[servicename].search.windows.net/skillsets/[skillset name]/resetskills?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
Параметры URI
| Параметр | Описание |
|---|---|
| Имя службы | Обязательно. Задайте для этого уникальное, определяемое пользователем имя службы поиска. |
| Имя набора навыков | Обязательно. URI запроса указывает имя набора навыков для сброса. |
| версия API | Обязательно. Дополнительные версии API см. в версиях API. |
Заголовки запросов
В следующей таблице описаны обязательные и необязательные заголовки запросов.
| Поля | Описание |
|---|---|
| Тип контента | Обязательно. Задайте для этого значение application/json |
| api-key | Необязательно, если вы используете роли Azure и маркер носителя предоставляется в запросе, в противном случае требуется ключ. Ключ API — это уникальная, созданная системой строка, которая проверяет подлинность запроса в службе поиска. Запросы на сброс должны содержать заголовок api-key, заданный для ключа администратора (в отличие от ключа запроса). Дополнительные сведения см. в статье Connect to Azure AI Search using key authentication. |
Текст запроса
Текст запроса — это массив имен навыков.
{
"skillNames" : ["<SKILL-1>", "SKILL-n"]
}
Ответ
Код состояния: 204 Нет содержимого для успешного ответа.