Dela via

Importera ett OData-API

GÄLLER FÖR: Alla API Management-nivåer

Den här artikeln visar hur du importerar en OData-kompatibel tjänst som ett API i API Management.

I den här artikeln kan du se hur du:

  • Importera en beskrivning av OData-metadata med hjälp av Azure Portal
  • Hantera OData-schemat i portalen
  • Skydda OData-API:et

Förutsättningar

Gå till API Management-instansen

  1. I Azure -portalensöker du efter och väljer API Management-tjänster:

    Skärmbild som visar API Management-tjänster i sökresultaten.

  2. På sidan API Management Services väljer du din API Management-instans:

    Skärmbild som visar en API Management-instans på sidan API Management-tjänster.

Importera OData-metadata

  1. Välj API:er> i den vänstra menyn och välj sedan + Lägg till API.

  2. Under Skapa från definition väljer du OData:

    Skärmbild av att skapa ett API från en OData-beskrivning i portalen.

  3. Ange API-inställningar. Du kan uppdatera inställningarna senare genom att gå till fliken Inställningar i API:et.

    1. I OData-specifikation anger du en URL för en OData-metadataslutpunkt. Det här värdet är vanligtvis URL:en till tjänstroten, som läggs till med /$metadata. Du kan också välja en lokal OData XML-fil som ska importeras.

    2. Ange ytterligare inställningar för att konfigurera ditt API. De här inställningarna beskrivs i självstudien Importera och publicera ditt första API .

  4. Välj Skapa.

    API:et läggs till i listan över API:er. Entitetsuppsättningar och funktioner som exponeras i beskrivningen av OData-metadata visas på fliken Entitetsuppsättningar och funktioner i API:et.

    Skärmbild som visar OData-entitetsuppsättningar och funktioner.

Uppdatera OData-schemat

Du kan komma åt en redigerare i portalen för att visa ditt API:s OData-schema. Om API:et ändras kan du även uppdatera schemat i API Management från en fil eller en OData-tjänstslutpunkt.

  1. I portalen navigerar du till din API Management-instans.

  2. I den vänstra menyn väljer du API:er och sedan ditt OData-API.

  3. På fliken Entitetsuppsättningar och funktioner väljer du ellipsen (...) bredvid en entitetsuppsättning eller funktion och väljer sedan Redigera.

    Skärmbild som visar platsen för kommandot Redigera.

  4. Granska schemat. Om du vill uppdatera den väljer du Uppdatera från fil eller Uppdatera schema från slutpunkten.

    Skärmbild av schemaredigeraren för ett OData-API.

Testa ditt OData-API

  1. I den vänstra menyn väljer du API:er och sedan ditt OData-API.

  2. På fliken Entitetsuppsättningar och funktioner väljer du ellipsen (...) bredvid en entitetsuppsättning eller funktion och väljer sedan Testa.

    Skärmbild som visar kommandot Test.

  3. I testkonsolen anger du mallparametrar, frågeparametrar och huvuden för testet och väljer sedan Testa. Mer information om hur du testar API:er i portalen finns i Testa det nya API:et i portalen.

Skydda ditt OData-API

Skydda ditt OData-API genom att tillämpa befintliga autentiserings- och auktoriseringsprinciper och en OData-valideringsprincip för att skydda mot attacker via OData API-begäranden.

Tips

I portalen konfigurerar du principer för ditt OData-API på fliken API-principer .

Lägg till andra API:er

Du kan skapa ett API av API:er som exponeras av olika tjänster, inklusive:

  • En OpenAPI-specifikation
  • ETT SOAP-API
  • Ett GraphQL-API
  • En webbapp som finns i Azure App Service
  • Azure-funktioner
  • Azure Logic-appar
  • Azure Service Fabric

Anteckning

När du importerar ett API läggs åtgärderna till i ditt aktuella API.

Så här lägger du till ett API i ett befintligt API:

  1. Gå till din Azure API Management-instans i Azure-portalen:

    Skärmbild som visar sidan API Management-tjänster.

  2. Välj API:er på sidan Översikt eller välj API:er>API:er på menyn till vänster.

    Skärmbild som visar valet av API:er på sidan Översikt.

  3. Välj ellipsen (...) bredvid det API som du vill lägga till ett annat API till.

  4. Välj Importera från den nedrullningsbara menyn:

    Skärmbild som visar kommandot Importera.

  5. Välj en tjänst som ett API ska importeras från.

Relaterat innehåll