將 SOAP API 匯入 APIM

適用於：所有 APIM 層

本文會示範如何匯入 SOAP API 的 WSDL 規格標準 XML 表示法。 本文也說明如何在 APIM 中測試 API。

在本文中，您將學會如何：

• 匯入 SOAP API
• 在 Azure 入口網站中測試 API

附註

WSDL 匯入至 API 管理會受限於某些限制。 不支援具有 wsdl:import、xsd:import 和 xsd:include 指示詞的 WSDL 檔案。 如需解析和合併 WSDL 檔案中這些相依性的開放原始碼工具，請參閱此 GitHub 存放庫 (英文)。

先決條件

• API 管理執行個體。 如果您還沒有執行個體，請完成下列快速入門：建立 Azure API 管理執行個體。

• Azure CLI

  • 在 Azure Cloud Shell 中使用 Bash 環境。 如需詳細資訊，請參閱開始使用 Azure Cloud Shell。

    

  • 若要在本機執行 CLI 參考命令，請安裝 (部分機器翻譯) Azure CLI。 若您在 Windows 或 macOS 上執行，請考慮在 Docker 容器中執行 Azure CLI。 如需詳細資訊，請參閱如何在 Docker 容器中執行 Azure CLI。

    • 如果您使用的是本機安裝，請使用 az login 命令，透過 Azure CLI 來登入。 請遵循您終端機上顯示的步驟，以完成驗證流程。 如需其他登入選項，請參閱 使用 Azure CLI 向 Azure 進行驗證。

    • 出現提示時，請在第一次使用時安裝 Azure CLI 延伸模組。 如需擴充功能的詳細資訊，請參閱 使用和管理 Azure CLI 的擴充功能。

    • 執行 az version (部分機器翻譯) 以尋找已安裝的版本和相依程式庫。 若要升級至最新版本，請執行 az upgrade。

• Azure PowerShell

  • 如果您選擇在本機使用 Azure PowerShell：
    • 安裝最新版的 Az PowerShell 模組。
    • 使用 Connect-AzAccount Cmdlet 連線至 Azure 帳戶。
  • 如果您選擇使用 Azure Cloud Shell：
    • 請參閱 Azure Cloud Shell 概觀 以取得詳細資訊。

匯入後端 API

入口網站

1. 在 Azure 入口網站中，瀏覽至您的 API 管理執行個體。

2. 在左側功能表中，選取 [API] > [+ 新增 API]。

3. 在 [從定義建立] 下，選取 [WSDL]。

   

4. 在 [WSDL 規格] 中，輸入 SOAP API 的 URL，或按一下 [選取檔案] 以選取本機 WSDL 檔案。

5. [匯入方法] 預設會選取 [SOAP 傳遞]。 使用此選項時，API 會公開為 SOAP，而 API 取用者必須利用 SOAP 規則。 如果您想要「Restify」API，請遵循匯入 SOAP API 並將其轉換成 REST 中的步驟。

   

6. 系統會根據 SOAP API 的資訊自動填入下列 API 設定：[顯示名稱]、[名稱] 和[描述]。 作業會自動填入[顯示名稱]、[URL] 和 [描述]，並接收系統產生的 [名稱]。

7. 輸入其他 API 設定。 您可以在建立期間設定這些值，或稍後前往 [設定] 索引標籤來進行設定。

   如需 API 設定的詳細資訊，請參閱匯入和發佈您的第一個 API 教學課程。

8. 選取 [建立]。

Azure CLI

下列範例會使用 az apim api import 命令，將 WSDL 規格從指定的 URL 匯入名為 apim-hello-world 的 APIM 執行個體。 若要使用規格的路徑而非 URL 匯入，請使用 --specification-path 參數。

在此範例 WSDL 中，服務名稱為 OrdersAPI，而其中一個可用的端點 (介面) 是基本。

# 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

下列範例會使用 Import-AzApiManagementApi Azure PowerShell Cmdlet，將 WSDL 規格從指定的 URL 匯入名為 apim-hello-world 的 APIM 執行個體。 若要使用規格的路徑而非 URL 匯入，請使用 -SpecificationPath 參數。

