Rychlý start: Vytvoření nové instance API Management Azure pomocí Azure CLI

Azure API Management (APIM) pomáhá organizacím při publikování rozhraní API pro externí, partnerské a interní vývojáře, aby tak 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. APIM umožňuje vytvářet a spravovat moderní brány rozhraní API pro stávající back-endové služby hostované kdekoli. Další informace najdete v tématu Přehled.

Tento rychlý start popisuje kroky pro vytvoření nové instance API Management pomocí příkazů az apim v Azure CLI.

Pokud ještě nemáte předplatné Azure,vytvořte si bezplatný účet před tím, než začnete.

Požadavky

• V nástroji použijte prostředí Bash Azure Cloud Shell.

  

• Pokud tomu dáváte přednost, můžete nainstalovat Azure CLI a spouštět referenční příkazy CLI.

  • 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í jsou popsané 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 azure CLI verze 2.11.1 nebo novější. Pokud používáte Azure Cloud Shell, je už nainstalovaná nejnovější verze.

Vytvoření skupiny prostředků

Instance API Management Azure, stejně jako všechny prostředky Azure, musí být nasazeny do skupiny prostředků. Skupiny prostředků vám umožňují organizaci a správu souvisejících prostředků 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í nové služby

Teď, když máte skupinu prostředků, můžete vytvořit instanci API Management služby. 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 jako název služby používá myapim. 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

Příkaz ve výchozím nastavení vytvoří instanci na úrovni Developer, což je úsporná možnost pro vyhodnocení azure API Management. Tato úroveň není používejte v produkčním prostředí. Další informace o škálování úrovní služby API Management najdete v tématu věnovaném upgradu a škálování.

Spuštěním příkazu az apim show zkontrolujte stav nasazení:

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

Zpočátku je výstup podobný následujícímu, který zobrazuje Activating stav:

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

Po aktivaci je stav a Online instance služby má adresu brány a veřejnou IP adresu. Tyto adresy teď nezpřístupňuje žádný obsah. Napří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 API Management online, můžete ji použít. Začněte kurzem importu a publikování vašeho prvního rozhraní API.

Vyčištění prostředků

Pokud už je nepotřebujete, můžete k odebrání skupiny prostředků a instance služby API Management az group delete.

az group delete --name myResourceGroup

Další kroky