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

Быстрый старт: создание нового экземпляра Azure API Management с помощью PowerShell

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

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

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

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

Предпосылки

  • Если вы решили использовать Azure PowerShell локально:
    • Установите последнюю версию модуля Az PowerShell.
    • Подключитесь к учетной записи Azure с помощью командлета Connect-AzAccount.
  • Если вы решили использовать Azure Cloud Shell:

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

Создайте группу ресурсов Azure с помощью New-AzResourceGroup. Группа ресурсов — это логический контейнер, в котором происходит развертывание ресурсов Azure и управление ими.

Следующая команда создает группу ресурсов с именем myResourceGroup в расположении западной части США:

New-AzResourceGroup -Name myResourceGroup -Location WestUS

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

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

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

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

Подсказка

Выполнение этой команды может занять от 30 до 40 минут для создания и активации службы управления API на этом уровне.

New-AzApiManagement -Name "myapim" -ResourceGroupName "myResourceGroup" `
  -Location "West US" -Organization "Contoso" -AdminEmail "admin@contoso.com"

Когда команда возвращается, выполните команду Get-AzApiManagement , чтобы просмотреть свойства службы управления API Azure. После активации ProvisioningState экземпляр завершен успешно и имеет несколько привязанных URL-адресов. Рассмотрим пример.

Get-AzApiManagement -Name "myapim" -ResourceGroupName "myResourceGroup"

Пример выходных данных:

PublicIPAddresses                     : {203.0.113.1}
PrivateIPAddresses                    :
Id                                    : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ApiManagement/service/myapim
Name                                  : myapim
Location                              : West US
Sku                                   : Developer
Capacity                              : 1
CreatedTimeUtc                        : 10/13/2025 9:54:18 PM
ProvisioningState                     : Succeeded
RuntimeUrl                            : https://myapim.azure-api.net
RuntimeRegionalUrl                    : https://myapi-westus-01.regional.azure-api.net
PortalUrl                             : https://myapim.portal.azure-api.net
DeveloperPortalUrl                    : https://myapim.developer.azure-api.net
ManagementApiUrl                      : https://myapim.management.azure-api.net
ScmUrl                                : https://myapim.scm.azure-api.net
PublisherEmail                        : admin@contoso.com
OrganizationName                      : Contoso
NotificationSenderEmail               : apimgmt-noreply@mail.windowsazure.com
VirtualNetwork                        :
VpnType                               : None
PortalCustomHostnameConfiguration     :
ProxyCustomHostnameConfiguration      : {myapim.azure-api.net}
ManagementCustomHostnameConfiguration :
ScmCustomHostnameConfiguration        :
DeveloperPortalHostnameConfiguration  :
SystemCertificates                    :
Tags                                  : {}
AdditionalRegions                     : {}
SslSetting                            : Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementSslSetting
Identity                              :
EnableClientCertificate               :
EnableClientCertificate               :
Zone                                  :
DisableGateway                        : False
MinimalControlPlaneApiVersion         :
PublicIpAddressId                     :
PlatformVersion                       : stv2
PublicNetworkAccess                   : Enabled
PrivateEndpointConnections            :
ResourceGroupName                     : myResourceGroup

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

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

При отсутствии необходимости можно использовать команду Remove-AzResourceGroup для удаления группы ресурсов и всех связанных ресурсов.

Remove-AzResourceGroup -Name myResourceGroup

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

Импорт и публикация первого API

  • Last updated on