Condividi tramite

Supporto delle API in App Web statiche di Azure con Funzioni di Azure

Le applicazioni Web front-end spesso chiamano le API back-end per dati e servizi. Per impostazione predefinita, le Azure Static Web Apps forniscono endpoint API serverless integrati tramite Funzioni di Azure.

Funzioni di Azure API in App Web statiche sono disponibili in due possibili configurazioni a seconda del piano di hosting:

  • Funzioni gestite: per impostazione predefinita, l'API di un'app Web statica è un'applicazione Funzioni di Azure gestita e distribuita da App Web statiche di Azure associata ad alcune restrizioni.

  • Bring your own functions: è possibile fornire un'applicazione Funzioni di Azure esistente di qualsiasi tipo di piano, che includa tutte le funzionalità di Funzioni di Azure. Con questa configurazione, si è responsabili della gestione di una distribuzione separata per l'app Funzioni.

La tabella seguente contrasta le differenze tra l'uso di funzioni gestite e esistenti.

Funzionalità Funzioni gestite Bring your own Functions
Accesso ai trigger e alle associazioni di Azure Functions Solo HTTP Tutto
Funzioni di Azure supportate runtime1 Vedere linguaggi e runtime supportati. Tutto
Funzioni di Azure piani di hosting supportati Consumo Consumo
Premio
Dedicato
Sicurezza integrata con accesso diretto all'autenticazione utente e ai dati di autorizzazione basati sui ruoli ✔ ✔
Integrazione del routing che rende il percorso disponibile per l'app Web in modo sicuro senza richiedere regole CORS personalizzate. ✔ ✔
Modello di programmazione Durable Functions ✕ ✔
Identità gestita ✕ ✔
Gestione dei token di autenticazione e autorizzazione del servizio app di Azure ✕ ✔
Funzioni API disponibili all'esterno di App Web statiche di Azure ✕ ✔
Riferimenti a Key Vault ✕ ✔

1 Per specificare la versione di runtime nelle funzioni gestite, aggiungere un file di configurazione all'app front-end e impostare la apiRuntime proprietà . Il supporto è soggetto ai criteri di supporto del runtime del linguaggio di Funzioni di Azure.

Le opzioni API per App Web statiche includono i servizi di Azure seguenti:

Per altre informazioni, vedere la panoramica delle API.

Impostazione

Gli endpoint API sono disponibili per l'app Web tramite la api route.

Funzioni gestite Bring your own functions
Mentre la /api route è fissa, è possibile controllare la posizione della cartella del codice sorgente dell'app di funzioni gestite. Per cambiare questo percorso, modificare il file YAML del flusso di lavoro che si trova nella cartella .github/workflows del repository. Le richieste alla /api route vengono inviate alla tua app esistente di Funzioni di Azure.

Risoluzione dei problemi e log

I log sono disponibili solo se si aggiunge Application Insights.

Funzioni gestite Bring your own functions
Attivare la registrazione abilitando Application Insights nell'app Web statica. Attivare la registrazione abilitando Application Insights nell'app Funzioni di Azure.

Vincoli

Oltre ai vincoli api App Web statiche, le restrizioni seguenti sono applicabili anche alle API Funzioni di Azure:

Funzioni gestite Bring your own functions
  • I trigger e le associazioni sono limitati a quelli HTTP.
  • L'app Funzioni di Azure deve trovarsi in Node.js 12, Node.js 14, Node.js 16, Node.js 18, Node.js 20 (anteprima), .NET Core 3.1, .NET 6.0, .NET 7.0, .NET 8.0, Python 3.8, Python 3.9 o Python 3.10.
  • Alcune impostazioni dell'applicazione vengono gestite dal servizio, pertanto i prefissi seguenti sono riservati dal runtime:
    • APPSETTING_, AZUREBLOBSTORAGE_, AZUREFILESSTORAGE_, AZURE_FUNCTION_, CONTAINER_, DIAGNOSTICS_, DOCKER_, FUNCTIONS_, IDENTITY_, MACHINEKEY_, MAINSITE_, MSDEPLOY_, SCMSITE_, SCM_, WEBSITES_, WEBSITE_, WEBSOCKET_, AzureWeb
  • Alcuni tag dell'applicazione vengono usati internamente dal servizio. Di conseguenza, i tag seguenti sono riservati:
    • AccountId, EnvironmentId, FunctionAppId.
  • Sei responsabile della gestione della distribuzione dell'app di Functions.

Passaggi successivi

Aggiungere un'API

  • Last updated on