[Interface] Implement IGMP Version Support in Terraform Provider

CHANGELOG.md

@@ -4,6 +4,7 @@
 - Add `ip_domain_lookup_nsap`, `ip_domain_lookup_recursive`, and `ip_domain_lookup_vrfs*` attributes to `iosxe_system` resource and data source
 - Add `iosxe_evpn_ethernet_segment` resource and data source for managing L2VPN EVPN Ethernet Segment configuration
 - Add `evpn_ethernet_segments` attribute to `iosxe_interface_ethernet` and `iosxe_interface_port_channel` resources and data sources
+- Add `iosxe_interface_igmp` resource and data source for managing IGMP configuration on interfaces
 - Add `ip_ssh_bulk_mode` and `ip_ssh_bulk_mode_window_size` attributes to `iosxe_system` resource and data source
 - Add `set_ip_next_hop_unchanged` attribute to `iosxe_route_map` resource and data source
 - Enhance `set_communities` attribute documentation in `iosxe_route_map` to clarify support for well-known BGP community values (internet, local-AS, no-advertise, no-export, gshut)

docs/data-sources/interface_igmp.md

@@ -0,0 +1,37 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "iosxe_interface_igmp Data Source - terraform-provider-iosxe"
+subcategory: "Multicast"
+description: |-
+  This data source can read the Interface IGMP configuration.
+---
+
+# iosxe_interface_igmp (Data Source)
+
+This data source can read the Interface IGMP configuration.
+
+## Example Usage
+
+```terraform
+data "iosxe_interface_igmp" "example" {
+  type = "Loopback"
+  name = "100"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `name` (String)
+- `type` (String) Interface type
+
+### Optional
+
+- `device` (String) A device name from the provider configuration.
+
+### Read-Only
+
+- `id` (String) The path of the retrieved object.
+- `version` (Number) IGMP version

docs/guides/changelog.md

@@ -13,6 +13,7 @@ description: |-
 - Add `ip_domain_lookup_nsap`, `ip_domain_lookup_recursive`, and `ip_domain_lookup_vrfs*` attributes to `iosxe_system` resource and data source
 - Add `iosxe_evpn_ethernet_segment` resource and data source for managing L2VPN EVPN Ethernet Segment configuration
 - Add `evpn_ethernet_segments` attribute to `iosxe_interface_ethernet` and `iosxe_interface_port_channel` resources and data sources
+- Add `iosxe_interface_igmp` resource and data source for managing IGMP configuration on interfaces
 - Add `ip_ssh_bulk_mode` and `ip_ssh_bulk_mode_window_size` attributes to `iosxe_system` resource and data source
 - Add `set_ip_next_hop_unchanged` attribute to `iosxe_route_map` resource and data source
 - Enhance `set_communities` attribute documentation in `iosxe_route_map` to clarify support for well-known BGP community values (internet, local-AS, no-advertise, no-export, gshut)

docs/resources/interface_igmp.md

@@ -0,0 +1,51 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "iosxe_interface_igmp Resource - terraform-provider-iosxe"
+subcategory: "Multicast"
+description: |-
+  This resource can manage the Interface IGMP configuration.
+---
+
+# iosxe_interface_igmp (Resource)
+
+This resource can manage the Interface IGMP configuration.
+
+## Example Usage
+
+```terraform
+resource "iosxe_interface_igmp" "example" {
+  type    = "Loopback"
+  name    = "100"
+  version = 3
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `name` (String)
+- `type` (String) Interface type
+  - Choices: `FastEthernet`, `GigabitEthernet`, `TwoGigabitEthernet`, `FiveGigabitEthernet`, `TenGigabitEthernet`, `TwentyFiveGigE`, `FortyGigabitEthernet`, `HundredGigE`, `Loopback`, `Vlan`, `Port-channel`, `Port-channel-subinterface/Port-channel`, `Tunnel`
+
+### Optional
+
+- `device` (String) A device name from the provider configuration.
+- `version` (Number) IGMP version
+  - Range: `1`-`3`
+  - Default value: `2`
+
+### Read-Only
+
+- `id` (String) The path of the object.
+
+## Import
+
+Import is supported using the following syntax:
+
+The [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import) can be used, for example:
+
+```shell
+terraform import iosxe_interface_igmp.example "<type>,<name>"
+```

examples/data-sources/iosxe_interface_igmp/data-source.tf

@@ -0,0 +1,4 @@
+data "iosxe_interface_igmp" "example" {
+  type = "Loopback"
+  name = "100"
+}

examples/resources/iosxe_interface_igmp/import.sh

@@ -0,0 +1 @@
+terraform import iosxe_interface_igmp.example "<type>,<name>"

examples/resources/iosxe_interface_igmp/resource.tf

@@ -0,0 +1,5 @@
+resource "iosxe_interface_igmp" "example" {
+  type    = "Loopback"
+  name    = "100"
+  version = 3
+}

gen/definitions/interface_igmp.yaml

@@ -0,0 +1,39 @@
+---
+name: Interface IGMP
+path: Cisco-IOS-XE-native:native/interface/%s=%v/ip/Cisco-IOS-XE-igmp:igmp
+augment_path: Cisco-IOS-XE-native:native/interface/GigabitEthernet=%v/ip/Cisco-IOS-XE-igmp:igmp
+no_delete: true
+doc_category: Multicast
+attributes:
+  - yang_name: type
+    tf_name: type
+    description: Interface type
+    type: String
+    reference: true
+    enum_values:
+      - FastEthernet
+      - GigabitEthernet
+      - TwoGigabitEthernet
+      - FiveGigabitEthernet
+      - TenGigabitEthernet
+      - TwentyFiveGigE
+      - FortyGigabitEthernet
+      - HundredGigE
+      - Loopback
+      - Vlan
+      - Port-channel
+      - Port-channel-subinterface/Port-channel
+      - Tunnel
+    example: Loopback
+  - yang_name: name
+    example: 100
+  - yang_name: version
+    description: IGMP version
+    default_value: 2
+    example: 3
+
+test_prerequisites:
+  - path: Cisco-IOS-XE-native:native/interface/Loopback=100
+    attributes:
+      - name: name
+        value: 100