Add support for links in Monitoring AlertPolicy (#11017) (#18549)

[upstream:c8d4f427e148d0c1a72869183303e787d8d93b08]

Signed-off-by: Modular Magician <[email protected]>

Author: modular-magician

.changelog/11017.txt

@@ -920,15 +920,35 @@ limited capacity might not show this documentation.`,
 The content may not exceed 8,192 Unicode characters and may not
 exceed more than 10,240 bytes when encoded in UTF-8 format,
 whichever is smaller.`,
-							AtLeastOneOf: []string{"documentation.0.content", "documentation.0.mime_type", "documentation.0.subject"},
+							AtLeastOneOf: []string{"documentation.0.content", "documentation.0.mime_type", "documentation.0.subject", "documentation.0.links"},
+						},
+						"links": {
+							Type:        schema.TypeList,
+							Optional:    true,
+							Description: `Links to content such as playbooks, repositories, and other resources. This field can contain up to 3 entries.`,
+							Elem: &schema.Resource{
+								Schema: map[string]*schema.Schema{
+									"display_name": {
+										Type:        schema.TypeString,
+										Optional:    true,
+										Description: `A short display name for the link. The display name must not be empty or exceed 63 characters. Example: "playbook".`,
+									},
+									"url": {
+										Type:        schema.TypeString,
+										Optional:    true,
+										Description: `The url of a webpage. A url can be templatized by using variables in the path or the query parameters. The total length of a URL should not exceed 2083 characters before and after variable expansion. Example: "https://my_domain.com/playbook?name=${resource.name}".`,
+									},
+								},
+							},
+							AtLeastOneOf: []string{"documentation.0.content", "documentation.0.mime_type", "documentation.0.subject", "documentation.0.links"},
 						},
 						"mime_type": {
 							Type:     schema.TypeString,
 							Optional: true,
 							Description: `The format of the content field. Presently, only the value
 "text/markdown" is supported.`,
 							Default:      "text/markdown",
-							AtLeastOneOf: []string{"documentation.0.content", "documentation.0.mime_type", "documentation.0.subject"},
+							AtLeastOneOf: []string{"documentation.0.content", "documentation.0.mime_type", "documentation.0.subject", "documentation.0.links"},
 						},
 						"subject": {
 							Type:     schema.TypeString,
@@ -937,7 +957,7 @@ whichever is smaller.`,
 exceed 10,240 bytes. In notifications generated by this policy the contents
 of the subject line after variable expansion will be truncated to 255 bytes
 or shorter at the latest UTF-8 character boundary.`,
-							AtLeastOneOf: []string{"documentation.0.content", "documentation.0.mime_type", "documentation.0.subject"},
+							AtLeastOneOf: []string{"documentation.0.content", "documentation.0.mime_type", "documentation.0.subject", "documentation.0.links"},
 						},
 					},
 				},
@@ -2049,6 +2069,8 @@ func flattenMonitoringAlertPolicyDocumentation(v interface{}, d *schema.Resource
 		flattenMonitoringAlertPolicyDocumentationMimeType(original["mimeType"], d, config)
 	transformed["subject"] =
 		flattenMonitoringAlertPolicyDocumentationSubject(original["subject"], d, config)
+	transformed["links"] =
+		flattenMonitoringAlertPolicyDocumentationLinks(original["links"], d, config)
 	return []interface{}{transformed}
 }
 func flattenMonitoringAlertPolicyDocumentationContent(v interface{}, d *schema.ResourceData, config *transport_tpg.Config) interface{} {
@@ -2063,6 +2085,33 @@ func flattenMonitoringAlertPolicyDocumentationSubject(v interface{}, d *schema.R
 	return v
 }
 
+func flattenMonitoringAlertPolicyDocumentationLinks(v interface{}, d *schema.ResourceData, config *transport_tpg.Config) interface{} {
+	if v == nil {
+		return v
+	}
+	l := v.([]interface{})
+	transformed := make([]interface{}, 0, len(l))
+	for _, raw := range l {
+		original := raw.(map[string]interface{})
+		if len(original) < 1 {
+			// Do not include empty json objects coming back from the api
+			continue
+		}
+		transformed = append(transformed, map[string]interface{}{
+			"display_name": flattenMonitoringAlertPolicyDocumentationLinksDisplayName(original["displayName"], d, config),
+			"url":          flattenMonitoringAlertPolicyDocumentationLinksUrl(original["url"], d, config),
+		})
+	}
+	return transformed
+}
+func flattenMonitoringAlertPolicyDocumentationLinksDisplayName(v interface{}, d *schema.ResourceData, config *transport_tpg.Config) interface{} {
+	return v
+}
+
+func flattenMonitoringAlertPolicyDocumentationLinksUrl(v interface{}, d *schema.ResourceData, config *transport_tpg.Config) interface{} {
+	return v
+}
+
 func expandMonitoringAlertPolicyDisplayName(v interface{}, d tpgresource.TerraformResourceData, config *transport_tpg.Config) (interface{}, error) {
 	return v, nil
 }
@@ -2927,6 +2976,13 @@ func expandMonitoringAlertPolicyDocumentation(v interface{}, d tpgresource.Terra
 		transformed["subject"] = transformedSubject
 	}
 
+	transformedLinks, err := expandMonitoringAlertPolicyDocumentationLinks(original["links"], d, config)
+	if err != nil {
+		return nil, err
+	} else if val := reflect.ValueOf(transformedLinks); val.IsValid() && !tpgresource.IsEmptyValue(val) {
+		transformed["links"] = transformedLinks
+	}
+
 	return transformed, nil
 }
 
