使用Terraform在IBM Cloud创建VSI时出现预留IP验证错误

错误本质 #

错误信息 updateSubnetReservedIPOptions failed validation: Key: 'UpdateSubnetReservedIPOptions.ID' Error:Field validation for 'ID' failed on the 'ne' tag 表示：IBM Cloud Provider 在执行子网预留IP更新操作时，传入的ID字段为空，不符合API要求的「非空（ne = not empty）」验证规则。

核心原因判断 #

1. Provider版本bug（最可能） #

该问题属于terraform-ibm-provider的已知逻辑缺陷，常见于v1.50.x及更早版本，尤其是在使用ibm_is_instance资源并指定primary_network_interface.0.primary_ipv4_address（静态内部IP）的场景下：

• VSI创建成功后，Provider会触发一个多余的预留IP更新操作，但未正确传递预留IP的ID参数（参数为空），导致API验证失败。
• 虽然VSI本身可用，但这个错误会被Terraform判定为资源创建异常，进而标记资源为「污染（tainted）」，强制后续apply时替换。

2. 配置依赖问题（次要可能） #

• 若你手动创建了ibm_is_subnet_reserved_ip资源并关联到VSI，但未通过depends_on明确声明依赖关系，可能导致Provider在更新时获取到的预留IP ID为空。
• Terraform状态文件与IBM Cloud实际资源状态不同步，也可能引发此类参数传递错误。

可行解决方案 #

• 移除污染标记：执行命令跳过强制替换：

  terraform untaint ibm_is_instance.your_vsi_resource_name
  

  注意：此方法仅临时解决替换问题，下次apply可能重复触发错误。

• 升级Provider版本：将terraform-ibm-provider升级至v1.60+的稳定版，官方已在后续版本中修复了多起预留IP相关的验证逻辑bug。

• 修正配置依赖：若使用手动创建的预留IP，明确声明依赖关系：

  resource "ibm_is_instance" "your_vsi" {
    name              = "your-vsi-name"
    profile           = "bx2-2x8"
    image             = "ibm-ubuntu-22-04-minimal-amd64-1"
    vpc               = ibm_is_vpc.your_vpc.id
    zone              = "us-south-1"
  
    primary_network_interface {
      subnet                  = ibm_is_subnet.your_subnet.id
      primary_ipv4_address    = ibm_is_subnet_reserved_ip.your_reserved_ip.address
    }
  
    # 明确依赖预留IP资源，确保Provider获取到有效ID
    depends_on = [ibm_is_subnet_reserved_ip.your_reserved_ip]
  }
  

结论 #

该问题主要由terraform-ibm-provider的版本bug导致，优先通过升级Provider版本解决；若升级后问题仍存在，可整理配置片段和完整错误日志，提交至IBM Cloud Provider的官方仓库反馈。

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