feat: Automated regeneration of batch v1 client (googleapis#21838)

Auto-created at 2025-02-26 20:55:02 +0000 using the toys pull request generator.

Author: yoshi-code-bot

api_names_out.yaml

@@ -45651,6 +45651,8 @@
 "/batch:v1/Binding/members": members
 "/batch:v1/Binding/members/member": member
 "/batch:v1/Binding/role": role
+"/batch:v1/CancelJobRequest": cancel_job_request
+"/batch:v1/CancelJobRequest/requestId": request_id
 "/batch:v1/CancelOperationRequest": cancel_operation_request
 "/batch:v1/CloudLoggingOption": cloud_logging_option
 "/batch:v1/CloudLoggingOption/useGenericTaskMonitoredResource": use_generic_task_monitored_resource
@@ -45915,6 +45917,8 @@
 "/batch:v1/Volume/nfs": nfs
 "/batch:v1/batch.projects.locations.get": get_project_location
 "/batch:v1/batch.projects.locations.get/name": name
+"/batch:v1/batch.projects.locations.jobs.cancel": cancel_job
+"/batch:v1/batch.projects.locations.jobs.cancel/name": name
 "/batch:v1/batch.projects.locations.jobs.create": create_project_location_job
 "/batch:v1/batch.projects.locations.jobs.create/jobId": job_id
 "/batch:v1/batch.projects.locations.jobs.create/parent": parent

generated/google-apis-batch_v1/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release history for google-apis-batch_v1
 
+### v0.49.0 (2025-02-26)
+
+* Regenerated from discovery document revision 20250122
+* Regenerated using generator version 0.16.0
+
 ### v0.48.0 (2024-12-15)
 
 * Regenerated from discovery document revision 20241204

generated/google-apis-batch_v1/lib/google/apis/batch_v1/classes.rb

@@ -760,6 +760,34 @@ def update!(**args)
         end
       end
 
+      # CancelJob Request.
+      class CancelJobRequest
+        include Google::Apis::Core::Hashable
+      
+        # Optional. An optional request ID to identify requests. Specify a unique
+        # request ID so that if you must retry your request, the server will know to
+        # ignore the request if it has already been completed. The server will guarantee
+        # that for at least 60 minutes after the first request. For example, consider a
+        # situation where you make an initial request and the request times out. If you
+        # make the request again with the same request ID, the server can check if
+        # original operation with the same request ID was received, and if so, will
+        # ignore the second request. This prevents clients from accidentally creating
+        # duplicate commitments. The request ID must be a valid UUID with the exception
+        # that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+        # Corresponds to the JSON property `requestId`
+        # @return [String]
+        attr_accessor :request_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @request_id = args[:request_id] if args.key?(:request_id)
+        end
+      end
+      
       # The request message for Operations.CancelOperation.
       class CancelOperationRequest
         include Google::Apis::Core::Hashable

generated/google-apis-batch_v1/lib/google/apis/batch_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module BatchV1
       # Version of the google-apis-batch_v1 gem
-      GEM_VERSION = "0.48.0"
+      GEM_VERSION = "0.49.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.15.1"
+      GENERATOR_VERSION = "0.16.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20241204"
+      REVISION = "20250122"
     end
   end
 end

generated/google-apis-batch_v1/lib/google/apis/batch_v1/representations.rb

@@ -130,6 +130,12 @@ class Representation < Google::Apis::Core::JsonRepresentation; end
         include Google::Apis::Core::JsonObjectSupport
       end
 
+      class CancelJobRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class CancelOperationRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
 
@@ -592,6 +598,13 @@ class Representation < Google::Apis::Core::JsonRepresentation
         end
       end
 
+      class CancelJobRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :request_id, as: 'requestId'
+        end
+      end
+      
       class CancelOperationRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

generated/google-apis-batch_v1/lib/google/apis/batch_v1/service.rb

@@ -124,6 +124,39 @@ def list_project_locations(name, filter: nil, page_size: nil, page_token: nil, f
           execute_or_queue_command(command, &block)
         end
 
+        # Cancel a Job.
+        # @param [String] name
+        #   Required. Job name.
+        # @param [Google::Apis::BatchV1::CancelJobRequest] cancel_job_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::BatchV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BatchV1::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 cancel_job(name, cancel_job_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:cancel', options)
+          command.request_representation = Google::Apis::BatchV1::CancelJobRequest::Representation
+          command.request_object = cancel_job_request_object
+          command.response_representation = Google::Apis::BatchV1::Operation::Representation
+          command.response_class = Google::Apis::BatchV1::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
+        
         # Create a Job.
         # @param [String] parent
         #   Required. The parent resource name where the Job will be created. Pattern: "