Importowanie interfejsu API PROTOKOŁU SOAP do usługi API Management

DOTYCZY: Wszystkie warstwy usługi API Management

W tym artykule pokazano, jak zaimportować specyfikację WSDL, która jest standardową reprezentacją XML interfejsu API protokołu SOAP. W tym artykule pokazano również, jak przetestować interfejs API w usłudze API Management.

W tym artykule omówiono sposób wykonywania następujących zadań:

• Importowanie interfejsu API SOAP
• Testowanie interfejsu API w witrynie Azure Portal

Uwaga

Importowanie WSDL do usługi API Management podlega pewnym ograniczeniom. Pliki WSDL z dyrektywami wsdl:import, xsd:importi xsd:include nie są obsługiwane. Aby narzędzie typu open source rozpoznawało i scalało te zależności w pliku WSDL, zobacz to repozytorium GitHub.

Wymagania wstępne

• Wystąpienie usługi API Management. Jeśli jeszcze go nie masz, wykonaj czynności opisane w następującym przewodniku Szybki start: Tworzenie wystąpienia usługi Azure API Management.

• Interfejs wiersza polecenia platformy Azure

  • Użyj środowiska powłoki Bash w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Szybki start dotyczący powłoki Bash w usłudze Azure Cloud Shell.

    

  • Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie interfejsu wiersza polecenia platformy Azure w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić interfejs wiersza polecenia platformy Azure w kontenerze platformy Docker.

    • Jeśli korzystasz z instalacji lokalnej, zaloguj się do interfejsu wiersza polecenia platformy Azure za pomocą polecenia az login. Aby ukończyć proces uwierzytelniania, wykonaj kroki wyświetlane w terminalu. Aby uzyskać inne opcje logowania, zobacz Logowanie się przy użyciu interfejsu wiersza polecenia platformy Azure.

    • Po wyświetleniu monitu zainstaluj rozszerzenie interfejsu wiersza polecenia platformy Azure podczas pierwszego użycia. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Korzystanie z rozszerzeń w interfejsie wiersza polecenia platformy Azure.

    • Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.

• Azure PowerShell

  • Jeśli zdecydujesz się używać programu Azure PowerShell lokalnie:
    • Zainstaluj najnowszą wersję modułu Az programu PowerShell.
    • Połączenie do konta platformy Azure przy użyciu polecenia cmdlet Połączenie-AzAccount.
  • Jeśli zdecydujesz się używać usługi Azure Cloud Shell:
    • Aby uzyskać więcej informacji, zobacz Omówienie usługi Azure Cloud Shell .

Importowanie interfejsu API zaplecza

Portal

1. W witrynie Azure Portal przejdź do wystąpienia usługi API Management.

2. W menu po lewej stronie wybierz pozycję Interfejsy> API+ Dodaj interfejs API.

3. W obszarze Utwórz z definicji wybierz pozycję WSDL.

   

4. W specyfikacji WSDL wprowadź adres URL interfejsu API protokołu SOAP lub kliknij pozycję Wybierz plik, aby wybrać lokalny plik WSDL.

5. W obszarze Metoda importu przekazywanie protokołu SOAP jest domyślnie zaznaczone. Po wybraniu tego wyboru interfejs API jest uwidaczniony jako protokół SOAP, a użytkownicy interfejsu API muszą używać reguł protokołu SOAP. Jeśli chcesz przekształcić interfejs API przy użyciu stylu REST, postępuj zgodnie z instrukcjami podanymi w temacie Import a SOAP API and convert it to REST (Importowanie interfejsu API protokołu SOAP i konwertowanie go do stylu REST).

   

6. Następujące ustawienia interfejsu API są wypełniane automatycznie na podstawie informacji z interfejsu API PROTOKOŁU SOAP: Nazwa wyświetlana, Nazwa, Opis. Operacje są wypełniane automatycznie przy użyciu nazwy wyświetlanej, adresu URL i opisu oraz odbierania nazwy wygenerowanej przez system.

7. Wprowadź inne ustawienia interfejsu API. Wartości można ustawić podczas tworzenia lub skonfigurować później, przechodząc do karty Ustawienia.

   Aby uzyskać więcej informacji na temat ustawień interfejsu API, zobacz Importowanie i publikowanie pierwszego samouczka interfejsu API .

8. Wybierz pozycję Utwórz.

Interfejs wiersza polecenia platformy Azure

W poniższym przykładzie użyto polecenia az apim api import do zaimportowania specyfikacji WSDL z określonego adresu URL do wystąpienia usługi API Management o nazwie apim-hello-world. Aby zaimportować przy użyciu ścieżki do specyfikacji zamiast adresu URL, użyj parametru --specification-path .

W tym przykładzie WSDL nazwa usługi to OrdersAPI, a jeden z dostępnych punktów końcowych (interfejsów) jest podstawowy.

# 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

Program PowerShell

W poniższym przykładzie użyto polecenia cmdlet Import-AzApiManagementApi programu Azure PowerShell do zaimportowania specyfikacji WSDL z określonego adresu URL do wystąpienia usługi API Management o nazwie apim-hello-world. Aby zaimportować przy użyciu ścieżki do specyfikacji zamiast adresu URL, użyj parametru -SpecificationPath .

