From 2bb9ad9c9b77d86017a67849335655e34a075937 Mon Sep 17 00:00:00 2001 From: Gerry Tan <2316198+gerrytan@users.noreply.github.com> Date: Tue, 2 Dec 2025 14:44:02 +1100 Subject: [PATCH 1/4] export-terraform-overview.md: inform user about portal v CLI distinction --- .../export-terraform-overview.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/articles/terraform/azure-export-for-terraform/export-terraform-overview.md b/articles/terraform/azure-export-for-terraform/export-terraform-overview.md index e2850a1087..10604278ba 100644 --- a/articles/terraform/azure-export-for-terraform/export-terraform-overview.md +++ b/articles/terraform/azure-export-for-terraform/export-terraform-overview.md @@ -1,15 +1,15 @@ --- -title: Overview of Azure Export for Terraform -description: Learn the benefits and uses of Azure Export for Terraform +title: Overview of Azure Export for Terraform CLI +description: Learn the benefits and uses of Azure Export for Terraform CLI ms.topic: overview ms.date: 05/10/2023 ms.author: stema ms.custom: devx-track-terraform,devx-track-export-terraform --- -# Overview of Azure Export for Terraform +# Overview of Azure Export for Terraform CLI -Azure Export for Terraform is a tool designed to help reduce friction in translation between Azure and Terraform concepts. +Azure Export for Terraform (`aztfexport`) is CLI a tool designed to help reduce friction in translation between Azure and Terraform concepts. This tool complements the [portal Terraform export experience](get-started-export-resources-portal.md). ## Benefits @@ -20,6 +20,13 @@ Azure Export for Terraform enables you to: - **Inspect preexisting infrastructure with all exposed properties.** Whether learning a newly released resource or investigating an issue in production, Azure Export for Terraform supports a read-only export with the option to expose all configurable resource properties. - **Follow plan/apply workflow to integrate non-Terraform infrastructure into Terraform.** Export HCL code, inspect non-Terraform resources and easily integrate them into your production infrastructure and remote backends. +## Comparison with portal export experience + +This CLI tool provides more features in comparison to the portal experience. + +- **Number of resources that can be exported**. In portal only up to 1000 resources can be exported, and the maximum exported configuration payload is 4 MB. Error wil be returned if the limit is exceeded. +- **Supported resource types**. In portal, some resource types such as Key Vault cannot be exported, but they are supported in the CLI tool. + ## Installation The [Azure Export for Terraform GitHub page](https://github.com/Azure/aztfexport/releases) lists releases of the tool with links to installation for various platforms (Windows MSIs, Homebrew, and Linux installations) and the source code. From 3841e76f1661a9eae22030cc2eb7630cd682bd16 Mon Sep 17 00:00:00 2001 From: Gerry Tan <2316198+gerrytan@users.noreply.github.com> Date: Thu, 4 Dec 2025 09:57:45 +1100 Subject: [PATCH 2/4] Improve accuracy of partial export / property support --- .../azure-export-for-terraform/export-terraform-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/articles/terraform/azure-export-for-terraform/export-terraform-overview.md b/articles/terraform/azure-export-for-terraform/export-terraform-overview.md index 10604278ba..435d5560d4 100644 --- a/articles/terraform/azure-export-for-terraform/export-terraform-overview.md +++ b/articles/terraform/azure-export-for-terraform/export-terraform-overview.md @@ -25,7 +25,7 @@ Azure Export for Terraform enables you to: This CLI tool provides more features in comparison to the portal experience. - **Number of resources that can be exported**. In portal only up to 1000 resources can be exported, and the maximum exported configuration payload is 4 MB. Error wil be returned if the limit is exceeded. -- **Supported resource types**. In portal, some resource types such as Key Vault cannot be exported, but they are supported in the CLI tool. +- **Supported resource types**. In portal, some resource types or properties within a resource type cannot be exported. ## Installation From 1d949ef95feb72f080a14d6556f08a171a8044fe Mon Sep 17 00:00:00 2001 From: Gerry Tan <2316198+gerrytan@users.noreply.github.com> Date: Thu, 4 Dec 2025 10:07:58 +1100 Subject: [PATCH 3/4] AI PR feedback: grammar and typos --- .../azure-export-for-terraform/export-terraform-overview.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/articles/terraform/azure-export-for-terraform/export-terraform-overview.md b/articles/terraform/azure-export-for-terraform/export-terraform-overview.md index 435d5560d4..b728018151 100644 --- a/articles/terraform/azure-export-for-terraform/export-terraform-overview.md +++ b/articles/terraform/azure-export-for-terraform/export-terraform-overview.md @@ -9,7 +9,7 @@ ms.custom: devx-track-terraform,devx-track-export-terraform # Overview of Azure Export for Terraform CLI -Azure Export for Terraform (`aztfexport`) is CLI a tool designed to help reduce friction in translation between Azure and Terraform concepts. This tool complements the [portal Terraform export experience](get-started-export-resources-portal.md). +Azure Export for Terraform (`aztfexport`) is a CLI tool designed to help reduce friction in translation between Azure and Terraform concepts. This tool complements the [portal Terraform export experience](get-started-export-resources-portal.md). ## Benefits @@ -24,7 +24,7 @@ Azure Export for Terraform enables you to: This CLI tool provides more features in comparison to the portal experience. -- **Number of resources that can be exported**. In portal only up to 1000 resources can be exported, and the maximum exported configuration payload is 4 MB. Error wil be returned if the limit is exceeded. +- **Number of resources that can be exported**. In portal only up to 1,000 resources can be exported, and the maximum exported configuration payload is 4 MB. The tool returns an error if the limit is exceeded. - **Supported resource types**. In portal, some resource types or properties within a resource type cannot be exported. ## Installation From 422a0e4555114bd7b1c65fc23928c2c3faca9228 Mon Sep 17 00:00:00 2001 From: Gerry Tan <2316198+gerrytan@users.noreply.github.com> Date: Thu, 4 Dec 2025 10:11:16 +1100 Subject: [PATCH 4/4] AI PR feedback: use 'the' article --- .../azure-export-for-terraform/export-terraform-overview.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/articles/terraform/azure-export-for-terraform/export-terraform-overview.md b/articles/terraform/azure-export-for-terraform/export-terraform-overview.md index b728018151..0217c703a2 100644 --- a/articles/terraform/azure-export-for-terraform/export-terraform-overview.md +++ b/articles/terraform/azure-export-for-terraform/export-terraform-overview.md @@ -24,8 +24,8 @@ Azure Export for Terraform enables you to: This CLI tool provides more features in comparison to the portal experience. -- **Number of resources that can be exported**. In portal only up to 1,000 resources can be exported, and the maximum exported configuration payload is 4 MB. The tool returns an error if the limit is exceeded. -- **Supported resource types**. In portal, some resource types or properties within a resource type cannot be exported. +- **Number of resources that can be exported**. In the portal only up to 1,000 resources can be exported, and the maximum exported configuration payload is 4 MB. The tool returns an error if the limit is exceeded. +- **Supported resource types**. In the portal, some resource types or properties within a resource type cannot be exported. ## Installation