google-apis-batch_v1 0.27.0 → 0.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1c3799c8c31ca7ef1be0696d15be378b25cf366dd32140c3667d99a59d99f405
-  data.tar.gz: dfa0bbe699770b4074ca1faa7a58cccc8d0d1cd67a9c13d00436a381883d41e7
+  metadata.gz: 0e9d85f5743c9efff93b66cb30f3b43fd966ff658a119d86568e995338c1a8c6
+  data.tar.gz: 470aa2aa03e88a7de3f9ca4add17084e3b9372121e3ec1fbd32ef467e567e14f
 SHA512:
-  metadata.gz: cf0faa4090a3b9133f16e110fbb04152dd6075b0911165d392253cdab0a6a3bb13ea44671ec99efeae7ae19f2be0c6de7bb0f5a7a6c708ef16b0490bc95a37fa
-  data.tar.gz: 7255ca2ab1b9ba8045e5eea464e46c825032b5bba319052f016e8ab800c9d2d2e8d7c9ff1721ffabff34a768ddb5626977428611d4ad84e4c2db1daedcb8886f
+  metadata.gz: 5b7fd12fd3d41e14118b635a01570910686b7a0dc91d75e0dd81376825efd42b07289f605297657d4298a21cb9febdbddb579a6a5569ad8a3ad77299cfd151e1
+  data.tar.gz: 7145dc94035224c080e7b2e16938a922bc06fd93fa4498798606ae5cd86c1bd43f7f580dff4164819dbcb8333ee696bf67b991f20d650f2f1d8128cd1e50610c

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Release history for google-apis-batch_v1
 
+### v0.29.0 (2024-02-04)
+
+* Regenerated from discovery document revision 20240127
+* Regenerated using generator version 0.13.1
+
+### v0.28.0 (2024-01-23)
+
+* Regenerated from discovery document revision 20240112
+* Regenerated using generator version 0.13.0
+
 ### v0.27.0 (2024-01-07)
 
 * Regenerated from discovery document revision 20231213

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

@@ -316,7 +316,7 @@ module Google
         # the first line of the file.(For example, to execute the script using bash, `#!/
         # bin/bash` should be the first line of the file. To execute the script using`
         # Python3`, `#!/usr/bin/env python3` should be the first line of the file.)
-        # Otherwise, the file will by default be excuted by `/bin/sh`.
+        # Otherwise, the file will by default be executed by `/bin/sh`.
         # Corresponds to the JSON property `path`
         # @return [String]
         attr_accessor :path
@@ -324,7 +324,7 @@ module Google
         # Shell script text. To specify an interpreter, please add a `#!\n` at the
         # beginning of the text.(For example, to execute the script using bash, `#!/bin/
         # bash\n` should be added. To execute the script using`Python3`, `#!/usr/bin/env
-        # python3\n` should be added.) Otherwise, the script will by default be excuted
+        # python3\n` should be added.) Otherwise, the script will by default be executed
         # by `/bin/sh`.
         # Corresponds to the JSON property `text`
         # @return [String]
@@ -732,6 +732,32 @@ module Google
         end
       end
       