W tym przykładzie WSDL nazwa usługi to OrdersAPI, a jeden z dostępnych punktów końcowych (interfejsów) jest podstawowy.

# 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

Testowanie nowego interfejsu API w portalu

Operacje można wywoływać bezpośrednio z portalu, co zapewnia wygodny sposób wyświetlania i testowania operacji interfejsu API przez administratorów.

1. Wybierz interfejs API utworzony w poprzednim kroku.

2. Wybierz kartę Test.

3. Wybierz operację. Na stronie zostaną wyświetlone pola parametrów zapytania i pola nagłówków.

   Uwaga

   W konsoli testowej usługa API Management automatycznie wypełnia nagłówek Ocp-Apim-Subscription-Key i konfiguruje klucz subskrypcji wbudowanej subskrypcji typu all-access. Ten klucz umożliwia dostęp do każdego interfejsu API w wystąpieniu usługi API Management. Opcjonalnie wyświetl nagłówek Ocp-Apim-Subscription-Key , wybierając ikonę "oko" obok żądania HTTP.

4. W zależności od operacji wprowadź wartości parametrów zapytania, wartości nagłówka lub treść żądania. Wybierz Wyślij.

   Po pomyślnym zakończeniu testu zaplecze odpowiada z pomyślnym kodem odpowiedzi HTTP i pewnymi danymi.

   Napiwek

   Domyślnie konsola testowa wysyła żądanie do serwera proxy CORS usługi API Management, który przekazuje żądanie do wystąpienia usługi API Management, które następnie przekazuje je do zaplecza. Ten serwer proxy używa publicznego adresu IP 13.91.254.72 i może uzyskiwać dostęp tylko do publicznych punktów końcowych. Jeśli chcesz wysłać żądanie bezpośrednio z przeglądarki do usługi API Management, wybierz pozycję Pomiń serwer proxy CORS. Użyj tej opcji, jeśli chcesz użyć konsoli testowej, a brama usługi API Management jest odizolowana od sieci lub nie zezwala na ruch z serwera proxy CORS.

Aby debugować interfejs API, zobacz Samouczek: debugowanie interfejsów API przy użyciu śledzenia żądań.

Akcja protokołu SOAP z symbolami wieloznacznymi

Jeśli musisz przekazać żądanie PROTOKOŁU SOAP, które nie ma dedykowanej akcji zdefiniowanej w interfejsie API, możesz skonfigurować akcję protokołu SOAP z symbolem wieloznacznymi. Akcja symboli wieloznacznych będzie zgodna z dowolnym żądaniem protokołu SOAP, które nie jest zdefiniowane w interfejsie API.

Aby zdefiniować akcję protokołu SOAP z symbolami wieloznacznymi:

1. W portalu wybierz interfejs API utworzony w poprzednim kroku.
2. Na karcie Projektowanie wybierz pozycję + Dodaj operację.
3. Wprowadź nazwę wyświetlaną operacji.
4. W adresie URL wybierz POST i wprowadź /soapAction={any} w zasobie. Parametr szablonu wewnątrz nawiasów klamrowych jest dowolny i nie ma wpływu na wykonanie.

Dołączanie innych interfejsów API

Możesz utworzyć interfejs API interfejsów API udostępnianych przez różne usługi, w tym:

• Specyfikacja interfejsu OpenAPI
• Interfejs API PROTOKOŁU SOAP
• Interfejs API graphQL
• Aplikacja internetowa hostowana w usłudze aplikacja systemu Azure
• Aplikacja funkcji platformy Azure
• Azure Logic Apps
• Azure Service Fabric

Dołącz inny interfejs API do istniejącego interfejsu API, wykonując następujące kroki.

Uwaga

Po zaimportowaniu innego interfejsu API operacje są dołączane do bieżącego interfejsu API.

1. Przejdź do wystąpienia Azure API Management w Azure Portal.

   

2. Wybierz pozycję Interfejsy API na stronie Przegląd lub z menu po lewej stronie.

   

3. Kliknij przycisk ... obok interfejsu API, który chcesz dołączyć do innego interfejsu API.

4. Z menu rozwijanego wybierz pozycję Importuj.

   

5. Wybierz usługę, z której chcesz zaimportować interfejs API.

   

Powiązane tematy

• Ograniczenia importu interfejsu API
• Importowanie specyfikacji interfejsu OpenAPI
• Importowanie interfejsu API SOAP
• Importowanie interfejsu API SOAP i konwertowanie go na interfejs API REST
• Importowanie interfejsu API usługi App Service
• Importowanie interfejsu API aplikacji kontenera
• Importowanie interfejsu API protokołu WebSocket
• Importowanie interfejsu GraphQL API
• Importowanie schematu GraphQL i konfigurowanie rozpoznawania pól
• Importowanie aplikacji funkcji platformy Azure
• Importowanie usługi Azure Logic App
• Importowanie usługi Service Fabric
• Importowanie interfejsu API OData
• Importowanie metadanych sap OData
• Importowanie interfejsu API gRPC
• Edytowanie interfejsu API

Następne kroki

Przekształcanie i ochrona opublikowanego interfejsu API