Az API Management szolgáltatás felfedezése

  • 3 perc

Az API Management alapvető funkciókat biztosít a sikeres API-programok biztosításához a fejlesztői előjegyzés, az üzleti elemzések, az elemzések, a biztonság és a védelem révén. Minden API egy vagy több műveletből áll, és minden API-t hozzá lehet adni egy vagy több termékhez. Az API-k használatához a fejlesztőknek elő kell fizetniük egy termékre, amely tartalmazza az adott API-t, utána meghívhatják az API műveletét, amelyre érvényesek az esetleg érvényben lévő használati házirendek.

API Management-összetevők

Az Azure API Management egy API-átjáróból, egy felügyeleti síkból és egy fejlesztői portálból áll. Ezek az összetevők alapértelmezés szerint az Azure által üzemeltetett és teljes körűen felügyelt összetevők. Az API Management a kapacitás és a funkciók különböző szintjeiben érhető el.

  • Az API-átjáró az a végpont, amely:

    • Fogadja az API-hívásokat, és átirányítja őket a megfelelő háttérrendszerekre
    • Az API-kulcsok és a kérésekkel megjelenített egyéb hitelesítő adatok ellenőrzése
    • Használati kvóták és díjkorlátok kikényszerítése
    • Átalakítja a házirend-utasításokban megadott kéréseket és válaszokat
    • A válaszok gyorsítótárazása a válasz késésének javítása és a háttérszolgáltatások terhelésének minimalizálása érdekében
    • Naplókat, metrikákat és nyomkövetéseket bocsát ki monitorozáshoz, jelentéskészítéshez és hibaelhárításhoz

  • A felügyeleti sík az a felügyeleti felület, ahol beállítja az API-programot. A következőkre lehet használni:

    • AZ API Management szolgáltatás beállításainak kiépítése és konfigurálása
    • API-séma definiálása vagy importálása
    • API-k csomagolása termékekbe
    • Szabályzatok, például kvóták vagy átalakítások beállítása az API-kban
    • Elemzési adatok lekérése
    • Manage users

  • A Fejlesztői portál egy automatikusan létrehozott, teljesen testre szabható webhely az API-k dokumentációjával. A fejlesztői portál használatával a fejlesztők a következő lépéseket tehetik:

    • API-dokumentáció olvasása
    • API meghívása az interaktív konzolon keresztül
    • Fiók létrehozása és feliratkozás API-kulcsok lekéréséhez
    • Saját használaton alapuló elemzések elérése
    • API-definíciók letöltése
    • API-kulcsok kezelése

Products

Az API-k a termékeken keresztül válnak elérhetővé a fejlesztők számára. Az API Management szolgáltatásban a termékek egy vagy több API-val rendelkeznek, emellett címmel, leírással és használati feltételekkel vannak konfigurálva. A termékeknek két típusa létezik: Nyílt és Védett. A védett termékeket csak előfizetők használhatják, míg a nyílt termékeket előfizetés nélkül is lehet használni. Az előfizetés jóváhagyása termékszinten van konfigurálva, és rendszergazdai jóváhagyást igényelhet, vagy automatikusan alkalmazható.

Groups

A csoportok használatával szabályozható a fejlesztők hozzáférése a termékhez. Az API Management az alábbi megváltoztathatatlan rendszercsoportokkal rendelkezik:

  • Rendszergazda istratorok – API Management-szolgáltatáspéldányok kezelése és a fejlesztők által használt API-k, műveletek és termékek létrehozása. Az Azure-előfizetés rendszergazdái ennek a csoportnak a tagjai.
  • Fejlesztők – Hitelesített fejlesztői portál felhasználói, amelyek alkalmazásokat készítenek az API-k használatával. A fejlesztők hozzáférhetnek a fejlesztői portálhoz, és olyan alkalmazásokat készíthetnek, amelyek egy API műveleteit hívják meg.
  • Vendégek – Nem hitelesített fejlesztői portál felhasználói. Bizonyos írásvédett hozzáférést kaphatnak, például megtekinthetik az API-kat, de nem hívhatják meg őket.

Ezen rendszercsoportok mellett a rendszergazdák egyéni csoportokat is létrehozhatnak, vagy külső csoportokat használhatnak a társított Microsoft Entra-bérlőkben.

Fejlesztők

A fejlesztők képviselik a felhasználói fiókokat az API Management szolgáltatáspéldányban. A fejlesztőket létrehozhatják vagy meghívhatják a rendszergazdák, vagy a Fejlesztői portálon is regisztrálhatnak. Minden fejlesztő egy vagy több csoport tagja, és előfizethet azokra a termékekre, amelyek láthatóságot biztosítanak a csoportjaik számára.

Házirendek

A házirendek utasítások gyűjteményei, amelyeket az API-k kérelmei és válaszai szerint egymást követően hajtanak végre. A népszerű utasítások közé tartozik a formátumátalakítás XML-ről JSON-ra, a hívások sebességének korlátozása a fejlesztőktől érkező hívások számának korlátozásához és számos más elérhető házirend.

A házirend-kifejezéseket attribútumértékekként vagy szövegértékekként lehet használni bármelyik API Management házirendben, hacsak a házirend másként nem rendelkezik. Néhány házirend, például a Vezérlés folyamata és a Változó beállítása házirend-kifejezéseken alapul.

A szabályzatok az igényeitől függően különböző hatókörökben alkalmazhatók: globális (minden API), termék, adott API vagy API-művelet.