feat: [monitoring] Added support for retriggering notifications in AlertPolicy (#9823)

* feat: Added support for retriggering notifications in AlertPolicy
feat: Added support for forecast options in AlertPolicy
feat: Added support for promQL condition type in AlertPolicy

PiperOrigin-RevId: 564411592

Source-Link: googleapis/googleapis@babab51

Source-Link: https://github.com/googleapis/googleapis-gen/commit/b282e012db0f0036bff22300d3fc101d258baca7
Copy-Tag: eyJwIjoiamF2YS1tb25pdG9yaW5nLy5Pd2xCb3QueWFtbCIsImgiOiJiMjgyZTAxMmRiMGYwMDM2YmZmMjIzMDBkM2ZjMTAxZDI1OGJhY2E3In0=

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

java-monitoring/google-cloud-monitoring/src/main/java/com/google/cloud/monitoring/v3/AlertPolicyServiceClient.java

@@ -556,6 +556,10 @@ public final UnaryCallable<GetAlertPolicyRequest, AlertPolicy> getAlertPolicyCal
   /**
    * Creates a new alerting policy.
    *
+   * <p>Design your application to single-thread API calls that modify the state of alerting
+   * policies in a single project. This includes calls to CreateAlertPolicy, DeleteAlertPolicy and
+   * UpdateAlertPolicy.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -598,6 +602,10 @@ public final AlertPolicy createAlertPolicy(ResourceName name, AlertPolicy alertP
   /**
    * Creates a new alerting policy.
    *
+   * <p>Design your application to single-thread API calls that modify the state of alerting
+   * policies in a single project. This includes calls to CreateAlertPolicy, DeleteAlertPolicy and
+   * UpdateAlertPolicy.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -640,6 +648,10 @@ public final AlertPolicy createAlertPolicy(OrganizationName name, AlertPolicy al
   /**
    * Creates a new alerting policy.
    *
+   * <p>Design your application to single-thread API calls that modify the state of alerting
+   * policies in a single project. This includes calls to CreateAlertPolicy, DeleteAlertPolicy and
+   * UpdateAlertPolicy.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -682,6 +694,10 @@ public final AlertPolicy createAlertPolicy(ProjectName name, AlertPolicy alertPo
   /**
    * Creates a new alerting policy.
    *
+   * <p>Design your application to single-thread API calls that modify the state of alerting
+   * policies in a single project. This includes calls to CreateAlertPolicy, DeleteAlertPolicy and
+   * UpdateAlertPolicy.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -721,6 +737,10 @@ public final AlertPolicy createAlertPolicy(String name, AlertPolicy alertPolicy)
   /**
    * Creates a new alerting policy.
    *
+   * <p>Design your application to single-thread API calls that modify the state of alerting
+   * policies in a single project. This includes calls to CreateAlertPolicy, DeleteAlertPolicy and
+   * UpdateAlertPolicy.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -750,6 +770,10 @@ public final AlertPolicy createAlertPolicy(CreateAlertPolicyRequest request) {
   /**
    * Creates a new alerting policy.
    *
+   * <p>Design your application to single-thread API calls that modify the state of alerting
+   * policies in a single project. This includes calls to CreateAlertPolicy, DeleteAlertPolicy and
+   * UpdateAlertPolicy.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -779,6 +803,10 @@ public final UnaryCallable<CreateAlertPolicyRequest, AlertPolicy> createAlertPol
   /**
    * Deletes an alerting policy.
    *
+   * <p>Design your application to single-thread API calls that modify the state of alerting
+   * policies in a single project. This includes calls to CreateAlertPolicy, DeleteAlertPolicy and
+   * UpdateAlertPolicy.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -811,6 +839,10 @@ public final void deleteAlertPolicy(AlertPolicyName name) {
   /**
    * Deletes an alerting policy.
    *
+   * <p>Design your application to single-thread API calls that modify the state of alerting
+   * policies in a single project. This includes calls to CreateAlertPolicy, DeleteAlertPolicy and
+   * UpdateAlertPolicy.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -840,6 +872,10 @@ public final void deleteAlertPolicy(String name) {
   /**
    * Deletes an alerting policy.
    *
+   * <p>Design your application to single-thread API calls that modify the state of alerting
+   * policies in a single project. This includes calls to CreateAlertPolicy, DeleteAlertPolicy and
+   * UpdateAlertPolicy.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -870,6 +906,10 @@ public final void deleteAlertPolicy(DeleteAlertPolicyRequest request) {
   /**
    * Deletes an alerting policy.
    *
+   * <p>Design your application to single-thread API calls that modify the state of alerting
+   * policies in a single project. This includes calls to CreateAlertPolicy, DeleteAlertPolicy and
+   * UpdateAlertPolicy.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -902,6 +942,10 @@ public final UnaryCallable<DeleteAlertPolicyRequest, Empty> deleteAlertPolicyCal
    * only certain fields in the current alerting policy by specifying the fields to be updated via
    * `updateMask`. Returns the updated alerting policy.
    *
+   * <p>Design your application to single-thread API calls that modify the state of alerting
+   * policies in a single project. This includes calls to CreateAlertPolicy, DeleteAlertPolicy and
+   * UpdateAlertPolicy.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -952,6 +996,10 @@ public final AlertPolicy updateAlertPolicy(FieldMask updateMask, AlertPolicy ale
    * only certain fields in the current alerting policy by specifying the fields to be updated via
    * `updateMask`. Returns the updated alerting policy.
    *
+   * <p>Design your application to single-thread API calls that modify the state of alerting
+   * policies in a single project. This includes calls to CreateAlertPolicy, DeleteAlertPolicy and
+   * UpdateAlertPolicy.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -983,6 +1031,10 @@ public final AlertPolicy updateAlertPolicy(UpdateAlertPolicyRequest request) {
    * only certain fields in the current alerting policy by specifying the fields to be updated via
    * `updateMask`. Returns the updated alerting policy.
    *
+   * <p>Design your application to single-thread API calls that modify the state of alerting
+   * policies in a single project. This includes calls to CreateAlertPolicy, DeleteAlertPolicy and
+   * UpdateAlertPolicy.
+   *
    * <p>Sample code:
    *
    * <pre>{@code

java-monitoring/google-cloud-monitoring/src/main/java/com/google/cloud/monitoring/v3/NotificationChannelServiceClient.java

@@ -620,7 +620,8 @@ public final NotificationChannelDescriptor getNotificationChannelDescriptor(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Lists the notification channels that have been created for the project.
+   * Lists the notification channels that have been created for the project. To list the types of
+   * notification channels that are supported, use the `ListNotificationChannelDescriptors` method.
    *
    * <p>Sample code:
    *
@@ -659,7 +660,8 @@ public final ListNotificationChannelsPagedResponse listNotificationChannels(Reso
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Lists the notification channels that have been created for the project.
+   * Lists the notification channels that have been created for the project. To list the types of
+   * notification channels that are supported, use the `ListNotificationChannelDescriptors` method.
    *
    * <p>Sample code:
    *
@@ -699,7 +701,8 @@ public final ListNotificationChannelsPagedResponse listNotificationChannels(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Lists the notification channels that have been created for the project.
+   * Lists the notification channels that have been created for the project. To list the types of
+   * notification channels that are supported, use the `ListNotificationChannelDescriptors` method.
    *
    * <p>Sample code:
    *
@@ -738,7 +741,8 @@ public final ListNotificationChannelsPagedResponse listNotificationChannels(Proj
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Lists the notification channels that have been created for the project.
+   * Lists the notification channels that have been created for the project. To list the types of
+   * notification channels that are supported, use the `ListNotificationChannelDescriptors` method.
    *
    * <p>Sample code:
    *
@@ -775,7 +779,8 @@ public final ListNotificationChannelsPagedResponse listNotificationChannels(Stri
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Lists the notification channels that have been created for the project.
+   * Lists the notification channels that have been created for the project. To list the types of
+   * notification channels that are supported, use the `ListNotificationChannelDescriptors` method.
    *
    * <p>Sample code:
    *
@@ -812,7 +817,8 @@ public final ListNotificationChannelsPagedResponse listNotificationChannels(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Lists the notification channels that have been created for the project.
+   * Lists the notification channels that have been created for the project. To list the types of
+   * notification channels that are supported, use the `ListNotificationChannelDescriptors` method.
    *
    * <p>Sample code:
    *
@@ -850,7 +856,8 @@ public final ListNotificationChannelsPagedResponse listNotificationChannels(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Lists the notification channels that have been created for the project.
+   * Lists the notification channels that have been created for the project. To list the types of
+   * notification channels that are supported, use the `ListNotificationChannelDescriptors` method.
    *
    * <p>Sample code:
    *
@@ -1039,6 +1046,10 @@ public final NotificationChannel getNotificationChannel(GetNotificationChannelRe
    * Creates a new notification channel, representing a single notification endpoint such as an
    * email address, SMS number, or PagerDuty service.
    *
+   * <p>Design your application to single-thread API calls that modify the state of notification
+   * channels in a single project. This includes calls to CreateNotificationChannel,
+   * DeleteNotificationChannel and UpdateNotificationChannel.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -1081,6 +1092,10 @@ public final NotificationChannel createNotificationChannel(
    * Creates a new notification channel, representing a single notification endpoint such as an
    * email address, SMS number, or PagerDuty service.
    *
+   * <p>Design your application to single-thread API calls that modify the state of notification
+   * channels in a single project. This includes calls to CreateNotificationChannel,
+   * DeleteNotificationChannel and UpdateNotificationChannel.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -1123,6 +1138,10 @@ public final NotificationChannel createNotificationChannel(
    * Creates a new notification channel, representing a single notification endpoint such as an
    * email address, SMS number, or PagerDuty service.
    *
+   * <p>Design your application to single-thread API calls that modify the state of notification
+   * channels in a single project. This includes calls to CreateNotificationChannel,
+   * DeleteNotificationChannel and UpdateNotificationChannel.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -1165,6 +1184,10 @@ public final NotificationChannel createNotificationChannel(
    * Creates a new notification channel, representing a single notification endpoint such as an
    * email address, SMS number, or PagerDuty service.
    *
+   * <p>Design your application to single-thread API calls that modify the state of notification
+   * channels in a single project. This includes calls to CreateNotificationChannel,
+   * DeleteNotificationChannel and UpdateNotificationChannel.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -1207,6 +1230,10 @@ public final NotificationChannel createNotificationChannel(
    * Creates a new notification channel, representing a single notification endpoint such as an
    * email address, SMS number, or PagerDuty service.
    *
+   * <p>Design your application to single-thread API calls that modify the state of notification
+   * channels in a single project. This includes calls to CreateNotificationChannel,
+   * DeleteNotificationChannel and UpdateNotificationChannel.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -1240,6 +1267,10 @@ public final NotificationChannel createNotificationChannel(
    * Creates a new notification channel, representing a single notification endpoint such as an
    * email address, SMS number, or PagerDuty service.
    *
+   * <p>Design your application to single-thread API calls that modify the state of notification
+   * channels in a single project. This includes calls to CreateNotificationChannel,
+   * DeleteNotificationChannel and UpdateNotificationChannel.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -1271,6 +1302,10 @@ public final NotificationChannel createNotificationChannel(
   /**
    * Updates a notification channel. Fields not specified in the field mask remain unchanged.
    *
+   * <p>Design your application to single-thread API calls that modify the state of notification
+   * channels in a single project. This includes calls to CreateNotificationChannel,
+   * DeleteNotificationChannel and UpdateNotificationChannel.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -1309,6 +1344,10 @@ public final NotificationChannel updateNotificationChannel(
   /**
    * Updates a notification channel. Fields not specified in the field mask remain unchanged.
    *
+   * <p>Design your application to single-thread API calls that modify the state of notification
+   * channels in a single project. This includes calls to CreateNotificationChannel,
+   * DeleteNotificationChannel and UpdateNotificationChannel.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -1341,6 +1380,10 @@ public final NotificationChannel updateNotificationChannel(
   /**
    * Updates a notification channel. Fields not specified in the field mask remain unchanged.
    *
+   * <p>Design your application to single-thread API calls that modify the state of notification
+   * channels in a single project. This includes calls to CreateNotificationChannel,
+   * DeleteNotificationChannel and UpdateNotificationChannel.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -1372,6 +1415,10 @@ public final NotificationChannel updateNotificationChannel(
   /**
    * Deletes a notification channel.
    *
+   * <p>Design your application to single-thread API calls that modify the state of notification
+   * channels in a single project. This includes calls to CreateNotificationChannel,
+   * DeleteNotificationChannel and UpdateNotificationChannel.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -1411,6 +1458,10 @@ public final void deleteNotificationChannel(NotificationChannelName name, boolea
   /**
    * Deletes a notification channel.
    *
+   * <p>Design your application to single-thread API calls that modify the state of notification
+   * channels in a single project. This includes calls to CreateNotificationChannel,
+   * DeleteNotificationChannel and UpdateNotificationChannel.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -1448,6 +1499,10 @@ public final void deleteNotificationChannel(String name, boolean force) {
   /**
    * Deletes a notification channel.
    *
+   * <p>Design your application to single-thread API calls that modify the state of notification
+   * channels in a single project. This includes calls to CreateNotificationChannel,
+   * DeleteNotificationChannel and UpdateNotificationChannel.
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -1481,6 +1536,10 @@ public final void deleteNotificationChannel(DeleteNotificationChannelRequest req
   /**
    * Deletes a notification channel.
    *
+   * <p>Design your application to single-thread API calls that modify the state of notification
+   * channels in a single project. This includes calls to CreateNotificationChannel,
+   * DeleteNotificationChannel and UpdateNotificationChannel.
+   *
    * <p>Sample code:
    *
    * <pre>{@code