Обновление до последней версии REST API в Поиск с использованием ИИ Azure

Используйте эту статью для миграции на более новые версии REST API службы поиска и REST API службы поиска для операций плоскости данных и плоскости управления .

Ниже приведены последние версии REST API:

Инструкции по обновлению сосредоточены на изменениях кода, которые позволяют преодолевать ломающие изменения из предыдущих версий, чтобы существующий код продолжал работать как прежде, но на более новой версии API. После того как код находится в рабочем порядке, вы можете решить, следует ли принимать новые функции. Чтобы узнать больше о новых функциях, см. новое в Поиск с использованием ИИ Azure.

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

2023-07-01-preview был первым REST API для поддержки векторов. Не используйте эту версию API. Он теперь устарел, и вам необходимо сразу перейти на стабильные или более новые предварительные интерфейсы REST API.

Когда необходимо обновить

Поиск с использованием ИИ Azure нарушает обратную совместимость только в крайнем случае. Обновление необходимо при:

• Код ссылается на устаревшую или неподдерживаемую версию API и подвергается одному или нескольким критическим изменениям.

• Код вызывает ошибку, если нераспознанные свойства возвращаются в ответе API. Как рекомендуется, приложение должно игнорировать свойства, которые он не понимает.

• Код сохраняет запросы API и пытается повторно отправить их в новую версию API. Например, это может произойти, если приложение сохраняет маркеры продолжения, возвращаемые из API поиска (дополнительные сведения @search.nextPageParameters см. в справочнике по API поиска).

Как обновить

1. Если вы обновляете версию плоскости данных, проверьте , что было выпущено в новой версии API.

2. Обновите параметр, указанный api-version в заголовке запроса, до более новой версии.

   В коде приложения, который выполняет прямые вызовы к REST API, найдите все экземпляры существующей версии и замените ее новой версией. Дополнительные сведения о структурировании вызова REST см. в кратком руководстве. Полнотекстовый поиск с помощью REST.

   Если вы используете Azure SDK, каждый пакет предназначен для конкретной версии REST API. Чтобы определить, какая версия REST API поддерживает пакет, просмотрите журнал изменений. Обновите последнюю версию пакета, чтобы получить доступ к новейшим функциям и улучшениям API.

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

Критические изменения

Следующие критические изменения применяются к операциям с данными.

** Критические изменения в агентном извлечении

2026-04-01 является первой стабильной версией REST API для поиска агентами. В ней представлены следующие критические изменения, исходящие из 2025-11-01-preview:

• Синтез ответов, планирование запросов и настраиваемые усилия по рассуждению удаляются. Извлечение возвращает только извлекаемое, заземленное содержимое.

• Изменения формы запроса на получение: messages заменяется на intents, а некоторые параметры переименованы или удалены.

• Фильтрация разрешений на уровне документа для больших двоичных объектов и источников знаний OneLake не поддерживается.

Полный список изменений на уровне свойств и этапов миграции см. в разделе «Перенос кода агентного извлечения».

Критические изменения для агентов знаний

Агенты знаний были введены в 2025-05-01-preview. В 2025-08-01-preview, targetIndexes был заменен новым объектом источника знаний и defaultMaxDocsForReranker заменен другими API. Внесено больше критических изменений в 2025-11-01-preview.

Полный список изменений на уровне свойств и этапов миграции см. в разделе «Перенос кода агентного извлечения».

Критические изменения для клиентского кода, считывающего сведения о подключении

Начиная с 29 марта 2024 г. и применимы ко всем поддерживаемым REST API:

• Набор навыков GET, GET Index и GET Indexer больше не возвращают ключи или свойства подключения в ответе. Это критическое изменение, если у вас есть подчиненный код, который считывает ключи или подключения (конфиденциальные данные) из ответа GET.

• Если вам нужно получить ключи API администратора или запроса для службы поиска, используйте REST API управления поиском.

• Если необходимо получить строки подключения другого ресурса Azure, например служба хранилища Azure или Azure Cosmos DB, используйте API этого ресурса и опубликованные инструкции для получения сведений.

Критические изменения для семантического рангера

Семантический рангер стал общедоступным в 2023-11-01. Это критические изменения из предыдущих выпусков:

