Esercitazione: Aggiungere una risorsa al modello di Azure Resource Manager

Nell'esercitazione precedente, si è appreso come creare e distribuire un modello di Azure Resource Manager (ARM template) vuoto. Ora sei pronto per implementare una risorsa effettiva in quel modello. In questo caso, un account di archiviazione di Azure. Il completamento di questa istruzione richiede 9 minuti .

Prerequisiti

È consigliabile completare l'esercitazione introduttiva sui modelli, ma non è obbligatorio.

È necessario avere Visual Studio Code e Azure PowerShell o l'interfaccia della riga di comando di Azure. Per altre informazioni, vedere Strumenti modello.

Aggiungere una risorsa

Per aggiungere una definizione di account di archiviazione di Azure al modello esistente, esaminare il file JSON nell'esempio seguente. Invece di provare a copiare sezioni del modello, copiare l'intero file e sostituire il modello con il relativo contenuto.

Sostituire {provide-unique-name} e le parentesi graffe {} con un nome di account di archiviazione univoco.

Importante

Il nome dell'account di archiviazione deve essere univoco in Azure. Si tratta solo di lettere minuscole o numeri e ha un limite di 24 caratteri. È possibile usare un nome come store1 come prefisso e quindi aggiungere le iniziali e la data odierna. Il nome, ad esempio, può essere store1abc06132022.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "{provide-unique-name}",
      "location": "eastus",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Indovinare un nome univoco per un account di archiviazione non è facile e non funziona bene per automatizzare le distribuzioni di grandi dimensioni. Più avanti in questa serie di esercitazioni si usano le funzionalità del modello che semplificano la creazione di un nome univoco.

Proprietà delle risorse

Ci si potrebbe chiedere come trovare le proprietà da usare per ogni tipo di risorsa. È possibile usare il riferimento al modello di Resource Manager per trovare i tipi di risorse da distribuire.

Ogni risorsa distribuita ha almeno le tre proprietà seguenti:

• type: tipo della risorsa. Questo valore è una combinazione dello spazio dei nomi del fornitore di risorse e del tipo di risorsa, come ad esempio Microsoft.Storage/storageAccounts.
• apiVersion: versione dell'API REST da usare per la creazione della risorsa. Ogni provider di risorse pubblica le proprie versioni API, quindi questo valore è specifico del tipo.
• name: nome della risorsa.

La maggior parte delle risorse ha anche una location proprietà che imposta l'area in cui si distribuisce la risorsa.

Le altre proprietà variano in base al tipo di risorsa e alla versione dell'API. È importante comprendere la connessione tra la versione dell'API e le proprietà disponibili, quindi si esaminerà più dettagliatamente.

In questa esercitazione si aggiunge un account di archiviazione al modello. È possibile visualizzare la versione dell'API dell'account di archiviazione in storageAccounts 2021-09-01. Si noti che non si aggiungono tutte le proprietà al modello. Molte delle proprietà sono facoltative. Il Microsoft.Storage provider di risorse potrebbe rilasciare una nuova versione dell'API, ma la versione che si sta distribuendo non deve cambiare. È possibile continuare a usare tale versione e sapere che i risultati della distribuzione sono coerenti.

Se si visualizza una versione precedente dell'API , è possibile che sia disponibile un set più piccolo di proprietà.

Se si decide di modificare la versione dell'API per una risorsa, assicurarsi di valutare le proprietà per tale versione e modificare il modello in modo appropriato.

Distribuire un modello

È possibile distribuire il modello per creare l'account di archiviazione. Assegnare alla distribuzione un nome diverso in modo da poterla trovare facilmente nella cronologia.

Se il gruppo di risorse non è stato creato, vedere Creare un gruppo di risorse. L'esempio presuppone che la templateFile variabile sia stata impostata sul percorso del file modello, come illustrato nella prima esercitazione.

Azure PowerShell

New-AzResourceGroupDeployment `
  -Name addstorage `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

CLI di Azure

Per eseguire questo comando di distribuzione, è necessario avere la versione più recente dell'interfaccia della riga di comando di Azure.

az deployment group create \
  --name addstorage \
  --resource-group myResourceGroup \
  --template-file $templateFile

Annotazioni

Se la distribuzione non riesce, usa l'opzione verbose per ottenere informazioni sulle risorse che stai creando. Usare l'opzione debug per ottenere altre informazioni per il debug.

Questi errori sono due possibili errori di distribuzione che potrebbero verificarsi:

• Error: Code=AccountNameInvalid; Message={provide-unique-name} non è un nome di account di archiviazione valido. Il nome dell'account di archiviazione deve avere una lunghezza compresa tra 3 e 24 caratteri e usare solo numeri e lettere minuscole.

  Nel modello sostituire {provide-unique-name} con un nome univoco dell'account di archiviazione. Vedere Aggiungere una risorsa.

• Error: Code=StorageAccountAlreadyTaken; Message=The storage account named store1abc09092019 è già in uso.

  Nel modello, prova un nome diverso per l'account di archiviazione.

Questa distribuzione richiede più tempo rispetto alla distribuzione di modelli vuoti perché si sta creando un account di archiviazione. L'operazione può richiedere circa un minuto.

Verificare la distribuzione

È possibile verificare la distribuzione esplorando il gruppo di risorse dal portale di Azure.

1. Accedi al portale di Azure.
2. Nel menu a sinistra selezionare Gruppi di risorse.
3. Selezionare la casella a sinistra di myResourceGroup e selezionare myResourceGroup
4. Selezionare il gruppo di risorse in cui è stato distribuito.
5. Si noterà che è stato distribuito un account di archiviazione.
6. Si noti che l'etichetta di distribuzione ora indica: Distribuzioni: 2 Riuscito.

Pulire le risorse

Se si passa all'esercitazione successiva, non è necessario eliminare il gruppo di risorse.

Se stai interrompendo ora, potresti voler ripulire le risorse distribuite eliminando il gruppo di risorse.

1. Nel portale di Azure selezionare Gruppo di risorse dal menu a sinistra.
2. Digitare il nome del gruppo di risorse nella casella Filtro per qualsiasi campo ... .
3. Selezionare la casella accanto a myResourceGroup e selezionare myResourceGroup o il nome del gruppo di risorse scelto.
4. Selezionare Elimina gruppo di risorse dal menu in alto.

Passaggi successivi

È stato creato un modello semplice per distribuire un account di archiviazione di Azure. Nelle esercitazioni successive si apprenderà come aggiungere parametri, variabili, risorse e output a un modello. Queste funzionalità sono i blocchi predefiniti per modelli molto più complessi.

Aggiungere parametri