다음을 통해 공유

gRPC API 가져오기

적용 대상: 개발자 | 프리미엄

본 문서는 API Management 환경에서 gRPC 서비스 정의를 API 형태로 가져오는 절차를 안내합니다. 그런 다음 API Management에서 API를 관리하고, 액세스를 보호하고, 다른 정책을 적용하고, gRPC API 요청을 게이트웨이를 통해 gRPC 백 엔드에 전달할 수 있습니다.

API Management에 gRPC API를 추가하기 위해서는 다음의 단계를 따라야 합니다.

  • API의 protobuf(프로토콜 버퍼) 정의 파일을 API Management에 업로드합니다.
  • gRPC 서비스의 위치를 지정합니다.
  • API Management에서 API를 구성합니다.

API Management는 단일 요청-응답 방식뿐만 아니라 서버, 클라이언트, 그리고 양방향 스트리밍 등 모든 형태의 gRPC 서비스 메서드 통과를 지원합니다. gRPC에 대한 자세한 내용은 gRPC 소개를 참조하세요.

참고

  • gRPC API는 현재 API Management 인스턴스의 관리형 게이트웨이에서는 이용할 수 없으며, 오직 자체 호스팅 게이트웨이를 통해서만 지원됩니다.
  • 다만, Azure Portal의 테스트 콘솔이나 API Management 개발자 포털에서는 gRPC API 테스트 기능을 아직 제공하지 않습니다.
  • 가져오기는 단일 protobuf(.proto) 파일로 제한됩니다.

필수 구성 요소

gRPC API 추가

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

  2. 사이드바 메뉴의 API 아래에서 API를 선택합니다.

  3. 새 API 정의에서 gRPC를 선택합니다.

    포털에서 gRPC API를 생성하는 과정을 보여주는 화면 스크린샷입니다.

  4. gRPC API 만들기 창에서 전체를 선택하세요.

  5. gRPC API를 사용하려면 다음의 설정 항목들을 지정해야 합니다.

    1. 표시 이름을 입력합니다.

    2. 업로드 스키마의 경우 가져올 API와 연결된 로컬 .proto 파일을 선택합니다.

    3. gRPC 서버 URL의 경우 gRPC 서비스의 주소를 입력합니다. 해당 주소는 반드시 HTTPS을 통해 접근 가능해야 합니다.

    4. 게이트웨이의 경우 API를 노출하는 데 사용할 게이트웨이 리소스를 선택합니다.

      중요합니다

      공개 미리 보기 단계에서는 자체 호스팅 게이트웨이만을 선택하여 사용할 수 있습니다. 관리 게이트웨이는 지원되지 않습니다.

  6. 나머지 설정을 입력하여 API를 구성합니다. 이러한 구성 방식은 API를 호출하고 게시하는 과정을 다룬 첫 번째 튜토리얼에서 자세히 확인하실 수 있습니다.

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

    API는 APIs 목록에 추가됩니다. API 설정 탭에서 최신 설정 업데이트 내역을 확인할 수 있습니다.

.NET으로 gRPC 서비스 호출

.NET 환경에서 gRPC 서비스를 호출하는 구체적인 방법은 아래 문서에서 확인할 수 있습니다.

다른 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를 불러올 서비스를 선택하세요.

관련 콘텐츠

  • Last updated on