docs: Mark the accessApprovalRequests.list method as deprecated (#7459)

PiperOrigin-RevId: 645007312 Source-Link: googleapis/googleapis@ed2491e Source-Link: googleapis/googleapis-gen@086dd13 Copy-Tag: eyJwIjoiQ29udHJvbHNQYXJ0bmVyLy5Pd2xCb3QueWFtbCIsImgiOiIwODZkZDEzZDBlMzE4MzM1ZWRlMTE3ZTAxMDgyOTZlZDlhZWNmMWUwIn0=
googleapis · Jun 21, 2024 · 64db789 · 64db789
1 parent a203ee0
commit 64db789
Show file tree

Hide file tree

Showing 29 changed files with 116 additions and 106 deletions.
diff --git a/ControlsPartner/metadata/V1Beta/Core.php b/ControlsPartner/metadata/V1Beta/Core.php
diff --git a/ControlsPartner/samples/V1beta/CloudControlsPartnerCoreClient/get_customer.php b/ControlsPartner/samples/V1beta/CloudControlsPartnerCoreClient/get_customer.php
@@ -32,7 +32,7 @@
  * Gets details of a single customer
  *
  * @param string $formattedName Format:
- *                              organizations/{organization}/locations/{location}/customers/{customer}
+ *                              `organizations/{organization}/locations/{location}/customers/{customer}`
  *                              Please see {@see CloudControlsPartnerCoreClient::customerName()} for help formatting this field.
  */
 function get_customer_sample(string $formattedName): void

diff --git a/ControlsPartner/samples/V1beta/CloudControlsPartnerCoreClient/get_ekm_connections.php b/ControlsPartner/samples/V1beta/CloudControlsPartnerCoreClient/get_ekm_connections.php
@@ -32,7 +32,7 @@
  * Gets the EKM connections associated with a workload
  *
  * @param string $formattedName Format:
- *                              organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/ekmConnections
+ *                              `organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/ekmConnections`
  *                              Please see {@see CloudControlsPartnerCoreClient::ekmConnectionsName()} for help formatting this field.
  */
 function get_ekm_connections_sample(string $formattedName): void

diff --git a/ControlsPartner/samples/V1beta/CloudControlsPartnerCoreClient/get_partner.php b/ControlsPartner/samples/V1beta/CloudControlsPartnerCoreClient/get_partner.php
@@ -31,7 +31,8 @@
 /**
  * Get details of a Partner.
  *
- * @param string $formattedName Format: organizations/{organization}/locations/{location}/partner
+ * @param string $formattedName Format:
+ *                              `organizations/{organization}/locations/{location}/partner`
  *                              Please see {@see CloudControlsPartnerCoreClient::partnerName()} for help formatting this field.
  */
 function get_partner_sample(string $formattedName): void

diff --git a/ControlsPartner/samples/V1beta/CloudControlsPartnerCoreClient/get_partner_permissions.php b/ControlsPartner/samples/V1beta/CloudControlsPartnerCoreClient/get_partner_permissions.php
@@ -32,7 +32,7 @@
  * Gets the partner permissions granted for a workload
  *
  * @param string $formattedName Name of the resource to get in the format:
- *                              organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/partnerPermissions
+ *                              `organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/partnerPermissions`
  *                              Please see {@see CloudControlsPartnerCoreClient::partnerPermissionsName()} for help formatting this field.
  */
 function get_partner_permissions_sample(string $formattedName): void

diff --git a/ControlsPartner/samples/V1beta/CloudControlsPartnerCoreClient/get_workload.php b/ControlsPartner/samples/V1beta/CloudControlsPartnerCoreClient/get_workload.php
@@ -32,7 +32,7 @@
  * Gets details of a single workload
  *
  * @param string $formattedName Format:
- *                              organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}
+ *                              `organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}`
  *                              Please see {@see CloudControlsPartnerCoreClient::workloadName()} for help formatting this field.
  */
 function get_workload_sample(string $formattedName): void

diff --git a/...lsPartner/samples/V1beta/CloudControlsPartnerCoreClient/list_access_approval_requests.php b/...lsPartner/samples/V1beta/CloudControlsPartnerCoreClient/list_access_approval_requests.php
@@ -30,11 +30,12 @@
 use Google\Cloud\CloudControlsPartner\V1beta\ListAccessApprovalRequestsRequest;
 
 /**
- * Lists access requests associated with a workload
+ * Deprecated: Only returns access approval requests directly associated with
+ * an assured workload folder.
  *
  * @param string $formattedParent Parent resource
  *                                Format:
- *                                organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}
+ *                                `organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}`
  *                                Please see {@see CloudControlsPartnerCoreClient::workloadName()} for help formatting this field.
  */
 function list_access_approval_requests_sample(string $formattedParent): void

