Expressions de stratégie de la Gestion des API

S’APPLIQUE À : Tous les niveaux de Gestion des API

Cet article décrit la syntaxe des expressions de stratégie dans C# 7. Chaque expression a accès à :

• La variable de contexte fournie implicitement.
• Un sous-ensemble autorisé de types .NET Framework.

Syntaxe

• Expressions à instruction unique :
  • Inclus dans @(expression), où expression est une instruction d’expression C# bien formée.
• Expressions à plusieurs instructions :
  • Inclus dans @{expression}.
  • Tous les chemins d’accès de code au sein des expressions à instructions multiples doivent se terminer par une instruction return.

Exemples

@(true)

@((1+1).ToString())

@("Hi There".Length)

@(Regex.Match(context.Response.Headers.GetValueOrDefault("Cache-Control",""), @"max-age=(?<maxAge>\d+)").Groups["maxAge"]?.Value)

@(context.Variables.ContainsKey("maxAge") ? int.Parse((string)context.Variables["maxAge"]) : 3600)

@{
  string[] value;
  if (context.Request.Headers.TryGetValue("Authorization", out value))
  {
      if(value != null && value.Length > 0)
      {
          return Encoding.UTF8.GetString(Convert.FromBase64String(value[0]));
      }
  }
  return null;

}

Utilisation

Sauf si la référence de stratégie spécifie le contraire, les expressions peuvent être utilisées comme valeurs d’attribut ou valeurs de texte dans l’une des stratégies de la Gestion des API.

Types .NET Framework autorisés dans les expressions de stratégie

Le tableau suivant liste les types .NET Framework et les membres autorisés dans les expressions de stratégie.

Variable contextuelle

La variable context est implicitement disponible dans toutes les expressions de stratégie. Ses membres :

• Fournissent des informations relatives à la demande et à la réponse de l’API, ainsi que les propriétés associées.
• Sont en lecture seule.

Contenu connexe

Pour plus d’informations sur l’utilisation de stratégies, consultez les pages :

• Stratégies dans Gestion des API
• Tutoriel : Transformer et protéger vos API
• Référence de stratégie pour obtenir la liste complète des instructions et des paramètres de stratégie
• Référentiel d’extrait de stratégie
• Kit de ressources des stratégies Gestion des API Azure
• Créer des stratégies à l’aide de Microsoft Copilot dans Azure

Pour plus d'informations :

• Découvrez comment fournir des informations de contexte à votre service backend. Utilisez les stratégies Set query string parameter et Set HTTP header pour fournir ces informations.
• Découvrez comment utiliser la stratégie Validate JWT pour pré-autoriser l’accès aux opérations à partir de revendications de jetons.
• Découvrez comment utiliser une trace Inspecteur d’API pour détecter comment les stratégies sont évaluées et connaître les résultats de ces évaluations.
• Découvrez comment utiliser les expressions avec les stratégies Get from cache et Store to cache pour configurer la durée de mise en cache des réponses de Gestion des API. Définissez une durée qui correspond à la mise en cache des réponses du service principal comme le spécifie la directive Cache-Control du service principal.
• Découvrez comment effectuer le filtrage de contenu. Supprimez des éléments de données de la réponse reçue du service principal à l’aide des stratégies Control flow et Set body.
• Pour télécharger les instructions de stratégie, consultez le référentiel GitHub api-management-samples/policies.