Festlegen der Variablen

GILT FÜR: Alle API Management-Ebenen

Mit der set-variable-Richtlinie wird eine set-variablevariable deklariert und einem Wert zugewiesen, der über einen Ausdruck oder ein Zeichenfolgenliteral angegeben wird. Wenn der Ausdruck ein Literal enthält, wird die Konvertierung in eine Zeichenfolge durchgeführt, und der Typ des Werts lautet System.String.

Hinweis

Legen Sie die Elemente und untergeordneten Elemente einer Richtlinie in der Reihenfolge fest, die in der Richtlinienanweisung angegeben ist. Erfahren Sie mehr darüber, wie Sie API Management-Richtlinien festlegen oder bearbeiten.

Richtlinienanweisung

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

Attribute

Attribut	BESCHREIBUNG	Erforderlich
name	Der Name der Variablen. Richtlinienausdrücke sind nicht zulässig.	Ja
value	Der Wert der Variablen. Dies kann ein Ausdruck oder ein Literalwert sein. Richtlinienausdrücke sind zulässig.	Ja

Verwendung

• Richtlinienabschnitte: inbound, outbound, backend, on-error
• Richtlinienbereiche: global, Arbeitsbereich, Produkt, API, Vorgang
• Gateways: klassisch, v2, Verbrauch, selbstgehostet, Arbeitsbereich

Zulässige Typen

Ausdrücke, die in der set-variable-Richtlinie verwendet werden, müssen einen der folgenden einfachen Typen zurückgeben.

• 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?

Beispiel

Im folgenden Beispiel wird eine set-variable-Richtlinie im Abschnitt für den eingehenden Datenverkehr veranschaulicht. Diese "set-variable"-Richtlinie erstellt die boolesche Kontextvariable isMobile, die auf "true" festgelegt wird, wenn der User-Agent-Anforderungsheader den Text iPad oder iPhone enthält.

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

Verwandte Richtlinien

• Transformation

Zugehöriger Inhalt

Weitere Informationen zum Arbeiten mit Richtlinien finden Sie hier:

• Tutorial: Transformieren und Schützen Ihrer API
• Unter Richtlinien für die API-Verwaltung finden Sie eine komplette Liste der Richtlinienanweisungen und der zugehörigen Einstellungen.
• Richtlinienausdrücke
• Festlegen oder Bearbeiten von Richtlinien
• Wiederverwenden von Richtlinienkonfigurationen
• Repository für Richtliniencodeausschnitte
• Erstellen von Richtlinien mit Microsoft Copilot in Azure