API 管理策略表达式

适用于：所有 API 管理层级

本文讨论 C# 7 中的策略表达式语法。 每个表达式都有权访问：

• 隐式提供的 context 变量。
• 允许的 .NET Framework 类型的子集。

语法

• 单一语句表达式：
  • 括在 @(expression) 中，其中 expression 是格式正确的 C# 表达式语句。
• 多个语句表达式：
  • 括在 @{expression} 中。
  • 多语句表达式中的所有代码路径必须以 return 语句结尾。

示例

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

}

使用情况

除非策略引用另行指定，否则在任何 API 管理策略中，表达式都可用作属性值或文本值。

策略表达式中允许使用的 .NET Framework 类型

下表列出了策略表达式中允许的 .NET Framework 类型及成员。

上下文变量

在每个策略表达式中均可隐式使用 context 变量。 其成员：

• 提供与 API 请求和响应相关的信息，以及相关的属性。
• 都是只读的。

相关内容

有关如何使用策略的详细信息，请参阅：

• API 管理中的策略
• 教程：转换和保护 API
• 策略参考，其中提供了策略语句及其设置的完整列表
• 策略片段存储库

有关详细信息，请参阅：

• 了解如何向后端服务提供上下文信息。 使用设置查询字符串参数和设置 HTTP 标头策略来提供此信息。
• 了解如何使用验证 JWT 策略根据令牌声明预先授予操作访问权限。
• 了解如何使用 API 检查器跟踪来检测策略求值方法和这些求值的结果。
• 了解如何对从缓存获取和存储到缓存策略使用表达式，以便配置 API 管理响应缓存。 设置持续时间，使之匹配由后端服务的 Cache-Control 指令指定的后端服务响应缓存。
• 了解如何进行内容筛选。 删除使用控制流和设置正文策略从后端接收的响应中的数据元素。
• 要下载策略语句，请参阅 api-management-samples/policies GitHub 存储库。