# Importieren einer API-Definition in Azure API Management

Importieren Sie Ihre API-Definition in Azure API Management.

## Vorbereitungen

* Sie haben Zugriff auf Azure API Manangement.
* Sie haben Microsoft PowerShell installiert. Weitere Informationen finden Sie in der [Microsoft PowerShell-Dokumentation](https://learn.microsoft.com/de-de/powershell/scripting/install/installing-powershell?view=powershell-7.4&viewFallbackFrom=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 Ihre API-Definition exportiert.

## Prozedur

1. Öffnen Sie die Befehlszeile.
2. Um den Kontext nicht für jeden Befehl einrichten zu müssen, können Sie ihn als Variable hinzufügen, indem Sie folgenden Befehl ausführen:
   ```
   $ApiMgmtContext = New-AzApiManagementContext -ResourceGroupName "{ResourceGroupName}" -ServiceName "{ServiceName}"
   ```
   | Parameter | Beschreibung |
   | --- | --- |
   | {ResourceGroupName} | Gruppe von Ressourcen, die mit dem Dienst verknüpft sind. Kann im Microsoft Azure-Portal eingesehen werden. |
   | {ServiceName} | Name des Dienstes. Kann im Microsoft Azure-Portal eingesehen werden. |
3. Geben Sie folgenden Befehl ein, um die Datei hochzuladen:
   ```
   Import-AzApiManagementApi -Context $ApiMgmtContext -SpecificationFormat "{format}" -SpecificationPath "{yourfile}" -Path "{api-url-suffix}" 
   ```
4. Fügen Sie die richtigen Parameter hinzu:
   | Parameter | Beschreibung |
   | --- | --- |
   | {format} | Format der zu importierenden API-Definition. Mögliche Werte:<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 exportierten API-Definition. |
   | {api-url-suffix} | Web API-Pfad, der an das Ende der öffentlichen URL Ihrer API hinzugefügt wird. |

## Ergebnisse

Ihre API wird importiert und die Befehlszeile gibt Informationen zur API zurück, z. B. deren ID, die zum Aktualisieren verwendet werden kann. Sie können die API-Definition im Azure-Portal überprüfen.

![Die API-Definition im Azure-Portal.](https://help.qlik.com/talend/de-DE/api-designer-user-guide/Resources/images/az_import.png)

Weitere Informationen zum Befehl Import-AzApiManagementApi finden Sie in der [Azure-Dokumentation](https://learn.microsoft.com/de-de/powershell/module/az.apimanagement/import-azapimanagementapi?view=azps-13.0.0&viewFallbackFrom=azps-2.4.0).