# Een API-definitie importeren naar Azure API Management

Importeer uw API-definitie naar Azure API Management.

* U hebt toegang tot Azure API Management.
* U hebt Microsoft PowerShell geïnstalleerd. Zie de [Microsoft PowerShell-documentatie](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell?view=powershell-6) voor meer informatie.
* U hebt de Azure PowerShell-module geïnstalleerd. Zie de [Microsoft Azure-documentatie](https://docs.microsoft.com/en-us/powershell/azure/install-az-ps?view=azps-2.4.0) voor meer informatie.
* U hebt uw API-definitie geëxporteerd.

1. Open uw opdrachtregel.
2. Om te voorkomen dat u de context in elke opdracht moet instellen, kunt u deze als een variabele toevoegen door de volgende opdracht uit te voeren:
   ```
   $ApiMgmtContext = New-AzApiManagementContext -ResourceGroupName "{ResourceGroupName}" -ServiceName "{ServiceName}"
   ```
   | Parameter | Beschrijving |
   | --- | --- |
   | {ResourceGroupName} | Groep van resources die aan de service zijn gekoppeld.<br>Deze is te vinden in de Microsoft Azure-portal. |
   | {ServiceName} | Naam van de service. Deze is te vinden in de<br>Microsoft Azure-portal. |
3. Voer de volgende opdracht in om het bestand te uploaden:
   ```
   Import-AzApiManagementApi -Context $ApiMgmtContext -SpecificationFormat "{format}" -SpecificationPath "{yourfile}" -Path "{api-url-suffix}" 
   ```
4. Voeg de juiste parameters toe:
   | Parameter | Beschrijving |
   | --- | --- |
   | {format} | Indeling van de API-definitie die moet worden geïmporteerd. De waarde kan zijn:<br><br><ul><li><span>Swagger</span> (aanbevolen)</li><li><span>Wadl</span></li><li><span>Wsdl</span></li><li><span>OpenApi</span></li></ul> |
   | {yourfile} | Pad en bestandsnaam van de API-definitie die u<br>hebt geëxporteerd. |
   | {api-url-suffix} | Web-API-pad<br>om toe te voegen aan het einde van uw openbare API-URL. |

Uw API is geïmporteerd en de opdrachtregel retourneert informatie over uw API, zoals de ID, die kan worden gebruikt om deze bij te werken. U kunt uw API-definitie controleren in de Azure-portal.

![De API-definitie in de Azure-portal.](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/az_import.png)

Zie de [Azure-documentatie](https://docs.microsoft.com/en-us/powershell/module/az.apimanagement/Import-AzApiManagementApi?view=azps-2.4.0) voor meer informatie over de opdracht Import-AzApiManagementApi.