Quickstart: Een nieuw Azure API Management-exemplaar maken met behulp van de Azure CLI
VAN TOEPASSING OP: Verbruik | Ontwikkelaar | Basic | Standaard | Premium
In deze quickstart worden de stappen beschreven voor het maken van een nieuw API Management-exemplaar met behulp van Azure CLI-opdrachten. Nadat u een exemplaar hebt gemaakt, kunt u de Azure CLI gebruiken voor algemene beheertaken, 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
Gebruik de Bash-omgeving in Azure Cloud Shell. Zie quickstart voor Bash in Azure Cloud Shell voor meer informatie.
Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.
Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.
Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.
Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.
- Voor dit artikel is versie 2.11.1 of hoger van Azure CLI vereist. Als u Azure Cloud Shell gebruikt, is de nieuwste versie al geïnstalleerd.
Een brongroep maken
Azure API Management-exemplaren moeten, zoals alle Azure-resources, worden geïmplementeerd in een resourcegroep. Met resourcegroepen kunt u gerelateerde Azure-resources organiseren en beheren.
Maak eerst een resourcegroep met de naam myResourceGroup in de locatie VS - centraal met behulp van de opdracht az group create:
az group create --name myResourceGroup --location centralus
Een API Management-exemplaar maken
Nu u een resourcegroep hebt, kunt u een API Management-exemplaar maken. Maak er een met behulp van de opdracht az apim create 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 naam van de organisatie van de uitgever van de API en het e-mailadres bij om meldingen te ontvangen.
az apim create --name myapim --resource-group myResourceGroup \
--publisher-name Contoso --publisher-email admin@contoso.com \
--no-wait
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 bijwerken en schalen voor meer informatie over het schalen van API Management-lagen.
Tip
Het kan tussen de dertig en veertig minuten duren om een API Management-service in deze laag te maken en activeren. De vorige opdracht gebruikt de optie --no-wait zodat de opdracht onmiddellijk retourneert terwijl de service wordt gemaakt.
Controleer de status van de implementatie door de opdracht az apim show uit te voeren:
az apim show --name myapim --resource-group myResourceGroup --output table
In eerste instantie ziet de uitvoer er ongeveer zo uit, met de status Activating:
NAME RESOURCE GROUP LOCATION GATEWAY ADDR PUBLIC IP PRIVATE IP STATUS TIER UNITS
----------- ---------------- ---------- -------------- ----------- ------------ ---------- --------- -------
myapim myResourceGroup Central US Activating Developer 1
Na de activering is de status Online en heeft het service-exemplaar een gateway-adres en een openbaar IP-adres. Voorlopig wordt met deze adressen geen inhoud beschikbaar gemaakt. Voorbeeld:
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
Als het API Management-service-exemplaar online is, kunt u het gebruiken. Begin met de zelfstudie om uw eerste API te importeren en publiceren.
Resources opschonen
U kunt de opdracht az group delete gebruiken om de resourcegroep en het API Management-service-exemplaar te verwijderen wanneer ze niet nodig zijn.
az group delete --name myResourceGroup