Regenerate workstations client (#8365)

Generated in GitHub action: https://togithub.com/googleapis/googleapis/google-api-php-client-services/actions/workflows/codegen.yaml

Author: yoshi-code-bot

src/CloudWorkstations/Resource/ProjectsLocations.php

@@ -46,11 +46,16 @@ public function get($name, $optParams = [])
   }
   /**
    * Lists information about the supported locations for this service. This method
-   * can be called in two ways: * **List all public locations:** Use the path `GET
-   * /v1/locations`. * **List project-visible locations:** Use the path `GET
-   * /v1/projects/{project_id}/locations`. This may include public locations as
-   * well as private or other locations specifically visible to the project.
-   * (locations.listProjectsLocations)
+   * lists locations based on the resource scope provided in the
+   * [ListLocationsRequest.name] field: * **Global locations**: If `name` is
+   * empty, the method lists the public locations available to all projects. *
+   * **Project-specific locations**: If `name` follows the format
+   * `projects/{project}`, the method lists locations visible to that specific
+   * project. This includes public, private, or other project-specific locations
+   * enabled for the project. For gRPC and client library implementations, the
+   * resource name is passed as the `name` field. For direct service calls, the
+   * resource name is incorporated into the request path based on the specific
+   * service implementation and version. (locations.listProjectsLocations)
    *
    * @param string $name The resource that owns the locations collection, if
    * applicable.

src/CloudWorkstations/Resource/ProjectsLocationsWorkstationClusters.php

@@ -39,7 +39,7 @@ class ProjectsLocationsWorkstationClusters extends \Google\Service\Resource
    * @param array $optParams Optional parameters.
    *
    * @opt_param bool validateOnly Optional. If set, validate the request and
-   * preview the review, but do not actually apply it.
+   * preview the result, but do not actually apply it.
    * @opt_param string workstationClusterId Required. ID to use for the
    * workstation cluster.
    * @return Operation
@@ -65,7 +65,7 @@ public function create($parent, WorkstationCluster $postBody, $optParams = [])
    * request only works if the workstation cluster has no configurations or
    * workstations.
    * @opt_param bool validateOnly Optional. If set, validate the request and
-   * preview the review, but do not apply it.
+   * preview the result, but do not apply it.
    * @return Operation
    * @throws \Google\Service\Exception
    */
