Azure AI 검색의 API 버전

Azure AI 검색은 정기적으로 기능 업데이트를 공개합니다. 항상 그렇지는 않지만 경우에 따라 이러한 업데이트에는 이전 버전과 호환성을 유지하기 위해 API의 새 버전이 필요하기도 합니다. 새 버전을 게시하면 코드에서 검색 서비스 업데이트를 통합 하는 시기와 방법을 제어할 수 있습니다.

일반적으로 REST API 및 라이브러리는 새 API 버전을 사용하도록 코드를 업그레이드하는 데 약간의 활동이 필요할 수 있으므로 필요한 경우에만 버전이 지정됩니다. API의 일부를 변경하여 더 이상 이전 버전과 호환되지 않는 경우에만 새 버전이 필요합니다. 그러한 변경은 기존 기능의 수정 또는 기존 API 노출 영역을 변경하는 새로운 기능으로 인해 발생할 수 있습니다.

사용 중단 경로에 대한 자세한 내용은 Azure SDK 수명 주기 및 지원 정책을 참조하세요.

더 이상 사용되지 않는 버전

2023-07-01-preview는 2024년 4월 8일에 더 이상 사용되지 않으며 2024년 7월 8일에 사용 중지됩니다. 벡터 검색 지원을 제공한 첫 번째 REST API입니다. 최신 API 버전에는 다른 벡터 구성이 있습니다. 최대한 빨리 최신 버전으로 마이그레이션하는 것이 좋습니다.

지원되지 않는 버전

일부 API 버전은 중단되었으며 검색 서비스에서 거부됩니다.

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

모든 SDK는 REST API 버전을 기반으로 합니다. REST 버전이 중단되면 해당 버전을 기반으로 하는 SDK 패키지도 중단됩니다. 3.0.0-rc 이전의 모든 Azure AI 검색 .NET SDK는 이제 사용되지 않습니다.

위에 나열된 버전에 대한 지원은 2020년 10월 15일에 종료되었습니다. 중단된 버전을 사용하는 코드가 있는 경우 기존 코드를 최신 REST API 버전 또는 최신 Azure SDK로 마이그레이션할 수 있습니다.

REST API

REST API	링크
Search Service(데이터 평면)	REST API 참조에서 API 버전을 참조하세요.
관리(컨트롤 플레인)	REST API 참조에서 API 버전을 참조하세요.

Azure SDK for .NET

다음 표에서는 최신 SDK 버전에 대한 링크를 제공합니다.

SDK 버전	상태	설명
Azure.Search.Documents 11	활성화	2020년 7월에 처음 릴리스된 Azure .NET SDK 팀의 새 클라이언트 라이브러리입니다. 부 릴리스에 대한 자세한 내용은 변경 로그를 참조하세요.
Microsoft.Azure.Search 10	사용 중지됨	2019년 5월에 릴리스됨. 이는 Microsoft.Azure.Search 패키지의 마지막 버전이며 현재 사용되지 않습니다. Azure.Search.Documents가 성공했습니다.
Microsoft.Azure.Management.Search 4.0.0	활성화	관리 REST api-버전=2020-08-01을 대상으로 합니다.
Microsoft.Azure.Management.Search 3.0.0	사용 중지됨	관리 REST api-version=2015-08-19을 대상으로 합니다.

Java용 Azure SDK

SDK 버전	상태	설명
Java azure-search-documents 11	활성화	데이터 평면 작업에 azure-search-documents 클라이언트 라이브러리를 사용합니다.
Java 관리 클라이언트 1.35.0	활성화	컨트롤 플레인 작업에 azure-mgmt-search 클라이언트 라이브러리를 사용합니다.

JavaScript용 Azure SDK

SDK 버전	상태	설명
JavaScript @azure/search-documents 11.0	진행 중	데이터 평면 작업에 @azure/search-documents 클라이언트 라이브러리를 사용합니다.
JavaScript @azure/arm-search	활성화	컨트롤 플레인 작업에 @azure/arm-search 클라이언트 라이브러리를 사용합니다.

Python용 Azure SDK

SDK 버전	상태	설명
Python azure-search-documents 11.0	활성화	데이터 평면 작업에 azure-search-documents 클라이언트 라이브러리를 사용합니다.
Python azure-mgmt-search 8.0	활성화	컨트롤 플레인 작업에 azure-mgmt-search 클라이언트 라이브러리를 사용합니다.

모든 Azure SDK

베타 클라이언트 라이브러리 및 설명서를 찾는 경우 이 페이지에는 모든 Azure SDK 라이브러리 패키지, 코드 및 설명서에 대한 링크가 포함되어 있습니다.