Prise en charge des API dans Azure Static Web Apps (préversion) avec Azure FunctionsAPI support in Azure Static Web Apps Preview with Azure Functions

Azure Static Web Apps fournit des points de terminaison d’API serverless via Azure Functions.Azure Static Web Apps provides serverless API endpoints via Azure Functions. En tirant parti d’Azure Functions, les API sont mises à l’échelle dynamiquement en fonction de la demande et elles incluent les fonctionnalités suivantes :By leveraging Azure Functions, APIs dynamically scale based on demand, and include the following features:

  • Sécurité intégrée avec accès direct aux données d’authentification et d’autorisation basées sur les rôles.Integrated security with direct access to user authentication and role-based authorization data.
  • Routage transparent qui met l’itinéraire api à la disposition de l’application web en toute sécurité sans nécessiter de règles CORS personnalisées.Seamless routing that makes the api route available to the web app securely without requiring custom CORS rules.
  • Azure Functions v3 compatible avec Node.js 12, .NET Core 3.1 et Python 3.8.Azure Functions v3 compatible with Node.js 12, .NET Core 3.1, and Python 3.8.
  • Déclencheurs HTTP et liaisons d’entrée/sortie.HTTP triggers and input/output bindings.

ConfigurationConfiguration

Les points de terminaison d’API sont disponibles pour l’application web via l’itinéraire api.API endpoints are available to the web app through the api route. Bien que cet itinéraire soit résolu, vous pouvez contrôler le dossier et le projet dans lequel vous recherchez l’application Azure Functions associée.While this route is fixed, you have control over the folder and project where you locate the associated Azure Functions app. Vous pouvez modifier cet emplacement en modifiant le fichier YAML de flux de travail situé dans le dossier . GitHub/workflows de votre référentiel.You can change this location by editing the workflow YAML file located in your repository's .github/workflows folder.

ContraintesConstraints

Azure Static Web Apps fournit une API via Azure Functions.Azure Static Web Apps provides an API through Azure Functions. Les fonctionnalités d’Azure Functions sont axées sur un ensemble spécifique de fonctionnalités qui vous permettent de créer une API pour une application web et de permettre à celle-ci de se connecter à l’API en toute sécurité.The capabilities of Azure Functions are focused to a specific set of features that enable you to create an API for a web app and allow the web app to connect to API securely. Ces fonctionnalités sont fournies avec certaines contraintes, notamment :These features come with some constraints, including:

  • Le préfixe d’itinéraire de l’API doit être api.The API route prefix must be api.
  • L’API doit être une application JavaScript, C# ou application Python Azure Functions.The API must either be a JavaScript, C#, or Python Azure Functions app.
  • Les règles de routage pour les fonctions d’API prennent uniquement en charge les redirections et la sécurisation des itinéraires avec des rôles.Route rules for API functions only support redirects and securing routes with roles.
  • Les déclencheurs sont limités à HTTP.Triggers are limited to HTTP.
    • Toutes les liaisons d’entrée et de sortie sont prises en charge.Input and output bindings are supported.
  • Les journaux ne sont disponibles que si vous ajoutez Application Insights à votre application Functions.Logs are only available if you add Application Insights to your Functions app.

Étapes suivantesNext steps