[ignore] Update the tenant_policies_endpoint_mac_tag_policy resource example and add resource comments

Author: sajagana

examples/tenant_policies_endpoint_mac_tag_policy/main.tf

@@ -31,12 +31,12 @@ resource "mso_schema_template_vrf" "tf_vrf" {
   name         = "tf_vrf"
   display_name = "tf_vrf"
   schema_id    = mso_schema.tf_schema.id
-  template     = "tf_template"
+  template     = one(mso_schema.tf_schema.template).name
 }
 
 resource "mso_schema_template_bd" "tf_bd" {
   schema_id              = mso_schema.tf_schema.id
-  template_name          = "tf_template"
+  template_name          = one(mso_schema.tf_schema.template).name
   name                   = "tf_bd"
   display_name           = "tf_bd"
   layer2_unknown_unicast = "proxy"

mso/datasource_mso_tenant_policies_endpoint_mac_tag_policy.go

@@ -84,6 +84,7 @@ func dataSourceMSOEndpointMACTagPolicyRead(d *schema.ResourceData, m interface{}
 	bdUUID := d.Get("bd_uuid").(string)
 	vrfUUID := d.Get("vrf_uuid").(string)
 
+	// Either 'bd_uuid' or 'vrf_uuid' must be specified to format the data source ID.
 	if bdUUID == "" && vrfUUID == "" {
 		return fmt.Errorf("Either 'bd_uuid' or 'vrf_uuid' must be specified to use Endpoint MAC Tag Policy Data Source")
 	}

mso/resource_mso_tenant_policies_endpoint_mac_tag_policy.go

@@ -195,6 +195,7 @@ func resourceMSOEndpointMACTagPolicyCreate(d *schema.ResourceData, m interface{}
 
 	templateId := d.Get("template_id").(string)
 
+	// Ignoring the input validation since the API returns a clear error when bd_uuid and vrf_uuid are not provided.
 	bdUUID := d.Get("bd_uuid").(string)
 	vrfUUID := d.Get("vrf_uuid").(string)
 
@@ -296,6 +297,7 @@ func resourceMSOEndpointMACTagPolicyUpdate(d *schema.ResourceData, m interface{}
 
 	if d.HasChange("bd_uuid") {
 		if bdUUID, ok := d.GetOk("bd_uuid"); ok && bdUUID.(string) != "" {
+			// Remove vrfRef if bd_uuid is being set, since both cannot coexist and NDO does not remove it automatically when bdRef is added
 			err := addPatchPayloadToContainer(payloadCont, "remove", fmt.Sprintf("%s/vrfRef", updatePath), nil)
 			if err != nil {
 				return err
@@ -311,6 +313,7 @@ func resourceMSOEndpointMACTagPolicyUpdate(d *schema.ResourceData, m interface{}
 
 	if d.HasChange("vrf_uuid") {
 		if vrfUUID, ok := d.GetOk("vrf_uuid"); ok && vrfUUID.(string) != "" {
+			// Remove bdRef if vrf_uuid is being set, since both cannot coexist and NDO does not remove it automatically when vrfRef is added
 			err := addPatchPayloadToContainer(payloadCont, "remove", fmt.Sprintf("%s/bdRef", updatePath), nil)
 			if err != nil {
 				return err