다음을 통해 공유

OData API 가져오기

  • 아티클

적용 대상: 모든 API Management 계층

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

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

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

필수 조건

API Management 인스턴스로 이동

  1. Azure Portal에서 API Management 서비스를 검색하여 선택합니다.

    API Management Services 선택

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

    API Management 인스턴스 선택

OData 메타데이터 가져오기

  1. 왼쪽 메뉴에서 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. 엔터티 집합 및 함수 탭에서 엔터티 집합 또는 함수 옆에 있는 바로 가기 메뉴(...)를 선택하고 편집을 선택합니다.

    포털에 설정된 OData 엔터티에 대한 바로 가기 메뉴 스크린샷.

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

    포털의 OData API용 스키마 편집기 스크린샷.

OData API 테스트

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

  2. 엔터티 집합 및 함수 탭에서 엔터티 집합 또는 함수 옆에 있는 바로 가기 메뉴(...)를 선택하고 테스트를 선택합니다.

    포털에 설정된 OData 엔터티에 대한 바로 가기 메뉴의 테스트 옵션 스크린샷.

  3. 테스트 콘솔에서 테스트에 대한 템플릿 매개 변수, 쿼리 매개 변수 및 헤더를 입력하고 테스트를 선택합니다. 포털에서 API 테스트에 대해 자세히 알아봅니다.

OData API 보호

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

팁

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

다른 API 추가

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

  • OpenAPI 사양
  • SOAP API
  • GraphQL API
  • Azure App Service에서 호스팅되는 웹앱
  • Azure 함수 앱
  • Azure Logic Apps
  • Azure Service Fabric

다음 단계를 사용하여 기존 API에 다른 API를 추가합니다.

참고 항목

다른 API를 가져오면 작업이 현재 API에 추가됩니다.

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

    Azure API Mgmt 인스턴스로 이동

  2. 개요 페이지 또는 왼쪽 메뉴에서 API를 선택합니다.

    API 선택

  3. 다른 API를 추가하려는 API 옆에 있는 ...를 클릭합니다.

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

    가져오기 선택

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

    서비스 선택