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, de consommation, auto-hébergées
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
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
- Créer des stratégies à l’aide de Microsoft Copilot pour Azure