@@ -2941,3 +2997,40 @@ func expandMonitoringAlertPolicyDocumentationMimeType(v interface{}, d tpgresour
 func expandMonitoringAlertPolicyDocumentationSubject(v interface{}, d tpgresource.TerraformResourceData, config *transport_tpg.Config) (interface{}, error) {
 	return v, nil
 }
+
+func expandMonitoringAlertPolicyDocumentationLinks(v interface{}, d tpgresource.TerraformResourceData, config *transport_tpg.Config) (interface{}, error) {
+	l := v.([]interface{})
+	req := make([]interface{}, 0, len(l))
+	for _, raw := range l {
+		if raw == nil {
+			continue
+		}
+		original := raw.(map[string]interface{})
+		transformed := make(map[string]interface{})
+
+		transformedDisplayName, err := expandMonitoringAlertPolicyDocumentationLinksDisplayName(original["display_name"], d, config)
+		if err != nil {
+			return nil, err
+		} else if val := reflect.ValueOf(transformedDisplayName); val.IsValid() && !tpgresource.IsEmptyValue(val) {
+			transformed["displayName"] = transformedDisplayName
+		}
+
+		transformedUrl, err := expandMonitoringAlertPolicyDocumentationLinksUrl(original["url"], d, config)
+		if err != nil {
+			return nil, err
+		} else if val := reflect.ValueOf(transformedUrl); val.IsValid() && !tpgresource.IsEmptyValue(val) {
+			transformed["url"] = transformedUrl
+		}
+
+		req = append(req, transformed)
+	}
+	return req, nil
+}
+
+func expandMonitoringAlertPolicyDocumentationLinksDisplayName(v interface{}, d tpgresource.TerraformResourceData, config *transport_tpg.Config) (interface{}, error) {
+	return v, nil
+}
+
+func expandMonitoringAlertPolicyDocumentationLinksUrl(v interface{}, d tpgresource.TerraformResourceData, config *transport_tpg.Config) (interface{}, error) {
+	return v, nil
+}

google/services/monitoring/resource_monitoring_alert_policy.go

@@ -331,6 +331,10 @@ resource "google_monitoring_alert_policy" "full" {
     content   = "test content"
     mime_type = "text/markdown"
     subject = "test subject"
+    links {
+        display_name = "link display name"
+        url = "http://mydomain.com"
+    }
   }
 }
 `, alertName, conditionName1, conditionName2)
@@ -362,6 +366,14 @@ resource "google_monitoring_alert_policy" "mql" {
     content   = "test content"
     mime_type = "text/markdown"
     subject = "test subject"
+    links {
+        display_name = "link display name"
+        url = "http://mydomain.com"
+    }
+    links {
+        display_name = "link display name2"
+        url = "http://mydomain2.com"
+    }
   }
 }
 `, alertName, conditionName)
@@ -397,7 +409,7 @@ resource "google_monitoring_alert_policy" "log" {
   documentation {
     content   = "test content"
     mime_type = "text/markdown"
-    subject = "test subject"    
+    subject = "test subject"
   }
 }
 `, alertName, conditionName)
@@ -459,6 +471,10 @@ resource "google_monitoring_alert_policy" "promql" {
     content   = "test content"
     mime_type = "text/markdown"
     subject = "test subject"
+    links {
+        display_name = "link display name"
+        url = "http://mydomain.com"
+    }
   }
 }
 `, alertName, conditionName)

google/services/monitoring/resource_monitoring_alert_policy_test.go

@@ -943,6 +943,22 @@ The following arguments are supported:
   of the subject line after variable expansion will be truncated to 255 bytes
   or shorter at the latest UTF-8 character boundary.
 
+* `links` -
+  (Optional)
+  Links to content such as playbooks, repositories, and other resources. This field can contain up to 3 entries.
+  Structure is [documented below](#nested_links).
+
+
+<a name="nested_links"></a>The `links` block supports:
+
+* `display_name` -
+  (Optional)
+  A short display name for the link. The display name must not be empty or exceed 63 characters. Example: "playbook".
+
+* `url` -
+  (Optional)
+  The url of a webpage. A url can be templatized by using variables in the path or the query parameters. The total length of a URL should not exceed 2083 characters before and after variable expansion. Example: "https://my_domain.com/playbook?name=${resource.name}".
+
 ## Attributes Reference
 
 In addition to the arguments listed above, the following computed attributes are exported: