API-toegangspoort in Azure API Management

GELDT VOOR: Alle API-beheersniveaus

Dit artikel biedt informatie over de rollen en functies van de API Management gateway-component en vergelijkt de gateways die je kunt implementeren.

Verwante informatie:

• Voor een overzicht van API Management-scenario's, componenten en concepten, zie Wat is Azure API Management?

• Voor meer informatie over de servicelagen en functies van API Management, zie:

  • API Management-niveaus
  • Vergelijking op basis van functies van de Azure API Management-niveaus.

Rol van de gateway

De API Management gateway (ook wel data plane of runtime genoemd) is het dienstonderdeel dat verantwoordelijk is voor het doorsturen van API-verzoeken, het toepassen van beleidsregels en het verzamelen van telemetrie.

Specifiek, de gateway:

• Fungeert als een façade naar back-endservices door API-aanroepen te accepteren en door te sturen naar de juiste back-ends
• Controleert API-sleutels en andere referenties, zoals JWT's en certificaten die worden weergegeven met aanvragen
• Vermeldt gebruiksquota en snelheidslimieten
• Transformeert optioneel verzoeken en antwoorden zoals gespecificeerd in beleidsverklaringen.
• Indien geconfigureerd, cacht antwoorden om de responstijd te verbeteren en de belasting op back-end diensten te minimaliseren.
• Zendt logboeken, metrieken en traces uit voor monitoring, rapportage en probleemoplossing

Beheerd en zelf gehost

API-beheer biedt zowel beheerde als zelf-gehoste gateways aan.

• Beheerd - De beheerde gateway is het standaard gateway-onderdeel dat wordt geïmplementeerd in Azure voor elke API Management-instantie in elke servicelaag. Een zelfstandige beheerde gateway kan ook worden gekoppeld aan een werkruimte in een API Management-exemplaar. Met de beheerde gateway stroomt al het API-verkeer via Azure, ongeacht waar back-ends die de API's implementeren, worden gehost.

  Note

  Vanwege verschillen in de onderliggende servicearchitectuur hebben de gateways in de verschillende API Management-servicelagen enkele verschillen in mogelijkheden. Zie de sectie Functievergelijking: Beheerde versus zelf-hostende gateways voor meer informatie.

• Zelf-hostend : de zelf-hostende gateway is een optionele, containerversie van de standaard beheerde gateway die beschikbaar is in bepaalde servicelagen. Het is handig voor hybride en multicloudscenario's waarbij er een vereiste is om de gateways uit te voeren buiten Azure in dezelfde omgevingen waar API-back-ends worden gehost. De zelf-gehoste gateway stelt klanten met een hybride IT-infrastructuur in staat om API's die on-premises en in de cloud worden gehost, te beheren vanuit een enkele API Management-service in Azure.

  • De zelf-gehoste gateway wordt verpakt als een Linux-gebaseerde Docker-container en wordt vaak gedeployed naar Kubernetes, inclusief naar Azure Kubernetes Service en Azure Arc-enabled Kubernetes.

  • Elke zelf-gehoste gateway is gekoppeld aan een Gateway-resource in een cloudgebaseerde API Management-omgeving, waarvan hij configuratie-updates ontvangt en status communiceert.

Functievergelijking: Beheerder versus zelf-gehoste gateways

De volgende tabellen vergelijken de functies die beschikbaar zijn in de volgende API Management-gateways:

• Classic - de beheerde gateway die beschikbaar is in de Developer, Basic, Standard en Premium servicelagen (voorheen gegroepeerd als dedicated lagen)
• V2 - de beheerde gateway beschikbaar in de Basic v2-, Standard v2- en Premium v2-niveaus
• Consumption - de beheerde gateway die beschikbaar is in de Consumption-laag
• Self-hosted - de optionele zelf-gehoste gateway beschikbaar in geselecteerde servicelagen
• Werkruimte : de beheerde gateway die beschikbaar is in een werkruimte in bepaalde servicelagen

