Kurz: Definování vlastních metadat
V tomto kurzu definujte vlastní metadata, která vám pomůžou uspořádat rozhraní API a další informace v centru rozhraní API. Pro vyhledávání a filtrování a vynucování standardů zásad správného řízení ve vaší organizaci používejte vlastní a integrovaná metadata.
Základní informace o metadatech ve službě Azure API Center najdete tady:
V tomto kurzu se naučíte používat portál k:
- Definování vlastních metadat v centru rozhraní API
- Zobrazení schématu metadat
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.
Definování metadat
Tady definujete dva vlastní příklady metadat: obchodní a veřejné; pokud chcete, definujte další vlastní metadata. Když do inventáře přidáte nebo aktualizujete rozhraní API a další informace, nastavíte hodnoty pro vlastní a všechna běžná integrovaná metadata.
Důležité
Do názvů (názvů) definovaných metadat nezahrnujte žádné citlivé, důvěrné ani osobní údaje. Tyto názvy jsou viditelné v protokolech monitorování, které Microsoft používá ke zlepšení funkčnosti služby. Další podrobnosti a hodnoty metadat jsou však chráněná zákaznická data.
Na webu Azure Portal přejděte do centra rozhraní API.
V nabídce vlevo v části Prostředky vyberte Metadata > + Nová metadata.
Na kartě Podrobnosti zadejte informace o metadatech.
V nadpisu zadejte řádek podnikání.
Volitelně zadejte popis.
Vyberte předdefinované volby a zadejte volby, jako jsou Marketing, Finance, IT, Sales atd. Volitelně povolte možnost Povolit výběr více hodnot. Vyberte Další.
Na kartě Zadání vyberte Požadované pro rozhraní API. Vyberte volitelné pro nasazení a prostředí. (Tyto entity přidáte v dalších kurzech.) Vyberte Další.
Na kartě Zkontrolovat a vytvořit zkontrolujte nastavení a vyberte Vytvořit.
Metadata se přidají do seznamu na stránce Metadata .
Pokud chcete přidat další příklad, vyberte + Nová metadata .
Na kartě Podrobnosti zadejte informace o metadatech.
Do pole Název zadejte veřejný přístup.
Vyberte typ logická hodnota.
Na kartě Zadání vyberte Požadované pro rozhraní API. Vyberte Nepoužitelné pro nasazení a prostředí.
Na kartě Zkontrolovat a vytvořit zkontrolujte nastavení a vyberte Vytvořit.
Metadata se přidají do seznamu.
Zobrazení schématu metadat
Můžete zobrazit a stáhnout schéma JSON pro metadata definovaná v centru rozhraní API. Schéma zahrnuje předdefinovaná a vlastní metadata.
V nabídce vlevo v části Prostředky vyberte schéma metadat Zobrazit metadata>.
Výběrem možnosti Zobrazit rozhraní API schématu > metadat zobrazíte schéma metadat pro rozhraní API, která zahrnují integrovaná a vlastní metadata. Můžete také zobrazit schéma metadat definované pro nasazení a prostředí ve vašem centru rozhraní API.
Další kroky
V tomto kurzu jste se naučili používat portál k:
- Definování vlastních metadat v centru rozhraní API
- Zobrazení schématu metadat
Teď, když jste připravili schéma metadat, přidejte rozhraní API do inventáře v centru rozhraní API.