docs: [google-cloud-cloudcontrolspartner] Mark the accessApprovalRequ…

…ests.list method as deprecated (#12815)

BEGIN_COMMIT_OVERRIDE
docs: Mark the accessApprovalRequests.list method as deprecated

END_COMMIT_OVERRIDE

- [ ] Regenerate this pull request now.

PiperOrigin-RevId: 645046820

Source-Link:
googleapis/googleapis@52630ea

Source-Link:
googleapis/googleapis-gen@4dec2d0
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWNsb3VkY29udHJvbHNwYXJ0bmVyLy5Pd2xCb3QueWFtbCIsImgiOiI0ZGVjMmQwZDdmZmZkY2MwZDRlN2ZmMWZjYmUxOGNkN2IzNGZjZTA5In0=

BEGIN_NESTED_COMMIT
docs: [google-cloud-cloudcontrolspartner] Mark the
accessApprovalRequests.list method as deprecated
PiperOrigin-RevId: 645007312

Source-Link:
googleapis/googleapis@ed2491e

Source-Link:
googleapis/googleapis-gen@086dd13
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWNsb3VkY29udHJvbHNwYXJ0bmVyLy5Pd2xCb3QueWFtbCIsImgiOiIwODZkZDEzZDBlMzE4MzM1ZWRlMTE3ZTAxMDgyOTZlZDlhZWNmMWUwIn0=
END_NESTED_COMMIT

---------

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

packages/google-cloud-cloudcontrolspartner/google/cloud/cloudcontrolspartner_v1/services/cloud_controls_partner_core/async_client.py

@@ -28,6 +28,7 @@
     Type,
     Union,
 )
+import warnings
 
 from google.api_core import exceptions as core_exceptions
 from google.api_core import gapic_v1
@@ -979,7 +980,8 @@ async def list_access_approval_requests(
         timeout: Union[float, object] = gapic_v1.method.DEFAULT,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> pagers.ListAccessApprovalRequestsAsyncPager:
-        r"""Lists access requests associated with a workload
+        r"""Deprecated: Only returns access approval requests
+        directly associated with an assured workload folder.
 
         .. code-block:: python
 
@@ -1034,6 +1036,11 @@ async def sample_list_access_approval_requests():
                 automatically.
 
         """
+        warnings.warn(
+            "CloudControlsPartnerCoreAsyncClient.list_access_approval_requests is deprecated",
+            DeprecationWarning,
+        )
+
         # Create or coerce a protobuf request object.
         # - Quick check: If we got a request object, we should *not* have
         #   gotten any keyword arguments that map to the request.

packages/google-cloud-cloudcontrolspartner/google/cloud/cloudcontrolspartner_v1/services/cloud_controls_partner_core/client.py

@@ -1471,7 +1471,8 @@ def list_access_approval_requests(
         timeout: Union[float, object] = gapic_v1.method.DEFAULT,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> pagers.ListAccessApprovalRequestsPager:
-        r"""Lists access requests associated with a workload
+        r"""Deprecated: Only returns access approval requests
+        directly associated with an assured workload folder.
 
         .. code-block:: python
 
@@ -1526,6 +1527,11 @@ def sample_list_access_approval_requests():
                 automatically.
 
         """
+        warnings.warn(
+            "CloudControlsPartnerCoreClient.list_access_approval_requests is deprecated",
+            DeprecationWarning,
+        )
+
         # Create or coerce a protobuf request object.
         # - Quick check: If we got a request object, we should *not* have
         #   gotten any keyword arguments that map to the request.

packages/google-cloud-cloudcontrolspartner/google/cloud/cloudcontrolspartner_v1/services/cloud_controls_partner_core/transports/grpc.py

@@ -414,7 +414,8 @@ def list_access_approval_requests(
     ]:
         r"""Return a callable for the list access approval requests method over gRPC.
 
-        Lists access requests associated with a workload
+        Deprecated: Only returns access approval requests
+        directly associated with an assured workload folder.
 
         Returns:
             Callable[[~.ListAccessApprovalRequestsRequest],

packages/google-cloud-cloudcontrolspartner/google/cloud/cloudcontrolspartner_v1/services/cloud_controls_partner_core/transports/grpc_asyncio.py

@@ -423,7 +423,8 @@ def list_access_approval_requests(
     ]:
         r"""Return a callable for the list access approval requests method over gRPC.
 
-        Lists access requests associated with a workload
+        Deprecated: Only returns access approval requests
+        directly associated with an assured workload folder.
 
         Returns:
             Callable[[~.ListAccessApprovalRequestsRequest],

packages/google-cloud-cloudcontrolspartner/google/cloud/cloudcontrolspartner_v1beta/services/cloud_controls_partner_core/async_client.py

@@ -28,6 +28,7 @@
     Type,
     Union,
 )
+import warnings
 
 from google.api_core import exceptions as core_exceptions
 from google.api_core import gapic_v1
@@ -348,8 +349,7 @@ async def sample_get_workload():
                 workload.
             name (:class:`str`):
                 Required. Format:
-
-                organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}
+                ``organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}``
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -455,10 +455,8 @@ async def sample_list_workloads():
             request (Optional[Union[google.cloud.cloudcontrolspartner_v1beta.types.ListWorkloadsRequest, dict]]):
                 The request object. Request to list customer workloads.
             parent (:class:`str`):
