Quickstart: Een nieuw Azure API Management-exemplaar maken met behulp van PowerShell
VAN TOEPASSING OP: Verbruik | Ontwikkelaar | Basic | Standaard | Premium
In deze quickstart maakt u een nieuw API Management-exemplaar met behulp van Azure PowerShell-cmdlets. Nadat u een exemplaar hebt gemaakt, kunt u Azure PowerShell-cmdlets gebruiken voor algemene beheeracties, zoals het importeren van API's in uw API Management-exemplaar.
Met Azure API Management kunnen organisaties API's publiceren naar externe, partner- en interne ontwikkelaars om het potentieel van hun gegevens en services te ontgrendelen. API Management beschikt over de competenties die belangrijk zijn voor een geslaagd API-programma via ontwikkelaarsbetrokkenheid, zakelijke inzichten, analytische gegevens, beveiliging en bescherming. Met API Management kunt u moderne API-gateways maken en beheren voor bestaande back-endservices die overal worden gehost.
Als u geen Azure-abonnement hebt, kunt u een gratis Azure-account maken voordat u begint.
Vereisten
- Als u ervoor kiest om Azure PowerShell lokaal te gebruiken:
- Installeer de nieuwste versie van de Az PowerShell-module.
- Maak verbinding met uw Azure-account met de cmdlet Connect-AzAccount.
- Als u ervoor kiest om Azure Cloud Shell te gebruiken:
- Raadpleeg Overzicht van Azure Cloud Shell voor meer informatie.
Resourcegroep maken
Maak een Azure-resourcegroep met behulp van de opdracht New-AzResourceGroup. Een resourcegroep is een logische container waarin Azure-resources worden geïmplementeerd en beheerd.
Met de volgende opdracht wordt een resourcegroep met de naam myResourceGroup gemaakt in de locatie US - west:
New-AzResourceGroup -Name myResourceGroup -Location WestUS
Een API Management-exemplaar maken
Met deze resourcegroep kunt u een API Management-service-exemplaar maken. Maak er een met behulp van New-AzApiManagement en geef een servicenaam en de details van de uitgever op. De servicenaam moet uniek zijn binnen Azure.
In het volgende voorbeeld wordt myapim gebruikt voor de servicenaam. Werk de naam bij naar een unieke waarde. Werk ook de organisatienaam van de API-uitgever en het e-mailadres van de beheerder bij om meldingen te ontvangen.
De opdracht maakt standaard het exemplaar in de ontwikkelaarslaag, een voordelige optie om Azure API Management te evalueren. Deze laag is niet bedoeld voor productie. Zie Op functies gebaseerde vergelijking van de Azure API Management-lagen voor meer informatie over de API Management-lagen.
Tip
Dit is een langdurige actie. Het kan tussen de dertig en veertig minuten duren om een API Management-service in deze laag te maken en activeren.
New-AzApiManagement -Name "myapim" -ResourceGroupName "myResourceGroup" `
-Location "West US" -Organization "Contoso" -AdminEmail "admin@contoso.com"
Wanneer de opdracht is uitgevoerd, voert u Get-AzApiManagement uit om de eigenschappen van de Azure API Management-service weer te geven. Na de activering is geslaagd ProvisioningState en heeft het exemplaar verschillende bijbehorende URL's. Voorbeeld:
Get-AzApiManagement -Name "myapim" -ResourceGroupName "myResourceGroup"
Voorbeelduitvoer:
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
Nadat het API Management-service-exemplaar is geïmplementeerd, kunt u het gebruiken. Begin met de zelfstudie om uw eerste API te importeren en publiceren.
Resources opschonen
U kunt de opdracht Remove-AzResourceGroup gebruiken om de resourcegroep en alle gerelateerde resources te verwijderen wanneer u ze niet meer nodig hebt.
Remove-AzResourceGroup -Name myResourceGroup