동의어 맵 가져오기(Azure Cognitive Search REST API)

동의어 맵 가져오기 작업은 Azure Cognitive Search 동의어 맵 정의를 가져옵니다.

GET https://[service name].search.windows.net/synonymmaps/[synonymmap 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 필수 요소. api-key는 Search Service 요청을 인증하는 데 사용됩니다. 서비스에 고유한 문자열 값입니다. 서비스에서 개체 정의에 대한 가져오기 요청에는 쿼리 키가 아니라 관리자 키로 설정된 api-key 필드가 포함되어야 합니다. Azure Portal 검색 서비스 대시보드에서 API 키를 찾을 수 있습니다.

요청 본문

없음

응답

상태 코드: 응답에 성공하면 ‘200 OK’가 반환됩니다.

응답은 동의어 맵 만들기(Azure Cognitive Search REST API)의 예제와 유사합니다.

{
    "name" : "synonymmap1",  
    "format" : "solr",  
    "synonyms" : "United States, United States of America, USA\n
    Washington, Wash. => WA",
    "encryptionKey": null
}

참고

동의어 맵에 암호화 키가 있는 경우 검색 서비스는 동의어 맵 정의를 검색하기 위해 암호화 키에 액세스할 수 있어야 합니다. 암호화 키에 액세스하지 않으면 400 잘못된 요청이 반환됩니다. 키에 대한 액세스를 복원하면 검색 서비스에서 동의어 맵 정의를 다시 검색할 수 있습니다.

참고 항목