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


OData API importálása

A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint

Ez a cikk bemutatja, hogyan importálhat egy OData-kompatibilis szolgáltatást API-ként az API Managementben.

Ebben a cikkben az alábbiakkal ismerkedhet meg:

  • OData-metaadat-leírás importálása az Azure Portal használatával
  • Az OData-séma kezelése a portálon
  • Az OData API védelme

Előfeltételek

  • EGY API Management-példány. Ha még nincs ilyenje, végezze el az alábbi rövid útmutatót: Azure API Management-példány létrehozása.

  • OData v2 vagy v4 néven közzétett szolgáltatás.

Nyissa meg az API Management-példányát

  1. Az Azure Portalon keresse meg és válassza ki az API Management-szolgáltatásokat.

    API Management-szolgáltatások kiválasztása

  2. Az API Management-szolgáltatások lapon válassza ki az API Management-példányt.

    Az API Management-példány kiválasztása

OData-metaadatok importálása

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

  2. A Létrehozás definícióból csoportban válassza az OData lehetőséget.

    Képernyőkép egy API létrehozásáról egy OData-leírásból a portálon.

  3. Adja meg az API-beállításokat. A beállítások később frissíthetők az API Beállítások lapján.

    1. Az OData specifikációban adjon meg egy URL-címet egy OData metaadat-végponthoz, amely általában a szolgáltatásgyökér URL-címe, amelyhez /$metadatahozzá van fűzve. Másik lehetőségként válasszon egy importálandó helyi OData XML-fájlt.

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

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

    Az API hozzá lesz adva az API-k listájához. Az OData metaadatok leírásában közzétett entitáskészletek és függvények az API Entitáskészletek és függvények lapján jelennek meg.

    Képernyőkép a portál OData-entitáskészleteiről és függvényeiről.

Az OData-séma frissítése

A portál egyik szerkesztőjéhez hozzáférhet az API OData-sémájának megtekintéséhez. Ha az API megváltozik, a sémát egy fájlból vagy egy OData-szolgáltatásvégpontból is frissítheti az API Managementben.

  1. A portálon keresse meg az API Management-példányt.

  2. A bal oldali menüben válassza az OData API API-kat> .

  3. Az Entitáskészletek és függvények lapon válassza az entitáskészlet vagy függvény melletti helyi menüt (...), és válassza a Szerkesztés lehetőséget.

    Képernyőkép a portálon beállított OData-entitás helyi menüjéről.

  4. Tekintse át a sémát. Ha frissíteni szeretné, válassza a Frissítés fájlból vagy a Séma frissítése a végpontról lehetőséget.

    Az OData API sémaszerkesztőjének képernyőképe a portálon.

Az OData API tesztelése

  1. A bal oldali menüben válassza az OData API API-kat> .

  2. Az Entitáskészletek és függvények lapon válassza az entitáskészlet vagy függvény melletti helyi menüt (...), majd válassza a Tesztelés lehetőséget.

    Képernyőkép a portálon beállított OData-entitás helyi menüjének Tesztelés lehetőségéről.

  3. A tesztkonzolon adja meg a teszt sablonparamétereit, lekérdezési paramétereit és fejléceit, majd válassza a Tesztelés lehetőséget. További információ az API-k portálon való teszteléséről.

Az OData API védelme

Az OData API biztonságossá tételéhez alkalmazza a meglévő hitelesítési és engedélyezési szabályzatokat , valamint egy OData érvényesítési szabályzatot , amely az OData API-kéréseken keresztüli támadások ellen nyújt védelmet.

Tipp.

A portálon konfigurálja az OData API szabályzatait az API-szabályzatok lapon.

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

Különböző szolgáltatások által közzétett API-kat készíthet, többek között az alábbiakat:

  • OpenAPI-specifikáció
  • A SOAP API
  • A GraphQL API
  • A Azure-alkalmazás Service-ben üzemeltetett webalkalmazás
  • Azure-függvényalkalmazás
  • Azure Logic Apps
  • Azure Service Fabric

Fűzjön hozzá egy másik API-t a meglévő API-hoz az alábbi lépésekkel.

Feljegyzés

Egy másik API importálásakor a műveletek hozzáfűződnek az aktuális API-hoz.

  1. Nyissa meg az Azure API Management-példányát az Azure Portalon.

    Képernyőkép az API Management-példányra való navigálásról a portálon.

  2. Válassza az API-kat az Áttekintés lapon vagy a bal oldali menüben.

    Képernyőkép az API-k kiválasztásáról a portál Áttekintés lapján.

  3. Kattintson a ... elemre azon API mellett, amelyhez egy másik API-t szeretne hozzáfűzni.

  4. Válassza az Importálás elemet a legördülő menüből.

    Importálás kiválasztása

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

    Képernyőkép egy szolgáltatás kiválasztásáról a portálon.