De API Management-service detecteren

  • 3 minuten

API Management biedt de kernfunctionaliteit om een succesvol API-programma te garanderen via betrokkenheid van ontwikkelaars, zakelijke inzichten, analyses, beveiliging en beveiliging. Elke API bestaat uit een of meer bewerkingen en elke API kan aan een of meer producten worden toegevoegd. Als ontwikkelaars een API willen gebruiken, abonneren ze zich op een product dat die API bevat en vervolgens kunnen ze de bewerking van de API aanroepen. Deze is onderworpen aan gebruiksbeleidsregels die mogelijk van kracht zijn.

API Management-onderdelen

Azure API Management bestaat uit een API-gateway, een beheervlak en een ontwikkelaarsportal. Deze onderdelen worden standaard door Azure gehost en volledig beheerd. API Management is beschikbaar in verschillende lagen die verschillen in capaciteit en functies.

  • De API-gateway is het eindpunt waarmee:

    • Accepteert API-aanroepen en stuurt deze door naar de juiste back-ends
    • Controleert API-sleutels en andere referenties die worden weergegeven met aanvragen
    • Hiermee worden gebruiksquota en frequentielimieten afgedwongen
    • Transformeert aanvragen en antwoorden die zijn opgegeven in beleidsinstructies
    • Slaat reacties in de cache op om de reactielatentie te verbeteren en de belasting van back-endservices te minimaliseren
    • Verzendt logboeken, metrische gegevens en traceringen voor bewaking, rapportage en probleemoplossing

  • Het beheervlak is de beheerinterface waar u uw API-programma instelt. Gebruik deze voor het volgende:

    • Api Management-service-instellingen inrichten en configureren
    • API-schema definiëren of importeren
    • API's verpakken in producten
    • Beleid instellen, zoals quota of transformaties in de API's
    • Inzichten verkrijgen uit analyses
    • Gebruikers beheren

  • De ontwikkelaarsportal is een automatisch gegenereerde, volledig aanpasbare website met de documentatie van uw API's. Met behulp van de ontwikkelaarsportal kunnen ontwikkelaars het volgende doen:

    • API-documentatie lezen
    • Een API aanroepen via de interactieve console
    • Een account maken en abonneren om API-sleutels op te halen
    • Toegang tot analyses voor hun eigen gebruik
    • API-definities downloaden
    • API-sleutels beheren

Producten

Producten zijn de manier waarop de API's worden opgehaald voor ontwikkelaars. Producten in API Management hebben een of meer API's en worden geconfigureerd met een titel, beschrijving en gebruiksvoorwaarden. Producten kunnen open of beveiligd zijn. Voor beveiligde producten is een abonnement nodig voordat ze kunnen worden gebruikt, terwijl open producten zonder abonnement kunnen worden gebruikt. Goedkeuring van het abonnement is geconfigureerd op productniveau en kan goedkeuring van de beheerder vereisen of automatisch worden goedgekeurd.

Groepen

Groepen worden gebruikt voor het beheren van de zichtbaarheid van producten voor ontwikkelaars. API Management heeft de volgende onveranderbare systeemgroepen:

  • Beheer istrators: API Management-service-exemplaren beheren en de API's, bewerkingen en producten maken die door ontwikkelaars worden gebruikt. Beheerders van Azure-abonnementen zijn lid van deze groep.
  • Ontwikkelaars : geverifieerde gebruikers van de ontwikkelaarsportal die toepassingen bouwen met behulp van uw API's. Ontwikkelaars krijgen toegang tot de ontwikkelaarsportal en bouwen toepassingen waarmee de bewerkingen van een API worden aangeroepen.
  • Gasten : niet-geverifieerde gebruikers van de ontwikkelaarsportal. Ze kunnen bepaalde alleen-lezentoegang krijgen, zoals de mogelijkheid om API's te bekijken, maar ze niet aan te roepen.

Naast deze systeemgroepen kunnen beheerders aangepaste groepen maken of externe groepen gebruiken in gekoppelde Microsoft Entra-tenants.

Ontwikkelaars

Ontwikkelaars vertegenwoordigen de gebruikersaccounts in een service-exemplaar van API Management. Ontwikkelaars kunnen worden gemaakt of worden uitgenodigd voor deelname door beheerders, maar ze kunnen zich ook registreren in de Ontwikkelaarsportal. Elke ontwikkelaar is lid van een of meer groepen en mag zich abonneren op de producten die zichtbaarheid aan deze groepen verlenen.

Beleidsregels

Beleidsregels zijn een verzameling instructies die sequentieel worden uitgevoerd op de aanvraag of het antwoord van een API. Populaire instructies omvatten indelingsconversie van XML in JSON en beperking van de aanroepfrequentie om het aantal inkomende aanroepen van een ontwikkelaar te beperken. Er zijn nog vele andere beleidsregels beschikbaar.

Beleidsexpressies kunnen worden gebruikt als kenmerkwaarden of tekstwaarden in API Management-beleidsregels, tenzij het beleid iets anders aangeeft. Sommige beleidsregels, zoals de beleidsregels Stroom controleren en Variabele instellen, zijn gebaseerd op beleidsexpressies.

Beleidsregels kunnen op verschillende bereiken worden toegepast, afhankelijk van uw behoeften: globaal (alle API's), een product, een specifieke API of een API-bewerking.