• Во всех версиях после 2020-06-01-preview: semanticConfiguration заменяет searchFields механизм указания полей, используемых для ранжирования L2.

• Для всех версий API обновления от 14 июля 2023 года в семантические модели, размещенные Microsoft, сделали ранжировщик семантическим и независимым от языка, фактически прекращая использование свойства queryLanguage. В коде нет "критического изменения", но свойство игнорируется.

См. статью "Миграция из предварительной версии", чтобы перенести код на использование semanticConfiguration.

Обновления плоскости данных

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

Обновление до версии 2026-08-01-preview

2026-08-01-preview добавляет новые элементы управления агентным извлечением, улучшения источников знаний и пагинацию на основе курсора для операций со списками.

Перед обновлением проверьте, применяются ли к вашему коду какое-либо из следующих 2026-08-01-preview критических изменений:

• Критические изменения в агентном поиске включают вложенные объекты model в журналах действий, resultsProcessing вместо inclusionMode для серверных инструментов в источнике знаний MCP, а также аутентификацию через принадлежащее клиенту приложение Microsoft Entra для источников знаний Work IQ. Пошаговое руководство по миграции см. в разделе Миграция кода агентного поиска.

• В операциях перечисления для источников данных, индексаторов, индексов, наборов навыков и источников знаний $top, $skip и pageSize заменены на пагинацию с использованием курсоров с помощью search, $count и @odata.nextLink. Дополнительные сведения о новом механизме пагинации см. в разделе «Постраничный просмотр результатов списка в Поиск с использованием ИИ Azure (предварительная версия)».

Для всех остальных существующих API нет изменений в поведении. Вы можете переключить новую версию API, и код выполняется так же, как и раньше.

Обновление до версии 2026-05-01-preview

2026-05-01-preview добавляет новые типы источников знаний, новые параметры для действия извлечения, новые типы контента индексатора SharePoint и параметры ACL и другие возможности.

Критические изменения 2025-11-01-previewна уровне провода отсутствуют. Однако, если вы используете пакет SDK Python или JavaScript для агентного поиска, клиент retrieve переименован в KnowledgeBaseRetrievalClient, а retrieveKnowledge(...) заменён на retrieve(...). Рекомендации по миграции SDK см. в разделе Перенос кода агентного поиска.

Для всех остальных существующих API нет изменений в поведении. Вы можете переключить новую версию API, и код выполняется так же, как и раньше.

Обновление до 2026-04-01

2026-04-01 является последней стабильной версией REST API. Он способствует агентному извлечению, отбору источников знаний, а также обеспечивает общую доступность для нескольких навыков и функций.

Перед обновлением проверьте, применяются ли к вашему коду какое-либо из следующих 2026-04-01 критических изменений:

• Шесть свойств удаляются из определения навыка GenAI Prompt: httpMethod, timeout, batchSize, degreeOfParallelism, httpHeaders, и authResourceId. Удалите эти свойства перед обновлением. Определения, которые по-прежнему включают эти свойства, возвращают ошибку 400 Bad Request .

• Теперь для агентного извлечения требуется отдельное согласие на выставление счетов. Если у вас есть semanticSearch=standard, необходимо явно задать knowledgeRetrieval=standard перед обновлением. Дополнительные сведения см. в разделе Включение или отключение выставления счетов за агентную выборку.

• Если агентский код извлечения предназначен 2025-11-01-preview, 2026-04-01 удаляет несколько предварительных возможностей и стандартизирует извлечение данных вокруг ввода намерений, извлекаемого результата и минимального анализа. Дополнительные сведения см. в разделе "Миграция вашего кода агентивного извлечения данных".

Для всех остальных существующих API нет изменений в поведении. Вы можете переключить новую версию API, и код выполняется так же, как и раньше.

Обновление до версии 2025-11-01-preview

2025-11-01-preview представляет следующие критические изменения в агентном извлечении, которое реализовано в 2025-08-01-preview:

• Заменяет agents на knowledgebases. Несколько свойств, связанных с источниками знаний, перемещены из определения базы знаний и действия извлечения.

• Свойства источника знаний рефакторингируются, реализуя новый ingestionParameters объект для источников знаний, создающих конвейер индексатора.

