인덱스 삭제(Azure AI Search REST API)

  • 아티클

인덱스 삭제 작업은 Azure AI Search Service 인덱스 및 해당 콘텐츠를 영구적으로 제거합니다. 이 작업은 복구 옵션이 없는 최종 작업입니다. 다시 빌드가 필요한 경우 인덱스 정의 코드의 마스터 복사본, 데이터 수집 코드 및 외부 데이터 원본의 백업이 있는지 확인합니다.

DELETE https://[service name].search.windows.net/indexes/[index name]?api-version=[api-version]  
  Content-Type: application/json  
  api-key: [admin key]

현재 별칭에 매핑된 인덱스를 삭제하려고 하면 인덱스를 삭제하기 전에 해당 인덱스에 매핑된 별칭을 삭제하거나 다른 인덱스에 매핑해야 한다는 오류 메시지와 함께 400(잘못된 요청)으로 작업이 실패합니다.

URI 매개 변수

매개 변수 Description
서비스 이름 필수 사항입니다. 검색 서비스의 고유한 사용자 정의 이름으로 설정합니다.
인덱스 이름 필수 사항입니다. 요청 URI는 삭제할 인덱스의 이름을 지정합니다.
api-version 필수 사항입니다. 현재 안정적인 버전은 입니다 api-version=2020-06-30. 더 많은 버전은 API 버전을 참조하세요.

요청 헤더

다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.

필드 Description
콘텐츠 형식 필수 사항입니다. application/json
api-key Azure 역할을 사용하고 요청에 전달자 토큰이 제공된 경우 선택 사항이며, 그렇지 않으면 키가 필요합니다. api-key는 검색 서비스에 대한 요청을 인증하는 고유한 시스템 생성 문자열입니다. 삭제 요청에는 쿼리 키와 api-key 달리 관리자 키로 설정된 헤더가 포함되어야 합니다. 자세한 내용은 키 인증을 사용하여 Azure AI Search에 연결을 참조하세요.

요청 본문

없음

응답

상태 코드: 응답에 성공하면 ‘204 콘텐츠 없음’이 반환됩니다.

추가 정보