Atualizar para a API REST mais recente na Pesquisa de IA do Azure

Use este artigo para migrar para versões mais recentes das APIs REST do Serviço de Pesquisa e das APIs REST do Gerenciamento de Pesquisa para operações de plano de dados e plano de controle .

Aqui estão as versões mais recentes das APIs REST:

As instruções de atualização se concentram nas alterações de código que ajudam você a quebrar as alterações das versões anteriores para que o código existente seja executado da mesma forma que antes, mas na versão mais recente da API. Quando o código estiver em funcionamento, você poderá decidir se deseja adotar recursos mais recentes. Para saber mais sobre novas funcionalidades, consulte O que há de novo.

Recomendamos atualizar as versões da API sucessivamente, trabalhando em cada versão até chegar à mais recente.

2023-07-01-preview foi a primeira API REST para suporte vetorial. Não use esta versão da API. Agora ele foi preterido e você deve migrar para APIs REST de visualização estáveis ou mais recentes imediatamente.

Quando atualizar

O Azure AI Search quebra a compatibilidade com versões anteriores como último recurso. A atualização é necessária quando:

• Seu código faz referência a uma versão de API desativada ou não suportada e está sujeito a uma ou mais alterações de quebra. Tem de abordar alterações de quebra se o seu código tem como alvo 2025-11-01-preview recuperação agêntica, 2025-05-01-preview agentes de conhecimento, 2023-07-10-preview vetores, 2020-06-01-preview classificador semântico e 2019-05-06 habilidades obsoletas e soluções alternativas.

• Seu código falha quando propriedades não reconhecidas são retornadas em uma resposta de API. Como prática recomendada, seu aplicativo deve ignorar propriedades que não compreende.

• Seu código persiste as solicitações de API e tenta reenviá-las para a nova versão da API. Por exemplo, isso pode acontecer se a sua aplicação armazenar tokens de continuidade retornados pela API de Pesquisa (para mais informações, consulte @search.nextPageParameters na Referência da API de Pesquisa).

Como atualizar

1. Se você estiver atualizando uma versão do plano de dados, revise as notas de versão da nova versão da API.

2. Atualize o api-version parâmetro, especificado no cabeçalho da solicitação, para uma versão mais recente.

   No código do aplicativo que faz chamadas diretas para as APIs REST, procure todas as instâncias da versão existente e substitua-a pela nova versão. Para obter mais informações sobre como estruturar uma chamada REST, consulte Guia de início rápido: pesquisa de texto completo usando REST.

   Se estiveres a usar um Azure SDK, cada pacote tem como alvo uma versão específica da API REST. Para determinar qual a versão da API REST que o seu pacote suporta, consulte o seu registo de alterações. Atualize para a versão mais recente do pacote para aceder às funcionalidades mais recentes e melhorias na API.

3. Se você estiver atualizando uma versão do plano de dados, revise as alterações significativas documentadas neste artigo e implemente as soluções alternativas. Comece com a versão utilizada pelo seu código e resolva qualquer mudança significativa para cada versão mais recente da API até chegar à versão estável ou preliminar mais recente.

Alterações interruptivas

As seguintes alterações importantes aplicam-se às operações de dados.

Alterações disruptivas para a recuperação agêntica

A versão mais recente 2025-11-01-preview refatora as APIs para agentes de conhecimento (bases), fontes de conhecimento e a ação de recuperação. A versão mais recente do 2025-11-01-preview renomeia agentes de conhecimento para bases de conhecimento e realoca várias propriedades. Várias propriedades são substituídas ou realocadas para outros objetos.

Para obter ajuda com alterações de quebra, consulte Migrar seu código de recuperação de agente.

Mudanças revolucionárias para os agentes do conhecimento

Os agentes do conhecimento foram introduzidos na 2025-05-01-preview. Em 2025-08-01-preview, targetIndexes foi substituído por um novo objeto fonte de conhecimento e defaultMaxDocsForReranker substituído por outras APIs. São introduzidas mais alterações disruptivas em 2025-11-01-preview.