Полный список изменений на уровне свойств и этапов миграции см. в разделе «Перенос кода агентного извлечения».

Для всех остальных существующих API нет изменений в поведении. Вы можете переключить новую версию API, и код выполняется так же, как и раньше.

Обновление до 2025-09-01

2025-09-01 является стабильной версией REST API, которая добавляет общедоступность для индексатора OneLake, функции макета документа и других API.

Критические изменения отсутствуют, если вы выполняете обновление 2024-07-01 и не используете какие-либо функции предварительной версии. Чтобы использовать новый стабильный выпуск, измените версию API и протестируйте код.

Обновление до версии 2025-08-01-preview

2025-08-01-preview представляет следующие основные изменения для интеллектуальных агентов, созданных с помощью 2025-05-01-preview:

• Заменяет targetIndexes на knowledgeSources.
• defaultMaxDocsForReranker Удаляется без замены.

В противном случае изменения поведения в существующих API-интерфейсах отсутствуют. Вы можете переключить новую версию API, и код выполняется так же, как и раньше.

Обновление до версии 2025-05-01-preview

2025-05-01-preview предоставляет новые функции, но в существующих API нет изменений в поведении. Вы можете переключить новую версию API, и код выполняется так же, как и раньше.

Обновление до версии 2025-03-01-preview

2025-03-01-preview предоставляет новые функции, но в существующих API нет изменений в поведении. Вы можете переключить новую версию API, и код выполняется так же, как и раньше.

Обновление до версии 2024-11-01-preview

2024-11-01-preview перезапись запросов, навык макета документов, безключевая система выставления счетов для обработки навыков, режим синтаксического анализа Markdown и параметры пересчета для сжатых векторов.

Если вы обновляетесь с 2024-09-01-preview, вы можете заменить старую версию на новую версию API, и ваш код будет выполняться так же, как и раньше.

Однако новая версия вводит изменения синтаксиса в vectorSearch.compressions:

• Заменяет rerankWithOriginalVectors на enableRescoring
• Перемещение defaultOversampling в новый rescoringOptions объект свойства

Обратная совместимость сохраняется из-за внутреннего сопоставления API, но рекомендуется изменить синтаксис при внедрении новой предварительной версии. Сравнение синтаксиса см. в разделе "Сжатие векторов" с помощью скалярной или двоичной квантизации.

Обновление до версии 2024-09-01-preview

2024-09-01-preview добавляет сжатие Matryoshka Representation Learning (MRL) для моделей текстового встраивания-3, целевую фильтрацию векторов для гибридных запросов, детали подсчета векторов для отладки и фрагментацию токенов для навыка разделения текста.

Если вы обновляетесь с 2024-05-01-preview, вы можете заменить старую версию на новую версию API, и ваш код будет выполняться так же, как и раньше.

Обновление до 2024-07-01

2024-07-01 — общедоступная версия. Теперь ранее доступные функции предварительной версии доступны для общего пользования: интегрированные блоки и векторизация (навык разделения текста, навык AzureOpenAIEmbedding), векторизатор запросов на основе AzureOpenAIEmbedding, сжатие векторов (скалярная квантизация, двоичная квантизация, хранимое свойство, узкие типы данных).

При обновлении с 2024-05-01-preview до стабильной версии не возникает критических изменений. Чтобы использовать новый стабильный выпуск, измените версию API и протестируйте код.

При обновлении непосредственно с 2023-11-01 возникают критические изменения. Выполните действия, указанные для каждой новой версии предварительного просмотра, чтобы перейти с 2023-11-01 на 2024-07-01.

Обновление до версии 2024-05-01-preview

2024-05-01-preview добавляет индексатор для Microsoft OneLake, двоичных векторов и других моделей внедрения.

При переходе с версии 2024-03-01-preview навык AzureOpenAIEmbedding теперь требует указания имени модели и свойства 'размеры'.

1. Выполните поиск в базе кода на ссылки AzureOpenAIEmbedding.

2. Установите modelName на "text-embedding-ada-002" и задайте значение dimensions на "1536".

Обновление до версии 2024-03-01-preview

