Importera SOAP API till API Management

Den här artikeln visar hur du importerar en WSDL-specifikation, vilket är en XML-standardrepresentation av ett SOAP-API. Artikeln visar också hur du testar API:et i API Management.

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

• Importera ett SOAP-API
• Testa API:et i Azure Portal

Anteckning

WSDL-import till API Management omfattas av vissa begränsningar. WSDL-filer med wsdl:import, xsd:importoch xsd:include -direktiv stöds inte. Ett verktyg med öppen källkod för att lösa och sammanfoga dessa beroenden i en WSDL-fil finns i den här GitHub-lagringsplatsen.

Förutsättningar

• En API Management instans. Om du inte redan har en, slutför du följande snabbstart: Skapa en Azure API Management-instans.

• Azure CLI

  • Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Snabbstart för Bash i Azure Cloud Shell.

    

  • Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör i Windows eller macOS kan du köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.

    • Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Andra inloggningsalternativ finns i Logga in med Azure CLI.

    • När du uppmanas att göra det installerar du Azure CLI-tillägget vid första användningen. Mer information om tillägg finns i Använda tillägg med Azure CLI.

    • Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

• Azure PowerShell

  • Om du väljer att använda Azure PowerShell lokalt:
    • Installera Az PowerShell-modulen.
    • Anslut till ditt Azure-konto med cmdleten Connect-AzAccount .
  • Om du väljer att använda Azure Cloud Shell:
    • Mer information finns i Översikt över Azure Cloud Shell.

Importera ett serverdels-API

Portal

1. I Azure Portal navigerar du till din API Management-instans.

2. I den vänstra menyn väljer du API:er>+ Lägg till API.

3. Under Skapa från definition väljer du WSDL.

   

4. I WSDL-specifikationen anger du URL:en till SOAP-API:et eller klickar på Välj en fil för att välja en lokal WSDL-fil.

5. I Import-metoden väljs SOAP-genomströmning som standard. Med det här valet exponeras API:et som SOAP och API-konsumenter måste använda SOAP-regler. Om du vill ”restify” API:et, följer du stegen i Importera ett SOAP API och konvertera det till REST.

   

6. Följande fält fylls automatiskt i med information från SOAP-API:et: Visningsnamn, Namn, Beskrivning.

7. Ange andra API-inställningar. Du kan ange värdena när du skapar eller konfigurera dem senare genom att gå till fliken Inställningar .

   Mer information om API-inställningar finns i Importera och publicera din första API-självstudie .

8. Välj Skapa.

Azure CLI

I följande exempel används kommandot az apim api import för att importera en WSDL-specifikation från den angivna URL:en till en API Management-instans med namnet apim-hello-world. Om du vill importera med hjälp av en sökväg till en specifikation i stället för en URL använder du parametern --specification-path .

I det här exemplet är WSDL tjänstnamnet OrdersAPI och en av de tillgängliga slutpunkterna (gränssnitten) är grundläggande.

# API Management service-specific details
APIMServiceName="apim-hello-world"
ResourceGroupName="myResourceGroup"

# API-specific details
APIId="order-api"
APIPath="order"
SpecificationFormat="Wsdl"
SpecificationURL="https://fazioapisoap.azurewebsites.net/FazioService.svc?singleWsdl"
WsdlServiceName="OrdersAPI"
WsdlEndpointName="basic"

# Import API
az apim api import --path $APIPath --resource-group $ResourceGroupName \
    --service-name $APIMServiceName --api-id $APIId \
    --specification-format $SpecificationFormat --specification-url $SpecificationURL \
    --wsdl-service-name $WsdlServiceName --wsdl-endpoint-name $WsdlEndpointName

PowerShell

I följande exempel används cmdleten Import-AzApiManagementApi Azure PowerShell för att importera en WSDL-specifikation från den angivna URL:en till en API Management-instans med namnet apim-hello-world. Om du vill importera med hjälp av en sökväg till en specifikation i stället för en URL använder du parametern -SpecificationPath .

