# 在 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 定義。
* 您已將舊版 API 定義上傳至 Azure API Management。
* 您已將內容參數設定為變數。如需詳細資訊，請參閱上述程序。

1. 開啟命令列並輸入下列命令以上傳檔案：
   ```
   Import-AzApiManagementApi -Context $ApiMgmtContext -SpecificationFormat "{format}" -SpecificationPath "{yourfile}" -ApiId "{api-id}" -Path "{api-url-suffix}"
   ```
2. 新增正確的參數：
   | 參數 | 說明 |
   | --- | --- |
   | {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-id} | 要更新之 API 的 Azure API Management 識別碼。 |
   | {api-url-suffix} | 要新增至 API 公用 URL 結尾的 Web API 路徑。 |
3. 執行命令。

您的 API 定義已匯入，且新檔案會取代舊版。您可以在 Azure 入口網站上檢查您的更新。

在此範例中，上傳了名為 Contacts API 的第一個 API 定義版本，其中包含五個作業。接著，它被名為 Contacts API V2 且包含十個作業的新定義所取代。

![更新後 API 定義的螢幕擷取畫面。](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/az_update.png)

如需有關 Import-AzApiManagementApi 命令的詳細資訊，請參閱 [Azure 文件](https://docs.microsoft.com/en-us/powershell/module/az.apimanagement/Import-AzApiManagementApi?view=azps-2.4.0)。