@@ -123,7 +123,7 @@ public function listProjectsLocationsWorkstationClusters($parent, $optParams = [
    * @opt_param string updateMask Required. Mask that specifies which fields in
    * the workstation cluster should be updated.
    * @opt_param bool validateOnly Optional. If set, validate the request and
-   * preview the review, but do not actually apply it.
+   * preview the result, but do not actually apply it.
    * @return Operation
    * @throws \Google\Service\Exception
    */

src/CloudWorkstations/Resource/ProjectsLocationsWorkstationClustersWorkstationConfigs.php

@@ -44,7 +44,7 @@ class ProjectsLocationsWorkstationClustersWorkstationConfigs extends \Google\Ser
    * @param array $optParams Optional parameters.
    *
    * @opt_param bool validateOnly Optional. If set, validate the request and
-   * preview the review, but do not actually apply it.
+   * preview the result, but do not actually apply it.
    * @opt_param string workstationConfigId Required. ID to use for the workstation
    * configuration.
    * @return Operation
@@ -70,7 +70,7 @@ public function create($parent, WorkstationConfig $postBody, $optParams = [])
    * configuration are also deleted. Otherwise, the request works only if the
    * workstation configuration has no workstations.
    * @opt_param bool validateOnly Optional. If set, validate the request and
-   * preview the review, but do not actually apply it.
+   * preview the result, but do not actually apply it.
    * @return Operation
    * @throws \Google\Service\Exception
    */
@@ -180,7 +180,7 @@ public function listUsable($parent, $optParams = [])
    * @opt_param string updateMask Required. Mask specifying which fields in the
    * workstation configuration should be updated.
    * @opt_param bool validateOnly Optional. If set, validate the request and
-   * preview the review, but do not actually apply it.
+   * preview the result, but do not actually apply it.
    * @return Operation
    * @throws \Google\Service\Exception
    */

src/CloudWorkstations/Resource/ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstations.php

@@ -48,7 +48,7 @@ class ProjectsLocationsWorkstationClustersWorkstationConfigsWorkstations extends
    * @param array $optParams Optional parameters.
    *
    * @opt_param bool validateOnly Optional. If set, validate the request and
-   * preview the review, but do not actually apply it.
+   * preview the result, but do not actually apply it.
    * @opt_param string workstationId Required. ID to use for the workstation.
    * @return Operation
    * @throws \Google\Service\Exception
@@ -68,7 +68,7 @@ public function create($parent, Workstation $postBody, $optParams = [])
    * @opt_param string etag Optional. If set, the request will be rejected if the
    * latest version of the workstation on the server does not have this ETag.
    * @opt_param bool validateOnly Optional. If set, validate the request and
-   * preview the review, but do not actually apply it.
+   * preview the result, but do not actually apply it.
    * @return Operation
    * @throws \Google\Service\Exception
    */
@@ -191,13 +191,13 @@ public function listUsable($parent, $optParams = [])
    * @param Workstation $postBody
    * @param array $optParams Optional parameters.
    *
-   * @opt_param bool allowMissing Optional. If set and the workstation
-   * configuration is not found, a new workstation configuration is created. In
-   * this situation, update_mask is ignored.
+   * @opt_param bool allowMissing Optional. If set and the workstation is not
+   * found, a new workstation is created. In this situation, update_mask is
+   * ignored.
    * @opt_param string updateMask Required. Mask specifying which fields in the
-   * workstation configuration should be updated.
+   * workstation should be updated.
    * @opt_param bool validateOnly Optional. If set, validate the request and
-   * preview the review, but do not actually apply it.
+   * preview the result, but do not actually apply it.
    * @return Operation
    * @throws \Google\Service\Exception
    */

src/CloudWorkstations/StartWorkstationRequest.php

@@ -34,7 +34,7 @@ class StartWorkstationRequest extends \Google\Model
    */
   public $etag;
   /**
-   * Optional. If set, validate the request and preview the review, but do not
+   * Optional. If set, validate the request and preview the result, but do not
    * actually apply it.
    *
    * @var bool
@@ -76,7 +76,7 @@ public function getEtag()
     return $this->etag;
   }
   /**
-   * Optional. If set, validate the request and preview the review, but do not
+   * Optional. If set, validate the request and preview the result, but do not
    * actually apply it.
    *
    * @param bool $validateOnly

src/CloudWorkstations/StopWorkstationRequest.php

@@ -27,7 +27,7 @@ class StopWorkstationRequest extends \Google\Model
    */
   public $etag;
   /**
-   * Optional. If set, validate the request and preview the review, but do not
+   * Optional. If set, validate the request and preview the result, but do not
    * actually apply it.
    *
    * @var bool
@@ -52,7 +52,7 @@ public function getEtag()
     return $this->etag;
   }
   /**
-   * Optional. If set, validate the request and preview the review, but do not
+   * Optional. If set, validate the request and preview the result, but do not
    * actually apply it.
    *
    * @param bool $validateOnly

src/CloudWorkstations/Workstation.php

@@ -41,6 +41,14 @@ class Workstation extends \Google\Model
    * it is started.
    */
   public const STATE_STATE_STOPPED = 'STATE_STOPPED';
+  /**
+   * The workstation is being suspended.
+   */
+  public const STATE_STATE_SUSPENDING = 'STATE_SUSPENDING';
+  /**
+   * The workstation is suspended.
+   */
+  public const STATE_STATE_SUSPENDED = 'STATE_SUSPENDED';
   /**
    * Optional. Client-specified annotations.
    *
@@ -399,7 +407,7 @@ public function getStartTime()
    * Output only. Current state of the workstation.
    *
    * Accepted values: STATE_UNSPECIFIED, STATE_STARTING, STATE_RUNNING,
-   * STATE_STOPPING, STATE_STOPPED
+   * STATE_STOPPING, STATE_STOPPED, STATE_SUSPENDING, STATE_SUSPENDED
    *
    * @param self::STATE_* $state
    */

src/CloudWorkstations/WorkstationConfig.php

@@ -171,18 +171,20 @@ class WorkstationConfig extends \Google\Collection
   public $replicaZones;
   /**
    * Optional. Number of seconds that a workstation can run until it is
-   * automatically shut down. We recommend that workstations be shut down daily
-   * to reduce costs and so that security updates can be applied upon restart.
-   * The idle_timeout and running_timeout fields are independent of each other.
-   * Note that the running_timeout field shuts down VMs after the specified
-   * time, regardless of whether or not the VMs are idle. Provide duration
-   * terminated by `s` for seconds—for example, `"54000s"` (15 hours). Defaults
-   * to `"43200s"` (12 hours). A value of `"0s"` indicates that workstations
-   * using this configuration should never time out. If encryption_key is set,
-   * it must be greater than `"0s"` and less than `"86400s"` (24 hours).
-   * Warning: A value of `"0s"` indicates that Cloud Workstations VMs created
-   * with this configuration have no maximum running time. This is strongly
-   * discouraged because you incur costs and will not pick up security updates.
+   * automatically shut down. This field applies to workstations in both
+   * STATE_RUNNING and STATE_SUSPENDED. We recommend that workstations be shut
+   * down daily to reduce costs and so that security updates can be applied upon
+   * restart. The idle_timeout and running_timeout fields are independent of
+   * each other. Note that the running_timeout field shuts down VMs after the
+   * specified time, regardless of whether or not the VMs are idle. Provide
+   * duration terminated by `s` for seconds—for example, `"54000s"` (15 hours).
+   * Defaults to `"43200s"` (12 hours). A value of `"0s"` indicates that
+   * workstations using this configuration should never time out. If
+   * encryption_key is set, it must be greater than `"0s"` and less than
+   * `"86400s"` (24 hours). Warning: A value of `"0s"` indicates that Cloud
+   * Workstations VMs created with this configuration have no maximum running
+   * time. This is strongly discouraged because you incur costs and will not
+   * pick up security updates.
    *
    * @var string
    */
@@ -634,18 +636,20 @@ public function getReplicaZones()
   }
   /**
    * Optional. Number of seconds that a workstation can run until it is
-   * automatically shut down. We recommend that workstations be shut down daily
-   * to reduce costs and so that security updates can be applied upon restart.
-   * The idle_timeout and running_timeout fields are independent of each other.
-   * Note that the running_timeout field shuts down VMs after the specified
-   * time, regardless of whether or not the VMs are idle. Provide duration
-   * terminated by `s` for seconds—for example, `"54000s"` (15 hours). Defaults
-   * to `"43200s"` (12 hours). A value of `"0s"` indicates that workstations
-   * using this configuration should never time out. If encryption_key is set,
-   * it must be greater than `"0s"` and less than `"86400s"` (24 hours).
-   * Warning: A value of `"0s"` indicates that Cloud Workstations VMs created
-   * with this configuration have no maximum running time. This is strongly
-   * discouraged because you incur costs and will not pick up security updates.
+   * automatically shut down. This field applies to workstations in both
+   * STATE_RUNNING and STATE_SUSPENDED. We recommend that workstations be shut
+   * down daily to reduce costs and so that security updates can be applied upon
+   * restart. The idle_timeout and running_timeout fields are independent of
+   * each other. Note that the running_timeout field shuts down VMs after the
+   * specified time, regardless of whether or not the VMs are idle. Provide
+   * duration terminated by `s` for seconds—for example, `"54000s"` (15 hours).
+   * Defaults to `"43200s"` (12 hours). A value of `"0s"` indicates that
+   * workstations using this configuration should never time out. If
+   * encryption_key is set, it must be greater than `"0s"` and less than
+   * `"86400s"` (24 hours). Warning: A value of `"0s"` indicates that Cloud
+   * Workstations VMs created with this configuration have no maximum running
+   * time. This is strongly discouraged because you incur costs and will not
+   * pick up security updates.
    *
    * @param string $runningTimeout
    */