Kiszolgáló nélküli REST API-k az Azure Functions használatával
Az Azure Functions egy alapvető számítási szolgáltatás, amellyel kiszolgáló nélküli REST-alapú API-kat hozhat létre. A HTTP-triggerek olyan REST-végpontokat tehetnek elérhetővé, amelyeket az ügyfelek meghívhatnak, például böngészőket, mobilalkalmazásokat és egyéb háttérszolgáltatásokat. Az útvonalak natív támogatásával egyetlen HTTP-aktivált függvény magas funkcionalitású REST API-t tehet elérhetővé. A Functions saját alapszintű kulcsalapú engedélyezési sémát is biztosít, amely segít korlátozni a hozzáférést csak bizonyos ügyfelek számára. További információ: Azure Functions HTTP-eseményindító
Bizonyos esetekben szükség lehet az API-ra a REST-viselkedések összetettebb halmazának támogatásához. Előfordulhat például, hogy több HTTP-függvényvégpontot kell egyetlen API-ba egyesítenie. Előfordulhat, hogy a kéréseket egy vagy több háttérbeli REST-szolgáltatásnak is át szeretné adni. Végül előfordulhat, hogy az API-k nagyobb fokú biztonságot igényelnek, amely lehetővé teszi a használatuk bevételszerzését.
Ma a függvények alapján összetettebb és robusztusabb API-k létrehozásához ajánlott az Azure API Management által biztosított átfogó API-szolgáltatások használata. Az API Management szabályzatalapú modellel szabályozza az útválasztást, a biztonságot és az OpenAPI-integrációt. Emellett olyan speciális szabályzatokat is támogat, mint a bevételszerzés sebességkorlátozása. A Functions-futtatókörnyezet korábbi verziói az örökölt Függvény-proxyk funkciót használták.
Fontos
Az Azure Functions-proxyk az Azure Functions-futtatókörnyezet 1.x és 3.x verzióinak örökölt funkciói. A proxyk támogatása újra engedélyezhető a 4.x verzióban, hogy sikeresen frissítse a függvényalkalmazásokat a legújabb futtatókörnyezeti verzióra. A lehető leghamarabb váltson a függvényalkalmazások Azure API Managementtel való integrálására. Az API Management lehetővé teszi, hogy kihasználja a függvényalapú API-k meghatározásához, biztonságossá tételéhez, kezeléséhez és értékesítéséhez használható funkciók egy teljesebb készletét. További információ: API Management-integráció.
Ha tudni szeretné, hogyan engedélyezheti újra a proxyk támogatását a Functions 4.x verziójában, olvassa el a Proxyk újbóli engedélyezését a Functions v4.x verziójában.
Váltás a Functions-proxykról az API Managementre
Amikor a Functions-proxykról az API Management használatára lép, integrálnia kell a függvényalkalmazást egy API Management-példánysal, majd konfigurálnia kell az API Management-példányt úgy, hogy az az előző proxyhoz hasonlóan működjön. Az alábbi szakasz hivatkozásokat tartalmaz azokra a vonatkozó cikkekre, amelyek segítenek az API Management és az Azure Functions használatának sikerességében.
Ha kihívást jelent a proxykról való áttérés, vagy ha az Azure API Management nem foglalkozik a konkrét forgatókönyvekkel, küldjön egy kérést az API Management visszajelzési fórumában.
API Management-integráció
Az API Management lehetővé teszi egy meglévő függvényalkalmazás importálását. Az importálást követően minden HTTP-aktivált függvényvégpont olyan API-vá válik, amelyet módosíthatja és kezelhet. Az importálás után az API Management használatával openAPI-definíciós fájlt is létrehozhat az API-khoz. Az importálás során a rendszer figyelmen kívül hagyja az engedélyezési szintű végpontokat.admin Az API Management és a Functions használatával kapcsolatos további információkért tekintse meg az alábbi cikkeket:
| Cikk | Leírás |
|---|---|
| Kiszolgáló nélküli API-k elérhetővé tétele HTTP-végpontokról az Azure API Management használatával | Bemutatja, hogyan hozhat létre új API Management-példányt egy meglévő függvényalkalmazásból az Azure Portalon. Minden nyelvet támogat. |
| Kiszolgáló nélküli API-k létrehozása a Visual Studióban az Azure Functions és az API Management integrációjával | Bemutatja, hogyan hozhat létre egy OpenAPI-bővítményt használó C#-projektet a Visual Studióval. Az OpenAPI-bővítmény lehetővé teszi a .NET API-k definiálását úgy, hogy attribútumokat alkalmaz közvetlenül a C#-kódra. |
| Rövid útmutató: Új Azure API Management szolgáltatáspéldány létrehozása az Azure Portal használatával | Hozzon létre egy új API Management-példányt a portálon. Miután létrehozott egy API Management-példányt, csatlakoztathatja azt a függvényalkalmazáshoz. A portálon kívüli egyéb létrehozási módszerek is támogatottak. |
| Azure-függvényalkalmazás importálása API-ként az Azure API Managementben | Azt mutatja be, hogyan importálhat egy meglévő függvényalkalmazást a meglévő HTTP-triggervégpontok felügyelt API-ként való elérhetővé tételéhez. Ez a cikk támogatja az új API létrehozását és a végpontok hozzáadását egy meglévő felügyelt API-hoz. |
Miután közzétette a függvényalkalmazás végpontjait az API Management használatával, az alábbi cikkek általános információkat nyújtanak a Függvényalapú API-k API-k API Management-példányban való kezeléséről.
| Cikk | Leírás |
|---|---|
| API szerkesztése | Bemutatja, hogyan dolgozhat az API Managementben üzemeltetett meglévő API-val. |
| Az Azure API Management szabályzatai | Az API Managementben a közzétevők a szabályzatok használatával konfigurálva módosíthatják az API viselkedését. A szabályzatok olyan utasítások gyűjteményei, amelyeket a rendszer egymást követően futtat egy API kérésére vagy válaszára reagálva. |
| API Management házirend-referencia | Az összes támogatott API Management-szabályzatot részletező hivatkozás. |
| API Management-szabályzatminták | Hasznos mintagyűjtemény API Management-szabályzatokkal a fő forgatókönyvekben. |
Örökölt függvény-proxyk
Az örökölt Functions-proxyk funkció a Functions-futtatókörnyezet 3.x-es és régebbi verziójához is biztosít alapszintű API-funkciókat.
Fontos
Az Azure Functions-proxyk az Azure Functions-futtatókörnyezet 1.x és 3.x verzióinak örökölt funkciói. A proxyk támogatása újra engedélyezhető a 4.x verzióban, hogy sikeresen frissítse a függvényalkalmazásokat a legújabb futtatókörnyezeti verzióra. A lehető leghamarabb váltson a függvényalkalmazások Azure API Managementtel való integrálására. Az API Management lehetővé teszi, hogy kihasználja a függvényalapú API-k meghatározásához, biztonságossá tételéhez, kezeléséhez és értékesítéséhez használható funkciók egy teljesebb készletét. További információ: API Management-integráció.
Ha tudni szeretné, hogyan engedélyezheti újra a proxyk támogatását a Functions 4.x verziójában, olvassa el a Proxyk újbóli engedélyezését a Functions v4.x verziójában.
A Functions Proxies cikk néhány alapvető tippet is hozzáadott az egyenértékű feladatok API Management használatával történő végrehajtásához. Jelenleg nem rendelkezünk olyan dokumentációval vagy eszközökkel, amelyek segíthetnek a meglévő Functions Proxies-implementációk API Managementbe való migrálásában.