Wersje interfejsu API w usłudze Azure AI Search

Usługa Azure AI Search regularnie wdraża aktualizacje funkcji. Czasami jednak nie zawsze te aktualizacje wymagają nowej wersji interfejsu API w celu zachowania zgodności z poprzednimi wersjami. Publikowanie nowej wersji umożliwia kontrolowanie, kiedy i jak integrujesz aktualizacje usługi wyszukiwania w kodzie.

Z reguły interfejsy API REST i biblioteki są wersjonowane tylko wtedy, gdy jest to konieczne, ponieważ może to obejmować pewne nakłady pracy nad uaktualnieniem kodu w celu korzystania z nowej wersji interfejsu API. Potrzebna jest nowa wersja tylko wtedy, gdy jakiś aspekt interfejsu API uległ zmianie w sposób, który przerywa zgodność z poprzednimi wersjami. Takie zmiany mogą wystąpić z powodu poprawek istniejących funkcji lub nowych funkcji, które zmieniają istniejący obszar powierzchni interfejsu API.

Aby uzyskać więcej informacji na temat ścieżki wycofania, zobacz zasady cyklu życia zestawu Azure SDK i pomocy technicznej.

Przestarzałe wersje

2023-07-01-preview został wycofany 8 kwietnia 2024 r. i nie będzie obsługiwany po 8 lipca 2024 r.

Był to pierwszy interfejs API REST, który oferował obsługę wyszukiwania wektorów. Nowsze wersje interfejsu API mają inną konfigurację wektorów. Należy przeprowadzić migrację do nowszej wersji tak szybko, jak to możliwe.

Wycofane wersje

Niektóre wersje interfejsu API nie są już udokumentowane ani obsługiwane:

• 2015-02-28
• 2015-02-28-Preview
• 2014-07-31-Preview
• 2014-10-20-Preview

Wszystkie zestawy SDK są oparte na wersjach interfejsu API REST. Jeśli wersja REST nie zostanie zakończona, pakiety zestawu SDK oparte na tej wersji również zostaną wycofane. Wszystkie zestawy .NET SDK usługi Azure AI Search starsze niż 3.0.0-rc są teraz przestarzałe.

Wsparcie dla powyższych wersji zakończyło się 15 października 2020 r. Jeśli masz kod korzystający z wycofanej wersji, możesz migrować istniejący kod do nowszej wersji interfejsu API REST lub do nowszej wersji zestawu Azure SDK.

Interfejsy API REST

interfejs API REST	Link
Usługa wyszukiwania (płaszczyzna danych)	Zobacz Wersje interfejsu API w dokumentacji interfejsu API REST.
Zarządzanie wyszukiwaniem (płaszczyzna sterowania)	Zobacz Wersje interfejsu API w dokumentacji interfejsu API REST.

Zestaw Azure SDK dla platformy .NET

Poniższa tabela zawiera linki do nowszych wersji zestawu SDK.

Wersja zestawu SDK	Stan	Dziennik zmian	opis
Azure.Search.Documents 11	Aktywne	Dziennik zmian	Interfejsy API dla operacji płaszczyzny danych w usłudze, takich jak operacje odczytu i zapisu na zawartości i obiektach.
Azure.ResourceManager.Search	Aktywne	Dziennik zmian	Interfejsy API dla operacji płaszczyzny sterowania w usłudze wyszukiwania.

Zestaw Azure SDK dla języka Java

Wersja zestawu SDK	Stan	Dziennik zmian	opis
azure-search-documents 11	Aktywne	Dziennik zmian Użyj azure-search-documents biblioteki klienta na potrzeby operacji płaszczyzny danych.
azure-resourcemanager-search 2	Aktywne	Dziennik zmian	Użyj biblioteki klienta do azure-resourcemanager-search wykonywania operacji płaszczyzny sterowania.

Zestaw Azure SDK dla języka JavaScript

Wersja zestawu SDK	Stan	Dziennik zmian	opis
@azure/search-documents 12	Aktywne	Dziennik zmian	Użyj biblioteki klienta na @azure/search-documents potrzeby operacji płaszczyzny danych.
@azure/arm-search 4	Aktywne	Dziennik zmian	@azure/arm-search Użyj pakietu do obsługi operacji płaszczyzny sterowania.

Zestaw Azure SDK dla środowiska Python

Wersja zestawu SDK	Stan	Dziennik zmian	opis
azure-search-documents 11	Aktywne	Dziennik zmian	Użyj biblioteki klienta na azure-search-documents potrzeby operacji płaszczyzny danych.
azure-mgmt-search 9	Aktywne	Dziennik zmian	Użyj biblioteki klienta do azure-mgmt-search wykonywania operacji płaszczyzny sterowania.

Wszystkie zestawy SDK platformy Azure

Jeśli szukasz bibliotek klienckich i dokumentacji beta, ta strona zawiera linki do wszystkich pakietów bibliotek zestawu SDK platformy Azure, kodu i dokumentów.