Обновление источника данных (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 Нет содержимого, если был обновлен существующий источник данных.
Примечание
Некоторые свойства в существующем источнике данных нельзя обновить. Например, невозможно изменить тип существующего источника данных.