I det här exemplet är WSDL tjänstnamnet OrdersAPI och en av de tillgängliga slutpunkterna (gränssnitten) är grundläggande.

# API Management service-specific details
$apimServiceName = "apim-hello-world"
$resourceGroupName = "myResourceGroup"

# API-specific det
$apiId = "orders-api"
$apiPath = "orders"
$specificationFormat = "Wsdl"
$specificationUrl = "https://fazioapisoap.azurewebsites.net/FazioService.svc?singleWsdl"
$wsdlServiceName = "OrdersAPI"
$wsdlEndpointName = "basic"

# Get context of the API Management instance. 
$context = New-AzApiManagementContext -ResourceGroupName $resourceGroupName -ServiceName $apimServiceName

# Import API
Import-AzApiManagementApi -Context $context -ApiId $apiId -SpecificationFormat $specificationFormat -SpecificationUrl $specificationUrl -Path $apiPath -WsdlServiceName $wsdlServiceName -WsdlEndpointName $wsdlEndpointName

Testa det nya API:et i portalen

Åtgärder kan anropas direkt från portalen, vilket är ett praktiskt sätt för administratörer att visa och testa driften av ett API.

1. Välj det API som du skapade i föregående steg.

2. Välj fliken Test.

3. Välj en åtgärd.

   Sidan visar fält för frågeparametrar och fält för sidhuvudena.

   Anteckning

   I testkonsolen fyller API Management automatiskt i ett Ocp-Apim-Subscription-Key-huvud och konfigurerar prenumerationsnyckeln för den inbyggda all-access-prenumerationen. Den här nyckeln ger åtkomst till varje API i API Management-instansen. Om du vill kan du visa Ocp-Apim-Subscription-Key-huvudet genom att välja ögonikonen bredvid HTTP-begäran.

4. Beroende på åtgärden anger du frågeparametervärden, rubrikvärden eller en begärandetext. Välj Skicka.

   När testet lyckas svarar serverdelen med 200 OK och vissa data.

Information om hur du felsöker ett API finns i Självstudie: Felsöka dina API:er med hjälp av spårning av begäranden.

Soap-åtgärd med jokertecken

Om du behöver skicka en SOAP-begäran som inte har en dedikerad åtgärd definierad i API:et kan du konfigurera en SOAP-åtgärd med jokertecken. Åtgärden med jokertecken matchar alla SOAP-begäranden som inte har definierats i API:et.

Så här definierar du en SOAP-åtgärd med jokertecken:

1. I portalen väljer du det API som du skapade i föregående steg.
2. På fliken Design väljer du + Lägg till åtgärd.
3. Ange ett visningsnamn för åtgärden.
4. I URL:en väljer du POST och anger /soapAction={any} i resursen. Mallparametern inom klammerparenteserna är godtycklig och påverkar inte körningen.

Lägg till andra API:er

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

• OpenAPI-specifikationen
• ETT SOAP-API
• En webbapp som finns i Azure App Service
• Azure-funktionsapp
• Azure Logic Apps
• Azure Service Fabric

Lägg till ett annat API i ditt befintliga API med hjälp av följande steg.

Anteckning

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

1. Öppna Azure API Management-instansen i Azure-portalen.

   

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

   

3. Klicka på ... intill det API som du vill lägga till ett annat API till.

4. Välj Import från den nedrullningsbara menyn.

   

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

   

Relaterade ämnen

• Begränsningar för API-import
• Importera en OpenAPI-specifikation
• Importera ett SOAP-API
• Importera ett SOAP-API och konvertera till REST
• Importera ett App Service-API
• Importera ett API för containerapp
• Importera ett WebSocket-API
• Importera ett GraphQL-API
• Importera ett GraphQL-schema och konfigurera fältmatchare
• Importera en Azure-funktionsapp
• Importera en Azure-logikapp
• Importera en Service Fabric-tjänst
• Importera SAP OData-metadata
• Redigera ett API

Nästa steg

Omvandla och skydda ett publicerat API