# Aktualisieren einer API-Definition in Azure API Management

Importieren Sie eine Datei in Azure API Management, um eine vorhandene Definition zu aktualisieren.

* Sie haben Zugriff auf Azure API Management.
* Sie haben Microsoft PowerShell installiert. Weitere Informationen finden Sie in der [Microsoft PowerShell-Dokumentation](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell?view=powershell-6).
* Sie haben das Azure PowerShell-Modul installiert. Weitere Informationen finden Sie in der [Microsoft Azure-Dokumentation](https://docs.microsoft.com/en-us/powershell/azure/install-az-ps?view=azps-2.4.0).
* Sie haben die API-Definition exportiert.
* Sie haben eine frühere Version der API-Definition in Azure API Management hochgeladen.
* Sie haben Ihre Kontextparameter als Variable festgelegt. Weitere Informationen finden Sie in dem obigen Verfahren.

1. Öffnen Sie eine Befehlszeile und geben Sie folgenden Befehl ein, um die Datei hochzuladen:
   ```
   Import-AzApiManagementApi -Context $ApiMgmtContext -SpecificationFormat "{format}" -SpecificationPath "{yourfile}" -ApiId "{api-id}" -Path "{api-url-suffix}"
   ```
2. Fügen Sie die korrekten Parameter hinzu:
   | Parameter | Beschreibung |
   | --- | --- |
   | {format} | Format der API-Definition zum Importieren. Folgende Werte sind möglich:<br><br><ul><li><span>Swagger</span> (empfohlen)</li><li><span>Wadl</span></li><li><span>Wsdl</span></li><li><span>OpenApi</span></li></ul> |
   | {yourfile} | Pfad und Dateiname der von Ihnen exportierten API-Definition. |
   | {api-id} | Azure API Management-ID der zu aktualisierenden API. |
   | {api-url-suffix} | Web-API-Pfad, der am Ende der öffentlichen API-URL hinzugefügt werden soll. |
3. Führen Sie den Befehl aus.

Ihre API-Definition wird importiert und die neue Datei ersetzt die vorherige Version. Sie können die Aktualisierung im Azure-Portal prüfen.

In diesem Beispiel wurde eine erste Version der API-Definition namens Contacts API hochgeladen, die fünf Vorgänge enthielt. Anschließend wurde sie durch eine neue Definition namens Contacts API V2 ersetzt, die zehn Vorgänge enthält.

![Screenshot der aktualisierten API-Definition.](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/az_update.png)

Weitere Informationen zum Befehl Import-AzApiManagementApi finden Sie in der [Azure-Dokumentation](https://docs.microsoft.com/en-us/powershell/module/az.apimanagement/Import-AzApiManagementApi?view=azps-2.4.0).