在此範例 WSDL 中，服務名稱為 OrdersAPI，而其中一個可用的端點 (介面) 是基本。

# 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

在入口網站中測試新的 API

您可以從入口網站直接呼叫作業，以方便管理員檢視和測試 API 的作業。

1. 選取您在上一個步驟中建立的 API。

2. 選取 [測試] 索引標籤。

3. 選取作業。 頁面會顯示查詢參數的欄位和標頭的欄位。

   附註

   在測試主控台中，API 管理會自動填入 Ocp-Apim-Subscription-Key 標頭，並設定內建所有存取訂用帳戶的訂用帳戶金鑰。 此金鑰可讓您存取 API 管理執行個體中的每個 API。 (選擇性) 選取 [HTTP 要求] 旁的「眼睛」圖示以顯示 Ocp-Apim-Subscription-Key 標頭。

4. 視作業而定，輸入查詢參數值、標頭值或要求本文。 選取 [傳送]。

   測試成功時，後端會以成功的 HTTP 回應碼和某些資料進行回應。

   秘訣

   根據預設，測試主控台會將要求傳送至 APIM 的 CORS Proxy，此 Proxy 將要求轉送至 APIM 執行個體，然後 APIM 執行個體又將其轉送至後端。 此 Proxy 使用公用 IP 位址 13.91.254.72，而且只能連線到公用端點。 如果您想要直接從瀏覽器將要求傳送至 APIM 服務，請選取 [略過 CORS Proxy]。 若要使用測試主控台，且 APIM 閘道與網路隔離或不允許來自 CORS Proxy 的流量時，請使用此選項。

若要偵錯 API，請參閱教學課程：使用要求追蹤對 API 進行偵錯。

萬用字元 SOAP 動作

如果您需要傳遞 SOAP 要求，而此要求在 API 中未定義專用動作，您可以設定萬用字元 SOAP 動作。 萬用字元動作會對應 API 中未定義的任何 SOAP 要求。

若要定義萬用字元 SOAP 動作：

1. 在入口網站選取您在上一個步驟中建立的 API。
2. 在 [設計] 索引標籤中，選取 [+ 新增作業]。
3. 輸入作業的 [顯示名稱]。
4. 在URL 中選取 POST，並在資源中輸入 /?soapAction={any}。 大括弧內的樣板參數是任意的，不會影響執行。

附註

請勿使用 [設計] 索引標籤中的 OpenAPI 規格編輯器修改 SOAP API。

附加其他 API

您可以將由不同服務所公開的 API 組合成一個 API，包括：

• OpenAPI 規格
• SOAP API
• GraphQL API
• 裝載在 Azure App Service 中的 Web 應用程式
• Azure Functions
• Azure Logic Apps
• Azure Service Fabric

附註

當您匯入 API 時，作業會附加至您目前的 API。

若要將 API 附加至現有的 API：

1. 在 Azure 入口網站中移至您的 Azure API 管理實例：

   

2. 在 [概觀] 頁面上選取 [API]，或選取左側功能表中的 [API]>[API]。

   

3. 在要附加至另一個 API 的 API 旁選取省略符號 (...)。

4. 從下拉選單中選擇匯入：

   

5. 選取要從中匯入 API 的服務。

相關內容

• API 匯入限制
• 匯入 OpenAPI 規格
• 匯入 SOAP API
• 匯入 SOAP API 並將它轉換成 REST
• 匯入 App Service API
• 匯入容器應用程式 API
• 匯入 WebSocket API
• 匯入 GraphQL API
• 匯入 GraphQL 結構描述並設定欄位解析器
• 匯入函式應用程式 API
• 匯入邏輯應用程式 API
• 匯入 Service Fabric 服務
• 匯入 Azure AI Foundry API
• 匯入 Azure OpenAI API
• 匯入 LLM API
• 匯入 OData API
• 將 REST API 匯出為 MCP 伺服器
• 公開現有的 MCP 伺服器
• Import an A2A agent API
• 匯入 SAP OData 中繼資料
• 匯入 gRPC API
• 編輯 API