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 nem rendelkezik Azure-előfizetéssel, első lépésként hozzon létre egy ingyenes Azure-fiókot.
Előfeltételek
Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.
Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.
Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.
Amikor a rendszer kéri, először 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 az Azure CLI-vel.
Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.
- 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. Emellett frissítse az API-közzétevő szervezetének nevét és az e-mail-címet az értesítések fogadásához.
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. További információt az API Management szintjeinek skálázásáról a frissítés és skálázás oldalon talál.
Tipp.
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áspéldány rendelkezik egy átjárócímmel és egy nyilvános IP-címmel. Ezek a címek egyelőre nem fednek fel tartalmakat. Példa:
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óanyaggal az első API importálásához és közzétételéhez.
Az erőforrások eltávolí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