Краткое руководство: Создание нового экземпляра службы «Управление API Azure» с использованием Azure CLI

ПРИМЕНЯЕТСЯ ДЛЯ: Потребление | Разработка | Базовый | Стандартный | Премиум

В этом кратком руководстве описаны действия по созданию нового экземпляра службы управления API с помощью команд Azure CLI. После создания экземпляра можно использовать Azure CLI для распространенных задач управления, таких как импорт API в экземпляре управления API.

Azure Управление API помогает организациям публиковать API для внешних, партнерских и внутренних разработчиков, чтобы разблокировать потенциал своих данных и служб. Служба управления API предоставляет базовые возможности для успешного выполнения программы API за счет привлечения разработчиков, бизнес-аналитики, анализа, безопасности и защищенности. С помощью Управление API создайте современные шлюзы API и управляйте ими для существующих внутренних служб, размещенных в любом месте.

Если у вас нет аккаунта Azure, создайте бесплатную учетную запись перед началом.

Предпосылки

• Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см. в статье "Начало работы с Azure Cloud Shell".

  

• Если вы предпочитаете запускать справочные команды CLI локально, установите Azure CLI. Если вы работаете в Windows или macOS, подумайте о запуске Azure CLI в контейнере Docker. Дополнительные сведения см. в статье Как запустить Azure CLI в контейнере Docker.

  • Если вы используете локальную установку, войдите в Azure CLI с помощью команды az login . Чтобы завершить процесс аутентификации, следуйте шагам, отображаемым в вашем терминале. Сведения о других параметрах входа см. в статье "Проверка подлинности в Azure с помощью Azure CLI".

  • Когда вас попросят, установите расширение Azure CLI при первом использовании. Дополнительные сведения о расширениях см. в статье Использование расширений и управление ими с помощью Azure CLI.

  • Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.

• Для этой статьи требуется версия 2.11.1 или более поздняя версия Azure CLI. Если вы используете Azure Cloud Shell, последняя версия уже установлена.

Создайте группу ресурсов

Экземпляры Azure API Management, как и все ресурсы Azure, должны быть развернуты в группе ресурсов. Группы ресурсов позволяют организовать соответствующие ресурсы Azure и управлять ими.

Сначала создайте группу ресурсов с именем myResourceGroup в расположении центрального сша с помощью следующей команды az group create :

az group create --name myResourceGroup --location centralus

Создание экземпляра службы управления API

Теперь, когда у вас есть группа ресурсов, можно создать экземпляр службы управления API. Создайте его с помощью команды az apim create и укажите имя службы и сведения о издателе. Имя службы должно быть уникальным в Azure.

В следующем примере myapim используется для имени службы. Обновите имя до уникального значения. Также обновите название организации издателя API, а чтобы получать уведомления, обновите адрес электронной почты.

az apim create --name myapim --resource-group myResourceGroup \
  --publisher-name Contoso --publisher-email [email protected] \
  --no-wait

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

Проверьте состояние развертывания, выполнив команду az apim show :

az apim show --name myapim --resource-group myResourceGroup --output table

Изначально выходные данные похожи на следующие, отображая Activating состояние:

NAME         RESOURCE GROUP    LOCATION    GATEWAY ADDR    PUBLIC IP    PRIVATE IP    STATUS      TIER       UNITS
-----------  ----------------  ----------  --------------  -----------  ------------  ----------  ---------  -------
myapim       myResourceGroup   Central US                                             Activating  Developer  1

После активации статус установлен Online, и экземпляр службы имеет адрес шлюза и общедоступный IP-адрес. Сейчас эти адреса не предоставляют никакого содержимого. Рассмотрим пример.

NAME         RESOURCE GROUP    LOCATION    GATEWAY ADDR                       PUBLIC IP     PRIVATE IP    STATUS    TIER       UNITS
-----------  ----------------  ----------  ---------------------------------  ------------  ------------  --------  ---------  -------
myapim       myResourceGroup   Central US  https://myapim.azure-api.net       203.0.113.1                 Online    Developer  1

Когда экземпляр службы "Управление API" находится в сети, его можно использовать. Изучите сведения из учебника, чтобы импортировать и опубликовать первый API.

Очистите ресурсы

Команду az group delete можно использовать для удаления группы ресурсов и экземпляра службы управления API, если они не нужны.

az group delete --name myResourceGroup

Дальнейшие шаги