Skip to content

Unrecognized Resource API Version

Neil Peterson edited this page Mar 11, 2020 · 2 revisions

When authoring an Azure Resource Manager template, each Azure resource is validated against a known good resource schema. These schemas are created from the Azure REST specification, also known as the OpenAPI specs. Without a resource schema, the resource cannot be validated.

For some Azure resource providers, the OpenAPI spec to resource schema process is automated. A full list of these resource providers can be found here. For others, the process is not yet automated and in many cases, a schema has not been generated.

What this means to you is that a template may include a valid resource version, however, the tools throw a validation warning. This is a good indication that a resource schema has not been generated.

As a first step to resolving these warnings, ensure that your ARM templates are using the latest root schema, this is the $schema value commonly found at the top of an ARM template. The latest schema version is:

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

Next, if you are ok with updating the resource apiVersion, select one of the alternates. Doing so provides full validation and IntelliSense. If you are not ok with updating the apiVersion, please open an issue on the Azure Resource Schemas GitHub repository.

We are working hard to automate the process across all resource providers and apologize for any inconvenience.

Clone this wiki locally