google-apis-workstations_v1 0.38.0 → 0.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e776a7703422b4773e414776672c1ca372a19b36d7fe2f7dbea9765ba7fd5d97
-  data.tar.gz: 7ba6302221bf973369b46ad6727b154d1b34f32f5c9218ba0a47344eb182ea0f
+  metadata.gz: d130379b4791aa9b6295e4bd00b6bd8ec605b06cc5364fa878bad98d4253b199
+  data.tar.gz: 3564c155f7b023c6f825bc1c96fe08eeb2ff4f1994830439fe795f0281400df3
 SHA512:
-  metadata.gz: 74860796d879d745eca3405b691cf435e16491cc605f7ba13d5cef37b8c87767e94f92c552a4d842f0459bde91a579106a8cac50162ba4e4bed829938dc2a6b5
-  data.tar.gz: 1d93d8d5569d9f308163bc14f2d546d4753d525cb0480aa02ccadf5c771be147b7797abf8f46bb4e996a3d8acbd51da392b297fd1bfa04e7eac4610f8c739525
+  metadata.gz: a4e7bfd70dea879b73a601ef585303b59a0f2db1d27e29e0a485d821b4e426a0ab3531857ddf0d547da6d452559a401565f2fe1b2fd74c941a5f0026ec712ebe
+  data.tar.gz: 616ddacc80e4d2eed02b4503e56bebfe4b825a0850c84c63cade8c59dbb651c808e9926d628564df9ff671f21548ea908d7a7cb275e831230aec2063022d5b10

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-workstations_v1
 
+### v0.39.0 (2026-09-06)
+
+* Regenerated from discovery document revision 20260901
+
 ### v0.38.0 (2026-08-16)
 
 * Regenerated from discovery document revision 20260807

data/lib/google/apis/workstations_v1/classes.rb

@@ -1876,6 +1876,34 @@ module Google
         end
       end
       
+      # Request message for SuspendWorkstation.
+      class SuspendWorkstationRequest
+        include Google::Apis::Core::Hashable
+      
+        # Optional. If set, the request will be rejected if the latest version of the
+        # workstation on the server does not have this ETag.
+        # Corresponds to the JSON property `etag`
+        # @return [String]
+        attr_accessor :etag
+      
+        # Optional. If set, validate the request and preview the result, but do not
+        # actually apply it.
+        # Corresponds to the JSON property `validateOnly`
+        # @return [Boolean]
+        attr_accessor :validate_only
+        alias_method :validate_only?, :validate_only
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @etag = args[:etag] if args.key?(:etag)
+          @validate_only = args[:validate_only] if args.key?(:validate_only)
+        end
+      end
+      
       # Request message for `TestIamPermissions` method.
       class TestIamPermissionsRequest
         include Google::Apis::Core::Hashable
@@ -2338,12 +2366,20 @@ module Google
         # @return [Google::Apis::WorkstationsV1::Host]
         attr_accessor :host
       
-        # Optional. Number of seconds to wait before automatically stopping a
-        # workstation after it last received user traffic. A value of `"0s"` indicates
-        # that Cloud Workstations VMs created with this configuration should never time
-        # out due to idleness. Provide [duration](https://developers.google.com/protocol-
-        # buffers/docs/reference/google.protobuf#duration) terminated by `s` for seconds—
-        # for example, `"7200s"` (2 hours). The default is `"1200s"` (20 minutes).
+        # Optional. The action to take when the workstation has been idle for the
+        # duration specified in idle_timeout. Defaults to STOP.
+        # Corresponds to the JSON property `idleAction`
+        # @return [String]
+        attr_accessor :idle_action
+      
+        # Optional. Number of seconds to wait before automatically stopping or
+        # suspending a workstation after it last received user traffic. See idle_action
+        # to configure whether to stop or suspend idle workstations. A value of `"0s"`
+        # indicates that Cloud Workstations VMs created with this configuration should
+        # never time out due to idleness. Provide [duration](https://developers.google.
+        # com/protocol-buffers/docs/reference/google.protobuf#duration) terminated by `s`
+        # for seconds—for example, `"7200s"` (2 hours). The default is `"1200s"` (20
+        # minutes).
         # Corresponds to the JSON property `idleTimeout`
         # @return [String]
         attr_accessor :idle_timeout
