Usare portale di Azure per esportare un modello
Per facilitare la creazione di modelli di Azure Resource Manager, è possibile esportare un modello da risorse esistenti. Il modello esportato consente di comprendere la sintassi e le proprietà JSON che distribuiscono le risorse. Per automatizzare le distribuzioni future, iniziare con il modello esportato e modificarlo per lo scenario in uso. Il processo di esportazione modello tenta di creare un modello utilizzabile. Tuttavia, la maggior parte dei modelli esportati richiede alcune modifiche prima che possano essere usate per distribuire le risorse di Azure.
Resource Manager consente di selezionare una o più risorse per l'esportazione in un modello. È possibile concentrarsi esattamente sulle risorse necessarie nel modello.
Questo articolo illustra come esportare modelli tramite il portale. Per altre opzioni, vedere:
- Esportare un modello con l'interfaccia della riga di comando di Azure
- Esportare un modello con Azure PowerShell
- Esportazione dell'API REST dal gruppo di risorse e esportazione dell'API REST dalla cronologia di distribuzione.
Scegliere l'opzione di esportazione corretta
Per esportare un modello sono disponibili due modi:
Esportare da un gruppo di risorse o da una risorsa. Questa opzione genera un nuovo modello da risorse esistenti. Il modello esportato è uno "snapshot" dello stato corrente del gruppo di risorse. È possibile esportare un intero gruppo di risorse o risorse specifiche all'interno di tale gruppo di risorse.
Salva dalla cronologia. Questa opzione recupera una copia esatta di un modello usato per la distribuzione. Specificare la distribuzione dalla cronologia di distribuzione.
A seconda dell'opzione scelta, i modelli esportati hanno qualità diverse.
| Dal gruppo di risorse o dalla risorsa | Dalla cronologia |
|---|---|
| Il modello viene generato automaticamente. È probabile che si voglia migliorare il codice prima di distribuirlo. | Il modello è una copia esatta di quella creata dall'autore del modello. È pronto per essere ridistribuito senza modifiche. |
| Il modello è uno snapshot dello stato corrente delle risorse. Include tutte le modifiche manuali apportate dopo la distribuzione. | Il modello mostra solo lo stato delle risorse al momento della distribuzione. Tutte le modifiche manuali apportate dopo la distribuzione non sono incluse. |
| È possibile selezionare le risorse da un gruppo di risorse da esportare. | Sono incluse tutte le risorse per una distribuzione specifica. Non è possibile selezionare un subset di tali risorse o aggiungere risorse aggiunte in un momento diverso. |
| Il modello include tutte le proprietà per le risorse, incluse alcune proprietà che normalmente non vengono impostate durante la distribuzione. È possibile rimuovere o pulire queste proprietà prima di riutilizzare il modello. | Il modello include solo le proprietà necessarie per la distribuzione. Il modello è più sparse e più facile da leggere. |
| Il modello probabilmente non include tutti i parametri necessari per il riutilizzo. La maggior parte dei valori delle proprietà è hardcoded nel modello. Per ridistribuire il modello in altri ambienti, è necessario aggiungere parametri che aumentano la possibilità di configurare le risorse. È possibile deselezionare Includi parametri in modo da poter creare parametri personalizzati. | Il modello include parametri che semplificano la ridistribuire in ambienti diversi. |
Esportare il modello da un gruppo di risorse o da una risorsa, quando:
- È necessario acquisire le modifiche alle risorse apportate dopo la distribuzione originale.
- Si desidera selezionare le risorse esportate.
- Le risorse non sono state create con un modello.
Esportare il modello dalla cronologia, quando:
- Si vuole un modello facile da riutilizzare.
- Non è necessario includere le modifiche apportate dopo la distribuzione originale.
Limiti
L'esportazione non garantisce l'esito positivo. L'esportazione non è un modo affidabile per trasformare le risorse preesistenti in modelli utilizzabili nell'ambiente di produzione. È preferibile creare risorse da zero usando un file Bicep scritto a mano, un modello arm o terraform.
Quando si esporta da un gruppo di risorse o da una risorsa, il modello esportato viene generato dagli schemi pubblicati per ogni tipo di risorsa. In alcuni casi, lo schema non ha la versione più recente per un tipo di risorsa. Controllare il modello esportato per assicurarsi che includa le proprietà necessarie. Se necessario, modificare il modello esportato per usare la versione dell'API necessaria.
Alcuni parametri password potrebbero non essere presenti nei modelli esportati. È necessario controllare il riferimento al modello e aggiungere manualmente questi parametri prima di poter usare i modelli per distribuire le risorse.
La funzionalità modello di esportazione non supporta l'esportazione delle risorse di Azure Data Factory. Per informazioni su come esportare le risorse di Data Factory, vedere Copiare o clonare una data factory in Azure Data Factory.
Per esportare le risorse create tramite il modello di distribuzione classica, è necessario eseguirne la migrazione al modello di distribuzione Resource Manager.
Se viene visualizzato un avviso durante l'esportazione di un modello che indica che un tipo di risorsa non è stato esportato, è comunque possibile individuare le proprietà per tale risorsa. Per le proprietà delle risorse, vedere informazioni di riferimento sul modello. È anche possibile esaminare l'API REST di Azure per il tipo di risorsa.
Esiste un limite di 200 risorse nel gruppo di risorse per cui si crea il modello esportato. Se si tenta di esportare un gruppo di risorse con più di 200 risorse, viene visualizzato il messaggio Export template is not supported for resource groups more than 200 resources di errore.
Esportare il modello da un gruppo di risorse
Per esportare una o più risorse da un gruppo di risorse:
Selezionare il gruppo di risorse che contiene le risorse da esportare.
Selezionare una o più risorse selezionando le caselle di controllo. Per selezionare tutto, selezionare la casella di controllo a sinistra di Nome. La voce di menu Esporta modello diventa abilitata solo dopo aver selezionato almeno una risorsa.
Nello screenshot è selezionato solo l'account di archiviazione.
Selezionare Esporta modello.
Il modello esportato viene visualizzato ed è disponibile per il download e la distribuzione.
I parametri di inclusione sono selezionati per impostazione predefinita. Se questa opzione è selezionata, tutti i parametri del modello vengono inclusi quando viene generato il modello. Per creare parametri personalizzati, attivare o disattivare questa casella di controllo per non includerli.
Esportare il modello da una risorsa
Per esportare una risorsa:
Selezionare il gruppo di risorse contenente la risorsa da esportare.
Selezionare la risorsa da esportare per aprire la risorsa.
Per tale risorsa, selezionare Esporta modello nel riquadro sinistro.
Il modello esportato viene visualizzato ed è disponibile per il download e la distribuzione. Il modello contiene solo la singola risorsa. I parametri di inclusione sono selezionati per impostazione predefinita. Se questa opzione è selezionata, tutti i parametri del modello vengono inclusi quando viene generato il modello. Per creare parametri personalizzati, attivare o disattivare questa casella di controllo per non includerli.
Scaricare il modello prima della distribuzione
Il portale ha la possibilità di scaricare un modello prima di distribuirlo. Questa opzione non è disponibile tramite PowerShell o l'interfaccia della riga di comando di Azure.
Selezionare il servizio di Azure da distribuire.
Immettere i valori per il nuovo servizio.
Dopo aver superato la convalida, ma prima di avviare la distribuzione, selezionare Scarica un modello per l'automazione.
Il modello viene visualizzato ed è disponibile per il download e la distribuzione.
Esportare il modello dopo la distribuzione
È possibile esportare il modello usato per distribuire le risorse esistenti. Il modello che si ottiene è esattamente quello usato per la distribuzione.
Selezionare il gruppo di risorse da esportare.
Selezionare il collegamento in Distribuzioni.
Selezionare una delle distribuzioni dalla cronologia delle distribuzioni.
Selezionare Modello. Viene visualizzato il modello usato per questa distribuzione ed è disponibile per il download.
Passaggi successivi
- Informazioni su come esportare modelli con l'interfaccia della riga di comando di Azure, Azure PowerShell o l'API REST.
- Per informazioni sulla sintassi del modello di Resource Manager, vedere Comprendere la struttura e la sintassi dei modelli di Azure Resource Manager.
- Per informazioni su come sviluppare modelli, vedere le esercitazioni dettagliate.