GRPC API importálása

A KÖVETKEZŐKRE VONATKOZIK: Fejlesztő | Alapszintű | Standard | Prémium

Ez a cikk bemutatja, hogyan importálhat egy gRPC-szolgáltatásdefiníciót API-ként az API Managementben. Ezután kezelheti az API-t az API Managementben, biztonságossá teheti a hozzáférést és más szabályzatokat alkalmazhat, és gRPC API-kéréseket továbbíthat az átjárón keresztül a gRPC háttérrendszernek.

Ha gRPC API-t szeretne hozzáadni az API Managementhez, a következőket kell elvégeznie:

  • Töltse fel az API protobuf (protokollpuffer) definíciós fájlját az API Managementbe.
  • Adja meg a gRPC szolgáltatás helyét.
  • Konfigurálja az API-t az API Managementben.

Az API Management a gRPC-szolgáltatás következő típusaival támogatja a továbbítást: unary, server streaming, client streaming, and bidirectional streaming. A gRPC-ről további információt a gRPC bemutatása című témakörben talál.

Megjegyzés

  • A gRPC API-k támogatottak a saját üzemeltetésű átjáróban és a felügyelt átjáróban a 2026. januártól létrehozott klasszikus szintű példányok esetében (előzetes verzió). Lépjen kapcsolatba az ügyfélszolgálattal, hogy engedélyezze a gRPC API támogatását az ezen dátum előtt létrehozott klasszikus rétegpéldányokban. A gRPC API-k jelenleg nem támogatottak a v2-szinteken.
  • A gRPC API-k tesztelése jelenleg nem támogatott az Azure Portal tesztkonzolján vagy az API Management fejlesztői portálon.
  • Az importálás egyetlen protobuf (.proto) fájlra korlátozódik.

Előfeltételek

GRPC API hozzáadása

  1. Az Azure Portalon nyissa meg az API Management-példányt.

  2. Az oldalsáv menüjében az API-k alatt válassza az API-kat.

  3. Az Új API definiálása területen válassza a gRPC lehetőséget.

    GRPC API portálon való létrehozásáról készített képernyőkép.

  4. A gRPC API létrehozása ablakban válassza a Teljes lehetőséget.

  5. GRPC API esetén adja meg a következő beállításokat:

    1. Adjon meg egy megjelenítendő nevet.

    2. A feltöltési séma esetében válassza ki az importálni kívánt API-hoz társított helyi .proto fájlt.

    3. A gRPC-kiszolgáló URL-címeként adja meg a gRPC szolgáltatás címét. A címnek HTTPS-en keresztül elérhetőnek kell lennie.

    4. Átjárók esetén válassza ki azt az átjáró-erőforrást, amelyet az API-t elérhetővé szeretne tenni.

  6. Adja meg a fennmaradó beállításokat az API konfigurálásához. Az első API-oktatóanyag importálása és közzététele ismerteti ezeket a beállításokat.

  7. Válassza a Létrehozás lehetőséget.

    A portál hozzáadja az API-t az API-k listájához. A beállítások megtekintéséhez és frissítéséhez lépjen az API Beállítások lapjára.

GRPC-szolgáltatások hívása a .NET használatával

A gRPC-szolgáltatások .NET használatával történő hívásával kapcsolatos információkért tekintse meg az alábbi cikkeket:

Egyéb API-k hozzáfűzése

Az API-kat különböző szolgáltatások által közzétett API-kból állíthatja össze, többek között a következőket:

  • OpenAPI-specifikáció
  • Egy SOAP API
  • A GraphQL programozási interfész (API)
  • Az Azure App Service-ben üzemeltetett webalkalmazás
  • Azure Functions
  • Azure Logic Apps
  • Azure Service Fabric

Megjegyzés

Api importálásakor a műveletek hozzá lesznek fűzve az aktuális API-hoz.

API hozzáfűzése egy meglévő API-hoz:

  1. Nyissa meg az Azure API Management-példányt az Azure Portalon:

    Képernyőkép az API Management-szolgáltatások oldalról.

  2. Válassza az API-kat az Áttekintés lapon, vagy válassza az API-kat> az oldalsáv menüjében.

    Képernyőkép, amelyen az API-k kiválasztása látható az Áttekintés lapon.

  3. Jelölje ki a három pontot (...) azon API mellett, amelyhez hozzá szeretne fűzni egy másik API-t.

  4. Válassza az Importálás lehetőséget a helyi menüből:

    Képernyőkép az Importálás parancsról.

  5. Válasszon egy szolgáltatást, amelyből importálni fogja az API-t.