# 將 API 定義匯入至 Azure API Management

將您的 API 定義匯入至 Azure API Management。

* 您具有 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 結尾的 Web API 路徑。 |

您的 API 已匯入，且命令列會傳回有關您 API 的資訊 (例如其 ID)，可用於對其進行更新。您可以在 Azure 入口網站上檢查您的 API 定義。

![Azure 入口網站中的 API 定義。](https://help.qlik.com/zh-TW/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)。