Azure İşlevleri ile Azure Static Web Apps'de API desteği

  • Makale
  • Okumak için 2 dakika

Azure Static Web Apps aracılığıyla sunucusuz API uç noktaları Azure İşlevleri. Api'Azure İşlevleri kullanarak isteğe bağlı olarak dinamik olarak ölçeklendirin ve aşağıdaki özellikleri dahil edin:

  • Kullanıcı kimlik doğrulamasına ve rol tabanlı yetkilendirme verilerine doğrudan erişimle tümleşik güvenlik.

  • Api rotasını özel CORS kurallarına gerek kalmadan web uygulamasının kullanımına güvenli bir şekilde sağlayan sorunsuz yönlendirme.

Azure Static Web Apps API'ler barındırma planına bağlı olarak iki olası yapılandırma tarafından de desteklemektedir:

  • Yönetilen işlevler: Varsayılan olarak, statik web uygulamasının API'si, Azure İşlevleri bir uygulama tarafından yönetilen ve Azure Static Web Apps bir uygulamadır.

  • Kendi işlevlerinizi getirin: İsteğe bağlı olarak, herhangi bir plan Azure İşlevleri mevcut bir uygulama oluşturabilirsiniz. Bu uygulamanın tüm özelliklerine Azure İşlevleri. Bu yapılandırmayla, İşlevler uygulaması için ayrı bir dağıtımı işlemek sizin sorumluluğundadır.

Aşağıdaki tabloda, yönetilen işlevlerin ve mevcut işlevlerin kullanımı arasındaki farklar karşıtlıklıdır.

Özellik Yönetilen İşlevler Kendi İşlevlerinizi Getirin
Azure İşlevleri erişimi Yalnızca Http Tümü
Desteklenen Azure İşlevleri çalışma zamanları Node.js 12
.NET Core 3.1
.NET 6.0
Python 3.8		 Tümü
Desteklenen Azure İşlevleri planları Tüketim Tüketim
Premium
Ayrılmış
Kullanıcı kimlik doğrulamasına ve rol tabanlı yetkilendirme verilerine doğrudan erişimle tümleşik güvenlik ✔ ✔
Özel CORS kurallarına gerek kalmadan API yolunu web uygulamasına güvenli bir şekilde kullanılabilir hale yapan yönlendirme tümleştirmesi. ✔ ✔
Dayanıklı İşlevler programlama modeli ✕ ✔
Yönetilen kimlik ✕ ✔
Azure App Service Kimlik Doğrulaması ve Yetkilendirme belirteci yönetimi ✕ ✔
API işlevleri, Azure Static Web Apps ✕ ✔
Key Vault başvuruları ✕ ✔

Yapılandırma

API uç noktaları, API yolu üzerinden web uygulaması tarafından kullanılabilir.

Yönetilen işlevler Kendi işlevlerinizi getirin
API yolu düzeltilse de, yönetilen işlevler uygulamasının kaynak kod klasörü konumu üzerinde denetime sahip olursanız. Deponun .github/workflows klasöründe bulunan iş akışı YAML dosyasını düzenleyerek bu konumu değiştirebilirsiniz. API yolu istekleri mevcut uygulamanıza Azure İşlevleri.

Sorun giderme ve günlükler

Günlükler yalnızca Application Analizler.

Yönetilen işlevler Kendi işlevlerinizi getirin
Statik web uygulamanıza Uygulama uygulama Analizler etkinleştirerek günlüğe kaydetmeyi açın. Uygulama uygulamanıza uygulama uygulamanıza Analizler etkinleştirerek Azure İşlevleri açın.

Kısıtlamalar

Yönetilen işlevler Kendi işlevlerinizi getirin
  • Tetikleyiciler HTTP ile sınırlıdır.
  • Azure İşlevleri uygulamanın 12, Node.js .NET Core 3.1, .NET 6.0 veya Python 3.8'de olması gerekir.
  • Bazı uygulama ayarları hizmet tarafından yönetiliyor, bu nedenle aşağıdaki ön ekler çalışma zamanı tarafından ayrılmıştır:
    • APPSETTING _ , AZUREBLOBSTORAGE _ , AZUREFILESSTORAGE _ , AZURE_FUNCTION , CONTAINER , _ _ DIAGNOSTICS , _ DOCKER , _ FUNCTIONS , IDENTITY _ , _ MACHINEKEY , _ MAINSITE , _ MSDEPLOY _ , SCMSITE _ , SCM , WEBSITES , _ _ _ WEBSITESI , WEBSOCKET _ , AzureWeb
  • İşlevler uygulaması dağıtımını yönetmek sizin sorumluluğundadır.

Sonraki adımlar

API ekleme