Rychlý start: Vytvoření nové instance služby Azure API Management pomocí Azure CLI
PLATÍ PRO: Consumption | Vývojář | Základní | Standardní | Premium
Tento rychlý start popisuje kroky pro vytvoření nové instance služby API Management pomocí příkazů Azure CLI. Po vytvoření instance můžete azure CLI použít k běžným úlohám správy, jako je import rozhraní API v instanci služby API Management.
Azure API Management pomáhá organizacím publikovat rozhraní API externím, partnerům a interním vývojářům, aby uvolnila potenciál jejich dat a služeb. Služba API Management nabízí základní možnosti pro zajištění úspěšného programu s rozhraním API prostřednictvím zapojení vývojářů, informací o podniku, analýz, zabezpečení a ochrany. Pomocí služby API Management můžete vytvářet a spravovat moderní brány rozhraní API pro stávající back-endové služby hostované kdekoli.
Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.
Požadavky
Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Rychlý start pro Bash v Azure Cloud Shellu.
Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Dockeru.
Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Přihlášení pomocí Azure CLI.
Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Využití rozšíření v Azure CLI.
Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.
- Tento článek vyžaduje verzi 2.11.1 nebo novější azure CLI. Pokud používáte Azure Cloud Shell, je už nainstalovaná nejnovější verze.
Vytvoření skupiny zdrojů
Instance služby Azure API Management, stejně jako všechny prostředky Azure, musí být nasazené do skupiny prostředků. Skupiny prostředků umožňují uspořádat a spravovat související prostředky Azure.
Nejprve vytvořte skupinu prostředků myResourceGroup v umístění USA – střed pomocí následujícího příkazu az group create :
az group create --name myResourceGroup --location centralus
Vytvoření instance API Managementu
Teď, když máte skupinu prostředků, můžete vytvořit instanci služby API Management. Vytvořte ho pomocí příkazu az apim create a zadejte název služby a podrobnosti o vydavateli. Název služby musí být v rámci Azure jedinečný.
V následujícím příkladu se myapim používá pro název služby. Aktualizujte název na jedinečnou hodnotu. Aktualizujte také název organizace vydavatele rozhraní API a e-mailovou adresu pro příjem oznámení.
az apim create --name myapim --resource-group myResourceGroup \
--publisher-name Contoso --publisher-email admin@contoso.com \
--no-wait
Ve výchozím nastavení příkaz vytvoří instanci na úrovni Developer, což je úsporná možnost vyhodnocení služby Azure API Management. Tato úroveň není určená pro produkční použití. Další informace o škálování úrovní služby API Management najdete v tématu věnovaném upgradu a škálování.
Tip
Vytvoření a aktivace služby API Management v této úrovni může trvat 30 až 40 minut. Předchozí příkaz používá --no-wait možnost, aby se příkaz vrátil okamžitě, když je služba vytvořena.
Spuštěním příkazu az apim show zkontrolujte stav nasazení:
az apim show --name myapim --resource-group myResourceGroup --output table
Výstup je zpočátku podobný následujícímu Activating , který zobrazuje stav:
NAME RESOURCE GROUP LOCATION GATEWAY ADDR PUBLIC IP PRIVATE IP STATUS TIER UNITS
----------- ---------------- ---------- -------------- ----------- ------------ ---------- --------- -------
myapim myResourceGroup Central US Activating Developer 1
Po aktivaci je Online stav a instance služby má adresu brány a veřejnou IP adresu. Prozatím tyto adresy nezpřístupňují žádný obsah. Příklad:
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
Když je vaše instance služby API Management online, jste připraveni ji použít. Začněte kurzem pro import a publikování vašeho prvního rozhraní API.
Vyčištění prostředků
Pomocí příkazu az group delete můžete odebrat skupinu prostředků a instanci služby API Management, pokud nejsou potřeba.
az group delete --name myResourceGroup