API-támogatás az Azure Static Web Appsben Azure Functions-függvényekkel
Az előtérbeli webalkalmazások gyakran visszahívják az adat- és szolgáltatásoldali végfelhasználói API-kat. Az Azure Static Web Apps alapértelmezés szerint beépített kiszolgáló nélküli API-végpontokat biztosít az Azure Functionsen keresztül.
A Static Web Apps Azure Functions API-jai az üzemeltetési tervtől függően két lehetséges konfigurációban érhetők el:
Felügyelt függvények: A statikus webalkalmazások API-ja alapértelmezés szerint egy Azure Functions-alkalmazás, amelyet az Azure Static Web Apps felügyel és helyez üzembe bizonyos korlátozásokkal együtt.
Saját függvények használata: Igény szerint bármilyen csomagtípusú meglévő Azure Functions-alkalmazást biztosíthat, amely az Azure Functions összes funkcióját tartalmazza. Ezzel a konfigurációval Ön felel a Functions-alkalmazás különálló üzembe helyezéséért.
Az alábbi táblázat a felügyelt és a meglévő függvények közötti különbségeket hasonlítja össze.
Szolgáltatás | Felügyelt függvények | Saját Függvények használata |
---|---|---|
Hozzáférés az Azure Functions eseményindítóihoz és kötéseihez | Csak HTTP | Mind |
Támogatott Azure Functions-futtatókörnyezetek 1 | Node.js 12 Node.js 14 Node.js 16 Node.js 18 .NET Core 3.1 .NET 6.0 .NET 7.0 Python 3.8 Python 3.9 Python 3.10 |
Mind |
Támogatott Azure Functions-üzemeltetési csomagok | Felhasználás | Felhasználás Prémium Dedikált |
Integrált biztonság a felhasználói hitelesítéshez és a szerepköralapú engedélyezési adatokhoz való közvetlen hozzáféréssel | ✔ | ✔ |
Útválasztási integráció , amely az /api útvonalat biztonságosan elérhetővé teszi a webalkalmazás számára egyéni CORS-szabályok megkövetelése nélkül. |
✔ | ✔ |
Elosztott függvények (előzetes verzió) a háttérbeli számítás dinamikus globális elosztásához. | ✔ | ✕ |
Durable Functions programozási modell | ✕ | ✔ |
Kezelt identitás | ✕ | ✔ |
Azure-alkalmazás szolgáltatáshitelesítési és engedélyezési jogkivonat-kezelés | ✕ | ✔ |
Az Azure Static Web Appsen kívül elérhető API-függvények | ✕ | ✔ |
Key Vault-hivatkozások | ✕ | ✔ |
1 A futtatókörnyezeti verzió felügyelt függvényekben való megadásához adjon hozzá egy konfigurációs fájlt az előtéralkalmazáshoz, és állítsa be a tulajdonságotapiRuntime
. A támogatásra az Azure Functions nyelvi futtatókörnyezet támogatási szabályzata vonatkozik.
A Static Web Apps API-beállításai a következő Azure-szolgáltatásokat tartalmazzák:
További információkért tekintse meg az API-k áttekintését .
Feljegyzés
Az elosztott függvények felügyelt függvényekkel érhetők el. Az elosztott függvények automatikusan elosztják a felügyelt függvényeket a nagy kérésterhelésű régiók között.
Konfiguráció
Az API-végpontok az útvonalon keresztül érhetők el a webalkalmazás számára api
.
Felügyelt függvények | Saját függvények használata |
---|---|
Amíg az /api útvonal ki van javítva, ön szabályozhatja a felügyelt függvényalkalmazás forráskódmappájának helyét. Ezt a helyet az adattár .github/workflows mappájában található munkafolyamat YAML-fájljának szerkesztésével módosíthatja. |
Az útvonalra irányuló kéréseket a /api rendszer elküldi a meglévő Azure Functions-alkalmazásnak. |
Hibaelhárítás és naplók
A naplók csak akkor érhetők el, ha alkalmazás Elemzések ad hozzá.
Felügyelt függvények | Saját függvények használata |
---|---|
Kapcsolja be a naplózást az Alkalmazás Elemzések statikus webalkalmazáson való engedélyezésével. | Kapcsolja be a naplózást úgy, hogy engedélyezi az Alkalmazás Elemzések az Azure Functions-alkalmazásban. |
Megszorítások
A Static Web Apps API korlátozásai mellett az alábbi korlátozások az Azure Functions API-kra is érvényesek:
Felügyelt függvények | Saját függvények használata |
---|---|
|
|
Következő lépések
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: