Announcing Azure Terrafy and AzAPI Terraform Provider Previews
Published Apr 12 2022 09:00 AM 55.8K Views



Infrastructure modernization these days typically involves one or more public clouds which enables the most agility, innovation and future proof for your business. A key component that enables businesses to manage their cloud infrastructure in a repeatable, understandable, and safe way is Infrastructure as Code (IaC) Tooling.


On Azure, businesses may choose many flavors of IaC tooling to manage their Azure resources including HashiCorp Terraform, Bicep, ARM templates, Ansible and many more. We encourage you to choose the IaC tool that best suits your needs. Our mission is to ensure that no matter which tool you choose, you have the best experience and integration with Azure.


To that end, we’re making it easier for you to use HashiCorp Terraform with Azure in two significan ways:

  • By strengthening some of the challenges that our customers have shared with us around Azure Terraform resource support and coverage.
  • By helping export Azure resources into HCL files so that you can manage your infrastructure declaratively using Terraform with Azure.


We are excited to be releasing preview versions of a few new tools that we hope and expect will make your experience with using Terraform on Azure even better than it already is.




Before we dive into the details of the new tooling, let’s take a look at a few scenarios that may resonate with you.


Getting started


Even if you are familiar with Terraform and Azure, sometimes it can be a challenge to determine how to author a Terraform configuration that will result in the exact infrastructure that you are looking for.  This typically results in an iterative process where you define a configuration, apply it, then visit the portal to determine if the infrastructure looks like you expected. This is very time consuming, and we are here to help.


Existing Infrastructure


Your current infrastructure was set up by you or someone who came before you. It may have been around “forever,” so who really knows exactly what the settings are now. You’ve adopted IaC for all new deployments and need to make some minor changes to this existing infrastructure or maybe even duplicate it. This sort of task looks daunting, but we’re here to help.


Azure Preview Functionality


The Azure team works hard to add features and functionality that will make your jobs easier. This new functionality is ordinarily released in phases, starting with private and then public preview and, finally, it is stable and made generally available. Many customers, like you, use Terraform to manage their infrastructure and are eager to adopt these new features. Terraform does not usually support these features until the final, generally available stage. This can results in clunky IaC workarounds, but we are here to help.


Escape Hatch


Azure has a vast cornucopia of services and features that are continually expanding and changing. Terraform supports the vast majority of them, but when you need to manage a features or service that is not yet supported, you end up having to fall back on imperfect work arounds, or “escape hatches,” that do not take advantage of all of the goodness you expect from Terraform. This is less than ideal, but we are here to help.


Remove Escape Hatch


With the aforementioned escape hatches are put in place, you can breathe a sigh of relief and get on with the rest of your work. Then the day comes when the “official” support is added to Terraform, and you want to remove those workarounds. The trick nw is to remove the workarounds without having to destroy your infrastructure and redeploy it. This process is anything but straight forward, but we are here to help.


New tools


We want your experience using Terraform with Azure to be delightful, and are super excited to share these open-source tools with you. The preview versions of these tools are available to use today. We invite you to download them and get started.


Azure Terrafy (aztfy)

Scenarios: Getting Started with Terraform, Migrating Existing Infrastructure


With Azure Terrafy, you can quickly and easily turn existing Azure infrastructure into Terraform HCL and will import to Terraform state. After you have completed importing your infrastructure, you can be manage it with your standard IaC processes.


Here’s how:

  1. Simply specify the Azure resource group that has the resources that you wish to start managing with Terraform,
  2. Verify that the AzureRM resource types and resource names are what you expect,
  3. aztfy will do the hard work of creating the HCL, complete with dependencies, and updating the state.
  4. Finally, validate that your configuration matches your infrastructure by running.
  5. The output confirms what you want to know:


Learn more about aztfy from the GitHub repo and download the latest binaries for your OS.


AzAPI Terraform provider

Scenarios: Azure Preview Functionality, Escape Hatch, Remove Escape hatch


The AzAPI provider is a very thin layer on top of the Azure ARM REST APIs. Use this new provider to authenticate to - and manage - Azure resources and functionality using the Azure Resource Manager APIs directly. This provider compliments the Azure Resource Manager provider (AzureRM provider) by enabling the management of Azure resources that are not yet or might never be supported in the AzureRM provider, such as private and public preview services and features.


Unlike some of the workarounds that you might currently be using to manage preview features and functionality such as a null resource to call the Azure CLI, this provider and resources are fully compatible with Terraform. This compatibility ensures that you get all the benefits of Terraform that you rely on.


To allow you to manage all Azure resources and features with this provider without requiring updates, the provider includes the following generic resources:

Resource Name Description

Used to fully manage any Azure (control plane) resource (API) with full CRUD. Example use cases:

  • New preview service
  • New feature added to existing service.
  • Existing feature / service not currently covered

Used to manage resources or parts of resources that do not have full CRUD. Example use cases:

  • Update new properties on an existing service.
  • Update pre-created child resource (e.g. DNS SOA record)


  1. Configure a resource that does not currently exist in the AzureRM provider.MarkGray_0-1649279382934.png
  2. Configure a preview property for an existing resource from AzureRM.MarkGray_1-1649279466260.png


Finally, to ensure your experience using the AzAPI provider — from authoring your configuration to migrating to the AzureRM provider—is as easy and streamlined as possible, we’ve created the following tools:

  • The Visual Studio Code extension and language server provides a rich authoring experience, complete with intellisense, code completion, hints, syntax validation, quick info and many other key features.
  • The AzureRM provider provides the best and most integrated Terraform experience for managing Azure resources. Although the AzAPI provider may be used while a service or feature is in preview, we expect customers to move to the AzureRM provider once the service is officially released. To streamline this migration from the AzAPI provider to the AzureRM provider, we have created the AzAPI2AzureRM tool to automate the process of converting AzAPI resources to AzureRM resources.


Learn more about AzAPI provider and associated tools on Microsoft Docs.


Let us hear from you


We look forward to hearing your feedback! Feel free to ask a question, report a problem or suggest a feature by opening an issue in our GitHub repo. If someone else has already mentioned the issue you want to report, let us know it is important to you as well by reacting to the issue with a thumbs-up emoji. To help ensure these tools perform well for you and everyone else, consider tracking the status of your issue and working with us directly in the discussions area.


We would love your continued feedback on Azure Terraform deployments. If you are interested in deeper conversations with the engineering team, sign up for our Azure Terraform community calls.

Version history
Last update:
‎Apr 12 2022 09:07 AM
Updated by: