Informazioni sulle risorse di Azure

Completato

Tutte le risorse di Azure vengono distribuite con un tipo specifico. Il tipo identifica il tipo di risorsa. L'ID risorsa è il modo in cui Azure identifica un'istanza specifica di una risorsa. È importante conoscere la struttura dei tipi di risorse e degli ID risorsa poiché forniscono informazioni importanti per la scrittura di modelli Bicep.

Provider di risorse

Azure Resource Manager è progettato per consentire la gestione di numerosi provider di risorse tramite le API e i modelli di Resource Manager. Un provider di risorse è un raggruppamento logico di tipi di risorse, che in genere sono correlati a uno o ad alcuni servizi di Azure. Di seguito sono riportati alcuni esempi di provider di risorse:

  • Microsoft.Compute, usato per le macchine virtuali.
  • Microsoft.Network, usato per le risorse di rete, ad esempio reti virtuali, gruppi di sicurezza di rete e tabelle di route.
  • Microsoft.Cache, usato per la cache di Azure per Redis.
  • Microsoft.Sql, usato per Azure SQL.
  • Microsoft.Web, usato per Servizio app di Azure e Funzioni di Azure.
  • Microsoft.DocumentDB, usato per Azure Cosmos DB.

Nota

I nomi dei provider di risorse e i nomi dei tipi di risorsa a volte non corrispondono ai nomi dei servizi di Azure corrispondenti o potrebbero essere nomi di prodotti o risorse precedenti. Ad esempio, il provider di risorse per le aree di lavoro Log Analytics è Microsoft.OperationalInsights.

La documentazione per la sintassi del modello di Resource Manager di ogni tipo di risorsa è suddivisa in base al provider di risorse.

Per poter utilizzare i tipi di risorse esposti dai provider di risorse, è necessario prima registrare i provider di risorse per la sottoscrizione. La registrazione viene in genere eseguita una sola volta. Quando si invia una distribuzione Bicep, Resource Manager registra automaticamente i provider di risorse usati nel file. È inoltre possibile registrare un provider di risorse usando il portale di Azure, l'interfaccia della riga di comando di Azure o Azure PowerShell.

Tipi di risorse

Un provider di risorse espone più tipi diversi. Ogni tipo di risorsa ha un proprio set di proprietà e comportamenti che definiscono la risorsa e le relative funzionalità. Ad esempio, all'interno del provider di risorse Microsoft.Web sono disponibili diversi tipi di risorse, tra cui:

  • sites: definisce un'applicazione del servizio app o di Funzioni di Azure. Le proprietà includono le variabili di ambiente usate dall'applicazione e i protocolli supportati (HTTP e HTTPS) per l'accesso all'applicazione.
  • serverFarms: definisce un piano di servizio app, l'infrastruttura che esegue le applicazioni. Le proprietà includono le dimensioni e lo SKU dei server e il numero di istanze del piano da distribuire.

Quando si definiscono le risorse in Bicep, è necessario specificare il tipo di risorsa e la versione dell'API del provider di risorse che si vuole che Bicep usi per la risorsa. Queste informazioni consentono agli strumenti di Bicep e a Resource Manager di individuare le proprietà da specificare con la definizione della risorsa.

Suggerimento

È consigliabile usare una versione recente dell'API per ogni risorsa. Le nuove funzionalità dei servizi di Azure sono talvolta disponibili solo nelle versioni più recenti dell'API.

Combinare il provider di risorse e il nome del tipo per creare un nome di tipo di risorsa completo. Il nome completo del tipo è costituito dal nome del provider di risorse, da una barra (/) e dal tipo di risorsa. Ad esempio, il nome completo del tipo di un account di archiviazione è Microsoft.Storage/storageAccounts. In questa istanza il nome del provider di risorse è Microsoft.Storage e il tipo di risorsa è storageAccounts.

ID risorsa

Ogni risorsa di Azure ha un ID risorsa univoco. Questo ID include informazioni che consentono di distinguere la risorsa da qualsiasi altra risorsa dello stesso tipo o anche da risorse diverse che possono avere lo stesso nome. Un ID risorsa per un account di archiviazione è simile al seguente:

/subscriptions/A123b4567c-1234-1a2b-2b1a-1234abc12345/resourceGroups/ToyDevelopment/providers/Microsoft.Storage/storageAccounts/secrettoys

Di seguito è illustrata la rappresentazione visiva delle stesse informazioni:

ID risorsa per un account di archiviazione, suddiviso con la coppia chiave/valore in una riga separata.

Come si può notare, un ID risorsa alterna informazioni sul tipo di risorsa e informazioni sulla risorsa specifica distribuita. L'ID risorsa di esempio è costituita dai seguenti componenti:

  • subscriptions/A123b4567c-1234-1a2b-2b1a-1234abc12345 indica che la risorsa si trova all'interno della sottoscrizione di Azure con ID. A123b4567c-1234-1a2b-2b1a-1234abc12345.
  • resourceGroups/ToyDevelopment indica che la risorsa si trova all'interno del gruppo di risorse denominato ToyDevelopment.
  • providers/Microsoft.Storage indica che la risorsa usa un tipo del provider di risorse Microsoft.Storage.
  • storageAccounts è il tipo di risorsa.
  • secrettoys è il nome dell'account di archiviazione.

Suggerimento

È possibile accedere all'ID di qualsiasi risorsa in Bicep usando il nome simbolico e la proprietà id. Ad esempio, se si definisce un account di archiviazione con il nome simbolico toyDesignDocumentsStorageAccount, è possibile accedere al relativo ID risorsa usando l'espressione toyDesignDocumentsStorageAccount.id.

Dopo aver compreso le nozioni di base sui tipi di risorse e gli ID risorsa, è possibile esaminare le risorse figlio.