feat: update log entry proto for backup plan for gkebackup platform l…

…ogging to include rpo_risk_level in the json payload (#7796)

PiperOrigin-RevId: 693038696
Source-Link: googleapis/googleapis@fa2a502
Source-Link: googleapis/googleapis-gen@fc0e48d
Copy-Tag: eyJwIjoiQ29tcHV0ZS8uT3dsQm90LnlhbWwiLCJoIjoiZmMwZTQ4ZDU2Y2JkOWUyNTVmZTE3NDhjYTBlMmUzNmU1MTQ5Nzk4MCJ9

chore: add types for async methods
PiperOrigin-RevId: 693215877
Source-Link: googleapis/googleapis@bb6b53e
Source-Link: googleapis/googleapis-gen@db8b5a9
Copy-Tag: eyJwIjoiQ29tcHV0ZS8uT3dsQm90LnlhbWwiLCJoIjoiZGI4YjVhOTM0ODRhZDQ0MDU1YjJiYWNjNGM3Y2Y4N2U5NzBmZTBlZCJ9

Compute/samples/V1/BackendServicesClient/list_usable.php

@@ -28,7 +28,7 @@
 use Google\Cloud\Compute\V1\BackendServicesClient;
 
 /**
- * Retrieves an aggregated list of all usable backend services in the specified project.
+ * Retrieves a list of all usable backend services in the specified project.
  *
  * @param string $project Project ID for this request.
  */

Compute/samples/V1/GlobalOperationsClient/delete.php

@@ -30,7 +30,7 @@
 /**
  * Deletes the specified Operations resource.
  *
- * @param string $operation Name of the Operations resource to delete.
+ * @param string $operation Name of the Operations resource to delete, or its unique numeric identifier.
  * @param string $project   Project ID for this request.
  */
 function delete_sample(string $operation, string $project): void

Compute/samples/V1/GlobalOperationsClient/get.php

@@ -30,7 +30,7 @@
 /**
  * Retrieves the specified Operations resource.
  *
- * @param string $operation Name of the Operations resource to return.
+ * @param string $operation Name of the Operations resource to return, or its unique numeric identifier.
  * @param string $project   Project ID for this request.
  */
 function get_sample(string $operation, string $project): void

Compute/samples/V1/GlobalOperationsClient/wait.php

@@ -30,7 +30,7 @@
 /**
  * Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method differs from the `GET` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`.
  *
- * @param string $operation Name of the Operations resource to return.
+ * @param string $operation Name of the Operations resource to return, or its unique numeric identifier.
  * @param string $project   Project ID for this request.
  */
 function wait_sample(string $operation, string $project): void

Compute/samples/V1/GlobalOrganizationOperationsClient/delete.php

@@ -30,7 +30,7 @@
 /**
  * Deletes the specified Operations resource.
  *
- * @param string $operation Name of the Operations resource to delete.
+ * @param string $operation Name of the Operations resource to delete, or its unique numeric identifier.
  */
 function delete_sample(string $operation): void
 {

Compute/samples/V1/GlobalOrganizationOperationsClient/get.php

@@ -30,7 +30,7 @@
 /**
  * Retrieves the specified Operations resource. Gets a list of operations by making a `list()` request.
  *
- * @param string $operation Name of the Operations resource to return.
+ * @param string $operation Name of the Operations resource to return, or its unique numeric identifier.
  */
 function get_sample(string $operation): void
 {

Compute/samples/V1/NetworksClient/patch.php

@@ -30,7 +30,7 @@
 use Google\Rpc\Status;
 
 /**
- * Patches the specified network with the data included in the request. Only the following fields can be modified: routingConfig.routingMode.
+ * Patches the specified network with the data included in the request. Only routingConfig can be modified.
  *
  * @param string $network Name of the network to update.
  * @param string $project Project ID for this request.

Compute/samples/V1/RegionBackendServicesClient/list_usable.php

@@ -28,7 +28,7 @@
 use Google\Cloud\Compute\V1\RegionBackendServicesClient;
 
 /**
- * Retrieves an aggregated list of all usable backend services in the specified project in the given region.
+ * Retrieves a list of all usable backend services in the specified project in the given region.
  *
  * @param string $project Project ID for this request.
  * @param string $region  Name of the region scoping this request. It must be a string that meets the requirements in RFC1035.

Compute/samples/V1/RegionOperationsClient/delete.php

@@ -30,7 +30,7 @@
 /**
  * Deletes the specified region-specific Operations resource.
  *
- * @param string $operation Name of the Operations resource to delete.
+ * @param string $operation Name of the Operations resource to delete, or its unique numeric identifier.
  * @param string $project   Project ID for this request.
  * @param string $region    Name of the region for this request.
  */

Compute/samples/V1/RegionOperationsClient/get.php

@@ -30,7 +30,7 @@
 /**
  * Retrieves the specified region-specific Operations resource.
  *
- * @param string $operation Name of the Operations resource to return.
+ * @param string $operation Name of the Operations resource to return, or its unique numeric identifier.
  * @param string $project   Project ID for this request.
  * @param string $region    Name of the region for this request.
  */

Compute/samples/V1/RegionOperationsClient/wait.php

@@ -30,7 +30,7 @@
 /**
  * Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method differs from the `GET` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`.
  *
- * @param string $operation Name of the Operations resource to return.
+ * @param string $operation Name of the Operations resource to return, or its unique numeric identifier.
  * @param string $project   Project ID for this request.
  * @param string $region    Name of the region for this request.
  */

Compute/samples/V1/RegionsClient/get.php

@@ -28,7 +28,7 @@
 use Google\Cloud\Compute\V1\RegionsClient;
 
 /**
- * Returns the specified Region resource. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request.
+ * Returns the specified Region resource. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request. This method fails if the quota information is unavailable for the region and if the organization policy constraint compute.requireBasicQuotaInResponse is enforced. This constraint, when enforced, disables the fail-open behaviour when quota information (the `items.quotas` field) is unavailable for the region. It is recommended to use the default setting for the constraint unless your application requires the fail-closed behaviour for this method.
  *
  * @param string $project Project ID for this request.
  * @param string $region  Name of the region resource to return.

Compute/samples/V1/RegionsClient/list.php

@@ -28,7 +28,7 @@
 use Google\Cloud\Compute\V1\RegionsClient;
 
 /**
- * Retrieves the list of region resources available to the specified project. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `items.quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request.
+ * Retrieves the list of region resources available to the specified project. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `items.quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request. This method fails if the quota information is unavailable for the region and if the organization policy constraint compute.requireBasicQuotaInResponse is enforced. This constraint, when enforced, disables the fail-open behaviour when quota information (the `items.quotas` field) is unavailable for the region. It is recommended to use the default setting for the constraint unless your application requires the fail-closed behaviour for this method.
  *
  * @param string $project Project ID for this request.
  */

Compute/samples/V1/StoragePoolsClient/update.php

@@ -30,7 +30,7 @@
 use Google\Rpc\Status;
 
 /**
- * Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: size_tb and provisioned_iops.
+ * Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: pool_provisioned_capacity_gb, pool_provisioned_iops and pool_provisioned_throughput.
  *
  * @param string $project     Project ID for this request.
  * @param string $storagePool The storagePool name for this request.

Compute/samples/V1/ZoneOperationsClient/delete.php

@@ -30,7 +30,7 @@
 /**
  * Deletes the specified zone-specific Operations resource.
  *
- * @param string $operation Name of the Operations resource to delete.
+ * @param string $operation Name of the Operations resource to delete, or its unique numeric identifier.
  * @param string $project   Project ID for this request.
  * @param string $zone      Name of the zone for this request.
  */

Compute/samples/V1/ZoneOperationsClient/get.php

@@ -30,7 +30,7 @@
 /**
  * Retrieves the specified zone-specific Operations resource.
  *
- * @param string $operation Name of the Operations resource to return.
+ * @param string $operation Name of the Operations resource to return, or its unique numeric identifier.
  * @param string $project   Project ID for this request.
  * @param string $zone      Name of the zone for this request.
  */

Compute/samples/V1/ZoneOperationsClient/wait.php

@@ -30,7 +30,7 @@
 /**
  * Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method waits for no more than the 2 minutes and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`.
  *
- * @param string $operation Name of the Operations resource to return.
+ * @param string $operation Name of the Operations resource to return, or its unique numeric identifier.
  * @param string $project   Project ID for this request.
  * @param string $zone      Name of the zone for this request.
  */