Para obter ajuda com alterações de quebra, consulte Migrar seu código de recuperação de agente.

Alterações significativas para o código do cliente que lê informações de conexão

Em vigor a partir de 29 de março de 2024 e aplicável a todas as APIs REST suportadas:

• GET Skillset, GET Index e GET Indexer não retornam mais chaves ou propriedades de conexão em uma resposta. Esta é uma alteração significativa se você tiver um código downstream que lê chaves ou conexões (dados confidenciais) de uma resposta GET.

• Se você precisar recuperar chaves de API de administrador ou consulta para seu serviço de pesquisa, use as APIs REST de Gerenciamento de Pesquisa.

• Se você precisar recuperar cadeias de conexão de outro recurso do Azure, como o Armazenamento do Azure ou o Azure Cosmos DB, use as APIs desse recurso e as diretrizes publicadas para obter as informações.

Alterações significativas para o classificador semântico

O ranker semântico tornou-se geralmente disponível em 2023-11-01. Estas são as principais mudanças em relação às versões anteriores:

• Em todas as versões após 2020-06-01-preview: semanticConfiguration substitui searchFields como o mecanismo para especificar quais campos usar para a classificação L2.

• Para todas as versões da API, as atualizações de 14 de julho de 2023 nos modelos semânticos hospedados pela Microsoft tornaram o ordenamento semântico independente do idioma, desativando efetivamente a propriedade queryLanguage. Não há "alteração de quebra" no código, mas a propriedade é ignorada.

Consulte Migrar da versão de pré-visualização para fazer a transição do seu código para utilizar semanticConfiguration.

Atualizações do plano de dados

As diretrizes de atualização pressupõem a atualização da versão anterior mais recente. Se o seu código for baseado em uma versão antiga da API, recomendamos atualizar através de cada versão sucessiva para chegar à versão mais recente.

Atualizar para versão de pré-visualização de 2025-11-01

2025-11-01-preview introduz as seguintes alterações disruptivas na recuperação agentiva, tal como implementadas no 2025-08-01-preview:

• Substitui agents por knowledgebases. Várias propriedades relacionadas com fontes de conhecimento foram movidas da definição da base de conhecimento para a ação de recuperação.
• As propriedades da fonte de conhecimento são refatoradas, implementando um objeto ingestionParameters novo para fontes de conhecimento que criam um pipeline de indexação.

Para mais informações sobre alterações e migração de código, consulte alterações de destaque em 2025-11-01-preview e Como migrar.

Para todas as outras APIs existentes, não há alterações de comportamento. Você pode trocar na nova versão da API e seu código é executado da mesma forma que antes.

Atualizar para 2025-09-01

2025-09-01 é a versão estável mais recente da API REST e adiciona disponibilidade geral para o indexador OneLake, habilidade Layout de Documento e outras APIs.

Não há alterações significativas se estiver a atualizar a partir de 2024-07-01 e não estiver a utilizar nenhum recurso de pré-visualização. Para usar a nova versão estável, altere a versão da API e teste seu código.

Atualize para 2025-08-01-preview

2025-08-01-preview Introduz as seguintes alterações significativas nos agentes de conhecimento criados usando 2025-05-01-preview:

• Substitui targetIndexes por knowledgeSources.
• Remove defaultMaxDocsForReranker sem substituição.

Caso contrário, não haverá alterações de comportamento nas APIs existentes. Você pode trocar na nova versão da API e seu código é executado da mesma forma que antes.

Atualize para 2025-05-01-preview

2025-05-01-preview fornece novos recursos, mas não há alterações de comportamento nas APIs existentes. Você pode trocar na nova versão da API e seu código é executado da mesma forma que antes.

Atualize para 2025-03-01-preview

2025-03-01-preview fornece novos recursos, mas não há alterações de comportamento nas APIs existentes. Você pode trocar na nova versão da API e seu código é executado da mesma forma que antes.

Faça a atualização para 2024-11-01-preview

