Rychlý start: Vytvoření nové instance služby Azure API Management pomocí PowerShellu
PLATÍ PRO: Consumption | Vývojář | Základní | Standardní | Premium
V tomto rychlém startu vytvoříte novou instanci služby API Management pomocí rutin Azure PowerShellu. Po vytvoření instance můžete použít rutiny Azure PowerShellu pro běžné akce správy, jako je import rozhraní API v instanci služby API Management.
Azure API Management pomáhá organizacím publikovat rozhraní API externím, partnerům a interním vývojářům, aby uvolnila potenciál jejich dat a služeb. Služba API Management nabízí základní možnosti pro zajištění úspěšného programu s rozhraním API prostřednictvím zapojení vývojářů, informací o podniku, analýz, zabezpečení a ochrany. Pomocí služby API Management můžete vytvářet a spravovat moderní brány rozhraní API pro stávající back-endové služby hostované kdekoli.
Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.
Požadavky
- Pokud se rozhodnete používat Azure PowerShell místně:
- Nainstalujte nejnovější verzi modulu Az PowerShell.
- Připojení k účtu Azure pomocí rutiny Připojení-AzAccount.
- Pokud se rozhodnete použít Azure Cloud Shell:
- Další informace najdete v přehledu služby Azure Cloud Shell .
Vytvořit skupinu zdrojů
Vytvořte skupinu prostředků Azure pomocí rutiny New-AzResourceGroup. Skupina prostředků je logický kontejner, ve kterém se nasazují a spravují prostředky Azure.
Následující příkaz vytvoří skupinu prostředků myResourceGroup v umístění USA – západ:
New-AzResourceGroup -Name myResourceGroup -Location WestUS
Vytvoření instance API Managementu
Teď, když máte skupinu prostředků, můžete vytvořit instanci služby API Management. Vytvořte ho pomocí Rutiny New-AzApiManagement a zadejte název služby a podrobnosti o vydavateli. Název služby musí být v rámci Azure jedinečný.
V následujícím příkladu se myapim používá pro název služby. Aktualizujte název na jedinečnou hodnotu. Aktualizujte také název organizace vydavatele rozhraní API a e-mailovou adresu správce, abyste dostávali oznámení.
Ve výchozím nastavení příkaz vytvoří instanci na úrovni Developer, což je úsporná možnost vyhodnocení služby Azure API Management. Tato úroveň není určená pro produkční použití. Další informace o úrovních SLUŽBY API Management najdete v tématu Porovnání úrovní služby Azure API Management na základě funkcí.
Tip
Jedná se o dlouhotrvající akci. Vytvoření a aktivace služby API Management v této úrovni může trvat 30 až 40 minut.
New-AzApiManagement -Name "myapim" -ResourceGroupName "myResourceGroup" `
-Location "West US" -Organization "Contoso" -AdminEmail "admin@contoso.com"
Když se příkaz vrátí, spusťte Get-AzApiManagement a zobrazte vlastnosti služby Azure API Management. Po aktivaci je úspěšné ProvisioningState
a instance má několik přidružených adres URL. Příklad:
Get-AzApiManagement -Name "myapim" -ResourceGroupName "myResourceGroup"
Příklad výstupu:
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 : 9/9/2022 9:07:43 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
Po nasazení instance služby API Management jste připraveni ji použít. Začněte kurzem pro import a publikování vašeho prvního rozhraní API.
Vyčištění prostředků
Pokud už ji nepotřebujete, můžete k odebrání skupiny prostředků a všech souvisejících prostředků použít příkaz Remove-AzResourceGroup .
Remove-AzResourceGroup -Name myResourceGroup