Prozkoumání struktury a schématu šablony Azure Resource Manageru

  • 6 min

Šablona Azure Resource Manageru obsahuje definici formátu JSON jednoho nebo více prostředků Azure spolu s parametry a proměnnými, které usnadňují přizpůsobení jejich konfigurace.

V nejjednodušší struktuře má šablona následující prvky:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "",
  "apiProfile": "",
  "parameters": {  },
  "variables": {  },
  "functions": [  ],
  "resources": [  ],
  "outputs": {  }
}
Název prvku Požadováno Popis
$schema Ano Umístění souboru schématu JSON (JavaScript Object Notation), který popisuje verzi jazyka šablony. Použité číslo verze závisí na rozsahu nasazení a editoru JSON.

Pokud používáte Visual Studio Code s rozšířením nástrojů Azure Resource Manageru, použijte nejnovější verzi pro nasazení skupin prostředků:
https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#

Jiné editory (včetně sady Visual Studio) nemusí toto schéma zpracovat. Pro tyto editory použijte:
https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#

Pro nasazení předplatného použijte:
https://schema.management.azure.com/schemas/2018-05-01/subscriptionDeploymentTemplate.json#

Pro nasazení skupin pro správu použijte:
https://schema.management.azure.com/schemas/2019-08-01/managementGroupDeploymentTemplate.json#

Pro nasazení tenanta použijte:
https://schema.management.azure.com/schemas/2019-08-01/tenantDeploymentTemplate.json#
contentVersion Ano Verze šablony (například 1.0.0.0).0) Pro tento prvek můžete zadat libovolnou hodnotu. Pomocí této hodnoty můžete zdokumentovat významné změny v šabloně. Při nasazování prostředků pomocí šablony je možné tuto hodnotu použít k zajištění toho, aby byla použita správná šablona.
apiProfile No Verze rozhraní API, která slouží jako kolekce verzí rozhraní API pro typy prostředků. Tuto hodnotu použijte, abyste nemuseli zadávat verze rozhraní API pro každý prostředek v šabloně. Když zadáte verzi profilu rozhraní API a nezadáte verzi rozhraní API pro typ prostředku, Resource Manager použije verzi rozhraní API pro tento typ prostředku definovaný v profilu.

Vlastnost profilu rozhraní API je užitečná hlavně při nasazování šablony do různých prostředí, jako je Azure Stack a globální Azure. Pomocí verze profilu rozhraní API se ujistěte, že vaše šablona automaticky používá verze podporované v obou prostředích. Seznam aktuálních verzí profilu rozhraní API a verzí rozhraní API prostředků definovaných v profilu najdete v části Profil rozhraní API.

Další informace najdete v tématu Sledování verzí pomocí profilů rozhraní API.
parameters No Hodnoty zadané při spuštění nasazení pro přizpůsobení nasazení prostředků
proměnné No Hodnoty, které se v šabloně používají jako fragmenty JSON pro zjednodušení výrazů jazyka šablony.
funkce No Uživatelem definované funkce, které jsou k dispozici v rámci šablony.
prostředky Ano Typy prostředků, které se nasazují nebo aktualizují ve skupině prostředků nebo předplatném.
výstupy No Hodnoty vrácené po nasazení

Volitelná ukázka