Az API Management szolgáltatás felfedezése
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.