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..0217c703a2 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 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 @@ -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 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 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.