2024-03-01-preview добавляет узкие типы данных, скалярную квантизацию и параметры хранилища векторов.

При обновлении с 2023-10-01-preview нет критических изменений. Однако существует одно различие в поведении: для 2023-11-01 и более новых предварительных версий vectorFilterMode значение по умолчанию изменилось с postfilter на предварительный фильтр для выражений фильтров.

1. Ищите в базе кода ссылки на vectorFilterMode.

2. Если свойство задано явным образом, действие не требуется. Если вы использовали значение по умолчанию, новое поведение по умолчанию — фильтровать перед выполнением запроса. Если требуется фильтрация после запроса, явно установите vectorFilterMode в postfilter, чтобы сохранить прежнее поведение.

Обновление до 2023-11-01

2023-11-01 — общедоступная версия. Теперь функции, ранее доступные в предварительной версии, стали общедоступными: семантический ранжировщик и поддержка векторов.

Нет критических изменений от 2023-10-01-preview, но есть несколько критических изменений от 2023-07-01-preview до 2023-11-01. Дополнительные сведения см. в разделе "Обновление от 2023-07-01-preview".

Чтобы использовать новый стабильный выпуск, измените версию API и протестируйте код.

Обновление до версии 2023-10-01-preview

2023-10-01-preview была первой предварительной версией, в которой добавлены встроенное разбиение данных и векторизация в процессе индексирования, а также встроенная векторизация запросов. Он также поддерживает индексирование векторов и запросы из предыдущей версии.

Если вы обновляете предыдущую версию, в следующем разделе описаны действия.

Обновление с версии 2023-07-01-preview

Не используйте эту версию API. Он реализует синтаксис векторного запроса, несовместимый с любой новой версией API.

2023-07-01-preview теперь устарел, поэтому вам не следует основывать новый код на этой версии, а также при любых обстоятельствах не обновляйтесь до этой версии. В этом разделе объясняется путь миграции из 2023-07-01-preview любой более новой версии API.

Обновление портала для векторных индексов

Azure портал поддерживает путь обновления одним щелчком для индексов 2023-07-01-preview. Он обнаруживает векторные поля и предоставляет кнопку Переместить.

• Путь миграции — от 2023-07-01-preview до 2024-05-01-preview.
• Обновления ограничены определениями векторных полей и конфигурациями алгоритмов векторного поиска.
• Обновления являются односторонними. Невозможно отменить обновление. После обновления индекса необходимо использовать 2024-05-01-preview или более поздней версии для запроса индекса.

Портальная миграция для обновления синтаксиса векторного запроса не предусмотрена. Ознакомьтесь с обновлениями кода для изменений синтаксиса запросов.

Перед нажатием кнопки "Миграция" нажмите кнопку "Изменить JSON ", чтобы сначала просмотреть обновленную схему. Вы должны найти схему, соответствующую изменениям, описанным в разделе обновления кода . Миграция портала обрабатывает только индексы с одной конфигурацией алгоритма векторного поиска. Он создает профиль по умолчанию, который сопоставляется с алгоритмом векторного 2023-07-01-preview поиска. Индексы с несколькими конфигурациями поиска векторов требуют ручной миграции.

Обновление кода для векторных индексов и запросов

Поддержка поиска векторов появилась в разделе "Создание или обновление индекса" (2023-07-01-preview).

Для обновления с 2023-07-01-preview до любой более новой стабильной или предварительной версии требуется:

• Переименование и реструктуризация конфигурации вектора в индексе
• Перезапись векторных запросов

Используйте инструкции, приведенные в этом разделе, чтобы перенести векторные поля, конфигурацию и запросы из 2023-07-01-preview.

1. Вызовите get Index, чтобы получить существующее определение.

