Utforska mallstrukturen och schemat för Azure Resource Manager

  • 6 minuter

En Azure Resource Manager-mall innehåller en JSON-formaterad definition av en eller flera Azure-resurser, tillsammans med parametrar och variabler som underlättar anpassningen av deras konfiguration.

I den enklaste strukturen har en mall följande element:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "",
  "apiProfile": "",
  "parameters": {  },
  "variables": {  },
  "functions": [  ],
  "resources": [  ],
  "outputs": {  }
}
Elementnamn Obligatoriskt Beskrivning
$schema Ja Plats för JSON-schemafilen (JavaScript Object Notation) som beskriver versionen av mallspråket. Vilket versionsnummer du använder beror på distributionens omfattning och JSON-redigeraren.

Om du använder Visual Studio Code med Azure Resource Manager-verktygstillägget använder du den senaste versionen för resursgruppsdistributioner:
https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#

Andra redigerare (inklusive Visual Studio) kanske inte kan bearbeta det här schemat. För dessa redigerare använder du:
https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#

För prenumerationsdistributioner använder du:
https://schema.management.azure.com/schemas/2018-05-01/subscriptionDeploymentTemplate.json#

För distributioner av hanteringsgrupper använder du:
https://schema.management.azure.com/schemas/2019-08-01/managementGroupDeploymentTemplate.json#

För klientdistributioner använder du:
https://schema.management.azure.com/schemas/2019-08-01/tenantDeploymentTemplate.json#
contentVersion Ja Version av mallen (till exempel 1.0.0.0). Du kan ange valfritt värde för det här elementet. Använd det här värdet för att dokumentera betydande ändringar i mallen. När du distribuerar resurser med hjälp av mallen kan det här värdet användas för att se till att rätt mall används.
apiProfile Nej En API-version som fungerar som en samling API-versioner för resurstyper. Använd det här värdet för att undvika att behöva ange API-versioner för varje resurs i mallen. När du anger en API-profilversion och inte anger någon API-version för resurstypen använder Resource Manager API-versionen för den resurstyp som definieras i profilen.

Egenskapen API-profil är särskilt användbar när du distribuerar en mall till olika miljöer, till exempel Azure Stack och globala Azure. Använd API-profilversionen för att se till att mallen automatiskt använder versioner som stöds i båda miljöerna. En lista över de aktuella API-profilversionerna och resursernas API-versioner som definierats i profilen finns i API-profil.

Mer information finns i Spåra versioner med HJÄLP av API-profiler.
parameters Nej Värden som anges när distributionen körs för att anpassa resursdistributionen.
Variabler Nej Värden som används som JSON-fragment i mallen för att förenkla mallspråkuttryck.
Funktioner Nej Användardefinierade funktioner som är tillgängliga i mallen.
Resurser Ja Resurstyper som distribueras eller uppdateras i en resursgrupp eller prenumeration.
Utgångar Nej Värden som returneras efter distributionen.

Valfri demo