-                Required. Parent resource
-                Format:
-
-                organizations/{organization}/locations/{location}/customers/{customer}
+                Required. Parent resource Format:
+                ``organizations/{organization}/locations/{location}/customers/{customer}``
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -575,8 +573,7 @@ async def sample_get_customer():
                 The request object. Message for getting a customer
             name (:class:`str`):
                 Required. Format:
-
-                organizations/{organization}/locations/{location}/customers/{customer}
+                ``organizations/{organization}/locations/{location}/customers/{customer}``
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -682,9 +679,8 @@ async def sample_list_customers():
             request (Optional[Union[google.cloud.cloudcontrolspartner_v1beta.types.ListCustomersRequest, dict]]):
                 The request object. Request to list customers
             parent (:class:`str`):
-                Required. Parent resource
-                Format:
-                organizations/{organization}/locations/{location}
+                Required. Parent resource Format:
+                ``organizations/{organization}/locations/{location}``
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -802,8 +798,7 @@ async def sample_get_ekm_connections():
                 connections associated with a workload
             name (:class:`str`):
                 Required. Format:
-
-                organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/ekmConnections
+                ``organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/ekmConnections``
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -910,9 +905,8 @@ async def sample_get_partner_permissions():
                 The request object. Request for getting the partner
                 permissions granted for a workload
             name (:class:`str`):
-                Required. Name of the resource to get
-                in the format:
-                organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/partnerPermissions
+                Required. Name of the resource to get in the format:
+                ``organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/partnerPermissions``
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -986,7 +980,8 @@ async def list_access_approval_requests(
         timeout: Union[float, object] = gapic_v1.method.DEFAULT,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> pagers.ListAccessApprovalRequestsAsyncPager:
-        r"""Lists access requests associated with a workload
+        r"""Deprecated: Only returns access approval requests
+        directly associated with an assured workload folder.
 
         .. code-block:: python
 
@@ -1020,10 +1015,8 @@ async def sample_list_access_approval_requests():
                 The request object. Request for getting the access
                 requests associated with a workload.
             parent (:class:`str`):
-                Required. Parent resource
-                Format:
-
-                organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}
+                Required. Parent resource Format:
+                ``organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}``
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1043,6 +1036,11 @@ async def sample_list_access_approval_requests():
                 automatically.
 
         """
+        warnings.warn(
+            "CloudControlsPartnerCoreAsyncClient.list_access_approval_requests is deprecated",
+            DeprecationWarning,
+        )
+
         # Create or coerce a protobuf request object.
         # - Quick check: If we got a request object, we should *not* have
         #   gotten any keyword arguments that map to the request.
@@ -1144,7 +1142,7 @@ async def sample_get_partner():
                 The request object. Message for getting a Partner
             name (:class:`str`):
                 Required. Format:
-                organizations/{organization}/locations/{location}/partner
+                ``organizations/{organization}/locations/{location}/partner``
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this

packages/google-cloud-cloudcontrolspartner/google/cloud/cloudcontrolspartner_v1beta/services/cloud_controls_partner_core/client.py

@@ -858,8 +858,7 @@ def sample_get_workload():
                 workload.
             name (str):
                 Required. Format:
-
-                organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}
+                ``organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}``
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -962,10 +961,8 @@ def sample_list_workloads():
             request (Union[google.cloud.cloudcontrolspartner_v1beta.types.ListWorkloadsRequest, dict]):
                 The request object. Request to list customer workloads.
             parent (str):
-                Required. Parent resource
-                Format:
-
-                organizations/{organization}/locations/{location}/customers/{customer}
+                Required. Parent resource Format:
+                ``organizations/{organization}/locations/{location}/customers/{customer}``
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1079,8 +1076,7 @@ def sample_get_customer():
                 The request object. Message for getting a customer
             name (str):
                 Required. Format:
-
-                organizations/{organization}/locations/{location}/customers/{customer}
+                ``organizations/{organization}/locations/{location}/customers/{customer}``
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1183,9 +1179,8 @@ def sample_list_customers():
             request (Union[google.cloud.cloudcontrolspartner_v1beta.types.ListCustomersRequest, dict]):
                 The request object. Request to list customers
             parent (str):
-                Required. Parent resource
-                Format:
-                organizations/{organization}/locations/{location}
+                Required. Parent resource Format:
+                ``organizations/{organization}/locations/{location}``
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1300,8 +1295,7 @@ def sample_get_ekm_connections():
                 connections associated with a workload
             name (str):
                 Required. Format:
-
-                organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/ekmConnections
+                ``organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/ekmConnections``
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1405,9 +1399,8 @@ def sample_get_partner_permissions():
                 The request object. Request for getting the partner
                 permissions granted for a workload
             name (str):
-                Required. Name of the resource to get
-                in the format:
-                organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/partnerPermissions
+                Required. Name of the resource to get in the format:
+                ``organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/partnerPermissions``
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1478,7 +1471,8 @@ def list_access_approval_requests(
         timeout: Union[float, object] = gapic_v1.method.DEFAULT,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> pagers.ListAccessApprovalRequestsPager:
-        r"""Lists access requests associated with a workload
+        r"""Deprecated: Only returns access approval requests
+        directly associated with an assured workload folder.
 
         .. code-block:: python
 
@@ -1512,10 +1506,8 @@ def sample_list_access_approval_requests():
                 The request object. Request for getting the access
                 requests associated with a workload.
             parent (str):
-                Required. Parent resource
-                Format:
-
-                organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}
+                Required. Parent resource Format:
+                ``organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}``
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1535,6 +1527,11 @@ def sample_list_access_approval_requests():
                 automatically.
 
         """
