# Azure API Management로 API 정의 가져오기

Azure API Management로 API 정의를 가져옵니다.

* Azure API Management에 대한 액세스 권한이 있습니다.
* Microsoft PowerShell을 설치했습니다. 자세한 내용은 [Microsoft PowerShell 설명서](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell?view=powershell-6)를 참조하십시오.
* Azure PowerShell 모듈을 설치했습니다. 자세한 내용은 [Microsoft Azure 설명서](https://docs.microsoft.com/en-us/powershell/azure/install-az-ps?view=azps-2.4.0)를 참조하십시오.
* API 정의를 내보냈습니다.

1. 명령줄을 엽니다.
2. 각 명령에서 컨텍스트를 설정하지 않으려면 다음 명령을 실행하여 변수로 추가할 수 있습니다.
   ```
   $ApiMgmtContext = New-AzApiManagementContext -ResourceGroupName "{ResourceGroupName}" -ServiceName "{ServiceName}"
   ```
   | 매개 변수 | 설명 |
   | --- | --- |
   | {ResourceGroupName} | 서비스와 연결된 리소스 그룹입니다. Microsoft Azure 포털에서 찾을 수 있습니다. |
   | {ServiceName} | 서비스의 이름입니다. Microsoft Azure 포털에서 찾을 수 있습니다. |
3. 다음 명령을 입력하여 파일을 업로드합니다.
   ```
   Import-AzApiManagementApi -Context $ApiMgmtContext -SpecificationFormat "{format}" -SpecificationPath "{yourfile}" -Path "{api-url-suffix}" 
   ```
4. 올바른 매개 변수를 추가합니다.
   | 매개 변수 | 설명 |
   | --- | --- |
   | {format} | 가져올 API 정의의 형식입니다. 값은 다음과 같을 수 있습니다.<br><br><ul><li><span>Swagger</span> (권장)</li><li><span>Wadl</span></li><li><span>Wsdl</span></li><li><span>OpenApi</span></li></ul> |
   | {yourfile} | 내보낸 API 정의의 경로 및 파일 이름입니다. |
   | {api-url-suffix} | API 공개 URL의 끝에 추가할 웹 API 경로입니다. |

API를 가져오면 명령줄에서 API를 업데이트하는 데 사용할 수 있는 ID와 같은 API에 대한 정보를 반환합니다. Azure 포털에서 API 정의를 확인할 수 있습니다.

![Azure 포털의 API 정의입니다.](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/az_import.png)

Import-AzApiManagementApi 명령에 대한 자세한 내용은 [Azure 설명서](https://docs.microsoft.com/en-us/powershell/module/az.apimanagement/Import-AzApiManagementApi?view=azps-2.4.0)를 참조하십시오.