feat: Add support to add links in AlertPolicy

Google APIs · copybara-github · commit 1e76b7210188 · 2024-06-17T07:51:53.000-07:00
PiperOrigin-RevId: 644006298
diff --git a/google/monitoring/v3/alert.proto b/google/monitoring/v3/alert.proto
@@ -49,6 +49,20 @@ message AlertPolicy {
   // Documentation that is included in the notifications and incidents
   // pertaining to this policy.
   message Documentation {
+    // Links to content such as playbooks, repositories, and other resources.
+    message Link {
+      // A short display name for the link. The display name must not be empty
+      // or exceed 63 characters. Example: "playbook".
+      string display_name = 1;
+
+      // 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}"
+      string url = 2;
+    }
+
     // The body of the documentation, interpreted according to `mime_type`.
     // 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
@@ -75,6 +89,10 @@ message AlertPolicy {
     // If this field is missing or empty, a default subject line will be
     // generated.
     string subject = 3 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. Links to content such as playbooks, repositories, and other
+    // resources. This field can contain up to 3 entries.
+    repeated Link links = 4 [(google.api.field_behavior) = OPTIONAL];
   }
 
   // A condition is a true/false test that determines when an alerting policy
