다음을 통해 공유


OData API 가져오기

적용 대상: 모든 API Management 계층

이 문서에서는 API Management에서 OData 규격 서비스를 API로 가져오는 방법을 보여 줍니다.

이 문서에서는 다음 방법을 설명합니다.

  • Azure Portal을 사용하여 OData 메타데이터 설명 가져오기
  • 포털에서 OData 스키마 관리
  • OData API 보호

필수 조건

API Management 인스턴스로 이동

  1. Azure 포털에서 API Management 서비스를 검색하고 선택합니다.

    검색 결과에서 API Management 서비스를 보여 주는 스크린샷

  2. API Management 서비스 페이지에서 API Management 인스턴스를 선택합니다.

    API Management 서비스 페이지의 API Management 인스턴스를 보여 주는 스크린샷

OData 메타데이터 가져오기

  1. 왼쪽 메뉴에서 API API>를 선택한 다음 + API 추가를 선택합니다.

  2. 정의에서 만들기에서OData를 선택합니다.

    포털의 OData 설명에서 API를 만드는 스크린샷.

  3. API 설정을 입력합니다. 나중에 API의 설정 탭으로 이동하여 설정을 업데이트할 수 있습니다.

    1. OData 사양에서 OData 메타데이터 엔드포인트의 URL을 입력합니다. 이 값은 일반적으로 서비스 루트에 대한 URL로, 와 함께 /$metadata추가됩니다. 또는 가져올 로컬 OData XML 파일을 선택합니다.

    2. 추가 설정을 입력하여 API를 구성합니다. 이러한 설정은 첫 번째 API 가져오기 및 게시 자습서에 설명되어 있습니다.

  4. 만들기를 선택합니다.

    API가 API 목록에 추가됩니다. OData 메타데이터 설명에 노출되는 엔터티 집합 및 함수는 API의 엔터티 집합 및 함수 탭에 표시됩니다.

    OData 엔터티 집합 및 함수를 보여 주는 스크린샷

OData 스키마 업데이트

포털에서 편집기에 액세스하여 API의 OData 스키마를 볼 수 있습니다. API가 변경되면 파일 또는 OData 서비스 엔드포인트에서 API Management의 스키마를 업데이트할 수도 있습니다.

  1. 포털에서 API Management 인스턴스로 이동합니다.

  2. 왼쪽 메뉴에서 API를 선택한 다음, OData API를 선택합니다.

  3. 엔터티 집합 및 함수 탭에서 엔터티 집합 또는 함수 옆에 있는 줄임표(...)를 선택한 다음 편집을 선택합니다.

    편집 명령의 위치를 보여 주는 스크린샷

  4. 스키마를 검토합니다. 업데이트하려면 파일에서 업데이트 또는 엔드포인트에서 스키마 업데이트를 선택합니다.

    OData API에 대한 스키마 편집기의 스크린샷

OData API 테스트

  1. 왼쪽 메뉴에서 API를 선택한 다음, OData API를 선택합니다.

  2. 엔터티 집합 및 함수 탭에서 엔터티 집합 또는 함수 옆에 있는 줄임표(...)를 선택한 다음 테스트를 선택합니다.

    테스트 명령을 보여 주는 스크린샷.

  3. 테스트 콘솔에서 테스트에 대한 템플릿 매개 변수, 쿼리 매개 변수 및 헤더를 입력한 다음 테스트를 선택합니다. 포털에서 API를 테스트하는 방법에 대한 자세한 내용은 포털에서 새 API 테스트를 참조하세요.

OData API 보호

OData API 요청을 통한 공격으로부터 보호하기 위해 기존 인증 및 권한 부여 정책OData 유효성 검사 정책을 적용하여 OData API를 보호합니다.

포털의 API 정책 탭에서 OData API에 대한 정책을 구성합니다.

다른 API 추가

다음을 포함하여 다양한 서비스에서 노출되는 API에서 API를 작성할 수 있습니다.

  • OpenAPI 사양
  • SOAP 기반 API
  • GraphQL API
  • Azure App Service에서 호스트되는 웹앱
  • Azure Functions (애저 펑션)
  • Azure 논리 앱
  • Azure 서비스 패브릭

참고

API를 가져올 때 작업은 현재 API에 추가됩니다.

기존 API에 API를 추가하려면 다음을 수행합니다.

  1. Azure Portal에서 Azure API Management 인스턴스로 이동합니다.

    API Management 서비스 페이지를 보여 주는 스크린샷

  2. 개요 페이지에서 API를 선택하거나 왼쪽 메뉴에서 API API>를 선택합니다.

    개요 페이지의 API 선택을 보여 주는 스크린샷.

  3. 다른 API를 추가할 API 옆에 있는 줄임표(...)를 선택합니다.

  4. 드롭다운 메뉴에서 가져오기 를 선택합니다.

    가져오기 명령을 보여 주는 스크린샷.

  5. API를 가져올 서비스를 선택합니다.