다음을 통해 공유

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 인스턴스에 대한 관리되는 게이트웨이가 아닌 자체 호스팅 게이트웨이에서만 지원됩니다.
  • 현재 gRPC API 테스트는 Azure Portal의 테스트 콘솔 또는 API Management 개발자 포털에서 지원되지 않습니다.
  • 가져오기는 단일 Protobuff(.proto) 파일로 제한됩니다.

필수 조건

gRPC API 추가

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

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

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

    포털에서 gRPC API를 만드는 스크린샷

  4. gRPC API 만들기 창에서 전체를 선택합니다.

  5. gRPC API의 경우 다음 설정을 지정해야 합니다.

    1. 업로드 스키마에서 가져올 API와 연결된 로컬 .proto 파일을 선택합니다.

    2. gRPC 서버 URL에 gRPC 서비스의 주소를 입력합니다. 주소는 HTTPS를 통해 액세스할 수 있어야 합니다.

    3. 게이트웨이에서 API를 노출하는 데 사용할 게이트웨이 리소스를 선택합니다.

      Important

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

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

  7. 만들기를 실행합니다.

    API가 API 목록에 추가됩니다. API의 설정 탭으로 이동하여 설정 업데이트를 확인할 수 있습니다.

.NET을 사용하여 gRPC 서비스 호출

.NET을 사용하여 gRPC 서비스를 호출하는 방법에 대한 자세한 내용은 다음 문서를 참조하세요.

다른 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 인스턴스로 이동합니다.

    포털에서 API Management 인스턴스로 이동하는 스크린샷

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

    포털의 개요 페이지에서 API를 선택하는 스크린샷.

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

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

    가져오기 선택

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

    포털에서 서비스를 선택하는 스크린샷