使用Terraform部署多版本集及多API到Azure APIM时遇验证错误

错误信息 #

Error - Future#WaitForCompletion: the number of retries has been exceeded: StatusCode=400 -- Original Error: Code="ValidationError" Message="One or more fields contain incorrect values:" Details=[{"code":"ValidationError","message":"Can't set VersionName when ApiVersionSetId is not set.","target":"ApiVersion"}]

问题原因 #

这个错误的核心逻辑很明确：API配置了VersionName但未正确关联版本集的ApiVersionSetId。即便添加了depends_on，仍出现问题，通常是以下两种情况：

1. 版本集的ID引用错误（比如硬编码路径、引用了未正确创建的资源）
2. Terraform的自动依赖解析未生效，导致API资源先于版本集创建

修复方案 #

• 正确引用版本集ID
  不要手动拼接版本集的资源ID，直接通过Terraform资源的属性引用。例如：
  假设版本集资源定义为：

  resource "azurerm_api_management_api_version_set" "vset" {
    name                = "my-version-set"
    resource_group_name = azurerm_resource_group.rg.name
    api_management_name = azurerm_api_management.apim.name
    display_name        = "My Version Set"
    versioning_scheme   = "Segment"
  }
  

  那么API资源中的api_version_set_id必须写为：

  api_version_set_id = azurerm_api_management_api_version_set.vset.id
  

• 确保版本配置成对出现
  API资源中只要设置了version_name，就必须同时配置api_version_set_id，两者是绑定关系，缺一不可。完整的API配置片段示例：

  resource "azurerm_api_management_api" "api_v1" {
    name                = "my-api-v1"
    resource_group_name = azurerm_resource_group.rg.name
    api_management_name = azurerm_api_management.apim.name
    revision            = "1"
    display_name        = "My API V1"
    path                = "myapi"
    protocols           = ["https"]
  
    # 版本相关配置必须同时存在
    version_name        = "v1"
    api_version_set_id  = azurerm_api_management_api_version_set.vset.id
  
    # 显式声明依赖，确保版本集先创建
    depends_on = [azurerm_api_management_api_version_set.vset]
  }
  

• 验证版本集的创建状态
  如果上述配置仍报错，先单独部署版本集资源，确认其创建成功：

  terraform apply -target=azurerm_api_management_api_version_set.vset
  

  版本集创建完成后，再部署整个配置，排除版本集本身的创建失败问题。

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