API Management-beleidsexpressies

VAN TOEPASSING OP: Alle API Management-lagen

In dit artikel worden de syntaxis van beleidsexpressies in C# 7 besproken. Elke expressie heeft toegang tot:

• De impliciet opgegeven contextvariabele .
• Een toegestane subset van .NET Framework-typen.

Syntaxis

• Expressies met één instructie:
  • Ingesloten in @(expression), waar expression een goed gevormde C#-expressie-instructie is.
• Expressies met meerdere instructies:
  • Ingesloten in @{expression}.
  • Alle codepaden binnen expressies met meerdere instructies moeten eindigen met een return instructie.

Voorbeelden

@(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;

}

Gebruik

Tenzij de beleidsreferentie anders aangeeft, kunnen expressies worden gebruikt als kenmerkwaarden of tekstwaarden in een API Management-beleid.

.NET Framework-typen die zijn toegestaan in beleidsexpressies

De volgende tabel bevat de .NET Framework-typen en leden die zijn toegestaan in beleidsexpressies.

Contextvariabele

De context variabele is impliciet beschikbaar in elke beleidsexpressie. De leden:

• Geef informatie op die relevant is voor de API-aanvraag en -reactie en gerelateerde eigenschappen.
• Zijn allemaal alleen-lezen.

Gerelateerde inhoud

Zie voor meer informatie over het werken met beleid:

• Zelfstudie: Uw API transformeren en beveiligen
• Beleidsreferentie voor een volledige lijst met beleidsinstructies en hun instellingen
• Beleidsexpressies
• Beleid definiëren of bijwerken
• Beleidsconfiguraties opnieuw gebruiken
• Beleidsfragmentenopslagplaats
• Beleidsspeelplaats
• Azure API Management-beleidstoolkit
• Krijg hulp van Copilot bij het maken, uitleggen en oplossen van problemen met beleid.

Bekijk voor meer informatie:

• Zie hoe u contextinformatie kunt opgeven voor uw back-endservice. Gebruik de queryreeksparameter instellen en STEL HTTP-headerbeleid in om deze informatie op te geven.
• Lees hoe u het JWT-beleid valideren gebruikt om de toegang tot bewerkingen vooraf te autoriseren op basis van tokenclaims.
• Lees hoe u API-tracering gebruikt om te detecteren hoe beleidsregels worden geëvalueerd en de resultaten van deze evaluaties.
• Zie hoe u expressies gebruikt met de get from cache en Store om beleid voor API Management-reacties te configureren. Stel een duur in die overeenkomt met de reactiecache van de back-endservice, zoals is opgegeven door de instructie van Cache-Control de ondersteunde service.
• Zie hoe u inhoudsfilters uitvoert. Verwijder gegevenselementen uit het antwoord dat is ontvangen van de back-end met behulp van de besturingsstroom en stel hoofdtekstbeleidsregels in.
• Zie de GitHub-opslagplaats api-management-samples/policies om de beleidsinstructies te downloaden.