feat: add inital BGP peer-template support

Author: Jeremy Spencer

CHANGELOG.md

@@ -7,6 +7,7 @@
 - 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)
+- Add `iosxe_bgp_template_peer_policy` resource
 
 ## 0.9.3
 
@@ -21,7 +22,7 @@
 - Add `passive_interface_disable_*` attributes to `iosxe_ospf` and `iosxe_ospf_vrf` resources and data sources
 - Fix issue with destroying `iosxe_interface_ethernet` resources
 - Change route target attributes of `iosxe_vrf` from type "List" to "Set"
-- Add `role_based_enforcement` attributes to `iosxe_cts` 
+- Add `role_based_enforcement` attributes to `iosxe_cts`
 - Add `tftp_source_interface_*` attributes to `iosxe_system` resource and data source
 - Add `hash` attribute to `iosxe_crypto_pki` resource and data source
 - Add `snooping_information_option`, `snooping_information_option_allow_untrusted` and `snooping_information_option_format_remote_id_string` attributes to `iosxe_dhcp` resource and data source
@@ -66,7 +67,7 @@
 - Add `level`, `list_name`, `action_type`, `broadcast`, `group_broadcast`, `group_logger`, `group1_group`, `group2_group`, `group3_group`, `group4_group`, `name`, `default`, `none`, `start_stop_broadcast`, `start_stop_logger`, `start_stop_group1`, `start_stop_group2`, `start_stop_group3`, `start_stop_group4`, `stop_only_broadcast`, `stop_only_logger`, `stop_only_group1`, `stop_only_group2`, `stop_only_group3`, `stop_only_group4`, `wait_start_broadcast`, `wait_start_logger`, `wait_start_group1`, `wait_start_group2`, `wait_start_group3`, `wait_start_group4`, `name`, `none`, `start_stop_broadcast`, `start_stop_logger`, `start_stop_group1`, `start_stop_group2`, `start_stop_group3`, `start_stop_group4`, `stop_only_broadcast`, `stop_only_logger`, `stop_only_group1`, `stop_only_group2`, `stop_only_group3`, `stop_only_group4`, `wait_start_broadcast`, `wait_start_logger`, `wait_start_group1`, `wait_start_group2`, `wait_start_group3`, and `wait_start_group4` attributes to `iosxe_aaa_accounting` resource and data source
 - Add `enable_default_group1_cache`, `enable_default_group1_enable`, `enable_default_group1_group`, `enable_default_group1_line`, `enable_default_group1_none`, `enable_default_group2_cache`, `enable_default_group2_enable`, `enable_default_group2_group`, `enable_default_group2_line`, `enable_default_group2_none`, `enable_default_group3_cache`, `enable_default_group3_enable`, `enable_default_group3_group`, `enable_default_group3_line`, `enable_default_group3_none`, `enable_default_group4_cache`, `enable_default_group4_enable`, `enable_default_group4_group`, `enable_default_group4_line`, and `enable_default_group4_none` attributes to `iosxe_aaa_authentication` resource and data source
 - Add `level`, `list_name`, `a1_group`, `a1_local`, `a1_if_authenticated`, `a1_none`, `a1_radius`, `a1_tacacs`, `a2_group`, `a2_local`, `a2_if_authenticated`, `a2_none`, `a2_radius`, `a2_tacacs`, `a3_group`, `a3_local`, `a3_if_authenticated`, `a3_none`, `a3_radius`, `a3_tacacs`, `a4_group`, `a4_local`, `a4_if_authenticated`, `a4_none`, `a4_radius`, `a4_tacacs`, `name`, `group1_cache`, `group1_group`, `group1_radius`, and `group1_tacacs` attributes to `iosxe_aaa_authorization` resource and data source
-- Add `vrf`, `local_authentication_type`, `local_authorization`, and `local_auth_max_fail_attempts` attributes to `iosxe_aaa` resrouce and data source 
+- Add `vrf`, `local_authentication_type`, `local_authorization`, and `local_auth_max_fail_attempts` attributes to `iosxe_aaa` resrouce and data source
 - Add `icmp_named_msg_type`, `destination_port_equal_2`, `destination_port_equal_3`, `destination_port_equal_4`, `destination_port_equal_5`, `destination_port_equal_6`, `destination_port_equal_7`, `destination_port_equal_8`, `destination_port_equal_9`, `destination_port_equal_10`, `icmp_msg_type`, and `icmp_msg_code` attributes to `iosxe_access_list_extended` resource and data source
 - Add `iosxe_access_list_role_based` resource and data source
 - Add `filter_lists_cdp` attribute to `iosxe_device_sensor` resource and data source

docs/data-sources/bgp_template_peer_policy.md