2. Измените конфигурацию векторного поиска. 2023-11-01 в более поздних версиях представлена концепция профилей векторов , которые объединяют конфигурации, связанные с векторами, под одним именем. Более новые версии также переименуют algorithmConfigurations в algorithms.

   • Переименуйте algorithmConfigurations на algorithms. Это просто переименование массива. Содержимое является обратно совместимым. Это означает, что можно использовать существующие параметры конфигурации HNSW.

   • Добавьте profiles, указав имя и конфигурацию алгоритма для каждой из них.

   Перед миграцией (2023-07-01-preview):

     "vectorSearch": {
       "algorithmConfigurations": [
           {
               "name": "myHnswConfig",
               "kind": "hnsw",
               "hnswParameters": {
                   "m": 4,
                   "efConstruction": 400,
                   "efSearch": 500,
                   "metric": "cosine"
               }
           }
       ]}
   

   После миграции (2023-11-01):

     "vectorSearch": {
       "algorithms": [
         {
           "name": "myHnswConfig",
           "kind": "hnsw",
           "hnswParameters": {
             "m": 4,
             "efConstruction": 400,
             "efSearch": 500,
             "metric": "cosine"
           }
         }
       ],
       "profiles": [
         {
           "name": "myHnswProfile",
           "algorithm": "myHnswConfig"
         }
       ]
     }
   

3. Измените определения векторного поля, заменив vectorSearchConfiguration на vectorSearchProfile. Убедитесь, что имя профиля соответствует новому определению профиля для вектора, а не имени конфигурации алгоритма. Другие свойства поля вектора остаются неизменными. Например, они не могут быть фильтруемыми, сортируемыми или фасетными, а также не использовать анализаторы или нормализаторы или карты синонимов.

   До (2023-07-01-preview):

     {
         "name": "contentVector",
         "type": "Collection(Edm.Single)",
         "key": false,
         "searchable": true,
         "retrievable": true,
         "filterable": false,  
         "sortable": false,  
         "facetable": false,
         "analyzer": "",
         "searchAnalyzer": "",
         "indexAnalyzer": "",
         "normalizer": "",
         "synonymMaps": "", 
         "dimensions": 1536,
         "vectorSearchConfiguration": "myHnswConfig"
     }
   

   После (2023-11-01):

     {
       "name": "contentVector",
       "type": "Collection(Edm.Single)",
       "searchable": true,
       "retrievable": true,
       "filterable": false,  
       "sortable": false,  
       "facetable": false,
       "analyzer": "",
       "searchAnalyzer": "",
       "indexAnalyzer": "",
       "normalizer": "",
       "synonymMaps": "", 
       "dimensions": 1536,
       "vectorSearchProfile": "myHnswProfile"
     }
   

4. Вызовите функцию Create or Update Index, чтобы применить изменения.

5. Измените метод Search POST , чтобы изменить синтаксис запроса. Это изменение API позволяет поддерживать типы запросов полиморфных векторов.

   • Переименуйте vectors на vectorQueries.
   • Для каждого векторного запроса добавьте kind, задав для него значение vector.
   • Для каждого векторного запроса переименуйте value в vector.
   • При необходимости добавьте vectorFilterMode , если вы используете выражения фильтров. По умолчанию используется префильтратор для индексов, созданных после 2023-10-01. Индексы, созданные до этой даты, поддерживают только postfilter независимо от того, как задать режим фильтра.

   До (2023-07-01-preview):

   {
       "search": "*", //Required by the API but ignored for ranking in vector-only queries
       "vectors": [
         {
           "value": [
               0.103,
               0.0712,
               0.0852,
               0.1547,
               0.1183
           ],
           "fields": "contentVector",
           "k": 5
         }
       ],
       "select": "title, content, category"
   }
   

   После (2023-11-01):

   {
     "search": "*", //Required by the API but ignored for ranking in vector-only queries
     "vectorQueries": [
       {
         "kind": "vector",
         "vector": [
           0.103,
           0.0712,
           0.0852,
           0.1547,
           0.1183
         ],
         "fields": "contentVector",
         "k": 5
       }
     ],
     "vectorFilterMode": "preFilter",
     "select": "title, content, category"
   }
   

В этих шагах выполняется миграция на 2023-11-01 стабильную версию API или более новую версию API предварительной версии.

Обновление до 2020-06-30

В этой версии есть одно критическое изменение и несколько различий в поведении. К общим возможностям относятся:

• Хранилище знаний, постоянное хранилище обогащенного содержимого, созданное с помощью наборов навыков, созданное для последующего анализа и обработки с помощью других приложений. Хранилище знаний создается с помощью Поиск с использованием ИИ Azure REST API, но он находится в служба хранилища Azure.

