Terraform Provider for AzureRM 中维护配置的月度窗口设置问题解析

在使用 Terraform Provider for AzureRM 创建 Azure 维护配置时，开发者可能会遇到一个关于月度维护窗口设置的常见错误。本文将深入分析这个问题，并提供正确的配置方法。

问题现象

当尝试通过 azurerm_maintenance_configuration 资源创建维护配置时，如果设置了月度(Month)重复周期但没有指定具体日期或周数，Azure API 会返回以下错误：

Invalid maintenance window. Error: Monthlow. Error: Monthly maintenance window is missing day of month or week of month.

原因分析

这个错误表明 Azure 维护配置服务要求当设置月度重复周期时，必须明确指定以下信息之一：

1. 每月的具体某一天（如每月1日）
2. 每月的第几周（如每月第一周）

单纯的 "Month" 参数不足以定义完整的重复周期规则，因此 API 拒绝了该请求。

正确配置方法

正确的月度维护窗口配置应该在 recur_every 参数中使用更详细的语法：

window {
  start_date_time = "2025-06-01 12:00"
  duration        = "01:30"
  time_zone       = "UTC"
  recur_every     = "1Month day1"  # 表示每月第1天
}

或者指定周数：

recur_every = "1Month week1"  # 表示每月第1周

完整示例

以下是一个完整的正确配置示例：

resource "azurerm_maintenance_configuration" "example" {
  name                     = "maintenance-config-example"
  resource_group_name      = azurerm_resource_group.example.name
  location                 = azurerm_resource_group.example.location
  scope                    = "InGuestPatch"
  in_guest_user_patch_mode = "User"
  
  install_patches {
    reboot = "IfRequired"
    linux {
      classifications_to_include = ["Security", "Critical"]
    }
  }
  
  window {
    start_date_time = "2025-06-01 12:00"
    duration        = "01:30"
    time_zone       = "UTC"
    recur_every     = "1Month day1"  # 每月第1天执行维护
  }

  tags = {
    environment = "production"
  }
}

最佳实践建议

1. 明确指定日期或周数：始终为月度维护窗口指定具体日期或周数
2. 测试配置：在应用到生产环境前，先在测试环境中验证配置
3. 考虑维护时长：确保维护窗口时长足够完成所有维护操作
4. 时区设置：根据用户所在地区设置合适的时区

通过遵循这些指导原则，开发者可以避免常见的配置错误，确保 Azure 维护配置按预期工作。