Выражения политики в службе управления API

ОБЛАСТЬ ПРИМЕНЕНИЯ: все уровни Управление API

В этой статье описан синтаксис выражений политики C# 7. Каждое выражение имеет доступ к:

• неявно заданной переменной контекста;
• допустимому подмножеству типов платформы .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
• Полный перечень операторов политик и их параметров см. в справочнике по политикам.
• Выражения политики
• Настройка или изменение политик
• Повторное использование конфигураций политик
• Репозиторий фрагментов политик
• репозиторий Policy
• Набор средств политики Управление API Azure
• Получите помощь Copilot для создания, объяснения и устранения неполадок в политике

Дополнительные сведения см. в следующих разделах:

• Способы передачи сведений о контексте во внутреннюю службу. Используйте политики настройки параметра строки запроса и настройки HTTP-заголовка, чтобы передать эти сведения.
• Использование политики проверки JWT для предварительной авторизации доступа к операциям на основе утверждений маркеров.
• Узнайте, как использовать трассировку API для определения оценки политик и результатов этих вычислений.
• Использование выражений с политиками получения из кэша и хранения в кэше для настройки кэширования ответа службы управления API. Установите такую же длительность, как и для кэширования ответа во внутренней службе, которая задается директивой Cache-Control на сервере.
• Сведения о том, как отфильтровать содержимое. Удалите элементы данных из ответа, полученного из внутренней службы с помощью политик потока управления и задания текста.
• Чтобы скачать инструкции политики, перейдите в репозиторий GitHub api-management-samples/policies.