Изменение, нарушающее совместимость

Код, написанный для более ранних версий API, нарушает работу на 2020-06-30 и более поздних версиях, если в коде используется следующая функциональность:

• Любые Edm.Date литералы (дата, состоящая из года, месяца и дня, например 2020-12-12) в выражениях фильтров должны соответствовать формату Edm.DateTimeOffset: 2020-12-12T00:00:00Z. Это изменение необходимо для обработки ошибочных или непредвиденных результатов запроса из-за различий часового пояса.

Изменения поведения

• Алгоритм ранжирования BM25 заменяет предыдущий алгоритм ранжирования более новой технологией. Службы, созданные после 2019 года, автоматически используют этот алгоритм. Для старых служб необходимо задать параметры для использования нового алгоритма.

• Упорядоченные результаты для значений NULL изменились в этой версии: значения NULL отображаются первыми, если сортировка asc, и последними, если сортировка desc. Если вы написали код для обработки сортировки значений NULL, помните об этом изменении.

Обновление до версии 2019-05-06

К функциям, которые стали общедоступными в этой версии API, относятся:

• Автозаполнение — это функция «typeahead», которая завершает частично введенный термин.
• Сложные типы обеспечивают встроенную поддержку структурированных данных объектов в индексе поиска.
• Синтаксический режим JsonLines, часть индексации BLOB-объектов в Azure, создаёт один поисковый документ для каждой JSON-сущности, разделённой с помощью новой строки.
• Обогащение ИИ обеспечивает индексирование, использующее механизмы обогащения ИИ средств Foundry.

Критические изменения

Код, написанный для более ранней версии API, ломается на 2019-05-06 и более поздних версиях, если он содержит следующую функциональность:

1. Свойство Type для Azure Cosmos DB. Для индексаторов, предназначенных для источника данных Azure Cosmos DB для NOSQL API, измените "type": "documentdb" на "type": "cosmosdb".

2. Если обработка ошибок индексатора содержит ссылки на status свойство, удалите его. Мы удалили статус из ответа на ошибку, поскольку он не предоставлял полезной информации.

3. Строки подключения источника данных больше не возвращаются в ответе. Начиная с версий API 2019-05-06 и 2019-05-06-Preview, API источника данных больше не возвращает строки подключения в ответ на любую операцию REST. В предыдущих версиях API для источников данных, созданных с помощью POST, Поиск с использованием ИИ Azure возвращал 201 с ответом OData, который содержал строку подключения в виде обычного текста.

4. Когнитивный навык распознавания именованных сущностей снят с эксплуатации. Если в коде вызывается навык распознавания сущностей имен , вызов завершается сбоем. Функция замены — Модуль распознавания сущностей (V3). Следуйте рекомендациям в нерекомендуемых навыках , чтобы перейти на поддерживаемый навык.

Обновление сложных типов

Версия 2019-05-06 API добавила официальную поддержку сложных типов. Если код реализовал предыдущие рекомендации по сложной эквивалентности типов в 2017-11-11-Preview или 2016-09-01-Preview, есть некоторые новые и измененные ограничения, начиная с версии 2019-05-06 которых необходимо учитывать:

• Ограничения на глубину подфилдов и количество сложных коллекций на индекс были снижены. Если вы создали индексы, превышающие эти ограничения с помощью предварительных версий API, любая попытка обновить или повторно создать их с помощью версии 2019-05-06 API завершается ошибкой. Если вы находитесь в этой ситуации, необходимо изменить схему в соответствии с новыми ограничениями, а затем перестроить индекс.

• Существует новое ограничение, начиная с версии 2019-05-06 API на количество элементов сложных коллекций на документ. Если вы создали индексы с документами, превышающими эти ограничения с помощью предварительных версий API, любая попытка повторного индексирования данных с помощью версии 2019-05-06 API завершается ошибкой. Если вы находитесь в этой ситуации, необходимо уменьшить количество сложных элементов коллекции на документ, прежде чем переиндексировать данные.

Дополнительные сведения см. в разделе Service limits for Поиск с использованием ИИ Azure.

Обновление старой структуры сложного типа