@@ -0,0 +1,49 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "iosxe_bgp_template_peer_policy Data Source - terraform-provider-iosxe"
+subcategory: "BGP"
+description: |-
+  This data source can read the BGP Template Peer Policy configuration.
+---
+
+# iosxe_bgp_template_peer_policy (Data Source)
+
+This data source can read the BGP Template Peer Policy configuration.
+
+## Example Usage
+
+```terraform
+data "iosxe_bgp_template_peer_policy" "example" {
+  asn  = "65000"
+  name = "PEERPOLICY_1"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `asn` (String)
+- `name` (String)
+
+### Optional
+
+- `device` (String) A device name from the provider configuration.
+
+### Read-Only
+
+- `allowas_in_as_number` (Number)
+- `as_override_split_horizon` (Boolean)
+- `id` (String) The path of the retrieved object.
+- `route_maps` (Attributes List) Apply route map to neighbor (see [below for nested schema](#nestedatt--route_maps))
+- `route_reflector_client` (Boolean) Configure a neighbor as Route Reflector client
+- `send_community` (String)
+
+<a id="nestedatt--route_maps"></a>
+### Nested Schema for `route_maps`
+
+Read-Only:
+
+- `in_out` (String)
+- `route_map_name` (String)

docs/guides/changelog.md

@@ -16,6 +16,7 @@ description: |-
 - 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)
+- Add `iosxe_bgp_template_peer_policy` resource
 
 ## 0.9.3
 
@@ -30,7 +31,7 @@ description: |-
 - Add `passive_interface_disable_*` attributes to `iosxe_ospf` and `iosxe_ospf_vrf` resources and data sources
 - Fix issue with destroying `iosxe_interface_ethernet` resources
 - Change route target attributes of `iosxe_vrf` from type "List" to "Set"
-- Add `role_based_enforcement` attributes to `iosxe_cts` 
+- Add `role_based_enforcement` attributes to `iosxe_cts`
 - Add `tftp_source_interface_*` attributes to `iosxe_system` resource and data source
 - Add `hash` attribute to `iosxe_crypto_pki` resource and data source
 - Add `snooping_information_option`, `snooping_information_option_allow_untrusted` and `snooping_information_option_format_remote_id_string` attributes to `iosxe_dhcp` resource and data source
@@ -75,7 +76,7 @@ description: |-
 - Add `level`, `list_name`, `action_type`, `broadcast`, `group_broadcast`, `group_logger`, `group1_group`, `group2_group`, `group3_group`, `group4_group`, `name`, `default`, `none`, `start_stop_broadcast`, `start_stop_logger`, `start_stop_group1`, `start_stop_group2`, `start_stop_group3`, `start_stop_group4`, `stop_only_broadcast`, `stop_only_logger`, `stop_only_group1`, `stop_only_group2`, `stop_only_group3`, `stop_only_group4`, `wait_start_broadcast`, `wait_start_logger`, `wait_start_group1`, `wait_start_group2`, `wait_start_group3`, `wait_start_group4`, `name`, `none`, `start_stop_broadcast`, `start_stop_logger`, `start_stop_group1`, `start_stop_group2`, `start_stop_group3`, `start_stop_group4`, `stop_only_broadcast`, `stop_only_logger`, `stop_only_group1`, `stop_only_group2`, `stop_only_group3`, `stop_only_group4`, `wait_start_broadcast`, `wait_start_logger`, `wait_start_group1`, `wait_start_group2`, `wait_start_group3`, and `wait_start_group4` attributes to `iosxe_aaa_accounting` resource and data source
 - Add `enable_default_group1_cache`, `enable_default_group1_enable`, `enable_default_group1_group`, `enable_default_group1_line`, `enable_default_group1_none`, `enable_default_group2_cache`, `enable_default_group2_enable`, `enable_default_group2_group`, `enable_default_group2_line`, `enable_default_group2_none`, `enable_default_group3_cache`, `enable_default_group3_enable`, `enable_default_group3_group`, `enable_default_group3_line`, `enable_default_group3_none`, `enable_default_group4_cache`, `enable_default_group4_enable`, `enable_default_group4_group`, `enable_default_group4_line`, and `enable_default_group4_none` attributes to `iosxe_aaa_authentication` resource and data source
 - Add `level`, `list_name`, `a1_group`, `a1_local`, `a1_if_authenticated`, `a1_none`, `a1_radius`, `a1_tacacs`, `a2_group`, `a2_local`, `a2_if_authenticated`, `a2_none`, `a2_radius`, `a2_tacacs`, `a3_group`, `a3_local`, `a3_if_authenticated`, `a3_none`, `a3_radius`, `a3_tacacs`, `a4_group`, `a4_local`, `a4_if_authenticated`, `a4_none`, `a4_radius`, `a4_tacacs`, `name`, `group1_cache`, `group1_group`, `group1_radius`, and `group1_tacacs` attributes to `iosxe_aaa_authorization` resource and data source
-- Add `vrf`, `local_authentication_type`, `local_authorization`, and `local_auth_max_fail_attempts` attributes to `iosxe_aaa` resrouce and data source 
+- Add `vrf`, `local_authentication_type`, `local_authorization`, and `local_auth_max_fail_attempts` attributes to `iosxe_aaa` resrouce and data source
 - Add `icmp_named_msg_type`, `destination_port_equal_2`, `destination_port_equal_3`, `destination_port_equal_4`, `destination_port_equal_5`, `destination_port_equal_6`, `destination_port_equal_7`, `destination_port_equal_8`, `destination_port_equal_9`, `destination_port_equal_10`, `icmp_msg_type`, and `icmp_msg_code` attributes to `iosxe_access_list_extended` resource and data source
 - Add `iosxe_access_list_role_based` resource and data source
 - Add `filter_lists_cdp` attribute to `iosxe_device_sensor` resource and data source
@@ -351,4 +352,3 @@ description: |-
 ## 0.1.0
 
 - Initial release
-

docs/resources/bgp_template_peer_policy.md

@@ -0,0 +1,71 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "iosxe_bgp_template_peer_policy Resource - terraform-provider-iosxe"
+subcategory: "BGP"
+description: |-
+  This resource can manage the BGP Template Peer Policy configuration.
+---
+
+# iosxe_bgp_template_peer_policy (Resource)
+
+This resource can manage the BGP Template Peer Policy configuration.
+
+## Example Usage
+
+```terraform
+resource "iosxe_bgp_template_peer_policy" "example" {
+  asn                    = "65000"
+  name                   = "PEERPOLICY_1"
+  route_reflector_client = true
+  send_community         = "both"
+  route_maps = [
+    {
+      in_out         = "in"
+      route_map_name = "ROUTEMAP_1"
+    }
+  ]
+  allowas_in_as_number      = 2
+  as_override_split_horizon = true
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `asn` (String)
+- `name` (String)
+
+### Optional
+
+- `allowas_in_as_number` (Number) - Range: `1`-`10`
+- `as_override_split_horizon` (Boolean)
+- `delete_mode` (String) Configure behavior when deleting/destroying the resource. Either delete the entire object (YANG container) being managed, or only delete the individual resource attributes configured explicitly and leave everything else as-is. Default value is `all`.
+  - Choices: `all`, `attributes`
+- `device` (String) A device name from the provider configuration.
+- `route_maps` (Attributes List) Apply route map to neighbor (see [below for nested schema](#nestedatt--route_maps))
+- `route_reflector_client` (Boolean) Configure a neighbor as Route Reflector client
+- `send_community` (String) - Choices: `both`, `extended`, `standard`
+
+### Read-Only
+
+- `id` (String) The path of the object.
+
+<a id="nestedatt--route_maps"></a>
+### Nested Schema for `route_maps`
+
+Required:
+
+- `in_out` (String) - Choices: `in`, `out`
+- `route_map_name` (String)
+
+## 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_bgp_template_peer_policy.example "<asn>,<name>"
+```

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

@@ -0,0 +1,4 @@
+data "iosxe_bgp_template_peer_policy" "example" {
+  asn  = "65000"
+  name = "PEERPOLICY_1"
+}

examples/resources/iosxe_bgp_template_peer_policy/import.sh

@@ -0,0 +1 @@
+terraform import iosxe_bgp_template_peer_policy.example "<asn>,<name>"

examples/resources/iosxe_bgp_template_peer_policy/resource.tf

@@ -0,0 +1,14 @@
+resource "iosxe_bgp_template_peer_policy" "example" {
+  asn                    = "65000"
+  name                   = "PEERPOLICY_1"
+  route_reflector_client = true
+  send_community         = "both"
+  route_maps = [
+    {
+      in_out         = "in"
+      route_map_name = "ROUTEMAP_1"
+    }
+  ]
+  allowas_in_as_number      = 2
+  as_override_split_horizon = true
+}

gen/definitions/bgp_template_peer_policy.yaml

@@ -0,0 +1,42 @@
+---
+name: BGP Template Peer Policy
+path: Cisco-IOS-XE-native:native/router/Cisco-IOS-XE-bgp:bgp=%v/template/peer-policy=%v
+doc_category: BGP
+attributes:
+  - yang_name: id
+    yang_scope: bgp
+    tf_name: asn
+    example: 65000
+  - yang_name: name
+    yang_scope: peer-policy
+    example: PEERPOLICY_1
+  - yang_name: route-reflector-client
+    example: true
+  - yang_name: send-community/send-community-where
+    tf_name: send_community
+    example: both
+  - yang_name: route-map1
+    type: List
+    tf_name: route_maps
+    attributes:
+      - yang_name: inout
+        tf_name: in_out
+        id: true
+        example: in
+      - yang_name: route-map-name
+        example: ROUTEMAP_1
+  - yang_name: allowas-in/as-number
+    tf_name: allowas_in_as_number
+    example: 2
+  - yang_name: as-override/split-horizon
+    tf_name: as_override_split_horizon
+    example: true
+test_prerequisites:
+  - path: Cisco-IOS-XE-native:native/router/Cisco-IOS-XE-bgp:bgp=65000
+    attributes:
+      - name: id
+        value: 65000
+  - path: Cisco-IOS-XE-native:native/route-map=ROUTEMAP_1
+    attributes:
+      - name: name
+        value: ROUTEMAP_1