Définir une variable

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

La stratégie set-variable déclare une variable de set-variable et lui affecte une valeur spécifiée par le biais d’une expression ou d’un littéral chaîne. Si l’expression contient un littéral, il sera converti en chaîne et le type de la valeur sera System.String.

Notes

Définissez les éléments enfants et de stratégie dans l’ordre fourni dans l’instruction de stratégie. En savoir plus sur comment définir ou modifier des stratégies du service Gestion des API.

Instruction de la stratégie

<set-variable name="variable name" value="Expression | String literal" />

Attributs

Attribut	Description	Obligatoire
name	Nom de la variable. Les expressions de stratégie ne sont pas autorisées.	Oui
value	Valeur de la variable. Peut être une expression ou une valeur littérale. Les expressions de stratégie sont autorisées.	Oui

Usage

• Sections de la stratégie : inbound, outbound, backend, on-error
• Étendues de la stratégie : global, espace de travail, produit, API, opération
• Passerelles : classiques, v2, consommation, auto-hébergées, espace de travail

Types autorisés

Les expressions utilisées dans la stratégie set-variable doivent renvoyer un des types de base suivants.

• System.Boolean
• System.SByte
• System.Byte
• System.UInt16
• System.UInt32
• System.UInt64
• System.Int16
• System.Int32
• System.Int64
• System.Decimal
• System.Single
• System.Double
• System.Guid
• System.String
• System.Char
• System.DateTime
• System.TimeSpan
• System.Byte?
• System.UInt16?
• System.UInt32?
• System.UInt64?
• System.Int16?
• System.Int32?
• System.Int64?
• System.Decimal?
• System.Single?
• System.Double?
• System.Guid?
• System.String?
• System.Char?
• System.DateTime?

Exemple

L’exemple suivant montre une stratégie set-variable dans la section inbound. Cette stratégie de variable définie crée une variable isMobile booléenne définie sur true si l'en-tête de demande User-Agent contient le texte iPad ou iPhone.

<set-variable name="IsMobile" value="@(context.Request.Headers.GetValueOrDefault("User-Agent","").Contains("iPad") || context.Request.Headers.GetValueOrDefault("User-Agent","").Contains("iPhone"))" />

Stratégies connexes

• Transformation

Contenu connexe

Pour plus d’informations sur l’utilisation des stratégies, consultez :

• Tutoriel : Transformer et protéger votre API
• Référence de stratégie pour obtenir la liste complète des instructions et des paramètres de stratégie
• Expressions de stratégie
• Définir ou modifier des stratégies
• Réutilisation de configurations 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