2024-11-01-preview reescrita de consultas, funcionalidade de layout de documento, faturamento sem chave para processamento de funcionalidades, modo de interpretação de Markdown e opções de remarcação para vetores compactados.

Se estiveres a atualizar do 2024-09-01-preview, podes trocar pela nova versão da API e o teu código será executado exatamente como antes.

No entanto, a nova versão introduz alterações de sintaxe para vectorSearch.compressions:

• Substitui rerankWithOriginalVectors por enableRescoring
• Move defaultOversampling para um novo rescoringOptions objeto de propriedade

A compatibilidade com versões anteriores é preservada devido a um mapeamento interno da API, mas recomendamos alterar a sintaxe se você adotar a nova versão de visualização. Para obter uma comparação da sintaxe, consulte Comprimir vetores usando quantização escalar ou binária.

Atualize para 2024-09-01-preview

2024-09-01-preview adiciona compactação Matryoshka Representation Learning (MRL) para modelos de incorporação de texto-3, filtragem vetorial direcionada para consultas híbridas, detalhes de subpontuação vetorial para depuração e fragmentação de token para habilidade de divisão de texto.

Se estiveres a atualizar do 2024-05-01-preview, podes trocar pela nova versão da API e o teu código será executado exatamente como antes.

Atualize para 2024-07-01

2024-07-01 é uma versão geral. Os recursos de visualização anteriores agora estão geralmente disponíveis: fragmentação e vetorização integradas (habilidade de divisão de texto, habilidade AzureOpenAIEmbedding), vetorizador de consulta baseado em AzureOpenAIEmbedding, compactação vetorial (quantização escalar, quantização binária, propriedade armazenada, tipos de dados estreitos).

Não há alterações significativas se você atualizar de 2024-05-01-preview para estável. Para usar a nova versão estável, altere a versão da API e teste seu código.

Há alterações significativas se você atualizar diretamente do 2023-11-01. Siga as etapas descritas para cada nova pré-visualização para migrar de 2023-11-01 para 2024-07-01.

Atualize para 2024-05-01-versão preliminar

2024-05-01-preview adiciona um indexador para o Microsoft OneLake, vetores binários e mais modelos de incorporação.

Se estiver a atualizar a partir de 2024-03-01-preview, a habilidade AzureOpenAIEmbedding agora requer um nome de modelo e uma propriedade de dimensões.

1. Pesquise sua base de código para referências AzureOpenAIEmbedding .

2. Defina modelName como "text-embedding-ada-002" e definido dimensions como "1536".

Atualize para 2024-03-01-preview

2024-03-01-preview Adiciona tipos de dados estreitos, quantização escalar e opções de armazenamento vetorial.

Se você estiver atualizando a partir do 2023-10-01-preview, não há alterações ininterruptas. No entanto, há uma diferença de comportamento: para 2023-11-01 e versões de pré-lançamento mais recentes, o vectorFilterMode padrão mudou de pós-filtro para pré-filtro em expressões de filtro.

1. Pesquise a sua base de código em busca de referências de vectorFilterMode.

2. Se a propriedade estiver definida explicitamente, nenhuma ação será necessária. Se você confiou no valor padrão, o novo comportamento padrão é filtrar antes da execução da consulta. Se desejar filtragem pós-consulta, defina vectorFilterMode explicitamente como postfilter para manter o comportamento antigo.

Atualize para 2023-11-01

2023-11-01 é uma versão geral. Os recursos de visualização anteriores agora estão geralmente disponíveis: classificador semântico e suporte vetorial.

Não há alterações de quebra de 2023-10-01-preview, mas há várias alterações de quebra de 2023-07-01-preview para 2023-11-01. Para obter mais informações, consulte Atualização de 2023-07-01-preview.

Para usar a nova versão estável, altere a versão da API e teste seu código.

Atualize para 2023-10-01-preview

2023-10-01-preview foi a primeira versão de pré-visualização a adicionar fragmentação e vetorização de dados incorporadas durante a indexação e vetorização de consulta incorporada. Ele também suporta indexação vetorial e consultas da versão anterior.

