feat: Added support for retriggering notifications in AlertPolicy (#560)

* docs: Minor formatting
chore: Update gapic-generator-python to v1.11.5
build: Update rules_python to 0.24.0

PiperOrigin-RevId: 563436317

Source-Link: googleapis/googleapis@42fd37b

Source-Link: googleapis/googleapis-gen@280264c
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMjgwMjY0Y2EwMmZiOTMxNmI0MjM3YTk2ZDBhZjFhMjM0M2E4MWE1NiJ9

* 🦉 Updates from OwlBot post-processor

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

* 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: googleapis/googleapis-gen@b282e01
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYjI4MmUwMTJkYjBmMDAzNmJmZjIyMzAwZDNmYzEwMWQyNThiYWNhNyJ9

* 🦉 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>

packages/google-cloud-monitoring/google/cloud/monitoring_v3/services/alert_policy_service/async_client.py

@@ -499,6 +499,11 @@ async def create_alert_policy(
     ) -> alert.AlertPolicy:
         r"""Creates a new alerting policy.
 
+        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.
+
         .. code-block:: python
 
             # This snippet has been automatically generated and should be regarded as a
@@ -629,6 +634,11 @@ async def delete_alert_policy(
     ) -> None:
         r"""Deletes an alerting policy.
 
+        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.
+
         .. code-block:: python
 
             # This snippet has been automatically generated and should be regarded as a
@@ -737,6 +747,11 @@ async def update_alert_policy(
         current alerting policy by specifying the fields to be updated
         via ``updateMask``. Returns the updated alerting policy.
 
+        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.
+
         .. code-block:: python
 
             # This snippet has been automatically generated and should be regarded as a

packages/google-cloud-monitoring/google/cloud/monitoring_v3/services/alert_policy_service/client.py

@@ -718,6 +718,11 @@ def create_alert_policy(
     ) -> alert.AlertPolicy:
         r"""Creates a new alerting policy.
 
+        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.
+
         .. code-block:: python
 
             # This snippet has been automatically generated and should be regarded as a
@@ -848,6 +853,11 @@ def delete_alert_policy(
     ) -> None:
         r"""Deletes an alerting policy.
 
+        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.
+
         .. code-block:: python
 
             # This snippet has been automatically generated and should be regarded as a
@@ -947,6 +957,11 @@ def update_alert_policy(
         current alerting policy by specifying the fields to be updated
         via ``updateMask``. Returns the updated alerting policy.
 
+        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.
+
         .. code-block:: python
 
             # This snippet has been automatically generated and should be regarded as a

packages/google-cloud-monitoring/google/cloud/monitoring_v3/services/alert_policy_service/transports/grpc.py

@@ -303,6 +303,11 @@ def create_alert_policy(
 
         Creates a new alerting policy.
 
+        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.
+
         Returns:
             Callable[[~.CreateAlertPolicyRequest],
                     ~.AlertPolicy]:
@@ -329,6 +334,11 @@ def delete_alert_policy(
 
         Deletes an alerting policy.
 
+        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.
+
         Returns:
             Callable[[~.DeleteAlertPolicyRequest],
                     ~.Empty]:
@@ -358,6 +368,11 @@ def update_alert_policy(
         current alerting policy by specifying the fields to be updated
         via ``updateMask``. Returns the updated alerting policy.
 
+        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.
+
         Returns:
             Callable[[~.UpdateAlertPolicyRequest],
                     ~.AlertPolicy]:

packages/google-cloud-monitoring/google/cloud/monitoring_v3/services/alert_policy_service/transports/grpc_asyncio.py

@@ -308,6 +308,11 @@ def create_alert_policy(
 
         Creates a new alerting policy.
 
+        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.
+
         Returns:
             Callable[[~.CreateAlertPolicyRequest],
                     Awaitable[~.AlertPolicy]]:
@@ -334,6 +339,11 @@ def delete_alert_policy(
 
         Deletes an alerting policy.
 
+        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.
+
         Returns:
             Callable[[~.DeleteAlertPolicyRequest],
                     Awaitable[~.Empty]]:
@@ -365,6 +375,11 @@ def update_alert_policy(
         current alerting policy by specifying the fields to be updated
         via ``updateMask``. Returns the updated alerting policy.
 
+        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.
+
         Returns:
             Callable[[~.UpdateAlertPolicyRequest],
                     Awaitable[~.AlertPolicy]]:

packages/google-cloud-monitoring/google/cloud/monitoring_v3/services/notification_channel_service/async_client.py

@@ -513,8 +513,10 @@ async def list_notification_channels(
         timeout: Union[float, object] = gapic_v1.method.DEFAULT,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> pagers.ListNotificationChannelsAsyncPager:
-        r"""Lists the notification channels that have been
-        created for the project.
+        r"""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.
 
         .. code-block:: python
 
@@ -782,6 +784,12 @@ async def create_notification_channel(
         single notification endpoint such as an email address,
         SMS number, or PagerDuty service.
 
+        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.
+
         .. code-block:: python
 
             # This snippet has been automatically generated and should be regarded as a
@@ -913,6 +921,12 @@ async def update_notification_channel(
         r"""Updates a notification channel. Fields not specified
         in the field mask remain unchanged.
 
+        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.
+
         .. code-block:: python
 
             # This snippet has been automatically generated and should be regarded as a
@@ -1033,6 +1047,12 @@ async def delete_notification_channel(
     ) -> None:
         r"""Deletes a notification channel.
 
+        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.
+
         .. code-block:: python
 
             # This snippet has been automatically generated and should be regarded as a

packages/google-cloud-monitoring/google/cloud/monitoring_v3/services/notification_channel_service/client.py

@@ -733,8 +733,10 @@ def list_notification_channels(
         timeout: Union[float, object] = gapic_v1.method.DEFAULT,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> pagers.ListNotificationChannelsPager:
-        r"""Lists the notification channels that have been
-        created for the project.
+        r"""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.
 
         .. code-block:: python
 
@@ -988,6 +990,12 @@ def create_notification_channel(
         single notification endpoint such as an email address,
         SMS number, or PagerDuty service.
 
+        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.
+
         .. code-block:: python
 
             # This snippet has been automatically generated and should be regarded as a
@@ -1123,6 +1131,12 @@ def update_notification_channel(
         r"""Updates a notification channel. Fields not specified
         in the field mask remain unchanged.
 
+        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.
+
         .. code-block:: python
 
             # This snippet has been automatically generated and should be regarded as a
@@ -1247,6 +1261,12 @@ def delete_notification_channel(
     ) -> None:
         r"""Deletes a notification channel.
 
+        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.
+
         .. code-block:: python
 
             # This snippet has been automatically generated and should be regarded as a

packages/google-cloud-monitoring/google/cloud/monitoring_v3/services/notification_channel_service/transports/grpc.py

@@ -309,8 +309,10 @@ def list_notification_channels(
     ]:
         r"""Return a callable for the list notification channels method over gRPC.
 
-        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.
 
         Returns:
             Callable[[~.ListNotificationChannelsRequest],
@@ -378,6 +380,12 @@ def create_notification_channel(
         single notification endpoint such as an email address,
         SMS number, or PagerDuty service.
 
+        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.
+
         Returns:
             Callable[[~.CreateNotificationChannelRequest],
                     ~.NotificationChannel]:
@@ -408,6 +416,12 @@ def update_notification_channel(
         Updates a notification channel. Fields not specified
         in the field mask remain unchanged.
 
+        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.
+
         Returns:
             Callable[[~.UpdateNotificationChannelRequest],
                     ~.NotificationChannel]:
@@ -436,6 +450,12 @@ def delete_notification_channel(
 
         Deletes a notification channel.
 
+        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.
+
         Returns:
             Callable[[~.DeleteNotificationChannelRequest],
                     ~.Empty]:

packages/google-cloud-monitoring/google/cloud/monitoring_v3/services/notification_channel_service/transports/grpc_asyncio.py

@@ -314,8 +314,10 @@ def list_notification_channels(
     ]:
         r"""Return a callable for the list notification channels method over gRPC.
 
-        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.
 
         Returns:
             Callable[[~.ListNotificationChannelsRequest],
@@ -383,6 +385,12 @@ def create_notification_channel(
         single notification endpoint such as an email address,
         SMS number, or PagerDuty service.
 
+        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.
+
         Returns:
             Callable[[~.CreateNotificationChannelRequest],
                     Awaitable[~.NotificationChannel]]:
@@ -413,6 +421,12 @@ def update_notification_channel(
         Updates a notification channel. Fields not specified
         in the field mask remain unchanged.
 
+        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.
+
         Returns:
             Callable[[~.UpdateNotificationChannelRequest],
                     Awaitable[~.NotificationChannel]]:
@@ -442,6 +456,12 @@ def delete_notification_channel(
 
         Deletes a notification channel.
 
+        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.
+
         Returns:
             Callable[[~.DeleteNotificationChannelRequest],
                     Awaitable[~.Empty]]: