Rövid útmutató: Új Azure API Management-példány létrehozása az Azure CLI használatával

A következőkre vonatkozik: Felhasználás | Fejlesztő | Alapszintű | Standard | Prémium

Ez a rövid útmutató az új API Management-példány Azure CLI-parancsokkal történő létrehozásának lépéseit ismerteti. A példány létrehozása után az Azure CLI használatával olyan gyakori felügyeleti feladatokhoz használhatja, mint például az API-k importálása az API Management-példányban.

Az Azure API Management segítségével a szervezetek api-kat tehetnek közzé külső, partneri és belső fejlesztőknek, hogy kiaknázhassák adataik és szolgáltatásaik lehetőségeit. Az API Management a fejlesztők bevonásán, az üzleti elemzéseken, a biztonságon és a védelmen keresztül biztosítja az alapvető kompetenciákat az API-program sikeressé tételéhez. Az API Management segítségével modern API-átjárókat hozhat létre és kezelhet a bárhol üzemeltetett meglévő háttérszolgáltatásokhoz.

Ha még nem rendelkezik Azure-fiókkal, első lépésként hozzon létre egy ingyenes fiókot.

Előfeltételek

• Használja a Bash-környezetet az Azure Cloud Shellben. További információ: Az Azure Cloud Shell használatának első lépései.

  

• Ha a CLI referencia parancsokat helyben szeretnéd futtatni, telepítsd az Azure CLI-t. Ha Windows vagy macOS rendszeren fut, fontolja meg az Azure CLI-t egy Docker-konténerben futtatni. További információkért lásd: Az Azure CLI használata Docker-konténerben.

  • Ha egy helyileg telepített verziót használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. Az azonosítási folyamat befejezéséhez kövesse a terminálján megjelenő lépéseket. További bejelentkezési lehetőségekért lásd: Hitelesítés az Azure-ba az Azure CLI használatával.

  • Amikor megjelenik a felszólítás, az első használatkor telepítse az Azure CLI bővítményt. További információ a bővítményekről: Bővítmények használata és kezelése az Azure CLI-vel.

  • Futtasd a az version parancsot, hogy megtudd a telepített verziót és függő könyvtárakat. A legújabb verzióra való frissítéshez futtassa a az upgrade parancsot.

• Ez a cikk az Azure CLI 2.11.1-es vagy újabb verzióját igényli. Az Azure Cloud Shell használata esetén a legújabb verzió már telepítve van.

Erőforráscsoport létrehozása

Az Azure API Management-példányokat, mint az összes Azure-erőforrást, egy erőforráscsoportban kell üzembe helyezni. Az erőforráscsoportok lehetővé teszik a kapcsolódó Azure-erőforrások rendszerezését és kezelését.

Először hozzon létre egy myResourceGroup nevű erőforráscsoportot az USA középső régiójában az alábbi az group create paranccsal:

az group create --name myResourceGroup --location centralus

API Management-példány létrehozása

Most, hogy rendelkezik egy erőforráscsoporttel, létrehozhat egy API Management-példányt. Hozzon létre egyet az az apim create paranccsal, és adja meg a szolgáltatás nevét és a közzétevő adatait. A szolgáltatásnévnek egyedinek kell lennie az Azure-ban.

Az alábbi példában a myapim a szolgáltatásnévhez használatos. Frissítse a nevet egy egyedi értékre. Frissítse az API-közzétevő szervezetének nevét is, és az értesítések fogadásához frissítse az e-mail-címet.

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

Alapértelmezés szerint a parancs létrehozza a példányt a fejlesztői szinten, amely egy gazdaságos lehetőség az Azure API Management kiértékelésére. Ez a szint nem éles használatra készült. Az API Management-szintek skálázásával kapcsolatos további információkért lásd: frissítés és skálázás.

Jótanács

Egy API Management-szolgáltatás létrehozása és aktiválása ebben a szinten 30–40 percet vehet igénybe. Az előző parancs úgy használja a --no-wait beállítást, hogy a parancs azonnal visszatérjen a szolgáltatás létrehozása közben.

Az az apim show parancs futtatásával ellenőrizze az üzembe helyezés állapotát:

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

A kimenet kezdetben a következőhöz hasonló, és az állapotot Activating mutatja:

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

Az aktiválás után az állapot Online, és a szolgáltatás példánya rendelkezik egy átjárócímmel és egy nyilvános IP-címmel. Ezek a címek egyelőre nem fednek fel tartalmakat. Például:

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

Ha az API Management szolgáltatáspéldány online állapotban van, készen áll a használatára. Kezdje az oktatóanyag elolvasásával az első API importálásához és közzétételéhez.

Erőforrások tisztítása

Az az group delete paranccsal eltávolíthatja az erőforráscsoportot és az API Management szolgáltatáspéldányt, ha nincs rájuk szükség.

az group delete --name myResourceGroup

Következő lépések

Az első API importálása és közzététele