SOAP API를 API Management로 가져오기

1. Azure Portal에서 API Management 인스턴스로 이동합니다.

2. 왼쪽 메뉴에서 API>+ API 추가를 선택합니다.

3. 정의에서 만들기에서 WSDL을 선택합니다.

   

4. WSDL 사양에서 SOAP API의 URL을 입력하거나 파일 선택을 클릭하여 로컬 WSDL 파일을 선택합니다.

5. 가져오기 방법에서는 SOAP 통과가 기본적으로 선택됩니다. 이 항목을 선택하면 API가 SOAP로 노출되고 API 소비자는 SOAP 규칙을 사용해야 합니다. API를 "restify"하려는 경우 SOAP API 가져오기 및 REST로 변환의 단계를 따릅니다.

   

6. 다음 API 설정은 SOAP API의 정보에 따라 자동으로 채워집니다. 표시 이름, 이름, 설명 작업은 표시 이름, URL 및 설명으로 자동으로 채워지고 시스템에서 생성된 이름을 받습니다.

7. 다른 API 설정을 입력합니다. 생성 중에 값을 설정하거나 나중에 설정 탭으로 이동하여 값을 설정할 수 있습니다.

   API 설정에 관한 자세한 내용은 첫 번째 API 가져오기 및 게시 자습서를 참조하세요.

8. 만들기를 실행합니다.

다음 예제에서는 az apim api import 명령을 사용하여 지정된 URL에서 apim-hello-world라는 API Management 인스턴스로 WSDL 사양을 가져옵니다. 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

다음 예제에서는 Import-AzApiManagementApi Azure PowerShell cmdlet을 사용하여 지정된 URL에서 apim-hello-world라는 API Management 인스턴스로 WSDL 사양을 가져옵니다. 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