Identifiera API Management-tjänsten

  • 3 minuter

API Management tillhandahåller de viktigaste funktionerna för att säkerställa ett lyckat API-program genom utvecklarengagemang, affärsinsikter, analys, säkerhet och skydd. Varje API består av en eller flera åtgärder och varje API kan läggas till i en eller flera produkter. För att kunna använda ett API prenumererar utvecklare på en produkt som innehåller API:et och kan sedan anropa API:ets åtgärder, baserat på eventuella användningsprinciper.

API Management-komponenter

Azure API Management består av en API-gateway, ett hanteringsplan och en utvecklarportal. Dessa komponenter är Azure-värdbaserade och fullständigt hanterade som standard. API Management är tillgängligt på olika nivåer som skiljer sig åt i kapacitet och funktioner.

  • API-gatewayen är slutpunkten som:

    • Accepterar API-anrop och dirigerar dem till lämpliga serverdelar
    • Verifierar API-nycklar och andra autentiseringsuppgifter som visas med begäranden
    • Framtvingar användningskvoter och hastighetsgränser
    • Transformerar begäranden och svar som anges i principinstruktioner
    • Cachelagrar svar för att förbättra svarsfördröjningen och minimera belastningen på serverdelstjänster
    • Genererar loggar, mått och spårningar för övervakning, rapportering och felsökning

  • Hanteringsplanet är det administrativa gränssnitt där du konfigurerar DITT API-program. Använd portalen om du vill:

    • Etablera och konfigurera inställningar för API Management-tjänsten
    • Definiera eller importera API-schema
    • Paketera API:er i produkter
    • Konfigurera principer som kvoter eller omvandlingar på API:erna
    • Hämta insikter från analys
    • Hantera användare

  • Utvecklarportalen är en automatiskt genererad, helt anpassningsbar webbplats med dokumentationen om dina API:er. Med hjälp av utvecklarportalen kan utvecklare:

    • Läs API-dokumentation
    • Anropa ett API via den interaktiva konsolen
    • Skapa ett konto och prenumerera för att hämta API-nycklar
    • Få åtkomst till analys på egen användning
    • Ladda ned API-definitioner
    • Hantera API-nycklar

Produkter

Produkter syftar på hur API:erna exponeras för utvecklare. Produkter i API Management har ett eller flera API:er och konfigureras med en rubrik, en beskrivning och användningsvillkor. Produkter kan vara öppna eller skyddade. Utvecklare måste prenumerera på skyddade produkter innan de kan användas. Öppna produkter kan användas utan en prenumeration. Prenumerationsgodkännande konfigureras på produktnivå och kan antingen kräva administratörsgodkännande eller godkännas automatiskt.

Grupper

Grupper används för att hantera hur produkterna visas för utvecklare. API Management har följande systemgrupper som inte kan ändras:

  • Administratörer – Hantera API Management-tjänstinstanser och skapa DE API:er, åtgärder och produkter som används av utvecklare. Azure-prenumerationsadministratörer är medlemmar i den här gruppen.
  • Utvecklare – Autentiserade användare av utvecklarportalen som skapar program med hjälp av dina API:er. Utvecklare beviljas åtkomst till utvecklarportalen och bygger program som anropar åtgärderna i ett API.
  • Gäster – oautentiserade användare av utvecklarportalen. De kan beviljas viss skrivskyddad åtkomst, till exempel möjligheten att visa API:er men inte anropa dem.

Utöver dessa systemgrupper kan administratörer skapa anpassade grupper eller använda externa grupper i associerade Microsoft Entra-klienter.

Utvecklare

Utvecklare representerar användarkontona i en API Management-tjänstinstans. Utvecklare kan skapas eller bjudas in av administratörer eller registrera sig på utvecklarportalen. Varje utvecklare är medlem i en eller flera grupper och kan prenumerera på de produkter som visas för dessa grupper.

Principer

Principer är en samling instruktioner som körs sekventiellt på begäran av eller efter ett svar från ett API. Exempel på populära instruktioner är formatkonvertering från XML till JSON och begränsning av anropsfrekvensen för att begränsa antalet inkommande anrop från en utvecklare. Många andra principer är också tillgängliga.

Principuttryck kan användas som attributvärden eller textvärden i API Management-principer, under förutsättning att principen tillåter det. Vissa principer som Kontrollflöde och Ange variabel baseras på principuttryck.

Principer kan tillämpas i olika omfång, beroende på dina behov: globala (alla API:er), en produkt, ett specifikt API eller en API-åtgärd.