chore: regenerate batch client (googleapis#23876)

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

Author: yoshi-code-bot

clients/google-api-services-batch/v1/2.0.0/README.md

@@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file:
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-batch</artifactId>
-      <version>v1-rev20241002-2.0.0</version>
+      <version>v1-rev20241106-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-batch:v1-rev20241002-2.0.0'
+  implementation 'com.google.apis:google-api-services-batch:v1-rev20241106-2.0.0'
 }
 ```
 

clients/google-api-services-batch/v1/2.0.0/com/google/api/services/batch/v1/model/CloudLoggingOption.java

@@ -30,7 +30,7 @@
 public final class CloudLoggingOption extends com.google.api.client.json.GenericJson {
 
   /**
-   * Optional. Set this flag to true to change the [monitored resource
+   * Optional. Set this field 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/re
    * sources#tag_batch.googleapis.com/Job) type to the formerly used
@@ -41,7 +41,7 @@ public final class CloudLoggingOption extends com.google.api.client.json.Generic
   private java.lang.Boolean useGenericTaskMonitoredResource;
 
   /**
-   * Optional. Set this flag to true to change the [monitored resource
+   * Optional. Set this field 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/re
    * sources#tag_batch.googleapis.com/Job) type to the formerly used
@@ -53,7 +53,7 @@ public java.lang.Boolean getUseGenericTaskMonitoredResource() {
   }
 
   /**
-   * Optional. Set this flag to true to change the [monitored resource
+   * Optional. Set this field 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/re
    * sources#tag_batch.googleapis.com/Job) type to the formerly used

clients/google-api-services-batch/v1/2.0.0/com/google/api/services/batch/v1/model/InstancePolicyOrTemplate.java

@@ -69,8 +69,9 @@ public final class InstancePolicyOrTemplate extends com.google.api.client.json.G
 
   /**
    * Name of an instance template used to create VMs. Named the field as 'instance_template' instead
-   * of 'template' to avoid C++ keyword conflict. Batch only supports global instance templates. You
-   * can specify the global instance template as a full or partial URL.
+   * of 'template' to avoid C++ keyword conflict. Batch only supports global instance templates from
+   * the same project as the job. You can specify the global instance template as a full or partial
+   * URL.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -166,8 +167,9 @@ public InstancePolicyOrTemplate setInstallOpsAgent(java.lang.Boolean installOpsA
 
   /**
    * Name of an instance template used to create VMs. Named the field as 'instance_template' instead
-   * of 'template' to avoid C++ keyword conflict. Batch only supports global instance templates. You
-   * can specify the global instance template as a full or partial URL.
+   * of 'template' to avoid C++ keyword conflict. Batch only supports global instance templates from
+   * the same project as the job. You can specify the global instance template as a full or partial
+   * URL.
    * @return value or {@code null} for none
    */
   public java.lang.String getInstanceTemplate() {
@@ -176,8 +178,9 @@ public java.lang.String getInstanceTemplate() {
 
   /**
    * Name of an instance template used to create VMs. Named the field as 'instance_template' instead
-   * of 'template' to avoid C++ keyword conflict. Batch only supports global instance templates. You
-   * can specify the global instance template as a full or partial URL.
+   * of 'template' to avoid C++ keyword conflict. Batch only supports global instance templates from
+   * the same project as the job. You can specify the global instance template as a full or partial
+   * URL.
    * @param instanceTemplate instanceTemplate or {@code null} for none
    */
   public InstancePolicyOrTemplate setInstanceTemplate(java.lang.String instanceTemplate) {

clients/google-api-services-batch/v1/2.0.0/com/google/api/services/batch/v1/model/LogsPolicy.java

@@ -17,7 +17,9 @@
 package com.google.api.services.batch.v1.model;
 
 /**
- * LogsPolicy describes how outputs from a Job's Tasks (stdout/stderr) will be preserved.
+ * LogsPolicy describes if and how a job's logs are preserved. Logs include information that is
+ * automatically written by the Batch service agent and any information that you configured the
+ * job's runnables to write to the `stdout` or `stderr` streams.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Batch API. For a detailed explanation see:
@@ -30,40 +32,44 @@
 public final class LogsPolicy extends com.google.api.client.json.GenericJson {
 
   /**
-   * Optional. Additional settings for Cloud Logging. It will only take effect when the destination
-   * of `LogsPolicy` is set to `CLOUD_LOGGING`.
+   * Optional. When `destination` is set to `CLOUD_LOGGING`, you can optionally set this field to
+   * configure additional settings for Cloud Logging.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private CloudLoggingOption cloudLoggingOption;
 
   /**
-   * Where logs should be saved.
+   * If and where logs should be saved.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private java.lang.String destination;
 
   /**
-   * The path to which logs are saved when the destination = PATH. This can be a local file path on
-   * the VM, or under the mount point of a Persistent Disk or Filestore, or a Cloud Storage path.
+   * When `destination` is set to `PATH`, you must set this field to the path where you want logs to
+   * be saved. This path can point to a local directory on the VM or (if congifured) a directory
+   * under the mount path of any Cloud Storage bucket, network file system (NFS), or writable
+   * persistent disk that is mounted to the job. For example, if the job has a bucket with
+   * `mountPath` set to `/mnt/disks/my-bucket`, you can write logs to the root directory of the
+   * `remotePath` of that bucket by setting this field to `/mnt/disks/my-bucket/`.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private java.lang.String logsPath;
 
   /**
-   * Optional. Additional settings for Cloud Logging. It will only take effect when the destination
-   * of `LogsPolicy` is set to `CLOUD_LOGGING`.
+   * Optional. When `destination` is set to `CLOUD_LOGGING`, you can optionally set this field to
+   * configure additional settings for Cloud Logging.
    * @return value or {@code null} for none
    */
   public CloudLoggingOption getCloudLoggingOption() {
     return cloudLoggingOption;
   }
 
   /**
-   * Optional. Additional settings for Cloud Logging. It will only take effect when the destination
-   * of `LogsPolicy` is set to `CLOUD_LOGGING`.
+   * Optional. When `destination` is set to `CLOUD_LOGGING`, you can optionally set this field to
+   * configure additional settings for Cloud Logging.
    * @param cloudLoggingOption cloudLoggingOption or {@code null} for none
    */
   public LogsPolicy setCloudLoggingOption(CloudLoggingOption cloudLoggingOption) {
@@ -72,15 +78,15 @@ public LogsPolicy setCloudLoggingOption(CloudLoggingOption cloudLoggingOption) {
   }
 
   /**
-   * Where logs should be saved.
+   * If and where logs should be saved.
    * @return value or {@code null} for none
    */
   public java.lang.String getDestination() {
     return destination;
   }
 
   /**
-   * Where logs should be saved.
+   * If and where logs should be saved.
    * @param destination destination or {@code null} for none
    */
   public LogsPolicy setDestination(java.lang.String destination) {
@@ -89,17 +95,25 @@ public LogsPolicy setDestination(java.lang.String destination) {
   }
 
   /**
-   * The path to which logs are saved when the destination = PATH. This can be a local file path on
-   * the VM, or under the mount point of a Persistent Disk or Filestore, or a Cloud Storage path.
+   * When `destination` is set to `PATH`, you must set this field to the path where you want logs to
+   * be saved. This path can point to a local directory on the VM or (if congifured) a directory
+   * under the mount path of any Cloud Storage bucket, network file system (NFS), or writable
+   * persistent disk that is mounted to the job. For example, if the job has a bucket with
+   * `mountPath` set to `/mnt/disks/my-bucket`, you can write logs to the root directory of the
+   * `remotePath` of that bucket by setting this field to `/mnt/disks/my-bucket/`.
    * @return value or {@code null} for none
    */
   public java.lang.String getLogsPath() {
     return logsPath;
   }
 
   /**
-   * The path to which logs are saved when the destination = PATH. This can be a local file path on
-   * the VM, or under the mount point of a Persistent Disk or Filestore, or a Cloud Storage path.
+   * When `destination` is set to `PATH`, you must set this field to the path where you want logs to
+   * be saved. This path can point to a local directory on the VM or (if congifured) a directory
+   * under the mount path of any Cloud Storage bucket, network file system (NFS), or writable
+   * persistent disk that is mounted to the job. For example, if the job has a bucket with
+   * `mountPath` set to `/mnt/disks/my-bucket`, you can write logs to the root directory of the
+   * `remotePath` of that bucket by setting this field to `/mnt/disks/my-bucket/`.
    * @param logsPath logsPath or {@code null} for none
    */
   public LogsPolicy setLogsPath(java.lang.String logsPath) {

clients/google-api-services-batch/v1/2.0.0/pom.xml

@@ -8,8 +8,8 @@
 
   <groupId>com.google.apis</groupId>
   <artifactId>google-api-services-batch</artifactId>
-  <version>v1-rev20241002-2.0.0</version>
-  <name>Batch API v1-rev20241002-2.0.0</name>
+  <version>v1-rev20241106-2.0.0</version>
+  <name>Batch API v1-rev20241106-2.0.0</name>
   <packaging>jar</packaging>
 
   <inceptionYear>2011</inceptionYear>

clients/google-api-services-batch/v1/README.md

@@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file:
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-batch</artifactId>
-      <version>v1-rev20241002-2.0.0</version>
+      <version>v1-rev20241106-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-batch:v1-rev20241002-2.0.0'
+  implementation 'com.google.apis:google-api-services-batch:v1-rev20241106-2.0.0'
 }
 ```