To assist with creating Azure Resource Manager templates, you can export a template from existing resources as either a Bicep file or an ARM JSON template. The exported template helps you understand the syntax and properties needed for resource deployment. To streamline future deployments, use the exported template as a starting point and customize it for your needs. While the export process generates a functional template, most exported templates require adjustments before they can be used for deployment.
Resource Manager enables you to pick one or more resources for exporting to a template. You can focus on exactly the resources you need in the template.
This article shows how to export templates through Azure CLI. For other options, see:
Export from resource group or resource. This option generates a new template from existing resources. The exported template is a "snapshot" of the current state of the resource group. You can export an entire resource group or specific resources within that resource group.
Save from history. This option supports exporting only ARM JSON templates. It retrieves an exact copy of the template used for deployment, allowing you to select a specific deployment from the deployment history. After exporting, you can decompile them into to Bicep files.
Depending on the option you choose, the exported templates have different qualities.
From resource group or resource
From history
Template is autogenerated. You'll probably want to improve the code before deploying it.
Template is an exact copy of the one created by the template author. It's ready to be redeployed without any changes.
Template is snapshot of the resources' current state. It includes any manual changes you made after deployment.
Template only shows state of resources at the time of deployment. Any manual changes you made after deployment aren't included.
You can select which resources from a resource group to export.
All resources for a specific deployment are included. You can't pick a subset of those resources or add resources that were added at a different time.
Template includes all properties for the resources, including some properties you wouldn't normally set during deployment. You might want to remove or clean up these properties before reusing the template.
Template includes only the properties needed for the deployment. The template is more sparse and easier to read.
Template probably doesn't include all of the parameters you need for reuse. Most property values are hard-coded in the template. To redeploy the template in other environments, you need to add parameters that increase the ability to configure the resources. You can unselect Include parameters so that you can author your own parameters.
Template includes parameters that make it easy to redeploy in different environments.
Export the template from a resource group or resource, when:
You need to capture changes to the resources that were made after the original deployment.
You want to select which resources are exported.
The resources weren't created with a template.
Export the template from the history, when:
You want an easy-to-reuse template.
You don't need to include changes you made after the original deployment.
Limitations
Export is not guaranteed to succeed. Export is not a reliable way to turn pre-existing resources into templates that are usable in production. It is better to create resources from scratch using hand-written Bicep file, ARM template or terraform.
When exporting from a resource group or resource, the exported template is generated from the published schemas for each resource type. Occasionally, the schema doesn't have the latest version for a resource type. Check your exported template to make sure it includes the properties you need. If necessary, edit the exported template to use the API version you need.
Some password parameters might be missing from the exported templates. You need to check template reference, and manually add these parameters before you can use the templates to deploy resources.
If you get a warning when exporting a template that indicates a resource type wasn't exported, you can still discover the properties for that resource. For resource properties, see template reference. You can also look at the Azure REST API for the resource type.
There's a limit of 200 resources in the resource group you create the exported template for. If you attempt to export a resource group that has more than 200 resources, the error message Export template is not supported for resource groups more than 200 resources is shown.
Export template from a resource group
After setting up your resource group successfully, you can export an Azure Resource Manager template for the resource group.
To export all resources in a resource group, use az group export and provide the resource group name.
Azure CLI
az group export --name demoGroup
The script displays the template on the console. To save to a file, use:
Azure CLI
az group export --name demoGroup > exportedtemplate.json
Instead of exporting all resources in the resource group, you can select which resources to export.
To export one resource, pass that resource ID.
Azure CLI
storageAccountID=$(az resource show --resource-group demoGroup --name demostg --resource-type Microsoft.Storage/storageAccounts --query id --output tsv)
az group export --resource-group demoGroup --resource-ids$storageAccountID
To export more than one resource, pass the space-separated resource IDs. To export all resources, don't specify this argument or supply "*".
Azure CLI
az group export --resource-group<resource-group-name>--resource-ids$storageAccountID1$storageAccountID2
When exporting the template, you can specify whether parameters are used in the template. By default, parameters for resource names are included but they don't have a default value.
If you use the --skip-resource-name-params parameter when exporting the template, parameters for resource names aren't included in the template. Instead, the resource name is set directly on the resource to its current value. You can't customize the name during deployment.
If you use the --include-parameter-default-value parameter when exporting the template, the template parameter includes a default value that is set to the current value. You can either use that default value or overwrite the default value by passing in a different value.