feat(monitoring): update the API

#### monitoring:v1

The following keys were changed:
- schemas.MosaicLayout.properties.columns.description

#### monitoring:v3

The following keys were added:
- schemas.AlertStrategy.properties.notificationPrompts.description
- schemas.AlertStrategy.properties.notificationPrompts.items.enum
- schemas.AlertStrategy.properties.notificationPrompts.items.enumDescriptions
- schemas.AlertStrategy.properties.notificationPrompts.items.type
- schemas.AlertStrategy.properties.notificationPrompts.type

The following keys were changed:
- schemas.AlertPolicy.description
- schemas.AlertPolicy.properties.alertStrategy.description
- schemas.AlertPolicy.properties.severity.description
- schemas.AlertPolicy.properties.validity.description
- schemas.AlertStrategy.properties.autoClose.description
- schemas.AlertStrategy.properties.notificationRateLimit.description
- schemas.Condition.properties.conditionSql.description
- schemas.Daily.properties.periodicity.description
- schemas.Hourly.properties.minuteOffset.description
- schemas.Hourly.properties.periodicity.description
- schemas.Minutes.properties.periodicity.description
- schemas.MonitoringQueryLanguageCondition.description
- schemas.NotificationRateLimit.description
- schemas.PrometheusQueryLanguageCondition.description
- schemas.SqlCondition.description
- schemas.SqlCondition.properties.query.description
- schemas.TimeOfDay.properties.hours.description
- schemas.TimeOfDay.properties.minutes.description
- schemas.TimeOfDay.properties.nanos.description
- schemas.TimeOfDay.properties.seconds.description

Author: yoshi-automation

discovery/monitoring-v1.json

@@ -753,7 +753,7 @@
       }
     }
   },
-  "revision": "20240929",
+  "revision": "20241003",
   "rootUrl": "https://monitoring.googleapis.com/",
   "schemas": {
     "Aggregation": {
@@ -1800,7 +1800,7 @@
       "id": "MosaicLayout",
       "properties": {
         "columns": {
-          "description": "The number of columns in the mosaic grid. The number of columns must be between 1 and 12, inclusive.",
+          "description": "The number of columns in the mosaic grid. The number of columns must be between 1 and 48, inclusive.",
           "format": "int32",
           "type": "integer"
         },

discovery/monitoring-v3.json

@@ -2715,7 +2715,7 @@
       }
     }
   },
-  "revision": "20240929",
+  "revision": "20241003",
   "rootUrl": "https://monitoring.googleapis.com/",
   "schemas": {
     "Aggregation": {
@@ -2820,12 +2820,12 @@
       "type": "object"
     },
     "AlertPolicy": {
-      "description": "A description of the conditions under which some aspect of your system is considered to be \"unhealthy\" and the ways to notify people or services about this state. For an overview of alert policies, see Introduction to Alerting (https://cloud.google.com/monitoring/alerts/).",
+      "description": "A description of the conditions under which some aspect of your system is considered to be \"unhealthy\" and the ways to notify people or services about this state. For an overview of alerting policies, see Introduction to Alerting (https://cloud.google.com/monitoring/alerts/).",
       "id": "AlertPolicy",
       "properties": {
         "alertStrategy": {
           "$ref": "AlertStrategy",
-          "description": "Control over how this alert policy's notification channels are notified."
+          "description": "Control over how this alerting policy's notification channels are notified."
         },
         "combiner": {
           "description": "How to combine the results of multiple conditions to determine if an incident should be opened. If condition_time_series_query_language is present, this must be COMBINE_UNSPECIFIED.",
@@ -2882,7 +2882,7 @@
           "type": "array"
         },
         "severity": {
-          "description": "Optional. The severity of an alert policy indicates how important incidents generated by that policy are. The severity level will be displayed on the Incident detail page and in notifications.",
+          "description": "Optional. The severity of an alerting policy indicates how important incidents generated by that policy are. The severity level will be displayed on the Incident detail page and in notifications.",
           "enum": [
             "SEVERITY_UNSPECIFIED",
             "CRITICAL",
@@ -2906,7 +2906,7 @@
         },
         "validity": {
           "$ref": "Status",
-          "description": "Read-only description of how the alert policy is invalid. This field is only set when the alert policy is invalid. An invalid alert policy will not generate incidents."
+          "description": "Read-only description of how the alerting policy is invalid. This field is only set when the alerting policy is invalid. An invalid alerting policy will not generate incidents."
         }
       },
       "type": "object"
@@ -2916,7 +2916,7 @@
       "id": "AlertStrategy",
       "properties": {
         "autoClose": {
-          "description": "If an alert policy that was active has no data for this long, any open incidents will close",
+          "description": "If an alerting policy that was active has no data for this long, any open incidents will close",
           "format": "google-duration",
           "type": "string"
         },
@@ -2927,9 +2927,26 @@
           },
           "type": "array"
         },
+        "notificationPrompts": {
+          "description": "For log-based alert policies, the notification prompts is always OPENED. For non log-based alert policies, the notification prompts can be OPENED or OPENED, CLOSED.",
+          "items": {
+            "enum": [
+              "NOTIFICATION_PROMPT_UNSPECIFIED",
+              "OPENED",
+              "CLOSED"
+            ],
+            "enumDescriptions": [
+              "No strategy specified. Treated as error.",
+              "Notify when an incident is opened.",
+              "Notify when an incident is closed."
+            ],
+            "type": "string"
+          },
+          "type": "array"
+        },
         "notificationRateLimit": {
           "$ref": "NotificationRateLimit",
-          "description": "Required for log-based alert policies, i.e. policies with a LogMatch condition.This limit is not implemented for alert policies that do not have a LogMatch condition."
+          "description": "Required for log-based alerting policies, i.e. policies with a LogMatch condition.This limit is not implemented for alerting policies that do not have a LogMatch condition."
         }
       },
       "type": "object"
@@ -3256,7 +3273,7 @@
         },
         "conditionSql": {
           "$ref": "SqlCondition",
-          "description": "A condition that uses SQL to define alerts in Logs Analytics."
+          "description": "A condition that periodically evaluates a SQL query result."
         },
         "conditionThreshold": {
           "$ref": "MetricThreshold",
@@ -3417,7 +3434,7 @@
           "description": "Optional. The time of day (in UTC) at which the query should run. If left unspecified, the server picks an arbitrary time of day and runs the query at the same time each day."
         },
         "periodicity": {
-          "description": "Required. LINT.IfChange The number of days between runs. Must be greater than or equal to 1 day and less than or equal to 31 days. LINT.ThenChange(//depot/google3/cloud/monitoring/api/alerts/policy_validation.cc)",
+          "description": "Required. The number of days between runs. Must be greater than or equal to 1 day and less than or equal to 31 days.",
           "format": "int32",
           "type": "integer"
         }