Se você estiver atualizando da versão anterior, a próxima seção terá as etapas.

Atualize a partir de 2023-07-01-preview

Não use esta versão da API. Ele implementa uma sintaxe de consulta vetorial que é incompatível com qualquer versão mais recente da API.

2023-07-01-preview agora está obsoleto, então você não deve basear o novo código nesta versão, nem deve atualizar para esta versão em nenhuma circunstância. Esta secção explica o caminho de migração de 2023-07-01-preview para qualquer versão mais recente da API.

Atualização do portal para índices vetoriais

O portal do Azure dá suporte a um caminho de atualização com um único clique para 2023-07-01-preview índices. Ele deteta campos vetoriais e fornece um botão Migrar .

• O caminho de migração é de 2023-07-01-preview para 2024-05-01-preview.
• As atualizações são limitadas a definições de campo vetorial e configurações de algoritmo de pesquisa vetorial.
• As atualizações são unidirecionais. Não é possível reverter a atualização. Depois de o índice ser atualizado, deverá usar a versão 2024-05-01-preview ou uma posterior para consultá-lo.

Não há migração de portal para atualizar a sintaxe de consulta vetorial. Consulte as atualizações de código para alterações na sintaxe de consulta.

Antes de selecionar Migrar, selecione Editar JSON para revisar o esquema atualizado primeiro. Você deve encontrar um esquema que esteja em conformidade com as alterações descritas na seção de atualização de código. A migração do portal apenas gere índices com uma configuração de algoritmo de pesquisa vetorial. Ele cria um perfil padrão que mapeia para o 2023-07-01-preview algoritmo de pesquisa vetorial. Índices com várias configurações de pesquisa vetorial exigem migração manual.

Atualização de código para índices vetoriais e consultas

O suporte à pesquisa vetorial foi introduzido no Create or Update Index (2023-07-01-preview).

A atualização de 2023-07-01-preview para qualquer versão estável ou de pré-visualização mais recente requer:

• Renomeando e reestruturando a configuração vetorial no índice
• Reescrevendo suas consultas vetoriais

Use as instruções nesta seção para migrar campos vetoriais, configuração e consultas do 2023-07-01-preview.

1. Chame Get Index para recuperar a definição existente.

2. Modifique a configuração da pesquisa vetorial. 2023-11-01e versões posteriores introduzem o conceito de perfis vetoriais que agrupam configurações relacionadas a vetores sob um nome. As versões mais recentes também mudam o nome algorithmConfigurations para algorithms.

   • Mudar o nome de algorithmConfigurations para algorithms. Esta é apenas uma mudança de nome da matriz. Os conteúdos são compatíveis com versões anteriores. Isso significa que seus parâmetros de configuração HNSW existentes podem ser usados.

   • Adicione profiles, dando um nome e uma configuração de algoritmo para cada um.

   Antes da migração (2023-07-01-preview):

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

   Após a migração (2023-11-01):

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

