Kurz: Přidání prostředí a nasazení pro rozhraní API
Rozšiřte inventář v centru rozhraní API přidáním informací o prostředích a nasazeních rozhraní API.
Prostředí představuje umístění, kde je možné nasadit modul runtime rozhraní API, například platformu API Management.
Nasazení je umístění (adresa), kde mají uživatelé přístup k rozhraní API.
Základní informace o rozhraních API, nasazeních a dalších entitách, které můžete inventarizace v Azure API Center provést, najdete v tématu Klíčové koncepty.
V tomto kurzu se naučíte používat portál k:
- Přidání informací o prostředích rozhraní API
- Přidání informací o nasazeních rozhraní API
Požadavky
Centrum rozhraní API ve vašem předplatném Azure. Pokud jste ho ještě nevytvořili, přečtěte si článek Rychlý start: Vytvoření centra rozhraní API.
Jedno nebo více rozhraní API zaregistrovaných v centru rozhraní API. Pokud jste ještě nezaregistrovali žádná rozhraní API, přečtěte si kurz : Registrace rozhraní API v inventáři rozhraní API. V tomto kurzu se používají ukázková rozhraní API, která jste přidali z předchozího kurzu.
Přidání prostředí
Pomocí centra rozhraní API můžete sledovat prostředí rozhraní API z reálného světa. K distribuci, zabezpečení a monitorování některých vašich rozhraní API můžete například použít Azure API Management nebo jiné řešení. Nebo můžete přímo obsluhovat některá rozhraní API pomocí výpočetní služby nebo clusteru Kubernetes.
Tady přidáte informace o fiktivním prostředí služby Azure API Management do centra rozhraní API. Pokud chcete, přidejte informace o jednom z existujících prostředí. Nakonfigurujete předdefinovaná metadata i všechna vlastní metadata, která jste definovali v předchozím kurzu.
V nabídce vlevo v části Prostředky vyberte Prostředí> + Nové prostředí.
Na stránce Nové prostředí přidejte následující informace. Pokud jste dříve definovali vlastní obchodní metadata nebo jiná metadata přiřazená k prostředím, uvidíte je v dolní části stránky.
Nastavení Hodnota Popis Název prostředí Zadejte moje testování. Pojmenujte prostředí, které zvolíte. Identifikace Jakmile zadáte předchozí název, Azure API Center vygeneruje tento identifikátor, který můžete přepsat. Název prostředku Azure pro prostředí Typ prostředí V rozevíracím seznamu vyberte Testovat . Typ prostředí pro rozhraní API Popis Volitelně zadejte popis. Popis prostředí Server Typ Volitelně v rozevíracím seznamu vyberte Azure API Management . Typ použitého řešení API Management Adresa URL portálu pro správu Volitelně zadejte adresu URL pro rozhraní pro správu, například https://admin.contoso.com
Adresa URL rozhraní pro správu pro prostředí Připojování Adresa URL vývojového portálu Volitelně zadejte adresu URL portálu pro vývojáře, například https://developer.contoso.com
Adresa URL rozhraní pro onboarding vývojářů v prostředí Pokyny Volitelně vyberte Upravit a zadejte pokyny k onboardingu ve standardním Markdownu. Pokyny k onboardingu k rozhraním API z prostředí Obchodní činnost Pokud jste přidali tato vlastní metadata, volitelně vyberte z rozevíracího seznamu, jako je IT. Vlastní metadata identifikující organizační jednotku, která spravuje prostředí Vyberte Vytvořit. Prostředí se zobrazí v seznamu prostředí.
Přidání nasazení
Centrum rozhraní API vám také může pomoct katalogovat nasazení rozhraní API – prostředí runtime, ve kterých jsou nasazená rozhraní API, která sledujete.
Tady přidáte nasazení tím, že přidružujete jedno z vašich rozhraní API k prostředí, které jste vytvořili v předchozí části. Nakonfigurujete předdefinovaná metadata i všechna vlastní metadata, která jste definovali.
Na portálu přejděte do centra rozhraní API.
V nabídce vlevo v části Prostředky vyberte rozhraní API.
Vyberte například rozhraní API konference.
Na stránce Rozhraní API konference v části Podrobnosti vyberte Nasazení> + Přidat nasazení.
Na stránce Přidat nasazení přidejte následující informace. Pokud jste dříve definovali vlastní obchodní metadata nebo jiná metadata přiřazená k prostředím, uvidíte je v dolní části stránky.
Nastavení Hodnota Popis Název Zadejte nasazení V1. Název, který zvolíte pro nasazení. Identifikace Jakmile zadáte předchozí název, Azure API Center vygeneruje tento identifikátor, který můžete přepsat. Název prostředku Azure pro nasazení Popis Volitelně zadejte popis. Popis nasazení Prostředí Vyberte ho z rozevíracího seznamu, například Moje testování, nebo volitelně vyberte Vytvořit nový. Nové nebo existující prostředí, ve kterém je nasazená verze rozhraní API. Definice Vyberte nebo přidejte definiční soubor pro verzi rozhraní CONFERENCE API. Definiční soubor rozhraní API. Runtime URL Zadejte základní adresu URL, například https://api.contoso.com
.Základní adresa URL modulu runtime pro rozhraní API v prostředí Obchodní činnost Pokud jste přidali tato vlastní metadata, volitelně vyberte z rozevíracího seznamu, jako je IT. Vlastní metadata identifikující organizační jednotku, která spravuje rozhraní API v prostředí Vyberte Vytvořit. Nasazení se zobrazí v seznamu nasazení.
V tomto kurzu jste se naučili používat portál k:
- Přidání informací o prostředích rozhraní API
- Přidání informací o nasazeních rozhraní API