Análisis del esquema y la estructura de plantillas de Azure Resource Manager

  • 6 minutos

Una plantilla de Azure Resource Manager contiene una definición con formato JSON de uno o más recursos de Azure, junto con parámetros y variables que facilitan la personalización de su configuración.

En la estructura más simple, una plantilla tiene los siguientes elementos:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "",
  "apiProfile": "",
  "parameters": {  },
  "variables": {  },
  "functions": [  ],
  "resources": [  ],
  "outputs": {  }
}
Nombre del elemento Obligatorio Descripción
$schema Sí Ubicación del archivo de esquema de notación de objetos JavaScript (JSON) que describe la versión del lenguaje de plantilla. El número de versión que use dependerá del ámbito de la implementación y del editor de JSON.

Si usa Visual Studio Code con la extensión de herramientas de Azure Resource Manager, utilice la versión más reciente de las implementaciones del grupo de recursos:
https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#

Es posible que otros editores (incluido Visual Studio) no puedan procesar este esquema. Para esos editores, use:
https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#

Para implementaciones de suscripciones, use:
https://schema.management.azure.com/schemas/2018-05-01/subscriptionDeploymentTemplate.json#

Para implementaciones del grupo de administración, use:
https://schema.management.azure.com/schemas/2019-08-01/managementGroupDeploymentTemplate.json#

Para implementaciones de inquilino, use:
https://schema.management.azure.com/schemas/2019-08-01/tenantDeploymentTemplate.json#
contentVersion Sí Versión de la plantilla (por ejemplo, 1.0.0.0). Puede especificar cualquier valor para este elemento. Use este valor para documentar los cambios importantes de la plantilla. Al implementar los recursos con la plantilla, este valor se puede usar para asegurarse de que se está usando la plantilla correcta.
apiProfile No Una versión de API que actúa como una colección de versiones de API para los tipos de recursos. Use este valor para evitar tener que especificar las versiones de API para cada recurso de la plantilla. Si especifica una versión del perfil de API y no especifica una versión de API para el tipo de recurso, Resource Manager usa la versión de API para el tipo de recurso que está definido en el perfil.

La propiedad del perfil de API es especialmente útil al implementar una plantilla en diferentes entornos, como Azure Stack y Azure global. Use la versión del perfil de API para asegurarse de que la plantilla utilice automáticamente las versiones que se admiten en ambos entornos. Para obtener una lista de las versiones del perfil de API actuales y de las versiones de API de recursos definidas en el perfil, consulte API Profile (Perfil de API).

Para más información, consulte Seguimiento de versiones mediante perfiles de API.
parameters No Valores que se proporcionan cuando se ejecuta la implementación para personalizar la implementación de recursos.
variables No Valores que se usan como fragmentos JSON en la plantilla para simplificar expresiones de idioma de la plantilla.
functions No Funciones definidas por el usuario que están disponibles dentro de la plantilla.
resources Sí Tipos de servicios que se implementan o actualizan en un grupo de recursos o suscripción.
outputs No Valores que se devuelven después de la implementación.

Demostración opcional