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

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

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 något Azure-konto skapar du ett kostnadsfritt konto innan du börjar.

Förutsättningar

• Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Kom igång med Azure Cloud Shell.

  

• Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör på Windows eller macOS, överväg att köra Azure CLI i en Docker-container. För mer information, se Hur man kör 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. För att slutföra autentiseringsprocessen, följ stegen som visas i din terminal. Andra inloggningsalternativ finns i Autentisera till Azure med Azure CLI.

  • När du blir uppmanad, installera Azure CLI-tillägget vid första användning. Mer information om tillägg finns i Använda och hantera tillägg med Azure CLI.

  • Kör az version för att ta reda på 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.

Till att börja med, skapa en resursgrupp med namnet myResourceGroup i centrala USA med följande az group create kommando:

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 uppdatera 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 hur du skalar API Management-nivåerna finns i uppgradera och skala.

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 statusen Online och tjänstinstansen har både 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