如何通过Terraform配置Azure逻辑应用的连接参数

1. 先创建对应的邮件服务连接资源 #

首先要提前创建Office 365 Outlook（或其他邮件服务）的逻辑应用连接，以下是服务主体认证的Office 365连接示例：

resource "azurerm_logic_app_connection" "office365" {
  name                = "office365-email-connection"
  resource_group_name = azurerm_resource_group.your_rg.name
  location            = azurerm_resource_group.your_rg.location
  managed_api_id      = "/subscriptions/${var.subscription_id}/providers/Microsoft.Web/locations/${azurerm_resource_group.your_rg.location}/managedApis/office365"

  parameter_values = {
    "token:TenantId"     = var.tenant_id
    "token:ClientId"     = var.client_id
    "token:ClientSecret" = var.client_secret
    "token:GrantType"    = "client_credentials"
  }
}

2. 配置逻辑应用的工作流参数与Action #

核心解决「需要字符串映射」错误：Terraform的workflow_parameters要求键值对均为字符串类型，需用jsonencode将连接参数对象转为字符串，同时在工作流定义里声明对应参数。

完整示例：

resource "azurerm_logic_app_workflow" "email_workflow" {
  name                = "send-email-workflow"
  resource_group_name = azurerm_resource_group.your_rg.name
  location            = azurerm_resource_group.your_rg.location

  # 关键：用jsonencode将连接参数转为字符串，满足字符串映射要求
  workflow_parameters = {
    "$connections" = jsonencode({
      "value" = {
        "office365" = {
          "connectionId"   = azurerm_logic_app_connection.office365.id
          "connectionName" = azurerm_logic_app_connection.office365.name
          "id"             = "/subscriptions/${var.subscription_id}/providers/Microsoft.Web/locations/${azurerm_resource_group.your_rg.location}/managedApis/office365"
        }
      }
    })
  }

  workflow_schema = <<SCHEMA
{
  "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "$connections": {
      "defaultValue": {},
      "type": "Object"
    }
  },
  "triggers": {
    # 保留你已配置好的触发器，以下是定时触发器示例
    "Recurrence": {
      "type": "Recurrence",
      "recurrence": {
        "frequency": "Day",
        "interval": 1
      }
    }
  },
  "actions": {
    "Send_an_email_(V2)": {
      "type": "ApiConnection",
      "inputs": {
        "body": {
          "Body": "<p>这是Terraform配置的测试邮件</p>",
          "Subject": "Terraform逻辑应用测试邮件",
          "To": "target@example.com"
        },
        "host": {
          "connection": {
            "name": "@parameters('$connections')['office365']['connectionName']"
          }
        },
        "method": "post",
        "path": "/v2/Mail/Send"
      }
    }
  }
}
SCHEMA
}

3. 关键注意事项 #

• 必须在workflow_schema的parameters块中声明$connections为Object类型，否则无法在Action中引用参数。
• 不要直接在host.connection.name硬编码连接ID，通过@parameters('$connections')引用参数，和Azure门户手动创建的模板结构对齐，也便于维护。
• 如果使用其他邮件服务（如SendGrid），只需替换managed_api_id、Action的path及对应参数即可。

4. 错误排查 #

若仍出现「需要字符串映射」错误，检查两点：

• workflow_parameters中的$connections值是jsonencode处理后的字符串，而非直接的HCL对象。
• workflow_schema里的parameters块已正确声明$connections参数。

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