데이터 원본 업데이트(Azure AI Search REST API)
수정된 버전으로 기존 데이터 원본 정의를 덮어씁니다.
PUT https://[service name].search.windows.net/datasources/[data source name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
URI 매개 변수
| 매개 변수 | Description |
|---|---|
| 서비스 이름 | 필수 사항입니다. 검색 서비스의 고유한 사용자 정의 이름으로 설정합니다. |
| 데이터 원본 이름(data source name) | 필수 사항입니다. 요청 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 콘텐츠 없음
참고
기존 데이터 원본의 경우 일부 속성을 업데이트할 수 없습니다. 예를 들어 기존 데이터 원본의 형식은 변경할 수 없습니다.