Merge pull request #294528 from mumian/0212-bicep-export

Export Bicep files from the Azure portal

Author: JillGrant615

articles/azure-resource-manager/bicep/decompile.md

@@ -2,7 +2,7 @@
 title: Decompile a JSON Azure Resource Manager template to Bicep
 description: Learn the commands for decompiling JSON Azure Resource Manager templates to Bicep files.
 ms.topic: how-to
-ms.date: 01/10/2025
+ms.date: 02/14/2025
 ms.custom: devx-track-bicep, devx-track-arm-template
 ---
 
@@ -167,6 +167,9 @@ output storageAccountName string = uniqueStorageName
 
 ## Export template and convert
 
+> [!NOTE]
+> You can export Bicep files by using the Azure portal.  For more information, see [Use Azure portal to export a Bicep file](./export-bicep-portal.md).
+
 You can export the template for a resource group and then pass it directly to the `decompile` command. The following examples show how to decompile an exported template:
 
 # [Azure CLI](#tab/azure-cli)

articles/azure-resource-manager/bicep/export-bicep-portal.md

@@ -0,0 +1,57 @@
+---
+title: Export Bicep files in Azure portal
+description: Use Azure portal to export a Bicep file from resources in your subscription.
+ms.topic: how-to
+ms.custom: devx-track-arm-template
+ms.date: 02/25/2025
+---
+
+# Use Azure portal to export a Bicep file
+
+[!INCLUDE [Export template intro](../../../includes/resource-manager-export-template-intro.md)]
+
+Currently, Bicep files can only be exported from the Azure portal. However, you can export ARM JSON templates via [Azure CLI](../templates/export-template-cli.md) or [Azure PowerShell](../templates/export-template-powershell.md) and then [decompile](./decompile.md) them into to Bicep files.
+
+[!INCLUDE [Export template limitations](../../../includes/resource-manager-export-template-limitations.md)]
+
+## Export Bicep file from a resource group
+
+To export one or more resources from a resource group:
+
+1. Select the resource group that contains the resources you want to export.
+
+1. Select one or more resources by selecting the checkboxes. To select all, select the checkbox on the left of **Name**. The **Export template** from the top menu only becomes enabled after you've selected at least one resource.
+
+   :::image type="content" source="./media/export-bicep-portal/select-all-resources.png" alt-text="Screenshot of selecting all resources for export in Azure portal.":::
+
+1. Select **Export template** from the top menu. The **Export template** from the left menu exports all the resources in the group to a Bicep file.
+
+1. Select **Bicep**. The exported Bicep file is displayed, and is available to download and deploy.
+
+   :::image type="content" source="./media/export-bicep-portal/show-template.png" alt-text="Screenshot of the displayed exported Bicep file in Azure portal.":::
+
+   All template parameters are included when the Bicep file is generated. 
+
+## Export Bicep file from a resource
+
+To export one resource:
+
+1. Select the resource group containing the resource you want to export.
+
+1. Select the resource that you want to export to open the resource.
+
+1. For that resource, select **Export template** in the left pane.
+
+   :::image type="content" source="./media/export-bicep-portal/export-single-resource.png" alt-text="Screenshot of exporting a single resource in Azure portal.":::
+
+1. Select **Bicep**. The exported Bicep file is displayed, and is available to download and deploy. The Bicep file only contains the single resource. All template parameters are included when the Bicep file is generated.
+
+## Export template after deployment
+
+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](./decompile.md) them into to Bicep files. For more information about saving from history and the export options, see [Choose the right export option](../templates/export-template-portal.md#choose-the-right-export-option).
+
+## Next steps
+
+* Learn how to export ARM JSON templates with [Azure CLI](../templates/export-template-cli.md), [Azure PowerShell](../templates/export-template-powershell.md), or [REST API](/rest/api/resources/resourcegroups/exporttemplate).
+* Learn the [Bicep file structure and syntax](./file.md).
+* Learn how to [decompile ARM JSON templates to Bicep](./decompile.md).

articles/azure-resource-manager/bicep/media/export-bicep-portal/export-single-resource.png

@@ -584,6 +584,10 @@
       href: deploy-powershell.md
     - name: Deploy - Cloud Shell
       href: deploy-cloud-shell.md
+  - name: Export 
+    items:
+    - name: Portal
+      href: export-bicep-portal.md
   - name: Configure settings
     items:
     - name: Bicep config file

articles/azure-resource-manager/bicep/media/export-bicep-portal/select-all-resources.png

@@ -3,7 +3,7 @@ title: Export template in Azure portal
 description: Use Azure portal to export an Azure Resource Manager template from resources in your subscription.
 ms.topic: how-to
 ms.custom: devx-track-arm-template
-ms.date: 10/16/2024
+ms.date: 02/12/2025
 ---
 
 # Use Azure portal to export a template
@@ -32,11 +32,11 @@ To export one or more resources from a resource group:
 
 1. Select **Export template** from the top menu. The **Export template** from the left menu exports all the resources in the group to a template.
 
-1. The exported template is displayed, and is available to download and deploy.
+1. Select **ARM Template**. The exported template is displayed, and is available to download and deploy.
 
    :::image type="content" source="./media/export-template-portal/show-template.png" alt-text="Screenshot of the displayed exported template in Azure portal.":::
 
-   **Include parameters** is selected by default.  When selected, all template parameters are included when the template is generated. If you’d like to author your own parameters, toggle this checkbox to not include them.
+   **Include parameters** is selected by default.  When selected, all template parameters are included when the template is generated. If you'd like to author your own parameters, toggle this checkbox to not include them.
 
 ## Export template from a resource
 
@@ -72,6 +72,6 @@ You can export the template that was used to deploy existing resources. The temp
 
 ## Next steps
 
-* Learn how to export templates with [Azure CLI](export-template-cli.md), [Azure PowerShell](export-template-powershell.md), or [REST API](/rest/api/resources/resourcegroups/exporttemplate).
+* Learn how to export Bicep files with the [Azure portal](../bicep/export-bicep-portal.md).
+* Learn how to export templates with [Azure CLI](./export-template-cli.md), [Azure PowerShell](./export-template-powershell.md), or [REST API](/rest/api/resources/resourcegroups/exporttemplate).
 * To learn the Resource Manager template syntax, see [Understand the structure and syntax of Azure Resource Manager templates](./syntax.md).
-* To learn how to develop templates, see the [step-by-step tutorials](../index.yml).