[TRM] Implement VRF VNID/EVPN-Instance Support in Terraform Provider (#389)

* Add VRF VNID and EVPN-Instance support

- Add vnid configuration support to iosxe_vrf resource
- Support VNID-only mode for automatic route-target generation
- Support VNID with explicit VNI configuration
- Support optional core-vlan parameter (platform-dependent)
- Tested on Cat8k routers (17.12, 17.15) and Cat9k switches
- Router platforms: VNID with/without explicit VNI (no core-vlan)
- Switch platforms: VNID with/without explicit VNI+core-vlan

* Fix schema validation error: remove max_elements from VNID definition

- Removed max_elements field which is not supported by schema
- Regenerated all provider code with corrected definition

* fix: Revert template to PATCH-first and exclude prerequisite-dependent VRF attributes from tests

- Revert gen/templates/resource.go to upstream PATCH-first logic for Create
  (PUT-only was not required for VRF VNID feature)
- Add exclude_test to core_vlan (switch-only attribute, not supported on routers)
- Add exclude_test to MDT attributes that require multicast/BGP/VXLAN prerequisites:
  - ipv4_mdt_default_address
  - ipv4_mdt_auto_discovery_vxlan
  - ipv4_mdt_auto_discovery_vxlan_inter_as
  - ipv4_mdt_overlay_use_bgp
  - ipv4_mdt_overlay_use_bgp_spt_only
  - ipv4_mdt_data_multicast
  - ipv4_mdt_data_threshold

The original test failures were caused by MDT attributes requiring prerequisites
not present in the test environment, not by PATCH vs PUT logic.

* feat(vrf): rename evpn_instance_vni_vni_num to evpn_instance_vni and use PATCH for Create

- Renamed tf_name from evpn_instance_vni_vni_num to evpn_instance_vni for cleaner API
- Updated template to use PATCH with fallback to PUT for resource creation
- Added exclude_test for core_vlan and MDT attributes (platform-specific)
- Regenerated provider code and documentation

---------

Co-authored-by: Cameron Schaeffer <[email protected]>
Co-authored-by: Andrea Testino <[email protected]>

Author: 3 people

docs/data-sources/vrf.md

@@ -69,6 +69,7 @@ data "iosxe_vrf" "example" {
 - `rd_auto` (Boolean) Specify to enable auto Route Distinguisher
 - `route_target_export` (Attributes Set) Export Target-VPN community (see [below for nested schema](#nestedatt--route_target_export))
 - `route_target_import` (Attributes Set) Import Target-VPN community (see [below for nested schema](#nestedatt--route_target_import))
+- `vnid` (Attributes List) Specify VNID for route-target auto generation (see [below for nested schema](#nestedatt--vnid))
 - `vpn_id` (String) Configure VPN ID in rfc2685 format
 
 <a id="nestedatt--ipv4_mdt_data_multicast"></a>
@@ -175,3 +176,20 @@ Read-Only:
 
 - `stitching` (Boolean) VXLAN route target set
 - `value` (String) Value
+
+
+<a id="nestedatt--vnid"></a>
+### Nested Schema for `vnid`
+
+Read-Only:
+
+- `evpn_instance_vni` (Attributes List) Specify explicit NVE L3 VNI number (see [below for nested schema](#nestedatt--vnid--evpn_instance_vni))
+- `vnid_value` (Number) VNID value for route-target auto generation
+
+<a id="nestedatt--vnid--evpn_instance_vni"></a>
+### Nested Schema for `vnid.evpn_instance_vni`
+
+Read-Only:
+
+- `core_vlan` (Number) Core vlan number to associate with VNI (explicit VNI mode)
+- `vni_num` (Number) The NVE L3 VNI number

docs/resources/vrf.md

@@ -69,16 +69,18 @@ resource "iosxe_vrf" "example" {
       value = "22:22"
     }
   ]
-  ipv6_import_map          = "IMPORT-MAP-1"
-  ipv6_export_map          = "EXPORT-MAP-1"
-  ipv4_mdt_default_address = "239.1.1.1"
-  ipv4_mdt_data_multicast = [
+  ipv6_import_map = "IMPORT-MAP-1"
+  ipv6_export_map = "EXPORT-MAP-1"
+  vnid = [
     {
-      address  = "239.1.2.0"
-      wildcard = "0.0.0.255"
+      vnid_value = 10001
+      evpn_instance_vni = [
+        {
+          vni_num = 20000
+        }
+      ]
     }
   ]
-  ipv4_mdt_data_threshold = 50
 }
 ```
 
@@ -132,6 +134,7 @@ resource "iosxe_vrf" "example" {
 - `rd_auto` (Boolean) Specify to enable auto Route Distinguisher
 - `route_target_export` (Attributes Set) Export Target-VPN community (see [below for nested schema](#nestedatt--route_target_export))
 - `route_target_import` (Attributes Set) Import Target-VPN community (see [below for nested schema](#nestedatt--route_target_import))
+- `vnid` (Attributes List) Specify VNID for route-target auto generation (see [below for nested schema](#nestedatt--vnid))
 - `vpn_id` (String) Configure VPN ID in rfc2685 format
 
 ### Read-Only
@@ -271,6 +274,32 @@ Optional:
 
 - `stitching` (Boolean) VXLAN route target set
 
+
+<a id="nestedatt--vnid"></a>
+### Nested Schema for `vnid`
+
+Required:
+
+- `vnid_value` (Number) VNID value for route-target auto generation
+  - Range: `1`-`2147483647`
+
+Optional:
+
+- `evpn_instance_vni` (Attributes List) Specify explicit NVE L3 VNI number (see [below for nested schema](#nestedatt--vnid--evpn_instance_vni))
+
+<a id="nestedatt--vnid--evpn_instance_vni"></a>
+### Nested Schema for `vnid.evpn_instance_vni`
+
+Required:
+
+- `vni_num` (Number) The NVE L3 VNI number
+  - Range: `4096`-`16777215`
+
+Optional:
+
+- `core_vlan` (Number) Core vlan number to associate with VNI (explicit VNI mode)
+  - Range: `1`-`4094`
+
 ## Import
 
 Import is supported using the following syntax:

examples/resources/iosxe_vrf/resource.tf

@@ -54,14 +54,16 @@ resource "iosxe_vrf" "example" {
       value = "22:22"
     }
   ]
-  ipv6_import_map          = "IMPORT-MAP-1"
-  ipv6_export_map          = "EXPORT-MAP-1"
-  ipv4_mdt_default_address = "239.1.1.1"
-  ipv4_mdt_data_multicast = [
+  ipv6_import_map = "IMPORT-MAP-1"
+  ipv6_export_map = "EXPORT-MAP-1"
+  vnid = [
     {
-      address  = "239.1.2.0"
-      wildcard = "0.0.0.255"
+      vnid_value = 10001
+      evpn_instance_vni = [
+        {
+          vni_num = 20000
+        }
+      ]
     }
   ]
-  ipv4_mdt_data_threshold = 50
 }

gen/definitions/vrf.yaml

@@ -160,20 +160,51 @@ attributes:
     tf_name: ipv6_export_map
     description: Route-map based VRF export for IPv6
     example: EXPORT-MAP-1
+  - yang_name: vnid
+    tf_name: vnid
+    type: List
+    attributes:
+      - yang_name: vnid-value
+        tf_name: vnid_value
+        type: Int64
+        id: true
+        description: VNID value for route-target auto generation
+        example: 10001
+      - yang_name: evpn-instance/vni/vni-auto-num/vni-num/vni-num
+        xpath: evpn-instance/vni/vni-num
+        tf_name: evpn_instance_vni
+        type: List
+        description: Specify explicit NVE L3 VNI number
+        attributes:
+          - yang_name: vni-num
+            tf_name: vni_num
+            type: Int64
+            id: true
+            description: The NVE L3 VNI number
+            example: 20000
+          - yang_name: core-vlan
+            tf_name: core_vlan
+            type: Int64
+            description: Core vlan number to associate with VNI (explicit VNI mode)
+            exclude_test: true
+            example: 200
   - yang_name: address-family/ipv4/mdt/default/address
     tf_name: ipv4_mdt_default_address
     description: MDT default group IPv4 address
+    exclude_test: true
     example: 239.1.1.1
   - yang_name: address-family/ipv4/mdt/auto-discovery/auto-discovery/vxlan/vxlan-config/vxlan
     xpath: address-family/ipv4/mdt/auto-discovery/vxlan-config/vxlan
     tf_name: ipv4_mdt_auto_discovery_vxlan
     description: Enable BGP auto-discovery for VxLAN
+    exclude_test: true
     example: true
     test_tags: [C9000V]
   - yang_name: address-family/ipv4/mdt/auto-discovery/auto-discovery/vxlan/vxlan-config/inter-as
     xpath: address-family/ipv4/mdt/auto-discovery/vxlan-config/inter-as
     tf_name: ipv4_mdt_auto_discovery_vxlan_inter_as
     description: Enable Inter-AS BGP auto-discovery for VxLAN
+    exclude_test: true
     example: true
     test_tags: [C9000V]
   - yang_name: address-family/ipv4/mdt/auto-discovery/auto-discovery/interworking/interworking/interworking/vxlan-pim/vxlan-pim-config/vxlan-pim
@@ -191,16 +222,19 @@ attributes:
   - yang_name: address-family/ipv4/mdt/overlay/use-bgp-config
     tf_name: ipv4_mdt_overlay_use_bgp
     description: Enable BGP for MDT overlay signaling
+    exclude_test: true
     example: true
     test_tags: [C9000V]
   - yang_name: address-family/ipv4/mdt/overlay/use-bgp-config/spt-only
     tf_name: ipv4_mdt_overlay_use_bgp_spt_only
     description: Enable Shortest path tree-only ASM mode
+    exclude_test: true
     example: true
     test_tags: [C9000V]
   - yang_name: address-family/ipv4/mdt/data/multicast
     tf_name: ipv4_mdt_data_multicast
     type: List
+    exclude_test: true
     description: MDT data multicast group ranges
     attributes:
       - yang_name: address
@@ -218,6 +252,7 @@ attributes:
   - yang_name: address-family/ipv4/mdt/data/threshold
     tf_name: ipv4_mdt_data_threshold
     description: MDT switching threshold in Kbps (1-4294967)
+    exclude_test: true
     example: 50
   - yang_name: address-family/ipv4/evpn-mcast/mdt-def-addr
     tf_name: ipv4_evpn_mcast_mdt_default_address