다음을 통해 공유

인덱서 업데이트(Azure AI Search REST API)

  • 아티클

HTTP PUT 요청을 사용하여 기존 인덱서 정의를 업데이트할 수 있습니다. 요청 URI에서 업데이트할 인덱서의 이름을 지정합니다.

PUT https://[service name].search.windows.net/indexers/[indexer name]?api-version=[api-version]  
    Content-Type: application/json  
    api-key: [admin key]

인덱서 정의를 업데이트해도 자동으로 실행되지는 않지만 수정 사항 및 연결된 데이터 원본에 따라 다시 설정 및 다시 실행이 필요할 수 있습니다.

URI 매개 변수

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

요청 헤더

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

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

요청 본문

요청 본문 구문은 인덱서 만들기와 동일합니다.

기존 인덱서 업데이트 시 전체 정의가 요청 본문의 내용으로 바뀝니다. 일반적으로 업데이트에 사용할 가장 좋은 패턴은 GET을 사용하여 인덱서 정의를 검색하고 수정한 다음 PUT으로 업데이트하는 것입니다.

응답

요청이 성공적으로 실행되면 새 인덱서가 생성된 경우 ‘201 생성됨’이 반환되고 기존 인덱서가 업데이트된 경우 ‘204 콘텐츠 없음’이 반환됩니다.

참고 항목