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

Azure API Management (APIM) hjälper organisationer att publicera API:er till externa partner och interna utvecklare så att de kan få ut maximalt av 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 APIM kan du skapa och hantera moderna API-gatewayer för befintliga backend-tjänster som finns var som helst. Mer information finns i Översikt.

Den här snabbstarten beskriver stegen för att skapa en API Management instans med az apim-kommandon i Azure CLI.

Om du inte har en Azure-prenumerationkan du skapa ett kostnads fritt konto innan du börjar.

Förutsättningar

• Använd bash-miljön i Azure Cloud Shell.

  

• Om du vill kan du i stället installera Azure CLI för att köra CLI-referenskommandon.

  • 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. Fler inloggningsalternativ finns i Logga in med Azure CLI.

  • När du uppmanas till det installerar du Azure CLI-tillägg vid första användning. 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 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. Resursgrupper gör det enkelt att organisera och hantera relaterade Azure-resurser.

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

az group create --name myResourceGroup --location centralus

Skapa en ny tjänst

Nu när du har en resursgrupp kan du skapa en API Management-tjänstinstans. Skapa ett med hjälp av kommandot az apim create och ange ett tjänstnamn och information om utgivaren. Tjänstnamnet måste vara unikt i Azure.

I följande exempel används myapim som tjänstnamn. 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å developer-nivån, ett ekonomiskt alternativ för att utvärdera Azure API Management. Den här nivån är inte till för produktionsanvändning. Mer information om att skala API Management-nivåerna finns i avsnittet 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 och visar Activating statusen:

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 en gateway-adress och en offentlig IP-adress. För tillfället exponerar inte de här adresserna något innehåll. 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

När den inte längre behövs kan du använda kommandot az group delete för att ta bort resursgruppen och API Management-tjänstinstansen.

az group delete --name myResourceGroup

Nästa steg