@@ -3890,12 +3907,12 @@
       "id": "Hourly",
       "properties": {
         "minuteOffset": {
-          "description": "Optional. LINT.IfChange The number of minutes after the hour (in UTC) to run the query. Must be between 0 and 59 inclusive. If left unspecified, then an arbitrary offset is used. LINT.ThenChange(//depot/google3/cloud/monitoring/api/alerts/policy_validation.cc)",
+          "description": "Optional. The number of minutes after the hour (in UTC) to run the query. Must be greater than or equal to 0 minutes and less than or equal to 59 minutes. If left unspecified, then an arbitrary offset is used.",
           "format": "int32",
           "type": "integer"
         },
         "periodicity": {
-          "description": "Required. LINT.IfChange The number of hours between runs. Must be greater than or equal to 1 hour and less than or equal to 48 hours. LINT.ThenChange(//depot/google3/cloud/monitoring/api/alerts/policy_validation.cc)",
+          "description": "Required. The number of hours between runs. Must be greater than or equal to 1 hour and less than or equal to 48 hours.",
           "format": "int32",
           "type": "integer"
         }
@@ -4797,7 +4814,7 @@
       "id": "Minutes",
       "properties": {
         "periodicity": {
-          "description": "Required. LINT.IfChange Number of minutes between runs. The interval must be between 5 minutes and 1440 minutes. LINT.ThenChange(//depot/google3/cloud/monitoring/api/alerts/policy_validation.cc)",
+          "description": "Required. Number of minutes between runs. The interval must be greater than or equal to 5 minutes and less than or equal to 1440 minutes.",
           "format": "int32",
           "type": "integer"
         }
@@ -4899,7 +4916,7 @@
       "type": "object"
     },
     "MonitoringQueryLanguageCondition": {
-      "description": "A condition type that allows alert policies to be defined using Monitoring Query Language (https://cloud.google.com/monitoring/mql).",
+      "description": "A condition type that allows alerting policies to be defined using Monitoring Query Language (https://cloud.google.com/monitoring/mql).",
       "id": "MonitoringQueryLanguageCondition",
       "properties": {
         "duration": {
@@ -5108,7 +5125,7 @@
       "type": "object"
     },
     "NotificationRateLimit": {
-      "description": "Control over the rate of notifications sent to this alert policy's notification channels.",
+      "description": "Control over the rate of notifications sent to this alerting policy's notification channels.",
       "id": "NotificationRateLimit",
       "properties": {
         "period": {
@@ -5239,7 +5256,7 @@
       "type": "object"
     },
     "PrometheusQueryLanguageCondition": {
-      "description": "A condition type that allows alert policies to be defined using Prometheus Query Language (PromQL) (https://prometheus.io/docs/prometheus/latest/querying/basics/).The PrometheusQueryLanguageCondition message contains information from a Prometheus alerting rule and its associated rule group.A Prometheus alerting rule is described here (https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/). The semantics of a Prometheus alerting rule is described here (https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/#rule).A Prometheus rule group is described here (https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/). The semantics of a Prometheus rule group is described here (https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/#rule_group).Because Cloud Alerting has no representation of a Prometheus rule group resource, we must embed the information of the parent rule group inside each of the conditions that refer to it. We must also update the contents of all Prometheus alerts in case the information of their rule group changes.The PrometheusQueryLanguageCondition protocol buffer combines the information of the corresponding rule group and alerting rule. The structure of the PrometheusQueryLanguageCondition protocol buffer does NOT mimic the structure of the Prometheus rule group and alerting rule YAML declarations. The PrometheusQueryLanguageCondition protocol buffer may change in the future to support future rule group and/or alerting rule features. There are no new such features at the present time (2023-06-26).",
+      "description": "A condition type that allows alerting policies to be defined using Prometheus Query Language (PromQL) (https://prometheus.io/docs/prometheus/latest/querying/basics/).The PrometheusQueryLanguageCondition message contains information from a Prometheus alerting rule and its associated rule group.A Prometheus alerting rule is described here (https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/). The semantics of a Prometheus alerting rule is described here (https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/#rule).A Prometheus rule group is described here (https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/). The semantics of a Prometheus rule group is described here (https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/#rule_group).Because Cloud Alerting has no representation of a Prometheus rule group resource, we must embed the information of the parent rule group inside each of the conditions that refer to it. We must also update the contents of all Prometheus alerts in case the information of their rule group changes.The PrometheusQueryLanguageCondition protocol buffer combines the information of the corresponding rule group and alerting rule. The structure of the PrometheusQueryLanguageCondition protocol buffer does NOT mimic the structure of the Prometheus rule group and alerting rule YAML declarations. The PrometheusQueryLanguageCondition protocol buffer may change in the future to support future rule group and/or alerting rule features. There are no new such features at the present time (2023-06-26).",
       "id": "PrometheusQueryLanguageCondition",
       "properties": {
         "alertRule": {
@@ -5670,7 +5687,7 @@
       "type": "object"
     },
     "SqlCondition": {
-      "description": "A condition that allows alert policies to be defined using GoogleSQL. SQL conditions examine a sliding window of logs using GoogleSQL. Alert policies with SQL conditions may incur additional billing.",
+      "description": "A condition that allows alerting policies to be defined using GoogleSQL. SQL conditions examine a sliding window of logs using GoogleSQL. Alert policies with SQL conditions may incur additional billing.",
       "id": "SqlCondition",
       "properties": {
         "booleanTest": {
@@ -5690,7 +5707,7 @@
           "description": "Schedule the query to execute every so many minutes."
         },
         "query": {
-          "description": "Required. The Log Analytics SQL query to run, as a string. The query must conform to the required shape. Specifically, the query must not try to filter the input by time. A filter will automatically be applied to filter the input so that the query receives all rows received since the last time the query was run.E.g. Extract all log entries containing an HTTP request:SELECT timestamp, log_name, severity, http_request, resource, labels FROM my-project.global._Default._AllLogs WHERE http_request IS NOT NULL",
+          "description": "Required. The Log Analytics SQL query to run, as a string. The query must conform to the required shape. Specifically, the query must not try to filter the input by time. A filter will automatically be applied to filter the input so that the query receives all rows received since the last time the query was run.For example, the following query extracts all log entries containing an HTTP request:SELECT timestamp, log_name, severity, http_request, resource, labels FROM my-project.global._Default._AllLogs WHERE http_request IS NOT NULL",
           "type": "string"
         },
         "rowCountTest": {
@@ -5787,22 +5804,22 @@
       "id": "TimeOfDay",
       "properties": {
         "hours": {
-          "description": "Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.",
+          "description": "Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.",
           "format": "int32",
           "type": "integer"
         },
         "minutes": {
-          "description": "Minutes of hour of day. Must be from 0 to 59.",
+          "description": "Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.",
           "format": "int32",
           "type": "integer"
         },
         "nanos": {
-          "description": "Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.",
+          "description": "Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.",
           "format": "int32",
           "type": "integer"
         },
         "seconds": {
-          "description": "Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.",
+          "description": "Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.",
           "format": "int32",
           "type": "integer"
         }