diff --git a/ControlsPartner/samples/V1beta/CloudControlsPartnerCoreClient/list_customers.php b/ControlsPartner/samples/V1beta/CloudControlsPartnerCoreClient/list_customers.php
@@ -33,7 +33,7 @@
  * Lists customers of a partner identified by its Google Cloud organization ID
  *
  * @param string $formattedParent Parent resource
- *                                Format: organizations/{organization}/locations/{location}
+ *                                Format: `organizations/{organization}/locations/{location}`
  *                                Please see {@see CloudControlsPartnerCoreClient::organizationLocationName()} for help formatting this field.
  */
 function list_customers_sample(string $formattedParent): void

diff --git a/ControlsPartner/samples/V1beta/CloudControlsPartnerCoreClient/list_workloads.php b/ControlsPartner/samples/V1beta/CloudControlsPartnerCoreClient/list_workloads.php
@@ -34,7 +34,7 @@
  *
  * @param string $formattedParent Parent resource
  *                                Format:
- *                                organizations/{organization}/locations/{location}/customers/{customer}
+ *                                `organizations/{organization}/locations/{location}/customers/{customer}`
  *                                Please see {@see CloudControlsPartnerCoreClient::customerName()} for help formatting this field.
  */
 function list_workloads_sample(string $formattedParent): void

diff --git a/ControlsPartner/samples/V1beta/CloudControlsPartnerMonitoringClient/get_violation.php b/ControlsPartner/samples/V1beta/CloudControlsPartnerMonitoringClient/get_violation.php
@@ -32,7 +32,7 @@
  * Gets details of a single Violation.
  *
  * @param string $formattedName Format:
- *                              organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/violations/{violation}
+ *                              `organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}/violations/{violation}`
  *                              Please see {@see CloudControlsPartnerMonitoringClient::violationName()} for help formatting this field.
  */
 function get_violation_sample(string $formattedName): void

diff --git a/ControlsPartner/samples/V1beta/CloudControlsPartnerMonitoringClient/list_violations.php b/ControlsPartner/samples/V1beta/CloudControlsPartnerMonitoringClient/list_violations.php
@@ -40,7 +40,7 @@
  *
  * @param string $formattedParent Parent resource
  *                                Format
- *                                organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}
+ *                                `organizations/{organization}/locations/{location}/customers/{customer}/workloads/{workload}`
  *                                Please see {@see CloudControlsPartnerMonitoringClient::workloadName()} for help formatting this field.
  */
 function list_violations_sample(string $formattedParent): void

diff --git a/ControlsPartner/src/V1beta/AccessApprovalRequest.php b/ControlsPartner/src/V1beta/AccessApprovalRequest.php
diff --git a/ControlsPartner/src/V1beta/Client/CloudControlsPartnerCoreClient.php b/ControlsPartner/src/V1beta/Client/CloudControlsPartnerCoreClient.php
@@ -508,7 +508,8 @@ public function getWorkload(GetWorkloadRequest $request, array $callOptions = []
     }
 
     /**
-     * Lists access requests associated with a workload
+     * Deprecated: Only returns access approval requests directly associated with
+     * an assured workload folder.
      *
      * The async variant is
      * {@see CloudControlsPartnerCoreClient::listAccessApprovalRequestsAsync()} .
@@ -530,6 +531,8 @@ public function getWorkload(GetWorkloadRequest $request, array $callOptions = []
      * @throws ApiException Thrown if the API call fails.
      *
      * @experimental
+     *
+     * @deprecated This method will be removed in the next major version update.
      */
     public function listAccessApprovalRequests(
         ListAccessApprovalRequestsRequest $request,

diff --git a/ControlsPartner/src/V1beta/Customer.php b/ControlsPartner/src/V1beta/Customer.php
diff --git a/ControlsPartner/src/V1beta/EkmConnections.php b/ControlsPartner/src/V1beta/EkmConnections.php
diff --git a/ControlsPartner/src/V1beta/GetCustomerRequest.php b/ControlsPartner/src/V1beta/GetCustomerRequest.php