Share via

Zelfstudie: Aangepaste metagegevens definiëren

In deze zelfstudie wordt uitgelegd hoe u aangepaste metagegevens definieert om uw API's en andere informatie in uw API-centrum te ordenen. U kunt aangepaste en ingebouwde metagegevens gebruiken voor zoeken en filteren en governancestandaarden in uw organisatie afdwingen.

Zie voor meer informatie over metagegevens in Azure API Center:

In deze zelfstudie leert u hoe u Azure Portal gebruikt voor het volgende:

  • Aangepaste metagegevens definiëren in uw API-centrum
  • Het metagegevensschema weergeven

Vereiste voorwaarden

Metagegevens definiëren

Hier definieert u twee voorbeelden van aangepaste metagegevens: type werkzaamheden en publieksgericht; definieer desgewenst uw eigen metagegevens. Wanneer u API's en andere informatie in uw inventaris toevoegt of bijwerkt, stelt u waarden in voor aangepaste en algemene ingebouwde metagegevens.

Belangrijk

Neem geen gevoelige, vertrouwelijke of persoonlijke gegevens op in de titels (namen) van metagegevens die u definieert. Deze titels zijn zichtbaar in bewakingslogboeken die door Microsoft worden gebruikt om de functionaliteit van de service te verbeteren. Andere metagegevensgegevens en -waarden zijn echter uw beveiligde klantgegevens.

  1. Meld u aan bij Azure Portal en navigeer vervolgens naar uw API-centrum.

  2. Selecteer in het zijbalkmenu onder Assets de optie Metagegevens>+ Nieuwe metagegevens.

  3. Voer op het tabblad Details informatie in over de metagegevens.

    1. Voer voor TitelLine-Of-Business in.

    2. Voer desgewenst een beschrijving in.

    3. Selecteer vooraf gedefinieerde opties en voer keuzes in, zoals Marketing, Financiën, IT, Verkoop, enzovoort. Schakel desgewenst selectie van meerdere waarden toestaan in. Kies Volgende.

    Schermopname die laat zien hoe u aangepaste metagegevens toevoegt in de portal.

  4. Selecteer Vereist voor API's op het tabblad Toewijzingen. Selecteer Optioneel voor implementaties en omgevingen. U kunt deze entiteiten toevoegen in latere handleidingen. Kies Volgende.

    Schermopname van metagegevenstoewijzingen in de portal.

  5. Controleer op het tabblad Controleren en maken de instellingen en selecteer Maken.

    De metagegevens worden toegevoegd aan de lijst op de pagina Metagegevens .

  6. Selecteer + Nieuwe metagegevens om nog een voorbeeld toe te voegen.

  7. Voer op het tabblad Details informatie in over de metagegevens.

    1. Voor Titel voert u Publiek in.

    2. Selecteer Het type Booleaanse waarde.

  8. Selecteer Vereist voor API's op het tabblad Toewijzingen. Selecteer Niet van toepassing op implementaties en omgevingen.

  9. Controleer op het tabblad Controleren en maken de instellingen en selecteer Maken.

    De metagegevens worden toegevoegd aan de lijst.

Metagegevensschema weergeven

U kunt het JSON-schema bekijken en downloaden voor de metagegevens die zijn gedefinieerd in uw API-centrum. Het schema bevat ingebouwde en aangepaste metagegevens.

  1. Selecteer in het linkermenu onder AssetsMetadata> en Weergave van metagegevensschema.

  2. SelecteerSchema-API's> voor metagegevens weergeven om het metagegevensschema voor API's weer te geven, waaronder ingebouwde en aangepaste metagegevens. U kunt ook het metagegevensschema bekijken dat is gedefinieerd voor implementaties en omgevingen in uw API-centrum.

    Schermopname van het metagegevensschema in de portal.

Volgende stap

Voeg API's toe aan de inventaris in uw API-centrum.

API's registreren in uw API-inventaris