+      # `CloudLoggingOption` contains additional settings for Cloud Logging logs
+      # generated by Batch job.
+      class CloudLoggingOption
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Set this flag to true to change the [monitored resource type](https:/
+        # /cloud.google.com/monitoring/api/resources) for Cloud Logging logs generated
+        # by this Batch job from the [`batch.googleapis.com/Job`](https://cloud.google.
+        # com/monitoring/api/resources#tag_batch.googleapis.com/Job) type to the
+        # formerly used [`generic_task`](https://cloud.google.com/monitoring/api/
+        # resources#tag_generic_task) type.
+        # Corresponds to the JSON property `useGenericTaskMonitoredResource`
+        # @return [Boolean]
+        attr_accessor :use_generic_task_monitored_resource
+        alias_method :use_generic_task_monitored_resource?, :use_generic_task_monitored_resource
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @use_generic_task_monitored_resource = args[:use_generic_task_monitored_resource] if args.key?(:use_generic_task_monitored_resource)
+        end
+      end
+      
       # Compute resource requirements. ComputeResource defines the amount of resources
       # required for each task. Make sure your tasks have enough resources to
       # successfully run. If you also define the types of resources for a job to use
@@ -810,12 +836,17 @@ module Google
         # @return [Array<String>]
         attr_accessor :commands
       
-        # Optional. If set to true, container will run with Image streaming. The
-        # container runtime will be changed to containerd instead of docker. Currently,
-        # only imageUri, commands, entrypoint and volumes are supported and any other
-        # fields will be ignored. Please refer [here](https://github.com/
-        # GoogleCloudPlatform/batch-samples/tree/main/api-samples/image-streaming) for
-        # the feature requirements and limitations.
+        # Optional. If set to true, this container runnable uses Image streaming. Use
+        # Image streaming to allow the runnable to initialize without waiting for the
+        # entire container image to download, which can significantly reduce startup
+        # time for large container images. When `enableImageStreaming` is set to true,
+        # the container runtime is [containerd](https://containerd.io/) instead of
+        # Docker. Additionally, this container runnable only supports the following `
+        # container` subfields: `imageUri`, `commands[]`, `entrypoint`, and `volumes[]`;
+        # any other `container` subfields are ignored. For more information about the
+        # requirements and limitations for using Image streaming with Batch, see the [`
+        # image-streaming` sample on GitHub](https://github.com/GoogleCloudPlatform/
+        # batch-samples/tree/main/api-samples/image-streaming).
         # Corresponds to the JSON property `enableImageStreaming`
         # @return [Boolean]
         attr_accessor :enable_image_streaming
@@ -837,16 +868,30 @@ module Google
         # @return [String]
         attr_accessor :options
       
-        # Optional password for logging in to a docker registry. If password matches `
-        # projects/*/secrets/*/versions/*` then Batch will read the password from the
-        # Secret Manager;
+        # Required if the container image is from a private Docker registry. The
+        # password to login to the Docker registry that contains the image. For security,
+        # it is strongly recommended to specify an encrypted password by using a Secret
+        # Manager secret: `projects/*/secrets/*/versions/*`. Warning: If you specify the
+        # password using plain text, you risk the password being exposed to any users
+        # who can view the job or its logs. To avoid this risk, specify a secret that
+        # contains the password instead. Learn more about [Secret Manager](https://cloud.
+        # google.com/secret-manager/docs/) and [using Secret Manager with Batch](https://
+        # cloud.google.com/batch/docs/create-run-job-secret-manager).
         # Corresponds to the JSON property `password`
         # @return [String]
         attr_accessor :password
       
-        # Optional username for logging in to a docker registry. If username matches `
-        # projects/*/secrets/*/versions/*` then Batch will read the username from the
-        # Secret Manager.
+        # Required if the container image is from a private Docker registry. The
+        # username to login to the Docker registry that contains the image. You can
+        # either specify the username directly by using plain text or specify an
+        # encrypted username by using a Secret Manager secret: `projects/*/secrets/*/
+        # versions/*`. However, using a secret is recommended for enhanced security.
+        # Caution: If you specify the username using plain text, you risk the username
+        # being exposed to any users who can view the job or its logs. To avoid this
+        # risk, specify a secret that contains the username instead. Learn more about [
+        # Secret Manager](https://cloud.google.com/secret-manager/docs/) and [using
+        # Secret Manager with Batch](https://cloud.google.com/batch/docs/create-run-job-
+        # secret-manager).
         # Corresponds to the JSON property `username`
         # @return [String]
         attr_accessor :username
@@ -1571,6 +1616,12 @@ module Google
       class LogsPolicy
         include Google::Apis::Core::Hashable
       
+        # `CloudLoggingOption` contains additional settings for Cloud Logging logs
+        # generated by Batch job.
+        # Corresponds to the JSON property `cloudLoggingOption`
+        # @return [Google::Apis::BatchV1::CloudLoggingOption]
+        attr_accessor :cloud_logging_option
+      
         # Where logs should be saved.
         # Corresponds to the JSON property `destination`
         # @return [String]
@@ -1589,6 +1640,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @cloud_logging_option = args[:cloud_logging_option] if args.key?(:cloud_logging_option)
           @destination = args[:destination] if args.key?(:destination)
           @logs_path = args[:logs_path] if args.key?(:logs_path)
         end
@@ -2038,7 +2090,7 @@ module Google
         # the first line of the file.(For example, to execute the script using bash, `#!/
         # bin/bash` should be the first line of the file. To execute the script using`
         # Python3`, `#!/usr/bin/env python3` should be the first line of the file.)
-        # Otherwise, the file will by default be excuted by `/bin/sh`.
+        # Otherwise, the file will by default be executed by `/bin/sh`.
         # Corresponds to the JSON property `path`
         # @return [String]
         attr_accessor :path
@@ -2046,7 +2098,7 @@ module Google
         # Shell script text. To specify an interpreter, please add a `#!\n` at the
         # beginning of the text.(For example, to execute the script using bash, `#!/bin/
         # bash\n` should be added. To execute the script using`Python3`, `#!/usr/bin/env
-        # python3\n` should be added.) Otherwise, the script will by default be excuted
+        # python3\n` should be added.) Otherwise, the script will by default be executed
         # by `/bin/sh`.
         # Corresponds to the JSON property `text`
         # @return [String]
@@ -2251,12 +2303,22 @@ module Google
       
         # When true, Batch will populate a file with a list of all VMs assigned to the
         # TaskGroup and set the BATCH_HOSTS_FILE environment variable to the path of
-        # that file. Defaults to false.
+        # that file. Defaults to false. The host file supports up to 1000 VMs.
         # Corresponds to the JSON property `requireHostsFile`
         # @return [Boolean]
         attr_accessor :require_hosts_file
         alias_method :require_hosts_file?, :require_hosts_file
       
+        # Optional. If not set or set to false, Batch uses the root user to execute
+        # runnables. If set to true, Batch runs the runnables using a non-root user.
+        # Currently, the non-root user Batch used is generated by OS Login. For more
+        # information, see [About OS Login](https://cloud.google.com/compute/docs/
+        # oslogin).
+        # Corresponds to the JSON property `runAsNonRoot`
+        # @return [Boolean]
+        attr_accessor :run_as_non_root
+        alias_method :run_as_non_root?, :run_as_non_root
+      
         # Scheduling policy for Tasks in the TaskGroup. The default value is
         # AS_SOON_AS_POSSIBLE.
         # Corresponds to the JSON property `schedulingPolicy`
@@ -2302,6 +2364,7 @@ module Google
           @parallelism = args[:parallelism] if args.key?(:parallelism)
           @permissive_ssh = args[:permissive_ssh] if args.key?(:permissive_ssh)
           @require_hosts_file = args[:require_hosts_file] if args.key?(:require_hosts_file)
+          @run_as_non_root = args[:run_as_non_root] if args.key?(:run_as_non_root)
           @scheduling_policy = args[:scheduling_policy] if args.key?(:scheduling_policy)
           @task_count = args[:task_count] if args.key?(:task_count)
           @task_count_per_node = args[:task_count_per_node] if args.key?(:task_count_per_node)

data/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.27.0"
+      GEM_VERSION = "0.29.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.12.0"
+      GENERATOR_VERSION = "0.13.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20231213"
+      REVISION = "20240127"
     end
   end
 end

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

@@ -130,6 +130,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CloudLoggingOption
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ComputeResource
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -576,6 +582,13 @@ module Google
         end
       end
       
+      class CloudLoggingOption
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :use_generic_task_monitored_resource, as: 'useGenericTaskMonitoredResource'
+        end
+      end
+      
       class ComputeResource
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -790,6 +803,8 @@ module Google
       class LogsPolicy
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :cloud_logging_option, as: 'cloudLoggingOption', class: Google::Apis::BatchV1::CloudLoggingOption, decorator: Google::Apis::BatchV1::CloudLoggingOption::Representation
+      
           property :destination, as: 'destination'
           property :logs_path, as: 'logsPath'
         end
@@ -965,6 +980,7 @@ module Google
           property :parallelism, :numeric_string => true, as: 'parallelism'
           property :permissive_ssh, as: 'permissiveSsh'
           property :require_hosts_file, as: 'requireHostsFile'
+          property :run_as_non_root, as: 'runAsNonRoot'
           property :scheduling_policy, as: 'schedulingPolicy'
           property :task_count, :numeric_string => true, as: 'taskCount'
           property :task_count_per_node, :numeric_string => true, as: 'taskCountPerNode'

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

@@ -22,7 +22,7 @@ module Google
     module BatchV1
       # Batch API
       #
-      # An API to manage the running of batch jobs on Google Cloud Platform.
+      # An API to manage the running of batch resources on Google Cloud Platform.
       #
       # @example
       #    require 'google/apis/batch_v1'
@@ -32,6 +32,8 @@ module Google
       #
       # @see https://cloud.google.com/batch/
       class BatchService < Google::Apis::Core::BaseService
+        DEFAULT_ENDPOINT_TEMPLATE = "https://batch.$UNIVERSE_DOMAIN$/"
+
         # @return [String]
         #  API key. Your API key identifies your project and provides you with API access,
         #  quota, and reports. Required unless you provide an OAuth 2.0 token.
@@ -43,7 +45,7 @@ module Google
         attr_accessor :quota_user
 
         def initialize
-          super('https://batch.googleapis.com/', '',
+          super(DEFAULT_ENDPOINT_TEMPLATE, '',
                 client_name: 'google-apis-batch_v1',
                 client_version: Google::Apis::BatchV1::GEM_VERSION)
           @batch_path = 'batch'

data/lib/google/apis/batch_v1.rb

@@ -21,7 +21,7 @@ module Google
   module Apis
     # Batch API
     #
-    # An API to manage the running of batch jobs on Google Cloud Platform.
+    # An API to manage the running of batch resources on Google Cloud Platform.
     #
     # @see https://cloud.google.com/batch/
     module BatchV1

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-batch_v1
 version: !ruby/object:Gem::Version
-  version: 0.27.0
+  version: 0.29.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-01-07 00:00:00.000000000 Z
+date: 2024-02-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: 0.12.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: 0.12.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -58,7 +58,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-batch_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-batch_v1/v0.27.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-batch_v1/v0.29.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-batch_v1
 post_install_message: 
 rdoc_options: []