이 문서에서는 Azure AI Search용 관리 REST API의 현재 및 이전 버전을 나열합니다.
버전이 지정된 API 문서
REST API 문서는 버전이 지정됩니다. API 참조 페이지를 열 때 드롭다운 필터에서 API 버전을 선택합니다.
안정 버전
| API 버전 | Specification | API 업데이트 |
|---|---|---|
2025-05-01(최신) |
스웨거 사양 | 릴리스 노트 |
2023-11-01 |
스웨거 사양 | 릴리스 노트 |
2022-09-01 |
스웨거 사양 | 릴리스 노트 |
2020-08-01 |
스웨거 사양 | 릴리스 노트 |
2020-03-13 |
스웨거 사양 | 릴리스 노트 |
2015-08-19 |
스웨거 사양 | 릴리스 노트 |
미리 보기 버전
미리 보기 버전은 새 기능을 테스트하고, 피드백을 수집하고, 문제를 검색하고 해결하기 위해 릴리스됩니다. 미리 보기 API는 추가 사용 약관에 따라 사용할 수 있으며 프로덕션 워크로드에는 권장되지 않습니다.
| API 버전 | Specification | API 업데이트 |
|---|---|---|
2025-02-01-Preview(최신) |
스웨거 사양 | 릴리스 노트 |
2024-06-01-Preview |
스웨거 사양 | 릴리스 노트 |
2024-03-01-Preview |
스웨거 사양 | 릴리스 노트 |
2021-04-01-Preview |
스웨거 사양 | 릴리스 노트 |
2020-08-01-Preview |
스웨거 사양 | 릴리스 노트 |
2019-10-01-Preview |
스웨거 사양 | 릴리스 노트 |
출시 정보
2025-05-01
이 일반 공급 버전은 다음과 같이 업데이트됩니다.
| Update | REST API |
|---|---|
| 검색 서비스를 미리 보기에서 일반 공급으로 업그레이드하도록 홍보합니다. | 업그레이드 서비스 |
| 가격 책정 계층을 미리 보기에서 일반 공급으로 변경하도록 홍보합니다. |
서비스 업데이트 (sku 속성) |
| 사용자 할당 관리 ID를 검색 서비스와 연결하는 것을 미리 보기에서 일반 공급으로 홍보합니다. |
서비스 업데이트 (identity 속성) |
| 네트워크 보안 경계에 검색 서비스를 미리 보기에서 일반 공급으로 할당하도록 홍보합니다. | 네트워크 보안 경계 구성 |
| 새로운 검색 서비스에 대한 기밀 컴퓨팅 지원을 일반 공급으로 직접 릴리스합니다. |
서비스 만들기 또는 업데이트 (computeType 속성) |
2025-02-01-Preview
이 미리 보기 버전은 다음과 같이 업데이트됩니다.
| Update | REST API |
|---|---|
| 검색 서비스 업그레이드에 대한 지원을 추가합니다. 지원되는 지역에서 2024년 4월 이전에 서비스를 만든 경우 일회성 업그레이드를 수행하여 더 높은 스토리지 및 벡터 제한을 얻습니다. | 업그레이드 서비스 |
| 가격 책정 계층 변경에 대한 지원을 추가합니다. 현재 기본과 표준(S1, S2 및 S3) 계층 간에만 전환할 수 있습니다. |
서비스 업데이트 (sku 속성) |
2024-06-01-Preview
이 미리 보기 버전은 다음과 같이 업데이트됩니다.
| Update | REST API |
|---|---|
| 네트워크 보안 경계에 검색 서비스를 할당하기 위한 지원을 추가합니다. | 네트워크 보안 경계 구성 |
에 AzureServices값을 추가합니다NetworkRuleSet.Bypass. 요청이 Azure의 신뢰할 수 있는 서비스에서 시작되는 경우 네트워크 IP 규칙을 무시할 수 있습니다. |
서비스 만들기 또는 업데이트 및 서비스 업데이트 (NetworkRuleSet.Bypass 속성) |
SearchService.ProvisioningState를 Succeeded로 변경하는 것과 같이 이름을 대문자로 바꾸 는 데 대한 지원을 추가합니다. |
서비스 만들기 또는 업데이트 및 서비스 업데이트 (SearchService.ProvisioningState 속성) |
2024-03-01-Preview
이 미리 보기 버전은 다음과 같이 업데이트됩니다.
| Update | REST API |
|---|---|
| 현재 사용할 수 없는 네트워크 보안 경계에 대한 API를 추가합니다. | 네트워크 보안 경계 구성 |
2023-11-01
이 일반 공급 버전은 다음과 같이 업데이트됩니다.
| Update | REST API |
|---|---|
| 의미 체계 순위를 미리 보기에서 일반 공급으로 승격합니다. | 서비스 만들기 또는 업데이트 및 서비스 업데이트 |
2022-09-01
이 일반 공급 버전은 다음과 같이 업데이트됩니다.
| Update | REST API |
|---|---|
| 적용 가능한 REST API에 인증 속성을 추가합니다. | 서비스 만들기 또는 업데이트 및 서비스 업데이트 |
| 역할 기반 액세스 제어를 미리 보기에서 일반 공급으로 승격합니다. | 서비스 만들기 또는 업데이트 및 서비스 업데이트 |
2021-04-01-Preview
이 미리 보기 버전은 다음과 같이 업데이트됩니다.
| Update | REST API |
|---|---|
| 검색 서비스에서 역할 기반 액세스 제어를 사용하거나 사용하지 않도록 설정하기 위한 지원을 추가합니다. | 서비스 만들기 또는 업데이트 및 서비스 업데이트 |
| 검색 서비스에서 시맨틱 랭커를 사용하거나 사용하지 않도록 설정하는 지원을 추가합니다. | 서비스 만들기 또는 업데이트 및 서비스 업데이트 |
| 데이터 평면 리소스의 암호화를 적용하기 위해 고객 관리형 키 에 대한 지원을 추가합니다. 이 요구 사항을 충족하지 않는 기존 검색 서비스는 비준수로 표시됩니다. | 서비스 만들기 또는 업데이트 및 서비스 업데이트 |
Azure AI Search에서 외부 리소스로 데이터를 푸시하는 워크로드를 사용하지 않도록 설정하기 위한 지원을 추가합니다. "모두"로 설정하면 properties.disabledDataExfiltrationOptionsPower Query 커넥터, 디버그 세션, 보강 캐시, 지식 저장소 및 사용자 지정 기술이 있는 기술 세트를 사용할 수 없습니다. |
서비스 만들기 또는 업데이트 및 서비스 업데이트 (disabledDataExfiltrationOptions 속성) |
2020-08-01-Preview
이 미리 보기 버전은 두 가지 새로운 리소스 종류에 대한 지원을 추가합니다 sharedPrivateLinkResources . 새 groupId 값에는 mysqlServer(Azure Database for MySQL) 및 sites(Azure Functions/app services)가 포함됩니다.
2020-08-01
이 일반 공급 버전은 미리 보기 버전에 언급된 리소스를 제외한 모든 아웃바운드 액세스 리소스에 대한 공유 Private Link 리소스 지원을 추가합니다.
2020-03-13
이 일반 공급 버전은 Azure Private Link를 통한 프라이빗 엔드포인트 연결 지원과 새 서비스에 대한 네트워크 IP 규칙을 추가합니다.
2019-10-01-Preview
첫 번째 미리 보기 버전입니다. 이 목록에는 미리 보기 기능이 소개되어 있지 않습니다. 이 미리 보기는 기능적으로 동일 2020-03-13 하며 계속 사용할 수 있습니다. 해당 버전을 호출하는 모든 스크립트 또는 코드가 작동하지만 동일한 결과를 얻으려면 최신 일반 공급 또는 미리 보기 API 버전을 사용하는 것이 좋습니다.
2015-08-19
관리 REST API의 초기 릴리스입니다. 검색 서비스를 생성 및 삭제하고, 복제본 및 파티션을 프로비저닝하고, API 키를 관리하기 위한 API를 제공했습니다.