chore: regenerate batch client (googleapis#22577)

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-rev20240703-2.0.0</version>
+      <version>v1-rev20240729-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-batch:v1-rev20240703-2.0.0'
+  implementation 'com.google.apis:google-api-services-batch:v1-rev20240729-2.0.0'
 }
 ```
 

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

@@ -17,7 +17,8 @@
 package com.google.api.services.batch.v1.model;
 
 /**
- * Barrier runnable blocks until all tasks in a taskgroup reach it.
+ * A barrier runnable automatically blocks the execution of subsequent runnables until all the tasks
+ * in the task group reach the barrier.
  *
  * <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:

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

@@ -39,9 +39,9 @@ public final class Container extends com.google.api.client.json.GenericJson {
   private java.lang.Boolean blockExternalNetwork;
 
   /**
-   * Overrides the `CMD` specified in the container. If there is an ENTRYPOINT (either in the
-   * container image or with the entrypoint field below) then commands are appended as arguments to
-   * the ENTRYPOINT.
+   * Required for some container images. Overrides the `CMD` specified in the container. If there is
+   * an `ENTRYPOINT` (either in the container image or with the `entrypoint` field below) then these
+   * commands are appended as arguments to the `ENTRYPOINT`.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -64,22 +64,23 @@ public final class Container extends com.google.api.client.json.GenericJson {
   private java.lang.Boolean enableImageStreaming;
 
   /**
-   * Overrides the `ENTRYPOINT` specified in the container.
+   * Required for some container images. Overrides the `ENTRYPOINT` specified in the container.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private java.lang.String entrypoint;
 
   /**
-   * The URI to pull the container image from.
+   * Required. The URI to pull the container image from.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private java.lang.String imageUri;
 
   /**
-   * Arbitrary additional options to include in the "docker run" command when running this
-   * container, e.g. "--network host".
+   * Required for some container images. Arbitrary additional options to include in the `docker run`
+   * command when running this container—for example, `--network host`. For the `--volume` option,
+   * use the `volumes` field for the container.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -116,13 +117,13 @@ public final class Container extends com.google.api.client.json.GenericJson {
 
   /**
    * Volumes to mount (bind mount) from the host machine files or directories into the container,
-   * formatted to match docker run's --volume option, e.g. /foo:/bar, or /foo:/bar:ro If the
-   * `TaskSpec.Volumes` field is specified but this field is not, Batch will mount each volume from
-   * the host machine to the container with the same mount path by default. In this case, the
-   * default mount option for containers will be read-only (ro) for existing persistent disks and
-   * read-write (rw) for other volume types, regardless of the original mount options specified in
-   * `TaskSpec.Volumes`. If you need different mount settings, you can explicitly configure them in
-   * this field.
+   * formatted to match `--volume` option for the `docker run` command—for example, `/foo:/bar` or
+   * `/foo:/bar:ro`. If the `TaskSpec.Volumes` field is specified but this field is not, Batch will
+   * mount each volume from the host machine to the container with the same mount path by default.
+   * In this case, the default mount option for containers will be read-only (`ro`) for existing
+   * persistent disks and read-write (`rw`) for other volume types, regardless of the original mount
+   * options specified in `TaskSpec.Volumes`. If you need different mount settings, you can
+   * explicitly configure them in this field.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -150,19 +151,19 @@ public Container setBlockExternalNetwork(java.lang.Boolean blockExternalNetwork)
   }
 
   /**
-   * Overrides the `CMD` specified in the container. If there is an ENTRYPOINT (either in the
-   * container image or with the entrypoint field below) then commands are appended as arguments to
-   * the ENTRYPOINT.
+   * Required for some container images. Overrides the `CMD` specified in the container. If there is
+   * an `ENTRYPOINT` (either in the container image or with the `entrypoint` field below) then these
+   * commands are appended as arguments to the `ENTRYPOINT`.
    * @return value or {@code null} for none
    */
   public java.util.List<java.lang.String> getCommands() {
     return commands;
   }
 
   /**
-   * Overrides the `CMD` specified in the container. If there is an ENTRYPOINT (either in the
-   * container image or with the entrypoint field below) then commands are appended as arguments to
-   * the ENTRYPOINT.
+   * Required for some container images. Overrides the `CMD` specified in the container. If there is
+   * an `ENTRYPOINT` (either in the container image or with the `entrypoint` field below) then these
+   * commands are appended as arguments to the `ENTRYPOINT`.
    * @param commands commands or {@code null} for none
    */
   public Container setCommands(java.util.List<java.lang.String> commands) {
@@ -206,15 +207,15 @@ public Container setEnableImageStreaming(java.lang.Boolean enableImageStreaming)
   }
 
   /**
-   * Overrides the `ENTRYPOINT` specified in the container.
+   * Required for some container images. Overrides the `ENTRYPOINT` specified in the container.
    * @return value or {@code null} for none
    */
   public java.lang.String getEntrypoint() {
     return entrypoint;
   }
 
   /**
-   * Overrides the `ENTRYPOINT` specified in the container.
+   * Required for some container images. Overrides the `ENTRYPOINT` specified in the container.
    * @param entrypoint entrypoint or {@code null} for none
    */
   public Container setEntrypoint(java.lang.String entrypoint) {
@@ -223,15 +224,15 @@ public Container setEntrypoint(java.lang.String entrypoint) {
   }
 
   /**
-   * The URI to pull the container image from.
+   * Required. The URI to pull the container image from.
    * @return value or {@code null} for none
    */
   public java.lang.String getImageUri() {
     return imageUri;
   }
 
   /**
-   * The URI to pull the container image from.
+   * Required. The URI to pull the container image from.
    * @param imageUri imageUri or {@code null} for none
    */
   public Container setImageUri(java.lang.String imageUri) {
@@ -240,17 +241,19 @@ public Container setImageUri(java.lang.String imageUri) {
   }
 
   /**
-   * Arbitrary additional options to include in the "docker run" command when running this
-   * container, e.g. "--network host".
+   * Required for some container images. Arbitrary additional options to include in the `docker run`
+   * command when running this container—for example, `--network host`. For the `--volume` option,
+   * use the `volumes` field for the container.
    * @return value or {@code null} for none
    */
   public java.lang.String getOptions() {
     return options;
   }
 
   /**
-   * Arbitrary additional options to include in the "docker run" command when running this
-   * container, e.g. "--network host".
+   * Required for some container images. Arbitrary additional options to include in the `docker run`
+   * command when running this container—for example, `--network host`. For the `--volume` option,
+   * use the `volumes` field for the container.
    * @param options options or {@code null} for none
    */
   public Container setOptions(java.lang.String options) {
@@ -324,13 +327,13 @@ public Container setUsername(java.lang.String username) {
 
   /**
    * Volumes to mount (bind mount) from the host machine files or directories into the container,
-   * formatted to match docker run's --volume option, e.g. /foo:/bar, or /foo:/bar:ro If the
-   * `TaskSpec.Volumes` field is specified but this field is not, Batch will mount each volume from
-   * the host machine to the container with the same mount path by default. In this case, the
-   * default mount option for containers will be read-only (ro) for existing persistent disks and
-   * read-write (rw) for other volume types, regardless of the original mount options specified in
-   * `TaskSpec.Volumes`. If you need different mount settings, you can explicitly configure them in
-   * this field.
+   * formatted to match `--volume` option for the `docker run` command—for example, `/foo:/bar` or
+   * `/foo:/bar:ro`. If the `TaskSpec.Volumes` field is specified but this field is not, Batch will
+   * mount each volume from the host machine to the container with the same mount path by default.
+   * In this case, the default mount option for containers will be read-only (`ro`) for existing
+   * persistent disks and read-write (`rw`) for other volume types, regardless of the original mount
+   * options specified in `TaskSpec.Volumes`. If you need different mount settings, you can
+   * explicitly configure them in this field.
    * @return value or {@code null} for none
    */
   public java.util.List<java.lang.String> getVolumes() {
@@ -339,13 +342,13 @@ public java.util.List<java.lang.String> getVolumes() {
 
   /**
    * Volumes to mount (bind mount) from the host machine files or directories into the container,
-   * formatted to match docker run's --volume option, e.g. /foo:/bar, or /foo:/bar:ro If the
-   * `TaskSpec.Volumes` field is specified but this field is not, Batch will mount each volume from
-   * the host machine to the container with the same mount path by default. In this case, the
-   * default mount option for containers will be read-only (ro) for existing persistent disks and
-   * read-write (rw) for other volume types, regardless of the original mount options specified in
-   * `TaskSpec.Volumes`. If you need different mount settings, you can explicitly configure them in
-   * this field.
+   * formatted to match `--volume` option for the `docker run` command—for example, `/foo:/bar` or
+   * `/foo:/bar:ro`. If the `TaskSpec.Volumes` field is specified but this field is not, Batch will
+   * mount each volume from the host machine to the container with the same mount path by default.
+   * In this case, the default mount option for containers will be read-only (`ro`) for existing
+   * persistent disks and read-write (`rw`) for other volume types, regardless of the original mount
+   * options specified in `TaskSpec.Volumes`. If you need different mount settings, you can
+   * explicitly configure them in this field.
    * @param volumes volumes or {@code null} for none
    */
   public Container setVolumes(java.util.List<java.lang.String> volumes) {

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

@@ -47,9 +47,8 @@ public final class Disk extends com.google.api.client.json.GenericJson {
    * projects/{project}/global/images/family/{image_family} * Specify the image version:
    * projects/{project}/global/images/{image_version} You can also use Batch customized image in
    * short names. The following image values are supported for a boot disk: * `batch-debian`: use
-   * Batch Debian images. * `batch-centos`: use Batch CentOS images. * `batch-cos`: use Batch
-   * Container-Optimized images. * `batch-hpc-centos`: use Batch HPC CentOS images. * `batch-hpc-
-   * rocky`: use Batch HPC Rocky Linux images.
+   * Batch Debian images. * `batch-cos`: use Batch Container-Optimized images. * `batch-hpc-rocky`:
+   * use Batch HPC Rocky Linux images.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -117,9 +116,8 @@ public Disk setDiskInterface(java.lang.String diskInterface) {
    * projects/{project}/global/images/family/{image_family} * Specify the image version:
    * projects/{project}/global/images/{image_version} You can also use Batch customized image in
    * short names. The following image values are supported for a boot disk: * `batch-debian`: use
-   * Batch Debian images. * `batch-centos`: use Batch CentOS images. * `batch-cos`: use Batch
-   * Container-Optimized images. * `batch-hpc-centos`: use Batch HPC CentOS images. * `batch-hpc-
-   * rocky`: use Batch HPC Rocky Linux images.
+   * Batch Debian images. * `batch-cos`: use Batch Container-Optimized images. * `batch-hpc-rocky`:
+   * use Batch HPC Rocky Linux images.
    * @return value or {@code null} for none
    */
   public java.lang.String getImage() {
@@ -132,9 +130,8 @@ public java.lang.String getImage() {
    * projects/{project}/global/images/family/{image_family} * Specify the image version:
    * projects/{project}/global/images/{image_version} You can also use Batch customized image in
    * short names. The following image values are supported for a boot disk: * `batch-debian`: use
-   * Batch Debian images. * `batch-centos`: use Batch CentOS images. * `batch-cos`: use Batch
-   * Container-Optimized images. * `batch-hpc-centos`: use Batch HPC CentOS images. * `batch-hpc-
-   * rocky`: use Batch HPC Rocky Linux images.
+   * Batch Debian images. * `batch-cos`: use Batch Container-Optimized images. * `batch-hpc-rocky`:
+   * use Batch HPC Rocky Linux images.
    * @param image image or {@code null} for none
    */
   public Disk setImage(java.lang.String image) {

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

@@ -30,44 +30,49 @@
 public final class Script extends com.google.api.client.json.GenericJson {
 
   /**
-   * Script file path on the host VM. To specify an interpreter, please add a `#!`(also known as
-   * [shebang line](https://en.wikipedia.org/wiki/Shebang_(Unix))) as 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 executed by `/bin/sh`.
+   * The path to a script file that is accessible from the host VM(s). Unless the script file
+   * supports the default `#!/bin/sh` shell interpreter, you must specify an interpreter by
+   * including a [shebang line](https://en.wikipedia.org/wiki/Shebang_(Unix) as the first line of
+   * the file. For example, to execute the script using bash, include `#!/bin/bash` as the first
+   * line of the file. Alternatively, to execute the script using Python3, include `#!/usr/bin/env
+   * python3` as the first line of the file.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private java.lang.String path;
 
   /**
-   * 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 executed by `/bin/sh`.
+   * The text for a script. Unless the script text supports the default `#!/bin/sh` shell
+   * interpreter, you must specify an interpreter by including a [shebang
+   * line](https://en.wikipedia.org/wiki/Shebang_(Unix) at the beginning of the text. For example,
+   * to execute the script using bash, include `#!/bin/bash\n` at the beginning of the text.
+   * Alternatively, to execute the script using Python3, include `#!/usr/bin/env python3\n` at the
+   * beginning of the text.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private java.lang.String text;
 
   /**
-   * Script file path on the host VM. To specify an interpreter, please add a `#!`(also known as
-   * [shebang line](https://en.wikipedia.org/wiki/Shebang_(Unix))) as 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 executed by `/bin/sh`.
+   * The path to a script file that is accessible from the host VM(s). Unless the script file
+   * supports the default `#!/bin/sh` shell interpreter, you must specify an interpreter by
+   * including a [shebang line](https://en.wikipedia.org/wiki/Shebang_(Unix) as the first line of
+   * the file. For example, to execute the script using bash, include `#!/bin/bash` as the first
+   * line of the file. Alternatively, to execute the script using Python3, include `#!/usr/bin/env
+   * python3` as the first line of the file.
    * @return value or {@code null} for none
    */
   public java.lang.String getPath() {
     return path;
   }
 
   /**
-   * Script file path on the host VM. To specify an interpreter, please add a `#!`(also known as
-   * [shebang line](https://en.wikipedia.org/wiki/Shebang_(Unix))) as 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 executed by `/bin/sh`.
+   * The path to a script file that is accessible from the host VM(s). Unless the script file
+   * supports the default `#!/bin/sh` shell interpreter, you must specify an interpreter by
+   * including a [shebang line](https://en.wikipedia.org/wiki/Shebang_(Unix) as the first line of
+   * the file. For example, to execute the script using bash, include `#!/bin/bash` as the first
+   * line of the file. Alternatively, to execute the script using Python3, include `#!/usr/bin/env
+   * python3` as the first line of the file.
    * @param path path or {@code null} for none
    */
   public Script setPath(java.lang.String path) {
@@ -76,21 +81,25 @@ public Script setPath(java.lang.String path) {
   }
 
   /**
-   * 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 executed by `/bin/sh`.
+   * The text for a script. Unless the script text supports the default `#!/bin/sh` shell
+   * interpreter, you must specify an interpreter by including a [shebang
+   * line](https://en.wikipedia.org/wiki/Shebang_(Unix) at the beginning of the text. For example,
+   * to execute the script using bash, include `#!/bin/bash\n` at the beginning of the text.
+   * Alternatively, to execute the script using Python3, include `#!/usr/bin/env python3\n` at the
+   * beginning of the text.
    * @return value or {@code null} for none
    */
   public java.lang.String getText() {
     return text;
   }
 
   /**
-   * 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 executed by `/bin/sh`.
+   * The text for a script. Unless the script text supports the default `#!/bin/sh` shell
+   * interpreter, you must specify an interpreter by including a [shebang
+   * line](https://en.wikipedia.org/wiki/Shebang_(Unix) at the beginning of the text. For example,
+   * to execute the script using bash, include `#!/bin/bash\n` at the beginning of the text.
+   * Alternatively, to execute the script using Python3, include `#!/usr/bin/env python3\n` at the
+   * beginning of the text.
    * @param text text or {@code null} for none
    */
   public Script setText(java.lang.String text) {