Informazioni sulle risorse di Azure
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:
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 denominatoToyDevelopment
.providers/Microsoft.Storage
indica che la risorsa usa un tipo del provider di risorseMicrosoft.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.