Infrastructure

¹ Het hangt af van hoe de gateway is geïmplementeerd, maar het is de verantwoordelijkheid van de klant.
² Connectiviteit naar het zelf-gehoste gateway v2 configuratie-eindpunt vereist DNS-resolutie van de eindpunt-hostnaam.
³ CA rootcertificaten voor zelf-gehoste gateway worden apart beheerd per gateway
⁴ Clientprotocol moet worden ingeschakeld.
⁵ Configureer met de forward-request policy.

Achterkant-API's

Policies

Beheerde en zelf-gehoste gateways ondersteunen alle beschikbare policies in beleidsdefinities met de volgende uitzonderingen. Zie de beleidsreferentie voor details over elk beleid.

¹ Geconfigureerde beleidsregels die niet door de zelf-gehoste gateway worden ondersteund, worden overgeslagen tijdens de uitvoering van het beleid.
² De frequentielimiet per sleutel, quotum per sleutel en limietbeleid voor AI-tokens is niet beschikbaar in de verbruikslaag.
³ Frequentielimieten in een zelf-hostende gateway kunnen worden geconfigureerd om lokaal te synchroniseren (tussen gateway-exemplaren tussen clusterknooppunten), bijvoorbeeld via helm-grafiekimplementatie voor Kubernetes of met behulp van de Azure Portal-implementatiesjablonen. Echter, tarieflimiet tellers synchroniseren niet met andere gatewaybronnen die zijn geconfigureerd in de API Management-instantie, inclusief de beheerde gateway in de cloud. Meer informatie

Monitoring

Voor meer informatie over monitoropties, zie Observeerbaarheid in Azure API Management.

¹ De v2-lagen ondersteunen analyses op basis van Azure Monitor.
² Gateway maakt gebruik van de ingebouwde geheugenbuffer van Azure Application Insight en biedt geen leveringsgaranties.
³ De zelf-hostende gateway verzendt momenteel geen resourcelogboeken (diagnostische logboeken) naar Azure Monitor. Optioneel stuur statistieken naar Azure Monitor, of configureer en bewaar logs lokaal waar de self-hosted gateway is geïmplementeerd.

Authenticatie en autorisatie

Beheerde en zelf-gehoste gateways ondersteunen alle beschikbare API-authenticatie- en autorisatieopties met de volgende uitzonderingen.

Gateway-doorvoer en schaalvergroting

Beheerde gateway

Voor een geschatte maximale doorvoer van de gateway in de API Management-serviceniveaus, zie API Management prijzen.

• Klassieke niveaus

  • Schaal de gatewaycapaciteit door schaalunits toe te voegen of te verwijderen, of upgrade het serviceniveau. (Schaalvergroting is niet beschikbaar op het ontwikkelaarsniveau.)
  • In de Basic-, Standaard- en Premium-niveaus kunt u desgewenst Azure Monitor autoschaal configureren.
  • In de Premium-laag kun je optioneel capaciteit van de gateway toevoegen en verdelen over meerdere regio's.

• v2-categoriën

  • Schaal de gatewaycapaciteit door schaalunits toe te voegen of te verwijderen, of upgrade het serviceniveau.

• Verbruiksniveau

  • API Management-instanties in de Consumptie-laag schalen automatisch op basis van het verkeer.

Zelfgehoste gateway

• In omgevingen zoals Kubernetes, voeg meerdere gateway-replica's toe om aan het verwachte gebruik te voldoen.
• Optioneel configureer autoscaling om aan de verkeersvraag te voldoen.

Werkruimte-gateway

Voeg capaciteit toe door schaaleenheden toe te voegen en te verwijderen in de werkruimte-gateway.

Verwante inhoud

Leer meer over:

• API Management in een hybride en multicloudwereld
• Capacity metric voor schaalbesluiten
• Waarneembaarheidsmogelijkheden in API Management
• AI-gatewaymogelijkheden in API Management