별칭 작업(미리 보기 REST API)

적용 : 2023-07-01-Preview. 이 버전은 더 이상 지원되지 않습니다. 업그레이드는 즉시 최신 버전으로.

중요하다

2023-07-01-Preview(변경 내용 없음).

2021-04-30-Preview는 API를 추가합니다.

Azure AI Search에서 인덱스 별칭은 검색 인덱스의 보조 이름입니다. 검색 인덱스에 매핑되는 별칭을 만들고, 그렇지 않으면 인덱스 이름을 참조할 위치에 별칭 이름을 대체할 수 있습니다. 이렇게 하면 애플리케이션이 가리키는 인덱스를 변경해야 하는 경우 유연성을 제공합니다. 애플리케이션 코드에서 인덱스 이름에 대한 참조를 업데이트하는 대신 별칭에 대한 매핑만 업데이트할 수 있습니다.

지정된 별칭 리소스에 대한 HTTP 요청(POST, GET, PUT, DELETE)을 통해 Azure AI Search 서비스에서 별칭을 만들고 관리할 수 있습니다. 별칭은 서비스 수준 리소스이며 검색 인덱스와 독립적으로 유지 관리됩니다. 검색 인덱스가 만들어지면 해당 검색 인덱스에 매핑되는 별칭을 만들 수 있습니다.

메모

문서 작업에서 별칭만 사용하거나 인덱스 정의를 가져와 업데이트할 수 있습니다. 별칭을 사용하여 인덱스를 삭제할 수 없고, 텍스트 분석 API와 함께 사용할 수 없으며, 인덱서에서 targetIndexName 사용할 수 없습니다.

본보기

다음 예제에서는 기존 검색 인덱스에 매핑되는 별칭을 만드는 방법을 보여 줍니다.

POST /aliases?api-version=2023-07-01-Preview
{   
  "name" : "my-alias",  
  "indexes" : ["my-index"]
}  

참고 항목

• Azure AI Search 인덱스 별칭 만들기