3. Modificar definições de campo vetorial, substituindo vectorSearchConfiguration por vectorSearchProfile. Verifique se o nome do perfil corresponde a uma nova definição de perfil vetorial, e não ao nome da configuração do algoritmo. Outras propriedades do campo vetorial permanecem inalteradas. Por exemplo, eles não podem ser filtráveis, classificáveis ou facialmente, nem usar analisadores ou normalizadores ou mapas de sinônimos.

   Antes (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"
     }
   

   Depois (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. Chame Criar ou Atualizar Índice para postar as alterações.

5. Modifique o POST de pesquisa para alterar a sintaxe da consulta. Essa alteração de API permite o suporte para tipos de consulta vetorial polimórfica.

   • Mudar o nome de vectors para vectorQueries.
   • Para cada consulta vetorial, adicione kind, definindo-a como vector.
   • Para cada consulta vetorial, renomeie value para vector.
   • Opcionalmente, adicione vectorFilterMode se estiver usando expressões de filtro. O padrão é pré-filtro para índices criados após 2023-10-01. Os índices criados antes dessa data suportam apenas o pós-filtro, independentemente de como você define o modo de filtro.

   Antes (2023-07-01-preview):

   {
       "search": (this parameter is ignored in vector search),
       "vectors": [
         {
           "value": [
               0.103,
               0.0712,
               0.0852,
               0.1547,
               0.1183
           ],
           "fields": "contentVector",
           "k": 5
         }
       ],
       "select": "title, content, category"
   }
   

   Depois (2023-11-01):

   {
     "search": "(this parameter is ignored in vector search)",
     "vectorQueries": [
       {
         "kind": "vector",
         "vector": [
           0.103,
           0.0712,
           0.0852,
           0.1547,
           0.1183
         ],
         "fields": "contentVector",
         "k": 5
       }
     ],
     "vectorFilterMode": "preFilter",
     "select": "title, content, category"
   }
   

Estas etapas concluem a migração para 2023-11-01 a versão estável da API ou para versões mais recentes da API de visualização.

Atualizar para 2020-06-30

Nesta versão, há uma mudança significativa e várias diferenças comportamentais. Os recursos geralmente disponíveis incluem:

• Armazenamento de conhecimento, armazenamento persistente de conteúdo enriquecido criado através de conjuntos de habilidades, criado para análise downstream e processamento através de outros aplicativos. Um repositório de conhecimento é criado por meio das APIs REST do Azure AI Search, mas reside no Armazenamento do Azure.

Quebrando a mudança

O código escrito para versões anteriores da API deixa de funcionar a partir de 2020-06-30 se o código contiver a seguinte funcionalidade:

• Quaisquer Edm.Date literais (uma data composta de ano-mês-dia, como 2020-12-12) em expressões de filtro devem seguir o formato Edm.DateTimeOffset: 2020-12-12T00:00:00Z. Essa alteração foi necessária para lidar com resultados de consulta incorretos ou inesperados devido a diferenças de fuso horário.

Alterações de comportamento

• O algoritmo de classificação BM25 substitui o algoritmo de classificação anterior por uma tecnologia mais recente. Os serviços criados após 2019 utilizam este algoritmo automaticamente. Para serviços mais antigos, você deve definir parâmetros para usar o novo algoritmo.

• Os resultados ordenados para valores nulos foram alterados nesta versão, com valores nulos aparecendo primeiro numa ordenação de asc e por último numa ordenação de desc. Se você escreveu código para manipular como os valores nulos são classificados, esteja ciente dessa alteração.

Atualize para 2019-05-06

Os recursos que se tornaram geralmente disponíveis nesta versão da API incluem:

• O preenchimento automático é um recurso de digitação antecipada que conclui uma entrada de termo parcialmente especificada.
• Tipos complexos fornecem suporte nativo para dados de objeto estruturado no índice de pesquisa.
• Os modos de análise JsonLines, parte da indexação de Blob do Azure, criam um documento de pesquisa por entidade JSON que é separado por uma nova linha.
• O enriquecimento de IA fornece indexação que utiliza os motores de enriquecimento de IA da Foundry Tools.

Alterações interruptivas

O código escrito em uma versão anterior da API quebra em 2019-05-06 e em versões posteriores se contiver a seguinte funcionalidade:

1. Propriedade do Tipo para o Azure Cosmos DB. Para indexadores que visam uma fonte de dados do Azure Cosmos DB API para NoSQL, altere para "type": "documentdb".

2. Se o tratamento de erros do indexador incluir referências à propriedade status, deve removê-la. Removemos o status da resposta de erro porque ele não estava fornecendo informações úteis.

3. As cadeias de conexão da fonte de dados não são mais retornadas na resposta. A partir das versões 2019-05-062019-05-06-Preview da API, a API da fonte de dados não retorna mais cadeias de conexão na resposta de qualquer operação REST. Em versões anteriores da API, para fontes de dados criadas usando POST, a Pesquisa de IA do Azure retornava 201 seguida pela resposta OData, que continha a cadeia de conexão em texto sem formatação.

4. A habilidade cognitiva de Reconhecimento de Entidade Nomeada é aposentada. Se chamaste a capacidade de Reconhecimento de Entidades Nomeadas no teu código, a chamada falhará. A funcionalidade de substituição é a Habilidade de Reconhecimento de Entidade (V3). Siga as recomendações em Habilidades preteridas para migrar para uma habilidade suportada.

Atualização de tipos complexos

A versão 2019-05-06 da API adicionou suporte formal para tipos complexos. Se o seu código implementou recomendações anteriores para equivalência de tipos complexos em 2017-11-11-Preview ou 2016-09-01-Preview, há alguns limites novos e alterados começando na versão 2019-05-06 dos quais você precisa estar ciente:

• Os limites da profundidade dos subcampos e do número de coleções complexas por índice foram reduzidos. Se criou índices que excedam estes limites usando as versões de pré-visualização da API, qualquer tentativa de os atualizar ou recriar usando a versão 2019-05-06 da API falha. Se você se encontrar nessa situação, precisará redesenhar seu esquema para caber dentro dos novos limites e, em seguida, reconstruir seu índice.

• Há um novo limite a partir da versão 2019-05-06 api no número de elementos de coleções complexas por documento. Se você criou índices com documentos que excedem esses limites usando as versões de api de visualização, qualquer tentativa de reindexar esses dados usando a versão 2019-05-06 de api falhará. Se você se encontrar nessa situação, precisará reduzir o número de elementos de coleta complexos por documento antes de reindexar seus dados.

Para obter mais informações, consulte Limites de serviço para o Azure AI Search.

Como atualizar uma antiga estrutura de tipo complexo

Se o seu código estiver usando tipos complexos com uma das versões mais antigas da API de visualização, você pode estar usando um formato de definição de índice semelhante a este:

{
  "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" }
  ]
}  

