Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Ez a cikk háttérinformációkat tartalmaz a metaadatokról, és arról, hogyan használható az API-szabályozáshoz az Azure API Centerben. Metaadatokat definiálhat és állíthat be az API-központ API-k és egyéb entitások rendszerezéséhez és szűréséhez. A metaadatok lehetnek beépítettek vagy egyéniek, és létrehozhat egy metaadat-sémát, amely konzisztenciát kényszerít az API-k, környezetek és üzemelő példányok között.
Beépített metaadatok
Api-k, környezetek és központi telepítések létrehozásakor vagy frissítésekor az API-központban meg kell adnia bizonyos beépített metaadat-tulajdonságokat, például az API típusát (REST, WSDL stb.).
Az alábbi táblázatok az Azure API Center-entitásokhoz biztosított beépített metaadatokat sorolják fel. További részletekért tekintse meg az API Center REST API-referenciáját. A táblák nem tartalmaznak szabványos Azure-tulajdonságokat, például erőforrás-azonosítókat, megjelenítési címeket vagy leírásokat. Nem minden tulajdonságra van szükség.
API-k
| Metadaták | Description | Példaértékek |
|---|---|---|
| kedves | Az API típusa (típusa) | REST, SOAP, GraphQL |
| életciklus-szakasz | Az API fejlesztési életciklusának szakasza | Tervezés, fejlesztés |
| licenc | Az API licencadatai | SPDX-azonosító, licencszövegre mutató hivatkozás |
| külső dokumentáció | Az API külső dokumentációjának webhelye | Dokumentációra mutató URL-cím |
| kapcsolattartási adatok | Az API kapcsolattartási pontjai | E-mail-cím, név, URL-cím |
| szolgáltatási feltételek | Az API szolgáltatási feltételei | A szolgáltatási feltételekre mutató URL-cím |
Environments
| Metadaták | Description | Példaértékek |
|---|---|---|
| kedves | Környezet típusa (típusa) | Gyártás, előkészítés, fejlesztés |
| kiszolgáló | A környezet kiszolgálóadatai | Típus és URL-cím a környezeti kiszolgálóra mutat |
| kiszolgáló típusa | A környezeti kiszolgáló típusa | API Management-kiszolgáló, Kubernetes-kiszolgáló, Apigee-kiszolgáló |
| bevezetés | Előkészítési információk a környezethez | Utasítások és a környezet fejlesztői portáljára mutató URL-cím |
Telepítések
| Metadaták | Description | Példaértékek |
|---|---|---|
| kiszolgáló | Az üzembe helyezés kiszolgálói adatai | Az üzembehelyezési kiszolgálóra mutató URL-cím |
| state | Az üzembe helyezés állapota | Aktív, inaktív |
Egyéni metaadatok
Egyéni metaadatok definiálása az Azure Portal, az Azure API Center REST API vagy az Azure CLI használatával az API-k, környezetek és üzemelő példányok rendszerezéséhez és szűréséhez az API-központban. Az Azure API Center az alábbi típusú egyéni metaadatokat támogatja.
| Típus | Description | Példa neve |
|---|---|---|
| Boolean | Igaz vagy hamis | IsInternal |
| szám | Számérték | YearOfCreation |
| karakterlánc | Szöveges érték | GitHubRepository |
| tömb | Értékek listája | Címkék |
| beépített választás | A választási lehetőségek beépített listája | Department |
| objektum | Több típusból álló összetett objektum | APIApprover |
Fontos
Ne adjon meg bizalmas, bizalmas vagy személyes adatokat a megadott metaadatok címében (neveiben). Ezek a címek láthatók a microsoft által a szolgáltatás működésének javítására használt figyelési naplókban. A metaadatok egyéb részletei és értékei azonban a védett ügyféladatok.
Metaadatok hozzárendelése entitásokhoz
Az egyéni metaadat-tulajdonságok api-khoz, környezetekhez vagy üzembe helyezésekhez rendelhetők az API-központban. Meghatározhatja és hozzárendelheti például a részleg metaadatait az API-khoz, így amikor regisztrál egy API-t, vagy új API-verziót ad hozzá, meg lesz adva az API-ért felelős részleg.
Ha entitáshoz van rendelve, a metaadatok megadása nem kötelező vagy kötelező. Szükség lehet például arra, hogy a részleg metaadatai csak API-khoz legyenek beállítva, de engedélyezze a YearOfCreation használatát a környezetek opcionális metaadataiként.
Megjegyzés:
- Bármikor definiálhat egyéni metaadatokat, és az API-központban lévő API-kra és más entitásokra is alkalmazható.
- Az egyéni metaadatok definiálása után módosíthatja annak hozzárendelését egy entitásra, például az API-k esetében kötelezőről választhatóra.
- Módosíthatja a metaadat-értékeket, de nem törölheti vagy nem módosíthatja az API-kban, környezetekben és üzemelő példányokban jelenleg beállított egyéni metaadatok típusát. Először törölje az egyéni metaadatokat az entitásokból, majd törölheti vagy módosíthatja őket.
Metaadatok használata szabályozáshoz
Beépített és egyéni metaadatok használatával rendszerezheti API-kat, környezeteket és üzembe helyezéseket az API-központban. Például:
A cégirányítási szabványok kényszerítése bizonyos metaadatok API-khoz, környezetekhez és üzemelő példányokhoz való beállításának megkövetelésével.
Keressen és szűrjön API-kat az API-központban metaadatértékek alapján. Szűrhet közvetlenül az Azure Portal API-k lapján, vagy az Azure API Center REST API vagy az Azure CLI használatával lekérdezheti az API-kat bizonyos metaadatok értékei alapján.
