Обновление источника данных (REST API поиска Azure AI)

  • Статья

Перезаписывает существующее определение источника данных измененной версией.

PUT https://[service name].search.windows.net/datasources/[data source 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 Нет содержимого, если был обновлен существующий источник данных.

Примечание

Некоторые свойства в существующем источнике данных нельзя обновить. Например, невозможно изменить тип существующего источника данных.

См. также раздел