Wersje interfejsu API REST zarządzania (azure AI Search)

  • Artykuł

W tym artykule wymieniono bieżące i wcześniejsze wersje interfejsów API REST zarządzania dla usługi Azure AI Search.

Dokumentacja interfejsu API w wersji

Dokumentacja interfejsu API REST jest teraz wersjonowana. Po otwarciu strony dokumentacji interfejsu API wybierz wersję interfejsu API z filtru rozwijanego.

Zrzut ekranu przedstawiający selektor wersji.

Stabilne wersje

Wersja interfejsu API Specyfikacja Aktualizacje interfejsu API
2023-11-01 (Najnowsze) Specyfikacja struktury Swagger Informacje o wersji
2022-09-01 Specyfikacja struktury Swagger Informacje o wersji
2020-08-01 Specyfikacja struktury Swagger Informacje o wersji
2020-03-13 Specyfikacja struktury Swagger Informacje o wersji
2015-08-19 Specyfikacja struktury Swagger Informacje o wersji

Wersje zapoznawcza

Wersje w wersji zapoznawczej są wydawane w celu testowania nowych funkcji, zbierania opinii oraz odnajdywania i rozwiązywania problemów. Interfejsy API w wersji zapoznawczej są dostępne w obszarze Uzupełniające warunki użytkowania i nie są zalecane w przypadku obciążeń produkcyjnych.

Wersja interfejsu API Specyfikacja Aktualizacje interfejsu API
2024-03-01-Preview (Najnowsze) Specyfikacja struktury Swagger Informacje o wersji
2021-04-01-Preview Specyfikacja struktury Swagger Informacje o wersji
2020-08-01-Preview Specyfikacja struktury Swagger Informacje o wersji
2019-10-01-Preview Specyfikacja struktury Swagger Informacje o wersji

Informacje o wersji

2024-03-01-Preview

Ta wersja zapoznawcza dodaje w przyszłości obsługę obwodu zabezpieczeń sieci. Jest ona oparta na 2023-11-01 punkcie odniesienia i udostępnia wszystkie interfejsy API w tej wersji. Zapoznaj się z ogłoszeniem o obwodzie zabezpieczeń sieci w artykule Co nowego w usłudze Azure AI Search.

2023-11-01

Ta ogólnie dostępna wersja dodaje możliwość włączania lub wyłączania klasyfikacji semantycznej w obszarze Tworzenie lub aktualizowanie usługi iusługi aktualizacji.

2022-09-01

Ta ogólnie dostępna wersja dodaje właściwości uwierzytelniania do tworzenia lub aktualizowania usługi i usługi aktualizacji.

Możliwość włączania lub wyłączania kontroli dostępu opartej na rolach jest ogólnie dostępna w tej wersji.

2021-04-01-Preview

Ten interfejs API w wersji zapoznawczej zawiera wszystkie funkcje poprzedniego interfejsu API w wersji zapoznawczej i dodaje następujące funkcje:

  • Obsługa wersji zapoznawczej kontroli dostępu opartej na rolach. Chociaż obsługa tego zadania jest ogólnie dostępna w 2022-09-01programie , można ją również włączyć lub wyłączyć przy użyciu tej wersji interfejsu API w wersji zapoznawczej.

  • Włącza lub wyłącza wyszukiwanie semantyczne. Wyszukiwanie semantyczne to funkcja w warstwie Premium, która działa w usługach warstwy Standardowa. W tym interfejsie API REST zarządzania w wersji zapoznawczej użyj polecenia Create or Update Services , aby wyłączyć wyszukiwanie semantyczne na poziomie usługi, aby uniemożliwić wykonywanie zapytań wywołujących klasyfikację semantyczną. Tę funkcję można również włączyć w usługach wyszukiwania w warstwie Bezpłatna dla niewielkiej liczby bezpłatnych zapytań.

  • Wymuszanie szyfrowania zasobów płaszczyzny danych za pomocą kluczy zarządzanych przez klienta (CMK). Użyj opcji Utwórz lub Aktualizuj usługi , aby skonfigurować tę opcję. Istniejące usługi wyszukiwania, które nie spełniają tego wymagania, są oznaczone jako niezgodne.

  • Wyłącz obciążenia, które wypychają dane z usługi Azure AI Search do zasobów zewnętrznych. Użyj polecenia Create or Update Services , aby ustawić wartość properties.disabledDataExfiltrationOptions "All" lub null (wartość domyślna). Wyłączenie wszystkich obciążeń powoduje wyłączenie następujących funkcji:

2020-08-01-Preview

Ten interfejs API w wersji zapoznawczej jest odpowiednikiem ogólnie dostępnej wersji 2020-08-01i dodaje następujące funkcje:

  • Dodano sharedPrivateLinkResources obsługę dwóch nowych typów zasobów. Nowe groupId wartości to mysqlServer (Azure Database for MySQL) i sites (Azure Functions/app services).

2020-08-01

Ta ogólnie dostępna wersja dodała obsługę zasobów udostępnionych Private Link dla wszystkich zasobów dostępnych dla ruchu wychodzącego z wyjątkiem zasobów zanotowanych w wersji zapoznawczej.

2020-03-13

Ta ogólnie dostępna wersja dodała obsługę prywatnego punktu końcowego Connections za pośrednictwem Azure Private Link i reguł adresów IP sieci dla nowych usług.

2019-10-01-Preview

Jest to pierwsza wersja zapoznawcza. Na tej liście nie wprowadzono żadnych funkcji w wersji zapoznawczej. Ta wersja zapoznawcza jest funkcjonalnie równoważna funkcji 2020-03-13. Pozostaje dostępny. Każdy skrypt lub kod, który wywołuje tę wersję, będzie działać, ale zalecamy klientom aktualizację do korzystania z nowszej wersji interfejsu API (ogólnie dostępnej lub zapoznawczej wersji interfejsu API), aby uzyskać te same wyniki.

2015-08-19

Jest to początkowa wersja interfejsu API REST zarządzania. Udostępniono interfejsy API do tworzenia i usuwania usługi, aprowizowania replik i partycji oraz zarządzania kluczami interfejsu API.

Zobacz też