Megosztás a következőn keresztül:


GRPC API importálása

A KÖVETKEZŐKRE VONATKOZIK: Fejlesztő | 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
  • Az API konfigurálása 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 hátteréről a gRPC bemutatása című témakörben olvashat.

Megjegyzés

  • A gRPC API-k jelenleg csak a saját üzemeltetésű átjáróban támogatottak; az API Management példányhoz tartozó felügyelt átjáróban nem.
  • 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 Protobuff -fájlra (.proto) korlátozódik.

Előfeltételek

GRPC API hozzáadása

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

  2. A bal oldali menüben válassza az API-k>+ API hozzáadása lehetőséget.

  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 a következő beállításokat kell megadnia:

    1. A Séma feltöltése területen válassza ki az importálni kívánt API-hoz társított helyi .proto fájlt.

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

    3. Az átjárókban válassza ki azt az átjáró-erőforrást, amelyet az API-t elérhetővé szeretne tenni.

      Fontos

      Nyilvános előzetes verzióban csak saját üzemeltetésű átjárót választhat ki. A felügyelt átjáró nem támogatott.

  6. Adja meg a fennmaradó beállításokat az API konfigurálásához. Ezeket a beállításokat az Importálja és tegye közzé az első API-ját oktatóanyag ismerteti.

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

    Az API hozzá lesz adva az API-k listájához. A beállítások frissítését az API Beállítások lapján tekintheti meg.

GRPC-szolgáltatások hívása .NET-tel

A gRPC-szolgáltatások .NET-tel való 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 (Felhasználói funkciók az Azure-ban)
  • 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-k lehetőséget az Áttekintés lapon, vagy válassza az API-k>API-k opciót a bal oldali menü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 a Importálás lehetőséget a legördülő 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.