Skip to content

Would you like to use the latest schema for deployment template "XXXX"?

Alex Frankel edited this page Nov 5, 2019 · 2 revisions

There are currently three valid Azure schemas for use with deployment templates targeted toward resource group deployment:

https://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json# https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json# https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#

The first two schemas are valid, but will not be updated to include the latest schemas for new Azure resource types and API versions. This is to minimize the performance impact on other JSON tools that are not capable of processing such a large number of resources schemas.

The Azure Resource Manager (ARM) Tools extension is able to handle a large number of resource types and API versions in the newest schema because it has knowledge about Azure that allows it to prune the validation tree based on individual resource types and versions.

For those using this extension, the most recent version (2019-04-01) of deploymentTemplate.json is recommended, and a notification will ask to automatically make the change for you. Going forward the 2019-04-01 root schema will be updated with all of the latest resource type and API version schemas. If you are sharing the code with other tools, you may need to do some testing to make sure they can handle this larger root schema.

If you never wish to see this prompt for any template file, you can disable it by setting azureResourceManagerTools.checkForLatestSchema to false in VS Code's settings. You can navigate to this setting in the VS Code UI by going to Settings -> Extensions -> Azure Resource Manager Tools.