Snabbstart: Skapa en ny Azure API Management-instans med hjälp av Azure CLI

Artikel
12/15/2023

GÄLLER FÖR: Förbrukning | Utvecklare | Grundläggande | Standard | Premium

Den här snabbstarten beskriver stegen för att skapa en ny API Management-instans med hjälp av Azure CLI-kommandon. När du har skapat en instans kan du använda Azure CLI för vanliga hanteringsuppgifter som att importera API:er i din API Management-instans.

Azure API Management hjälper organisationer att publicera API:er till externa utvecklare, partner och interna utvecklare för att frigöra potentialen för sina data och tjänster. API Management lägger grunden till ett effektivt API-program genom engagerade utvecklare, affärsinsikter, analyser, hög säkerhet och skydd. Med API Management skapar och hanterar du moderna API-gatewayer för befintliga serverdelstjänster var som helst.

Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.

Förutsättningar

Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Snabbstart för Bash i Azure Cloud Shell.
Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör i Windows eller macOS kan du köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.
- Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Andra inloggningsalternativ finns i Logga in med Azure CLI.
- När du uppmanas att installera Azure CLI-tillägget vid första användningen. Mer information om tillägg finns i Använda tillägg med Azure CLI.
- Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

Den här artikeln kräver version 2.11.1 eller senare av Azure CLI. Om du använder Azure Cloud Shell är den senaste versionen redan installerad.

Skapa en resursgrupp

Azure API Management-instanser, precis som alla Azure-resurser, måste distribueras till en resursgrupp. Med resursgrupper kan du organisera och hantera relaterade Azure-resurser.

Skapa först en resursgrupp med namnet myResourceGroup på platsen USA, centrala med följande kommando az group create :

az group create --name myResourceGroup --location centralus

Skapa en API Management-instans

Nu när du har en resursgrupp kan du skapa en API Management-instans. Skapa ett med kommandot az apim create och ange ett tjänstnamn och utgivarinformation. Tjänstnamnet måste vara unikt i Azure.

I följande exempel används myapim för tjänstnamnet. Uppdatera namnet till ett unikt värde. Uppdatera även namnet på API-utgivarens organisation och e-postadressen för att ta emot meddelanden.

az apim create --name myapim --resource-group myResourceGroup \
  --publisher-name Contoso --publisher-email admin@contoso.com \
  --no-wait

Som standard skapar kommandot instansen på nivån Utvecklare, ett ekonomiskt alternativ för att utvärdera Azure API Management. Den här nivån är inte avsedd för produktionsanvändning. Mer information om att skala API Management-nivåerna finns i avsnittet Uppgradera och skala.

Dricks

Det kan ta mellan 30 och 40 minuter att skapa och aktivera en API Management-tjänst på den här nivån. Föregående kommando använder --no-wait alternativet så att kommandot returneras omedelbart medan tjänsten skapas.

Kontrollera statusen för distributionen genom att köra kommandot az apim show :

az apim show --name myapim --resource-group myResourceGroup --output table

Inledningsvis liknar utdata följande, vilket visar statusen Activating :

NAME         RESOURCE GROUP    LOCATION    GATEWAY ADDR    PUBLIC IP    PRIVATE IP    STATUS      TIER       UNITS
-----------  ----------------  ----------  --------------  -----------  ------------  ----------  ---------  -------
myapim       myResourceGroup   Central US                                             Activating  Developer  1

Efter aktiveringen är Online statusen och tjänstinstansen har en gatewayadress och en offentlig IP-adress. För tillfället exponerar inte dessa adresser något innehåll. Till exempel:

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

När din API Management-tjänstinstans är online är du redo att använda den. Börja med självstudien för att importera och publicera ditt första API.

Rensa resurser

Du kan använda kommandot az group delete för att ta bort resursgruppen och API Management-tjänstinstansen när de inte behövs.

az group delete --name myResourceGroup

Nästa steg

Importera och publicera ditt första API

Dela via