@@ -2405,11 +2441,13 @@ module Google
         # updates can be applied upon restart. The idle_timeout and running_timeout
         # fields are independent of each other. Note that the running_timeout field
         # stops workstations after the specified time, regardless of whether or not the
-        # workstations 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 are idle. Note: This timeout applies to workstations in the
+        # following states: * STATE_RUNNING * STATE_SUSPENDED Suspending a workstation
+        # does not reset this timeout. 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.
@@ -2450,6 +2488,7 @@ module Google
           @etag = args[:etag] if args.key?(:etag)
           @grant_workstation_admin_role_on_create = args[:grant_workstation_admin_role_on_create] if args.key?(:grant_workstation_admin_role_on_create)
           @host = args[:host] if args.key?(:host)
+          @idle_action = args[:idle_action] if args.key?(:idle_action)
           @idle_timeout = args[:idle_timeout] if args.key?(:idle_timeout)
           @labels = args[:labels] if args.key?(:labels)
           @max_usable_workstations = args[:max_usable_workstations] if args.key?(:max_usable_workstations)

data/lib/google/apis/workstations_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module WorkstationsV1
       # Version of the google-apis-workstations_v1 gem
-      GEM_VERSION = "0.38.0"
+      GEM_VERSION = "0.39.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.19.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20260807"
+      REVISION = "20260901"
     end
   end
 end

data/lib/google/apis/workstations_v1/representations.rb

@@ -280,6 +280,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class SuspendWorkstationRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class TestIamPermissionsRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -737,6 +743,14 @@ module Google
         end
       end
       
+      class SuspendWorkstationRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :etag, as: 'etag'
+          property :validate_only, as: 'validateOnly'
+        end
+      end
+      
       class TestIamPermissionsRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -832,6 +846,7 @@ module Google
           property :grant_workstation_admin_role_on_create, as: 'grantWorkstationAdminRoleOnCreate'
           property :host, as: 'host', class: Google::Apis::WorkstationsV1::Host, decorator: Google::Apis::WorkstationsV1::Host::Representation
       
+          property :idle_action, as: 'idleAction'
           property :idle_timeout, as: 'idleTimeout'
           hash :labels, as: 'labels'
           property :max_usable_workstations, as: 'maxUsableWorkstations'

data/lib/google/apis/workstations_v1/service.rb

@@ -1258,6 +1258,39 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Suspends a workstation to reduce costs.
+        # @param [String] name
+        #   Required. Name of the workstation to suspend.
+        # @param [Google::Apis::WorkstationsV1::SuspendWorkstationRequest] suspend_workstation_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::WorkstationsV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::WorkstationsV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def suspend_workstation(name, suspend_workstation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:suspend', options)
+          command.request_representation = Google::Apis::WorkstationsV1::SuspendWorkstationRequest::Representation
+          command.request_object = suspend_workstation_request_object
+          command.response_representation = Google::Apis::WorkstationsV1::Operation::Representation
+          command.response_class = Google::Apis::WorkstationsV1::Operation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Returns permissions that a caller has on the specified resource. If the
         # resource does not exist, this will return an empty set of permissions, not a `
         # NOT_FOUND` error. Note: This operation is designed to be used for building

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-workstations_v1
 version: !ruby/object:Gem::Version
-  version: 0.38.0
+  version: 0.39.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-workstations_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-workstations_v1/v0.38.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-workstations_v1/v0.39.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-workstations_v1
 rdoc_options: []
 require_paths: