如何将已有Azure资源批量导入本地Terraform state文件

以下方案均不需要逐条执行terraform import命令，可完成批量同步

方案1：使用官方aztfexport工具（最高效，推荐优先使用） #

aztfexport是微软官方维护的Azure专属Terraform导入工具，支持按范围批量扫描存量资源，自动生成对应Terraform配置同时同步到state文件，全程无需手动编写资源配置。
操作步骤：

• 首先完成Azure CLI身份认证，执行az login登录到目标订阅，确认当前订阅为需要导入资源的订阅
• 本地新建空的Terraform工作目录，执行terraform init初始化对应版本的azurerm provider
• 根据导入范围执行对应扫描命令：
  • 导入单个资源组下所有资源：aztfexport resource-group <目标资源组名>
  • 按标签筛选导入指定资源：aztfexport query "tag.业务线 = '交易系统'"
  • 导入整个订阅下所有资源：aztfexport subscription <目标订阅ID>
• 工具会自动输出扫描到的所有资源清单，可手动勾选排除不需要导入的资源，确认后工具会自动生成对应.tf配置文件，同时将资源信息写入本地state文件

方案2：使用Terraform原生批量import功能（1.5+版本支持） #

如果不方便安装第三方工具，可使用Terraform原生的import块功能完成批量导入：

• 先收集所有需要导入的资源的Azure资源ID，以及你规划的对应Terraform资源寻址名称（例如azurerm_linux_vm.frontend_vm_001）
• 工作目录下新建import.tf文件，按格式写入所有导入规则：

  import {
    to = azurerm_linux_vm.frontend_vm_001
    id = "/subscriptions/替换为订阅ID/resourceGroups/替换为资源组名/providers/Microsoft.Compute/virtualMachines/替换为VM名称"
  }
  
  import {
    to = azurerm_resource_group.prod_rg
    id = "/subscriptions/替换为订阅ID/resourceGroups/替换为资源组名"
  }
  # 所有需要导入的资源均按上述格式追加即可
  

• 执行terraform plan -generate-config-out=generated_resources.tf，Terraform会自动根据存量资源的属性生成对应的资源配置文件，无需手动编写
• 验证生成的配置无问题后，执行terraform apply即可完成所有资源到state的同步

注意事项 #

• 操作前务必备份现有state文件（如果已有存量state），避免操作失误导致state损坏
• 导入完成后执行terraform plan验证，无增改资源提示则代表同步成功

内容的提问来源于stack exchange，提问作者hitman126