Поделиться через

Создание, понимание и отладка политик управления API Azure в Visual Studio Code

ПРИМЕНЯЕТСЯ КО ВСЕМ уровням управления API

В этой статье объясняется, как с помощью расширения Azure API Management для Visual Studio Code создавать, разрабатывать и отлаживать политики управления API Azure при поддержке ИИ из GitHub Copilot для Azure.

Политики управления API Azure — это последовательность инструкций, которые устраняют перекрестные проблемы, такие как проверка подлинности, авторизация, регулирование, кэширование и преобразование, применяемые к запросам ИЛИ ответам API.

Предварительные условия

Ограничения и границы

  • Отладка политики в настоящее время поддерживается только на уровне разработчика управления API.

  • В процессе отладки политики используется встроенная подписка на полный доступ (уровень сервиса) (отображаемое имя "Встроенная подписка на полный доступ"). Для использования этой подписки необходимо быть владельцем службы.

Создание политики с помощью GitHub Copilot для Azure

Расширение управления API Azure интегрируется с GitHub Copilot для Azure, чтобы помочь вам создать проект политики. С помощью ИИ создайте и измените политики в удобном для пользователя способе.

Чтобы создать политику, выполните следующие действия.

  1. Откройте расширение управления API в Visual Studio Code.

  2. Выберите экземпляр управления API, с которым вы хотите работать.

  3. Выберите область политики, с которой вы хотите работать.

    • Чтобы создать политику, которая применяется ко всем API в экземпляре, выберите глобальную политику.
    • Чтобы создать политику, которая применяется к определенному API, в разделе API выберите API и выберите политику.
    • Чтобы создать политику, которая применяется к определенной операции API, выберите операцию и выберите политику.

  4. Откройте чат.

  5. В окне чата введите запрос на естественном языке, чтобы создать политику. Примеры.

    @azure I want to limit requests to 100 calls per minute

    @azure Create a policy that sets the backend URL to https://mybackend.contoso.com and adds a custom header to the request

  6. Copilot создает черновик политики в окне чата. Вы можете уточнить запрос, если вы хотите, чтобы Copilot изменил выходные данные.

  7. Когда вы будете готовы, нажмите кнопку "Копировать ", чтобы скопировать политику в буфер обмена, или нажмите кнопку "Применить в редакторе ", чтобы вставить политику в окно редактора. Если вы удовлетворены изменением в XML-коде политики, нажмите кнопку "Сохранить".

Совет

Проверьте окно "Проблемы" , чтобы объяснить все проблемы в XML-файле политики.

Описание политики с помощью GitHub Copilot для Azure

Copilot может помочь объяснить существующую политику в экземпляре службы управления API.

Чтобы получить объяснение, выполните указанные действия.

  1. Откройте расширение управления API в Visual Studio Code.

  2. Выберите экземпляр управления API, с которым вы хотите работать.

  3. Выберите область политики, с которой вы хотите работать.

    • Чтобы объяснить политику, которая применяется ко всем API в экземпляре, выберите глобальную политику.
    • Чтобы объяснить политику, которая применяется к определенному API, в разделе API выберите API и выберите политику.
    • Чтобы объяснить политику, которая применяется к определенной операции API, выберите операцию и выберите политику.

  4. В появившемся окне редактора политик щелкните правой кнопкой мыши и выберите "Объяснить".

  5. Обзор и объяснение политик в XML-документе политики создаются в окне чата.

Отладка политик с помощью расширения VS Code

Расширение управления API Azure для Visual Studio Code предоставляет возможность отладки, которая позволяет выполнять шаги по конвейеру политики или устанавливать точку останова при отправке запроса в шлюз.

Запуск сеанса отладки

  1. Откройте расширение управления API в Visual Studio Code.
  2. Выберите экземпляр управления API для отладки.
  3. Выберите API и операцию для отладки.
  4. Щелкните правой кнопкой мыши операцию и выберите "Запустить отладку политики".

На этом этапе расширение начинает устанавливать сеанс отладки с шлюзом управления API. Проверьте ход выполнения в окне консоли отладки .

Снимок экрана: запуск сеанса отладки политики в Visual Studio Code.

Замечание

Запуск сеанса отладки также включает трассировку запросов на протяжении всего сеанса, чтобы помочь вам диагностировать и устранять проблемы.

Отправьте тестовый запрос.

При установке сеанса отладки расширение REST Client открывает новый редактор, позволяющий создавать и отправлять тестовый HTTP-запрос в шлюз.

Заголовок Ocp-Apim-Debug добавляется автоматически в запрос. Этот заголовок является обязательным, и для него должно быть задано значение ключа подписки уровня службы с полным доступом, что позволяет активировать функции отладки в шлюзе API Management.

Измените HTTP-запрос в редакторе в соответствии со своим сценарием тестирования. Затем нажмите кнопку "Отправить запрос" , чтобы отправить тестовый запрос шлюзу управления API.

Снимок экрана: отправка тестового запроса в Visual Studio Code.

Политики отладки

После отправки тестового HTTP-запроса расширение открывает окно отладки, которое показывает действующие политики этой операции и останавливается на первой эффективной политике.

Снимок экрана: окно отладки в Visual Studio Code.

В рамках конвейера политик можно просматривать политики по одной или установить точку останова на нужной политике и перейти непосредственно к ней.

  • На панели "Переменные" проверьте значения созданных системой и пользовательских переменных.
  • На панели точек останова просмотрите список всех установленных точек останова.
  • На панели «Стек вызовов» просмотрите текущую область действия политики.

При возникновении ошибки во время выполнения политики вы увидите подробные сведения о ней в той политике, где она произошла.

После завершения сеанса отладки нажмите кнопку "Остановить ".

Снимок экрана: исключение политики в Visual Studio Code.

Совет

Чтобы просмотреть трассировку запроса, выберите значение заголовка, предоставленного Ocp-Apim-Trace-Location в ответе HTTP.

Связанный контент

  • Last updated on