+        warnings.warn(
+            "CloudControlsPartnerCoreClient.list_access_approval_requests is deprecated",
+            DeprecationWarning,
+        )
+
         # Create or coerce a protobuf request object.
         # - Quick check: If we got a request object, we should *not* have
         #   gotten any keyword arguments that map to the request.
@@ -1635,7 +1632,7 @@ def sample_get_partner():
                 The request object. Message for getting a Partner
             name (str):
                 Required. Format:
-                organizations/{organization}/locations/{location}/partner
+                ``organizations/{organization}/locations/{location}/partner``
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this

packages/google-cloud-cloudcontrolspartner/google/cloud/cloudcontrolspartner_v1beta/services/cloud_controls_partner_core/transports/grpc.py

@@ -414,7 +414,8 @@ def list_access_approval_requests(
     ]:
         r"""Return a callable for the list access approval requests method over gRPC.
 
-        Lists access requests associated with a workload
+        Deprecated: Only returns access approval requests
+        directly associated with an assured workload folder.
 
         Returns:
             Callable[[~.ListAccessApprovalRequestsRequest],

packages/google-cloud-cloudcontrolspartner/google/cloud/cloudcontrolspartner_v1beta/services/cloud_controls_partner_core/transports/grpc_asyncio.py

@@ -423,7 +423,8 @@ def list_access_approval_requests(
     ]:
         r"""Return a callable for the list access approval requests method over gRPC.
 
-        Lists access requests associated with a workload
+        Deprecated: Only returns access approval requests
+        directly associated with an assured workload folder.
 
         Returns:
             Callable[[~.ListAccessApprovalRequestsRequest],

packages/google-cloud-cloudcontrolspartner/google/cloud/cloudcontrolspartner_v1beta/services/cloud_controls_partner_monitoring/async_client.py

@@ -327,9 +327,8 @@ async def sample_list_violations():
                 The request object. Message for requesting list of
                 Violations
             parent (:class:`str`):
-                Required. Parent resource
-                Format
-                organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}
+                Required. Parent resource Format
+                ``organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}``
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -446,8 +445,7 @@ async def sample_get_violation():
                 The request object. Message for getting a Violation
             name (:class:`str`):
                 Required. Format:
-
-                organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/violations/{violation}
+                ``organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/violations/{violation}``
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this

packages/google-cloud-cloudcontrolspartner/google/cloud/cloudcontrolspartner_v1beta/services/cloud_controls_partner_monitoring/client.py

@@ -755,9 +755,8 @@ def sample_list_violations():
                 The request object. Message for requesting list of
                 Violations
             parent (str):
-                Required. Parent resource
-                Format
-                organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}
+                Required. Parent resource Format
+                ``organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}``
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -871,8 +870,7 @@ def sample_get_violation():
                 The request object. Message for getting a Violation
             name (str):
                 Required. Format:
-
-                organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/violations/{violation}
+                ``organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/violations/{violation}``
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this

packages/google-cloud-cloudcontrolspartner/google/cloud/cloudcontrolspartner_v1beta/types/access_approval_requests.py

@@ -37,7 +37,7 @@ class AccessApprovalRequest(proto.Message):
     Attributes:
         name (str):
             Identifier. Format:
-            organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/accessApprovalRequests/{access_approval_request}.
+            ``organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/accessApprovalRequests/{access_approval_request}``
         request_time (google.protobuf.timestamp_pb2.Timestamp):
             The time at which approval was requested.
         requested_reason (google.cloud.cloudcontrolspartner_v1beta.types.AccessReason):
@@ -77,10 +77,8 @@ class ListAccessApprovalRequestsRequest(proto.Message):
 
     Attributes:
         parent (str):
-            Required. Parent resource
-            Format:
-
-            organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}
+            Required. Parent resource Format:
+            ``organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}``
         page_size (int):
             Optional. The maximum number of access
             requests to return. The service may return fewer