Um novo formato semelhante a uma árvore para definir campos de índice foi introduzido na versão 2017-11-11-Previewda API. No novo formato, cada campo complexo tem uma coleção de campos onde seus subcampos são definidos. Na versão API 2019-05-06, este novo formato é usado exclusivamente e a tentativa de criar ou atualizar um índice usando o formato antigo falhará. Se você tiver índices criados usando o formato antigo, precisará usar a versão 2017-11-11-Preview da API para atualizá-los para o novo formato antes que eles possam ser gerenciados usando a versão da API 2019-05-06.

Você pode atualizar índices simples para o novo formato com as seguintes etapas usando a versão 2017-11-11-Previewda API:

1. Execute uma solicitação GET para recuperar seu índice. Se já estiver no novo formato, está concluído.

2. Traduza o índice do formato simples para o novo formato. Você tem que escrever código para esta tarefa, uma vez que não há nenhum código de exemplo disponível no momento em que este artigo foi escrito.

3. Execute uma solicitação PUT para atualizar o índice para o novo formato. Evite alterar quaisquer outros detalhes do índice, como a capacidade de pesquisa/filtragem de campos, porque as alterações que afetam a expressão física do índice existente não são permitidas pela API de Índice de Atualização.

Atualizações do plano de controle

Aplica-se a:2014-07-31-Preview, 2015-02-28e 2015-08-19

A listQueryKeys solicitação GET em versões mais antigas da API de Gerenciamento de Pesquisa agora foi preterida. Recomendamos migrar para a versão mais recente da API do plano de controle estável para usar a listQueryKeys solicitação POST.

1. No código existente, altere o api-version parâmetro para a versão mais recente (2025-05-01).

2. Reformular a solicitação de GET para 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. Se você estiver usando um SDK do Azure, é recomendável atualizar para a versão mais recente.

Próximos passos

Consulte a documentação de referência da API REST de pesquisa. Se você encontrar problemas, peça-nos ajuda sobre o Stack Overflow ou entre em contato com o suporte.