Если код использует сложные типы с одной из старых версий API предварительной версии, вы можете использовать формат определения индекса, который выглядит следующим образом:

{
  "name": "hotels",  
  "fields": [
    { "name": "HotelId", "type": "Edm.String", "key": true, "filterable": true },
    { "name": "HotelName", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": true, "facetable": false },
    { "name": "Description", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "en.microsoft" },
    { "name": "Description_fr", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "fr.microsoft" },
    { "name": "Category", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Tags", "type": "Collection(Edm.String)", "searchable": true, "filterable": true, "sortable": false, "facetable": true, "analyzer": "tagsAnalyzer" },
    { "name": "ParkingIncluded", "type": "Edm.Boolean", "filterable": true, "sortable": true, "facetable": true },
    { "name": "LastRenovationDate", "type": "Edm.DateTimeOffset", "filterable": true, "sortable": true, "facetable": true },
    { "name": "Rating", "type": "Edm.Double", "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address", "type": "Edm.ComplexType" },
    { "name": "Address/StreetAddress", "type": "Edm.String", "filterable": false, "sortable": false, "facetable": false, "searchable": true },
    { "name": "Address/City", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/StateProvince", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/PostalCode", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/Country", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Location", "type": "Edm.GeographyPoint", "filterable": true, "sortable": true },
    { "name": "Rooms", "type": "Collection(Edm.ComplexType)" }, 
    { "name": "Rooms/Description", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "en.lucene" },
    { "name": "Rooms/Description_fr", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "fr.lucene" },
    { "name": "Rooms/Type", "type": "Edm.String", "searchable": true },
    { "name": "Rooms/BaseRate", "type": "Edm.Double", "filterable": true, "facetable": true },
    { "name": "Rooms/BedOptions", "type": "Edm.String", "searchable": true },
    { "name": "Rooms/SleepsCount", "type": "Edm.Int32", "filterable": true, "facetable": true },
    { "name": "Rooms/SmokingAllowed", "type": "Edm.Boolean", "filterable": true, "facetable": true },
    { "name": "Rooms/Tags", "type": "Collection(Edm.String)", "searchable": true, "filterable": true, "facetable": true, "analyzer": "tagsAnalyzer" }
  ]
}  

Более новый формат дерева для определения полей индекса появился в версии 2017-11-11-PreviewAPI. В новом формате каждое сложное поле имеет коллекцию полей, в которой определены его подполя. В версии API 2019-05-06 этот новый формат используется исключительно, и попытка создания или обновления индекса с использованием старого формата завершится ошибкой. Если у вас есть индексы, созданные с помощью старого формата, необходимо использовать версию 2017-11-11-Preview API для обновления их до нового формата, прежде чем управлять с помощью API версии 2019-05-06.

Вы можете обновить неструктурированные индексы до нового формата, выполнив следующие действия с помощью версии 2017-11-11-PreviewAPI:

1. Выполните запрос GET, чтобы получить индекс. Если он уже в новом формате, вы закончили.

2. Перевод индекса из неструктурированного формата в новый формат. Необходимо написать код для этой задачи, так как во время написания этой задачи нет примера кода.

3. Выполните запрос PUT, чтобы обновить индекс до нового формата. Избегайте изменения других сведений индекса, таких как возможность поиска и фильтрация полей, так как изменения, влияющие на физическое выражение существующего индекса, не допускаются API обновления индекса.

Обновления плоскости управления

Применимо к:2014-07-31-Preview, 2015-02-28и 2015-08-19

Теперь listQueryKeys запрос GET для старых версий API управления поиском устарел. Для использования listQueryKeys запроса POST рекомендуется обновиться до последней стабильной версии API уровня управления.

1. В существующем коде измените api-version параметр на последнюю версию (2025-05-01).

2. Переформулируйте запрос от GET в POST.

   POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/listQueryKeys?api-version=2025-05-01
   Authorization: Bearer {{token}}
   

3. Если вы используете Azure SDK, рекомендуется обновить до последней версии.

Дальнейшие действия

Ознакомьтесь со справочной документацией по REST API поиска. Если у вас возникли проблемы, обратитесь за помощью в Stack Overflow или обратитесь в службу поддержки.