Quickstart: Een nieuw Azure API Management-service-exemplaar maken met behulp van de Azure CLI
APIM (API Management) helpt organisaties bij het publiceren van API's naar externe en interne ontwikkelaars, en naar partnerontwikkelaars om alle mogelijkheden van hun gegevens en services te ontsluiten. API Management beschikt over de competenties die belangrijk zijn voor een geslaagd API-programma via ontwikkelaarsbetrokkenheid, zakelijke inzichten, analytische gegevens, beveiliging en bescherming. Met APIM kunt u moderne API-gateways maken en beheren voor bestaande back-endservices die op elke willekeurige locatie worden gehost. Zie het overzicht voor meer informatie.
In deze quickstart worden de stappen beschreven voor het maken van een nieuw API Management-exemplaar met behulp van de opdrachten az apim in Azure CLI.
Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.
Vereisten
Gebruik de bash-omgeving in Azure Cloud shell.
Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren.
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 de 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 resourcegroep 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 nieuwe service maken
Met deze resourcegroep kunt u een API Management-service-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. Bijvoorbeeld:
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 importeren en publiceren.
Resources opschonen
U kunt de opdracht az group delete gebruiken om de resourcegroep en de API Management-service-exemplaar te verwijderen, wanneer u ze niet meer nodig hebt.
az group delete --name myResourceGroup