# Aggiornamento di una definizione di API in Azure API Management

Importare un file in Azure API Management per aggiornare una definizione esistente.

* Si ha accesso ad Azure API Management.
* È stato installato Microsoft PowerShell. Per ulteriori informazioni, consultare la [documentazione di Microsoft PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell?view=powershell-6).
* È stato installato il modulo Azure PowerShell. Per ulteriori informazioni, consultare la [documentazione di Microsoft Azure](https://docs.microsoft.com/en-us/powershell/azure/install-az-ps?view=azps-2.4.0).
* È stata esportata la definizione dell'API.
* È stata caricata una versione precedente della definizione dell'API in Azure API Management.
* I parametri di contesto sono stati impostati come variabile. Per ulteriori informazioni, consultare la procedura precedente.

1. Aprire una riga di comando e inserire il seguente comando per caricare il file:
   ```
   Import-AzApiManagementApi -Context $ApiMgmtContext -SpecificationFormat "{format}" -SpecificationPath "{yourfile}" -ApiId "{api-id}" -Path "{api-url-suffix}"
   ```
2. Aggiungere i parametri corretti:
   | Parametro | Descrizione |
   | --- | --- |
   | {format} | Formato della definizione dell'API da importare. Il valore può essere:<br><br><ul><li><span>Swagger</span> (consigliato)</li><li><span>Wadl</span></li><li><span>Wsdl</span></li><li><span>OpenApi</span></li></ul> |
   | {yourfile} | Percorso e nome del file della definizione dell'API esportata. |
   | {api-id} | ID di Azure API Management dell'API da aggiornare. |
   | {api-url-suffix} | Percorso dell'API Web da aggiungere alla fine dell'URL pubblico dell'API. |
3. Eseguire il comando.

La definizione dell'API viene importata e il nuovo file sostituisce la versione precedente. È possibile verificare l'aggiornamento sul portale di Azure.

In questo esempio, è stata caricata una prima versione della definizione dell'API denominata Contacts API, che conteneva cinque operazioni. Successivamente, è stata sostituita con una nuova definizione denominata Contacts API V2 contenente dieci operazioni.

![Screenshot della definizione dell'API aggiornata.](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/az_update.png)

Per ulteriori informazioni sul comando Import-AzApiManagementApi, consultare la [documentazione di Azure](https://docs.microsoft.com/en-us/powershell/module/az.apimanagement/Import-AzApiManagementApi?view=azps-2.4.0).