- * Normally, a non-zero exit status causes the Task to fail. This flag allows
- * execution of other Runnables to continue instead.
+ * Normally, a runnable that returns a non-zero exit status fails and causes
+ * the task to fail. However, you can set this field to `true` to allow the
+ * task to continue executing its other runnables even if this runnable
+ * fails.
*
*
* bool ignore_exit_status = 3;
@@ -5212,9 +5214,18 @@ public boolean getIgnoreExitStatus() {
*
*
*
- * This flag allows a Runnable to continue running in the background while the
- * Task executes subsequent Runnables. This is useful to provide services to
- * other Runnables (or to provide debugging support tools like SSH servers).
+ * Normally, a runnable that doesn't exit causes its task to fail. However,
+ * you can set this field to `true` to configure a background runnable.
+ * Background runnables are allowed continue running in the background while
+ * the task executes subsequent runnables. For example, background runnables
+ * are useful for providing services to other runnables or providing
+ * debugging-support tools like SSH servers.
+ *
+ * Specifically, background runnables are killed automatically (if they have
+ * not already exited) a short time after all foreground runnables have
+ * completed. Even though this is likely to result in a non-zero exit status
+ * for the background runnable, these automatic kills are not treated as task
+ * failures.
*
*
* bool background = 4;
@@ -6876,8 +6887,10 @@ public Builder setDisplayNameBytes(com.google.protobuf.ByteString value) {
*
*
*
- * Normally, a non-zero exit status causes the Task to fail. This flag allows
- * execution of other Runnables to continue instead.
+ * Normally, a runnable that returns a non-zero exit status fails and causes
+ * the task to fail. However, you can set this field to `true` to allow the
+ * task to continue executing its other runnables even if this runnable
+ * fails.
*
*
* bool ignore_exit_status = 3;
@@ -6892,8 +6905,10 @@ public boolean getIgnoreExitStatus() {
*
*
*
- * Normally, a non-zero exit status causes the Task to fail. This flag allows
- * execution of other Runnables to continue instead.
+ * Normally, a runnable that returns a non-zero exit status fails and causes
+ * the task to fail. However, you can set this field to `true` to allow the
+ * task to continue executing its other runnables even if this runnable
+ * fails.
*
*
* bool ignore_exit_status = 3;
@@ -6912,8 +6927,10 @@ public Builder setIgnoreExitStatus(boolean value) {
*
*
*
- * Normally, a non-zero exit status causes the Task to fail. This flag allows
- * execution of other Runnables to continue instead.
+ * Normally, a runnable that returns a non-zero exit status fails and causes
+ * the task to fail. However, you can set this field to `true` to allow the
+ * task to continue executing its other runnables even if this runnable
+ * fails.
*
*
* bool ignore_exit_status = 3;
@@ -6932,9 +6949,18 @@ public Builder clearIgnoreExitStatus() {
*
*
*
- * This flag allows a Runnable to continue running in the background while the
- * Task executes subsequent Runnables. This is useful to provide services to
- * other Runnables (or to provide debugging support tools like SSH servers).
+ * Normally, a runnable that doesn't exit causes its task to fail. However,
+ * you can set this field to `true` to configure a background runnable.
+ * Background runnables are allowed continue running in the background while
+ * the task executes subsequent runnables. For example, background runnables
+ * are useful for providing services to other runnables or providing
+ * debugging-support tools like SSH servers.
+ *
+ * Specifically, background runnables are killed automatically (if they have
+ * not already exited) a short time after all foreground runnables have
+ * completed. Even though this is likely to result in a non-zero exit status
+ * for the background runnable, these automatic kills are not treated as task
+ * failures.
*
*
* bool background = 4;
@@ -6949,9 +6975,18 @@ public boolean getBackground() {
*
*
*
- * This flag allows a Runnable to continue running in the background while the
- * Task executes subsequent Runnables. This is useful to provide services to
- * other Runnables (or to provide debugging support tools like SSH servers).
+ * Normally, a runnable that doesn't exit causes its task to fail. However,
+ * you can set this field to `true` to configure a background runnable.
+ * Background runnables are allowed continue running in the background while
+ * the task executes subsequent runnables. For example, background runnables
+ * are useful for providing services to other runnables or providing
+ * debugging-support tools like SSH servers.
+ *
+ * Specifically, background runnables are killed automatically (if they have
+ * not already exited) a short time after all foreground runnables have
+ * completed. Even though this is likely to result in a non-zero exit status
+ * for the background runnable, these automatic kills are not treated as task
+ * failures.
*
*
* bool background = 4;
@@ -6970,9 +7005,18 @@ public Builder setBackground(boolean value) {
*
*
*
- * This flag allows a Runnable to continue running in the background while the
- * Task executes subsequent Runnables. This is useful to provide services to
- * other Runnables (or to provide debugging support tools like SSH servers).
+ * Normally, a runnable that doesn't exit causes its task to fail. However,
+ * you can set this field to `true` to configure a background runnable.
+ * Background runnables are allowed continue running in the background while
+ * the task executes subsequent runnables. For example, background runnables
+ * are useful for providing services to other runnables or providing
+ * debugging-support tools like SSH servers.
+ *
+ * Specifically, background runnables are killed automatically (if they have
+ * not already exited) a short time after all foreground runnables have
+ * completed. Even though this is likely to result in a non-zero exit status
+ * for the background runnable, these automatic kills are not treated as task
+ * failures.
*
*
* bool background = 4;
diff --git a/java-batch/proto-google-cloud-batch-v1/src/main/java/com/google/cloud/batch/v1/RunnableOrBuilder.java b/java-batch/proto-google-cloud-batch-v1/src/main/java/com/google/cloud/batch/v1/RunnableOrBuilder.java
index 60832a170c52..e294bd4d8850 100644
--- a/java-batch/proto-google-cloud-batch-v1/src/main/java/com/google/cloud/batch/v1/RunnableOrBuilder.java
+++ b/java-batch/proto-google-cloud-batch-v1/src/main/java/com/google/cloud/batch/v1/RunnableOrBuilder.java
@@ -164,8 +164,10 @@ public interface RunnableOrBuilder
*
*
*
- * Normally, a non-zero exit status causes the Task to fail. This flag allows
- * execution of other Runnables to continue instead.
+ * Normally, a runnable that returns a non-zero exit status fails and causes
+ * the task to fail. However, you can set this field to `true` to allow the
+ * task to continue executing its other runnables even if this runnable
+ * fails.
*
*
* bool ignore_exit_status = 3;
@@ -178,9 +180,18 @@ public interface RunnableOrBuilder
*
*
*
- * This flag allows a Runnable to continue running in the background while the
- * Task executes subsequent Runnables. This is useful to provide services to
- * other Runnables (or to provide debugging support tools like SSH servers).
+ * Normally, a runnable that doesn't exit causes its task to fail. However,
+ * you can set this field to `true` to configure a background runnable.
+ * Background runnables are allowed continue running in the background while
+ * the task executes subsequent runnables. For example, background runnables
+ * are useful for providing services to other runnables or providing
+ * debugging-support tools like SSH servers.
+ *
+ * Specifically, background runnables are killed automatically (if they have
+ * not already exited) a short time after all foreground runnables have
+ * completed. Even though this is likely to result in a non-zero exit status
+ * for the background runnable, these automatic kills are not treated as task
+ * failures.
*
*
* bool background = 4;
diff --git a/java-batch/proto-google-cloud-batch-v1/src/main/java/com/google/cloud/batch/v1/TaskSpec.java b/java-batch/proto-google-cloud-batch-v1/src/main/java/com/google/cloud/batch/v1/TaskSpec.java
index 794a1bffa8f0..ca4541d239fb 100644
--- a/java-batch/proto-google-cloud-batch-v1/src/main/java/com/google/cloud/batch/v1/TaskSpec.java
+++ b/java-batch/proto-google-cloud-batch-v1/src/main/java/com/google/cloud/batch/v1/TaskSpec.java
@@ -89,15 +89,13 @@ protected com.google.protobuf.MapFieldReflectionAccessor internalGetMapFieldRefl
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -113,15 +111,13 @@ public java.util.Listrepeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -138,15 +134,13 @@ public java.util.Listrepeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -162,15 +156,13 @@ public int getRunnablesCount() {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -186,15 +178,13 @@ public com.google.cloud.batch.v1.Runnable getRunnables(int index) {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1422,15 +1412,13 @@ private void ensureRunnablesIsMutable() {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1449,15 +1437,13 @@ public java.util.Listrepeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1476,15 +1462,13 @@ public int getRunnablesCount() {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1503,15 +1487,13 @@ public com.google.cloud.batch.v1.Runnable getRunnables(int index) {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1536,15 +1518,13 @@ public Builder setRunnables(int index, com.google.cloud.batch.v1.Runnable value)
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1567,15 +1547,13 @@ public Builder setRunnables(
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1600,15 +1578,13 @@ public Builder addRunnables(com.google.cloud.batch.v1.Runnable value) {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1633,15 +1609,13 @@ public Builder addRunnables(int index, com.google.cloud.batch.v1.Runnable value)
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1663,15 +1637,13 @@ public Builder addRunnables(com.google.cloud.batch.v1.Runnable.Builder builderFo
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1694,15 +1666,13 @@ public Builder addRunnables(
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1725,15 +1695,13 @@ public Builder addAllRunnables(
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1755,15 +1723,13 @@ public Builder clearRunnables() {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1785,15 +1751,13 @@ public Builder removeRunnables(int index) {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1808,15 +1772,13 @@ public com.google.cloud.batch.v1.Runnable.Builder getRunnablesBuilder(int index)
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1835,15 +1797,13 @@ public com.google.cloud.batch.v1.RunnableOrBuilder getRunnablesOrBuilder(int ind
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1863,15 +1823,13 @@ public com.google.cloud.batch.v1.RunnableOrBuilder getRunnablesOrBuilder(int ind
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1887,15 +1845,13 @@ public com.google.cloud.batch.v1.Runnable.Builder addRunnablesBuilder() {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -1911,15 +1867,13 @@ public com.google.cloud.batch.v1.Runnable.Builder addRunnablesBuilder(int index)
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
diff --git a/java-batch/proto-google-cloud-batch-v1/src/main/java/com/google/cloud/batch/v1/TaskSpecOrBuilder.java b/java-batch/proto-google-cloud-batch-v1/src/main/java/com/google/cloud/batch/v1/TaskSpecOrBuilder.java
index 67be4a8dc4d4..21417cf34f5f 100644
--- a/java-batch/proto-google-cloud-batch-v1/src/main/java/com/google/cloud/batch/v1/TaskSpecOrBuilder.java
+++ b/java-batch/proto-google-cloud-batch-v1/src/main/java/com/google/cloud/batch/v1/TaskSpecOrBuilder.java
@@ -31,15 +31,13 @@ public interface TaskSpecOrBuilder
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -52,15 +50,13 @@ public interface TaskSpecOrBuilder
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -73,15 +69,13 @@ public interface TaskSpecOrBuilder
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -94,15 +88,13 @@ public interface TaskSpecOrBuilder
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
@@ -115,15 +107,13 @@ public interface TaskSpecOrBuilder
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1.Runnable runnables = 8;
diff --git a/java-batch/proto-google-cloud-batch-v1/src/main/proto/google/cloud/batch/v1/task.proto b/java-batch/proto-google-cloud-batch-v1/src/main/proto/google/cloud/batch/v1/task.proto
index 5aba9c8a5097..f9edabb2b6a0 100644
--- a/java-batch/proto-google-cloud-batch-v1/src/main/proto/google/cloud/batch/v1/task.proto
+++ b/java-batch/proto-google-cloud-batch-v1/src/main/proto/google/cloud/batch/v1/task.proto
@@ -304,13 +304,24 @@ message Runnable {
// provided the index of the runnable will be used for outputs.
string display_name = 10 [(google.api.field_behavior) = OPTIONAL];
- // Normally, a non-zero exit status causes the Task to fail. This flag allows
- // execution of other Runnables to continue instead.
+ // Normally, a runnable that returns a non-zero exit status fails and causes
+ // the task to fail. However, you can set this field to `true` to allow the
+ // task to continue executing its other runnables even if this runnable
+ // fails.
bool ignore_exit_status = 3;
- // This flag allows a Runnable to continue running in the background while the
- // Task executes subsequent Runnables. This is useful to provide services to
- // other Runnables (or to provide debugging support tools like SSH servers).
+ // Normally, a runnable that doesn't exit causes its task to fail. However,
+ // you can set this field to `true` to configure a background runnable.
+ // Background runnables are allowed continue running in the background while
+ // the task executes subsequent runnables. For example, background runnables
+ // are useful for providing services to other runnables or providing
+ // debugging-support tools like SSH servers.
+ //
+ // Specifically, background runnables are killed automatically (if they have
+ // not already exited) a short time after all foreground runnables have
+ // completed. Even though this is likely to result in a non-zero exit status
+ // for the background runnable, these automatic kills are not treated as task
+ // failures.
bool background = 4;
// By default, after a Runnable fails, no further Runnable are executed. This
@@ -339,15 +350,13 @@ message TaskSpec {
// Required. The sequence of one or more runnables (executable scripts,
// executable containers, and/or barriers) for each task in this task group to
// run. Each task runs this list of runnables in order. For a task to succeed,
- // all of its script and container runnables each must either exit with a zero
- // status or enable the `ignore_exit_status` subfield and exit with any
- // status.
+ // all of its script and container runnables each must meet at least one of
+ // the following conditions:
//
- // Background runnables are killed automatically (if they have not already
- // exited) a short time after all foreground runnables have completed. Even
- // though this is likely to result in a non-zero exit status for the
- // background runnable, these automatic kills are not treated as Task
- // failures.
+ // + The runnable exited with a zero status.
+ // + The runnable didn't finish, but you enabled its `background` subfield.
+ // + The runnable exited with a non-zero status, but you enabled its
+ // `ignore_exit_status` subfield.
repeated Runnable runnables = 8;
// ComputeResource requirements.
diff --git a/java-batch/proto-google-cloud-batch-v1alpha/src/main/java/com/google/cloud/batch/v1alpha/Runnable.java b/java-batch/proto-google-cloud-batch-v1alpha/src/main/java/com/google/cloud/batch/v1alpha/Runnable.java
index a14c6f971a18..aaeeaeb131d2 100644
--- a/java-batch/proto-google-cloud-batch-v1alpha/src/main/java/com/google/cloud/batch/v1alpha/Runnable.java
+++ b/java-batch/proto-google-cloud-batch-v1alpha/src/main/java/com/google/cloud/batch/v1alpha/Runnable.java
@@ -5196,8 +5196,10 @@ public com.google.protobuf.ByteString getDisplayNameBytes() {
*
*
*
- * Normally, a non-zero exit status causes the Task to fail. This flag allows
- * execution of other Runnables to continue instead.
+ * Normally, a runnable that returns a non-zero exit status fails and causes
+ * the task to fail. However, you can set this field to `true` to allow the
+ * task to continue executing its other runnables even if this runnable
+ * fails.
*
*
* bool ignore_exit_status = 3;
@@ -5215,9 +5217,18 @@ public boolean getIgnoreExitStatus() {
*
*
*
- * This flag allows a Runnable to continue running in the background while the
- * Task executes subsequent Runnables. This is useful to provide services to
- * other Runnables (or to provide debugging support tools like SSH servers).
+ * Normally, a runnable that doesn't exit causes its task to fail. However,
+ * you can set this field to `true` to configure a background runnable.
+ * Background runnables are allowed continue running in the background while
+ * the task executes subsequent runnables. For example, background runnables
+ * are useful for providing services to other runnables or providing
+ * debugging-support tools like SSH servers.
+ *
+ * Specifically, background runnables are killed automatically (if they have
+ * not already exited) a short time after all foreground runnables have
+ * completed. Even though this is likely to result in a non-zero exit status
+ * for the background runnable, these automatic kills are not treated as task
+ * failures.
*
*
* bool background = 4;
@@ -6885,8 +6896,10 @@ public Builder setDisplayNameBytes(com.google.protobuf.ByteString value) {
*
*
*
- * Normally, a non-zero exit status causes the Task to fail. This flag allows
- * execution of other Runnables to continue instead.
+ * Normally, a runnable that returns a non-zero exit status fails and causes
+ * the task to fail. However, you can set this field to `true` to allow the
+ * task to continue executing its other runnables even if this runnable
+ * fails.
*
*
* bool ignore_exit_status = 3;
@@ -6901,8 +6914,10 @@ public boolean getIgnoreExitStatus() {
*
*
*
- * Normally, a non-zero exit status causes the Task to fail. This flag allows
- * execution of other Runnables to continue instead.
+ * Normally, a runnable that returns a non-zero exit status fails and causes
+ * the task to fail. However, you can set this field to `true` to allow the
+ * task to continue executing its other runnables even if this runnable
+ * fails.
*
*
* bool ignore_exit_status = 3;
@@ -6921,8 +6936,10 @@ public Builder setIgnoreExitStatus(boolean value) {
*
*
*
- * Normally, a non-zero exit status causes the Task to fail. This flag allows
- * execution of other Runnables to continue instead.
+ * Normally, a runnable that returns a non-zero exit status fails and causes
+ * the task to fail. However, you can set this field to `true` to allow the
+ * task to continue executing its other runnables even if this runnable
+ * fails.
*
*
* bool ignore_exit_status = 3;
@@ -6941,9 +6958,18 @@ public Builder clearIgnoreExitStatus() {
*
*
*
- * This flag allows a Runnable to continue running in the background while the
- * Task executes subsequent Runnables. This is useful to provide services to
- * other Runnables (or to provide debugging support tools like SSH servers).
+ * Normally, a runnable that doesn't exit causes its task to fail. However,
+ * you can set this field to `true` to configure a background runnable.
+ * Background runnables are allowed continue running in the background while
+ * the task executes subsequent runnables. For example, background runnables
+ * are useful for providing services to other runnables or providing
+ * debugging-support tools like SSH servers.
+ *
+ * Specifically, background runnables are killed automatically (if they have
+ * not already exited) a short time after all foreground runnables have
+ * completed. Even though this is likely to result in a non-zero exit status
+ * for the background runnable, these automatic kills are not treated as task
+ * failures.
*
*
* bool background = 4;
@@ -6958,9 +6984,18 @@ public boolean getBackground() {
*
*
*
- * This flag allows a Runnable to continue running in the background while the
- * Task executes subsequent Runnables. This is useful to provide services to
- * other Runnables (or to provide debugging support tools like SSH servers).
+ * Normally, a runnable that doesn't exit causes its task to fail. However,
+ * you can set this field to `true` to configure a background runnable.
+ * Background runnables are allowed continue running in the background while
+ * the task executes subsequent runnables. For example, background runnables
+ * are useful for providing services to other runnables or providing
+ * debugging-support tools like SSH servers.
+ *
+ * Specifically, background runnables are killed automatically (if they have
+ * not already exited) a short time after all foreground runnables have
+ * completed. Even though this is likely to result in a non-zero exit status
+ * for the background runnable, these automatic kills are not treated as task
+ * failures.
*
*
* bool background = 4;
@@ -6979,9 +7014,18 @@ public Builder setBackground(boolean value) {
*
*
*
- * This flag allows a Runnable to continue running in the background while the
- * Task executes subsequent Runnables. This is useful to provide services to
- * other Runnables (or to provide debugging support tools like SSH servers).
+ * Normally, a runnable that doesn't exit causes its task to fail. However,
+ * you can set this field to `true` to configure a background runnable.
+ * Background runnables are allowed continue running in the background while
+ * the task executes subsequent runnables. For example, background runnables
+ * are useful for providing services to other runnables or providing
+ * debugging-support tools like SSH servers.
+ *
+ * Specifically, background runnables are killed automatically (if they have
+ * not already exited) a short time after all foreground runnables have
+ * completed. Even though this is likely to result in a non-zero exit status
+ * for the background runnable, these automatic kills are not treated as task
+ * failures.
*
*
* bool background = 4;
diff --git a/java-batch/proto-google-cloud-batch-v1alpha/src/main/java/com/google/cloud/batch/v1alpha/RunnableOrBuilder.java b/java-batch/proto-google-cloud-batch-v1alpha/src/main/java/com/google/cloud/batch/v1alpha/RunnableOrBuilder.java
index 0e1b5fbe3372..e0fbf1509775 100644
--- a/java-batch/proto-google-cloud-batch-v1alpha/src/main/java/com/google/cloud/batch/v1alpha/RunnableOrBuilder.java
+++ b/java-batch/proto-google-cloud-batch-v1alpha/src/main/java/com/google/cloud/batch/v1alpha/RunnableOrBuilder.java
@@ -164,8 +164,10 @@ public interface RunnableOrBuilder
*
*
*
- * Normally, a non-zero exit status causes the Task to fail. This flag allows
- * execution of other Runnables to continue instead.
+ * Normally, a runnable that returns a non-zero exit status fails and causes
+ * the task to fail. However, you can set this field to `true` to allow the
+ * task to continue executing its other runnables even if this runnable
+ * fails.
*
*
* bool ignore_exit_status = 3;
@@ -178,9 +180,18 @@ public interface RunnableOrBuilder
*
*
*
- * This flag allows a Runnable to continue running in the background while the
- * Task executes subsequent Runnables. This is useful to provide services to
- * other Runnables (or to provide debugging support tools like SSH servers).
+ * Normally, a runnable that doesn't exit causes its task to fail. However,
+ * you can set this field to `true` to configure a background runnable.
+ * Background runnables are allowed continue running in the background while
+ * the task executes subsequent runnables. For example, background runnables
+ * are useful for providing services to other runnables or providing
+ * debugging-support tools like SSH servers.
+ *
+ * Specifically, background runnables are killed automatically (if they have
+ * not already exited) a short time after all foreground runnables have
+ * completed. Even though this is likely to result in a non-zero exit status
+ * for the background runnable, these automatic kills are not treated as task
+ * failures.
*
*
* bool background = 4;
diff --git a/java-batch/proto-google-cloud-batch-v1alpha/src/main/java/com/google/cloud/batch/v1alpha/TaskSpec.java b/java-batch/proto-google-cloud-batch-v1alpha/src/main/java/com/google/cloud/batch/v1alpha/TaskSpec.java
index e020f83540a3..de4bda8eea83 100644
--- a/java-batch/proto-google-cloud-batch-v1alpha/src/main/java/com/google/cloud/batch/v1alpha/TaskSpec.java
+++ b/java-batch/proto-google-cloud-batch-v1alpha/src/main/java/com/google/cloud/batch/v1alpha/TaskSpec.java
@@ -89,15 +89,13 @@ protected com.google.protobuf.MapFieldReflectionAccessor internalGetMapFieldRefl
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -113,15 +111,13 @@ public java.util.Listrepeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -138,15 +134,13 @@ public java.util.Listrepeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -162,15 +156,13 @@ public int getRunnablesCount() {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -186,15 +178,13 @@ public com.google.cloud.batch.v1alpha.Runnable getRunnables(int index) {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1425,15 +1415,13 @@ private void ensureRunnablesIsMutable() {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1452,15 +1440,13 @@ public java.util.Listrepeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1479,15 +1465,13 @@ public int getRunnablesCount() {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1506,15 +1490,13 @@ public com.google.cloud.batch.v1alpha.Runnable getRunnables(int index) {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1539,15 +1521,13 @@ public Builder setRunnables(int index, com.google.cloud.batch.v1alpha.Runnable v
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1570,15 +1550,13 @@ public Builder setRunnables(
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1603,15 +1581,13 @@ public Builder addRunnables(com.google.cloud.batch.v1alpha.Runnable value) {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1636,15 +1612,13 @@ public Builder addRunnables(int index, com.google.cloud.batch.v1alpha.Runnable v
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1666,15 +1640,13 @@ public Builder addRunnables(com.google.cloud.batch.v1alpha.Runnable.Builder buil
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1697,15 +1669,13 @@ public Builder addRunnables(
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1728,15 +1698,13 @@ public Builder addAllRunnables(
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1758,15 +1726,13 @@ public Builder clearRunnables() {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1788,15 +1754,13 @@ public Builder removeRunnables(int index) {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1811,15 +1775,13 @@ public com.google.cloud.batch.v1alpha.Runnable.Builder getRunnablesBuilder(int i
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1838,15 +1800,13 @@ public com.google.cloud.batch.v1alpha.RunnableOrBuilder getRunnablesOrBuilder(in
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1866,15 +1826,13 @@ public com.google.cloud.batch.v1alpha.RunnableOrBuilder getRunnablesOrBuilder(in
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1890,15 +1848,13 @@ public com.google.cloud.batch.v1alpha.Runnable.Builder addRunnablesBuilder() {
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
*
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -1914,15 +1870,13 @@ public com.google.cloud.batch.v1alpha.Runnable.Builder addRunnablesBuilder(int i
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
diff --git a/java-batch/proto-google-cloud-batch-v1alpha/src/main/java/com/google/cloud/batch/v1alpha/TaskSpecOrBuilder.java b/java-batch/proto-google-cloud-batch-v1alpha/src/main/java/com/google/cloud/batch/v1alpha/TaskSpecOrBuilder.java
index 4c7b45db83b8..6e10b2e6401e 100644
--- a/java-batch/proto-google-cloud-batch-v1alpha/src/main/java/com/google/cloud/batch/v1alpha/TaskSpecOrBuilder.java
+++ b/java-batch/proto-google-cloud-batch-v1alpha/src/main/java/com/google/cloud/batch/v1alpha/TaskSpecOrBuilder.java
@@ -31,15 +31,13 @@ public interface TaskSpecOrBuilder
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -52,15 +50,13 @@ public interface TaskSpecOrBuilder
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -73,15 +69,13 @@ public interface TaskSpecOrBuilder
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -94,15 +88,13 @@ public interface TaskSpecOrBuilder
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
@@ -116,15 +108,13 @@ public interface TaskSpecOrBuilder
* Required. The sequence of one or more runnables (executable scripts,
* executable containers, and/or barriers) for each task in this task group to
* run. Each task runs this list of runnables in order. For a task to succeed,
- * all of its script and container runnables each must either exit with a zero
- * status or enable the `ignore_exit_status` subfield and exit with any
- * status.
- *
- * Background runnables are killed automatically (if they have not already
- * exited) a short time after all foreground runnables have completed. Even
- * though this is likely to result in a non-zero exit status for the
- * background runnable, these automatic kills are not treated as Task
- * failures.
+ * all of its script and container runnables each must meet at least one of
+ * the following conditions:
+ *
+ * + The runnable exited with a zero status.
+ * + The runnable didn't finish, but you enabled its `background` subfield.
+ * + The runnable exited with a non-zero status, but you enabled its
+ * `ignore_exit_status` subfield.
*
*
* repeated .google.cloud.batch.v1alpha.Runnable runnables = 8;
diff --git a/java-batch/proto-google-cloud-batch-v1alpha/src/main/proto/google/cloud/batch/v1alpha/task.proto b/java-batch/proto-google-cloud-batch-v1alpha/src/main/proto/google/cloud/batch/v1alpha/task.proto
index 073e77e71422..08a20f499dd1 100644
--- a/java-batch/proto-google-cloud-batch-v1alpha/src/main/proto/google/cloud/batch/v1alpha/task.proto
+++ b/java-batch/proto-google-cloud-batch-v1alpha/src/main/proto/google/cloud/batch/v1alpha/task.proto
@@ -323,13 +323,24 @@ message Runnable {
// provided the index of the runnable will be used for outputs.
string display_name = 10 [(google.api.field_behavior) = OPTIONAL];
- // Normally, a non-zero exit status causes the Task to fail. This flag allows
- // execution of other Runnables to continue instead.
+ // Normally, a runnable that returns a non-zero exit status fails and causes
+ // the task to fail. However, you can set this field to `true` to allow the
+ // task to continue executing its other runnables even if this runnable
+ // fails.
bool ignore_exit_status = 3;
- // This flag allows a Runnable to continue running in the background while the
- // Task executes subsequent Runnables. This is useful to provide services to
- // other Runnables (or to provide debugging support tools like SSH servers).
+ // Normally, a runnable that doesn't exit causes its task to fail. However,
+ // you can set this field to `true` to configure a background runnable.
+ // Background runnables are allowed continue running in the background while
+ // the task executes subsequent runnables. For example, background runnables
+ // are useful for providing services to other runnables or providing
+ // debugging-support tools like SSH servers.
+ //
+ // Specifically, background runnables are killed automatically (if they have
+ // not already exited) a short time after all foreground runnables have
+ // completed. Even though this is likely to result in a non-zero exit status
+ // for the background runnable, these automatic kills are not treated as task
+ // failures.
bool background = 4;
// By default, after a Runnable fails, no further Runnable are executed. This
@@ -358,15 +369,13 @@ message TaskSpec {
// Required. The sequence of one or more runnables (executable scripts,
// executable containers, and/or barriers) for each task in this task group to
// run. Each task runs this list of runnables in order. For a task to succeed,
- // all of its script and container runnables each must either exit with a zero
- // status or enable the `ignore_exit_status` subfield and exit with any
- // status.
+ // all of its script and container runnables each must meet at least one of
+ // the following conditions:
//
- // Background runnables are killed automatically (if they have not already
- // exited) a short time after all foreground runnables have completed. Even
- // though this is likely to result in a non-zero exit status for the
- // background runnable, these automatic kills are not treated as Task
- // failures.
+ // + The runnable exited with a zero status.
+ // + The runnable didn't finish, but you enabled its `background` subfield.
+ // + The runnable exited with a non-zero status, but you enabled its
+ // `ignore_exit_status` subfield.
repeated Runnable runnables = 8;
// ComputeResource requirements.
diff --git a/java-gke-connect-gateway/google-cloud-gke-connect-gateway/src/main/java/com/google/cloud/gkeconnect/gateway/v1beta1/GatewayControlClient.java b/java-gke-connect-gateway/google-cloud-gke-connect-gateway/src/main/java/com/google/cloud/gkeconnect/gateway/v1beta1/GatewayControlClient.java
new file mode 100644
index 000000000000..9fb7bb3f77f0
--- /dev/null
+++ b/java-gke-connect-gateway/google-cloud-gke-connect-gateway/src/main/java/com/google/cloud/gkeconnect/gateway/v1beta1/GatewayControlClient.java
@@ -0,0 +1,263 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.cloud.gkeconnect.gateway.v1beta1;
+
+import com.google.api.core.BetaApi;
+import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.rpc.UnaryCallable;
+import com.google.cloud.gkeconnect.gateway.v1beta1.stub.GatewayControlStub;
+import com.google.cloud.gkeconnect.gateway.v1beta1.stub.GatewayControlStubSettings;
+import java.io.IOException;
+import java.util.concurrent.TimeUnit;
+import javax.annotation.Generated;
+
+// AUTO-GENERATED DOCUMENTATION AND CLASS.
+/**
+ * Service Description: GatewayControl is the control plane API for Connect Gateway.
+ *
+ * This class provides the ability to make remote calls to the backing service through method + * calls that map to API methods. Sample code to get started: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (GatewayControlClient gatewayControlClient = GatewayControlClient.create()) {
+ * GenerateCredentialsRequest request =
+ * GenerateCredentialsRequest.newBuilder()
+ * .setName("name3373707")
+ * .setForceUseAgent(true)
+ * .setVersion("version351608024")
+ * .setKubernetesNamespace("kubernetesNamespace-1862862667")
+ * .build();
+ * GenerateCredentialsResponse response = gatewayControlClient.generateCredentials(request);
+ * }
+ * }
+ *
+ * Note: close() needs to be called on the GatewayControlClient object to clean up resources such + * as threads. In the example above, try-with-resources is used, which automatically calls close(). + * + *
| Method | + *Description | + *Method Variants | + *
|---|---|---|
GenerateCredentials |
+ * GenerateCredentials provides connection information that allows a user to access the specified membership using Connect Gateway. |
+ *
+ * Request object method variants only take one parameter, a request object, which must be constructed before the call. + *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. + *
|
+ *
See the individual methods for example code. + * + *
Many parameters require resource names to be formatted in a particular way. To assist with + * these names, this class includes a format method for each type of name, and additionally a parse + * method to extract the individual identifiers contained within names that are returned. + * + *
This class can be customized by passing in a custom instance of GatewayControlSettings to + * create(). For example: + * + *
To customize credentials: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * GatewayControlSettings gatewayControlSettings =
+ * GatewayControlSettings.newBuilder()
+ * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
+ * .build();
+ * GatewayControlClient gatewayControlClient = GatewayControlClient.create(gatewayControlSettings);
+ * }
+ *
+ * To customize the endpoint: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * GatewayControlSettings gatewayControlSettings =
+ * GatewayControlSettings.newBuilder().setEndpoint(myEndpoint).build();
+ * GatewayControlClient gatewayControlClient = GatewayControlClient.create(gatewayControlSettings);
+ * }
+ *
+ * Please refer to the GitHub repository's samples for more quickstart code snippets. + */ +@BetaApi +@Generated("by gapic-generator-java") +public class GatewayControlClient implements BackgroundResource { + private final GatewayControlSettings settings; + private final GatewayControlStub stub; + + /** Constructs an instance of GatewayControlClient with default settings. */ + public static final GatewayControlClient create() throws IOException { + return create(GatewayControlSettings.newBuilder().build()); + } + + /** + * Constructs an instance of GatewayControlClient, using the given settings. The channels are + * created based on the settings passed in, or defaults for any settings that are not set. + */ + public static final GatewayControlClient create(GatewayControlSettings settings) + throws IOException { + return new GatewayControlClient(settings); + } + + /** + * Constructs an instance of GatewayControlClient, using the given stub for making calls. This is + * for advanced usage - prefer using create(GatewayControlSettings). + */ + public static final GatewayControlClient create(GatewayControlStub stub) { + return new GatewayControlClient(stub); + } + + /** + * Constructs an instance of GatewayControlClient, using the given settings. This is protected so + * that it is easy to make a subclass, but otherwise, the static factory methods should be + * preferred. + */ + protected GatewayControlClient(GatewayControlSettings settings) throws IOException { + this.settings = settings; + this.stub = ((GatewayControlStubSettings) settings.getStubSettings()).createStub(); + } + + protected GatewayControlClient(GatewayControlStub stub) { + this.settings = null; + this.stub = stub; + } + + public final GatewayControlSettings getSettings() { + return settings; + } + + public GatewayControlStub getStub() { + return stub; + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * GenerateCredentials provides connection information that allows a user to access the specified + * membership using Connect Gateway. + * + *
Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (GatewayControlClient gatewayControlClient = GatewayControlClient.create()) {
+ * GenerateCredentialsRequest request =
+ * GenerateCredentialsRequest.newBuilder()
+ * .setName("name3373707")
+ * .setForceUseAgent(true)
+ * .setVersion("version351608024")
+ * .setKubernetesNamespace("kubernetesNamespace-1862862667")
+ * .build();
+ * GenerateCredentialsResponse response = gatewayControlClient.generateCredentials(request);
+ * }
+ * }
+ *
+ * @param request The request object containing all of the parameters for the API call.
+ * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+ */
+ public final GenerateCredentialsResponse generateCredentials(GenerateCredentialsRequest request) {
+ return generateCredentialsCallable().call(request);
+ }
+
+ // AUTO-GENERATED DOCUMENTATION AND METHOD.
+ /**
+ * GenerateCredentials provides connection information that allows a user to access the specified
+ * membership using Connect Gateway.
+ *
+ * Sample code: + * + *
{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (GatewayControlClient gatewayControlClient = GatewayControlClient.create()) {
+ * GenerateCredentialsRequest request =
+ * GenerateCredentialsRequest.newBuilder()
+ * .setName("name3373707")
+ * .setForceUseAgent(true)
+ * .setVersion("version351608024")
+ * .setKubernetesNamespace("kubernetesNamespace-1862862667")
+ * .build();
+ * ApiFuture future =
+ * gatewayControlClient.generateCredentialsCallable().futureCall(request);
+ * // Do something.
+ * GenerateCredentialsResponse response = future.get();
+ * }
+ * }
+ */
+ public final UnaryCallableThe default instance has everything set to sensible defaults: * @@ -48,7 +47,7 @@ *
The builder of this class is recursive, so contained classes are themselves builders. When * build() is called, the tree of builders is called to create the complete settings object. * - *
For example, to set the total timeout of getResource to 30 seconds: + *
For example, to set the total timeout of generateCredentials to 30 seconds: * *
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
@@ -56,85 +55,66 @@
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
- * GatewayServiceSettings.Builder gatewayServiceSettingsBuilder =
- * GatewayServiceSettings.newBuilder();
- * gatewayServiceSettingsBuilder
- * .getResourceSettings()
+ * GatewayControlSettings.Builder gatewayControlSettingsBuilder =
+ * GatewayControlSettings.newBuilder();
+ * gatewayControlSettingsBuilder
+ * .generateCredentialsSettings()
* .setRetrySettings(
- * gatewayServiceSettingsBuilder
- * .getResourceSettings()
+ * gatewayControlSettingsBuilder
+ * .generateCredentialsSettings()
* .getRetrySettings()
* .toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30))
* .build());
- * GatewayServiceSettings gatewayServiceSettings = gatewayServiceSettingsBuilder.build();
+ * GatewayControlSettings gatewayControlSettings = gatewayControlSettingsBuilder.build();
* }
*/
@BetaApi
@Generated("by gapic-generator-java")
-public class GatewayServiceSettings extends ClientSettingsThis class provides the ability to make remote calls to the backing service through method - * calls that map to API methods. Sample code to get started: - * - *
{@code
- * // This snippet has been automatically generated and should be regarded as a code template only.
- * // It will require modifications to work:
- * // - It may require correct/in-range values for request initialization.
- * // - It may require specifying regional endpoints when creating the service client as shown in
- * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
- * try (GatewayServiceClient gatewayServiceClient = GatewayServiceClient.create()) {
- * HttpBody request =
- * HttpBody.newBuilder()
- * .setContentType("contentType-389131437")
- * .setData(ByteString.EMPTY)
- * .addAllExtensions(new ArrayList())
- * .build();
- * HttpBody response = gatewayServiceClient.getResource(request);
- * }
- * }
- *
- * Note: close() needs to be called on the GatewayServiceClient object to clean up resources such - * as threads. In the example above, try-with-resources is used, which automatically calls close(). - * - *
| Method | - *Description | - *Method Variants | - *
|---|---|---|
GetResource |
- * GetResource performs an HTTP GET request on the Kubernetes API Server. |
- *
- * Request object method variants only take one parameter, a request object, which must be constructed before the call. - *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. - *
|
- *
PostResource |
- * PostResource performs an HTTP POST on the Kubernetes API Server. |
- *
- * Request object method variants only take one parameter, a request object, which must be constructed before the call. - *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. - *
|
- *
DeleteResource |
- * DeleteResource performs an HTTP DELETE on the Kubernetes API Server. |
- *
- * Request object method variants only take one parameter, a request object, which must be constructed before the call. - *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. - *
|
- *
PutResource |
- * PutResource performs an HTTP PUT on the Kubernetes API Server. |
- *
- * Request object method variants only take one parameter, a request object, which must be constructed before the call. - *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. - *
|
- *
PatchResource |
- * PatchResource performs an HTTP PATCH on the Kubernetes API Server. |
- *
- * Request object method variants only take one parameter, a request object, which must be constructed before the call. - *
Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service. - *
|
- *
See the individual methods for example code. - * - *
Many parameters require resource names to be formatted in a particular way. To assist with - * these names, this class includes a format method for each type of name, and additionally a parse - * method to extract the individual identifiers contained within names that are returned. - * - *
This class can be customized by passing in a custom instance of GatewayServiceSettings to - * create(). For example: - * - *
To customize credentials: - * - *
{@code
- * // This snippet has been automatically generated and should be regarded as a code template only.
- * // It will require modifications to work:
- * // - It may require correct/in-range values for request initialization.
- * // - It may require specifying regional endpoints when creating the service client as shown in
- * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
- * GatewayServiceSettings gatewayServiceSettings =
- * GatewayServiceSettings.newBuilder()
- * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
- * .build();
- * GatewayServiceClient gatewayServiceClient = GatewayServiceClient.create(gatewayServiceSettings);
- * }
- *
- * To customize the endpoint: - * - *
{@code
- * // This snippet has been automatically generated and should be regarded as a code template only.
- * // It will require modifications to work:
- * // - It may require correct/in-range values for request initialization.
- * // - It may require specifying regional endpoints when creating the service client as shown in
- * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
- * GatewayServiceSettings gatewayServiceSettings =
- * GatewayServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
- * GatewayServiceClient gatewayServiceClient = GatewayServiceClient.create(gatewayServiceSettings);
- * }
- *
- * Please refer to the GitHub repository's samples for more quickstart code snippets. - */ -@BetaApi -@Generated("by gapic-generator-java") -public class GatewayServiceClient implements BackgroundResource { - private final GatewayServiceSettings settings; - private final GatewayServiceStub stub; - - /** Constructs an instance of GatewayServiceClient with default settings. */ - public static final GatewayServiceClient create() throws IOException { - return create(GatewayServiceSettings.newBuilder().build()); - } - - /** - * Constructs an instance of GatewayServiceClient, using the given settings. The channels are - * created based on the settings passed in, or defaults for any settings that are not set. - */ - public static final GatewayServiceClient create(GatewayServiceSettings settings) - throws IOException { - return new GatewayServiceClient(settings); - } - - /** - * Constructs an instance of GatewayServiceClient, using the given stub for making calls. This is - * for advanced usage - prefer using create(GatewayServiceSettings). - */ - public static final GatewayServiceClient create(GatewayServiceStub stub) { - return new GatewayServiceClient(stub); - } - - /** - * Constructs an instance of GatewayServiceClient, using the given settings. This is protected so - * that it is easy to make a subclass, but otherwise, the static factory methods should be - * preferred. - */ - protected GatewayServiceClient(GatewayServiceSettings settings) throws IOException { - this.settings = settings; - this.stub = ((GatewayServiceStubSettings) settings.getStubSettings()).createStub(); - } - - protected GatewayServiceClient(GatewayServiceStub stub) { - this.settings = null; - this.stub = stub; - } - - public final GatewayServiceSettings getSettings() { - return settings; - } - - public GatewayServiceStub getStub() { - return stub; - } - - // AUTO-GENERATED DOCUMENTATION AND METHOD. - /** - * GetResource performs an HTTP GET request on the Kubernetes API Server. - * - *
Sample code: - * - *
{@code
- * // This snippet has been automatically generated and should be regarded as a code template only.
- * // It will require modifications to work:
- * // - It may require correct/in-range values for request initialization.
- * // - It may require specifying regional endpoints when creating the service client as shown in
- * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
- * try (GatewayServiceClient gatewayServiceClient = GatewayServiceClient.create()) {
- * HttpBody request =
- * HttpBody.newBuilder()
- * .setContentType("contentType-389131437")
- * .setData(ByteString.EMPTY)
- * .addAllExtensions(new ArrayList())
- * .build();
- * HttpBody response = gatewayServiceClient.getResource(request);
- * }
- * }
- *
- * @param request The request object containing all of the parameters for the API call.
- * @throws com.google.api.gax.rpc.ApiException if the remote call fails
- */
- public final HttpBody getResource(HttpBody request) {
- return getResourceCallable().call(request);
- }
-
- // AUTO-GENERATED DOCUMENTATION AND METHOD.
- /**
- * GetResource performs an HTTP GET request on the Kubernetes API Server.
- *
- * Sample code: - * - *
{@code
- * // This snippet has been automatically generated and should be regarded as a code template only.
- * // It will require modifications to work:
- * // - It may require correct/in-range values for request initialization.
- * // - It may require specifying regional endpoints when creating the service client as shown in
- * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
- * try (GatewayServiceClient gatewayServiceClient = GatewayServiceClient.create()) {
- * HttpBody request =
- * HttpBody.newBuilder()
- * .setContentType("contentType-389131437")
- * .setData(ByteString.EMPTY)
- * .addAllExtensions(new ArrayList())
- * .build();
- * ApiFuture future = gatewayServiceClient.getResourceCallable().futureCall(request);
- * // Do something.
- * HttpBody response = future.get();
- * }
- * }
- */
- public final UnaryCallableSample code: - * - *
{@code
- * // This snippet has been automatically generated and should be regarded as a code template only.
- * // It will require modifications to work:
- * // - It may require correct/in-range values for request initialization.
- * // - It may require specifying regional endpoints when creating the service client as shown in
- * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
- * try (GatewayServiceClient gatewayServiceClient = GatewayServiceClient.create()) {
- * HttpBody request =
- * HttpBody.newBuilder()
- * .setContentType("contentType-389131437")
- * .setData(ByteString.EMPTY)
- * .addAllExtensions(new ArrayList())
- * .build();
- * HttpBody response = gatewayServiceClient.postResource(request);
- * }
- * }
- *
- * @param request The request object containing all of the parameters for the API call.
- * @throws com.google.api.gax.rpc.ApiException if the remote call fails
- */
- public final HttpBody postResource(HttpBody request) {
- return postResourceCallable().call(request);
- }
-
- // AUTO-GENERATED DOCUMENTATION AND METHOD.
- /**
- * PostResource performs an HTTP POST on the Kubernetes API Server.
- *
- * Sample code: - * - *
{@code
- * // This snippet has been automatically generated and should be regarded as a code template only.
- * // It will require modifications to work:
- * // - It may require correct/in-range values for request initialization.
- * // - It may require specifying regional endpoints when creating the service client as shown in
- * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
- * try (GatewayServiceClient gatewayServiceClient = GatewayServiceClient.create()) {
- * HttpBody request =
- * HttpBody.newBuilder()
- * .setContentType("contentType-389131437")
- * .setData(ByteString.EMPTY)
- * .addAllExtensions(new ArrayList())
- * .build();
- * ApiFuture future = gatewayServiceClient.postResourceCallable().futureCall(request);
- * // Do something.
- * HttpBody response = future.get();
- * }
- * }
- */
- public final UnaryCallableSample code: - * - *
{@code
- * // This snippet has been automatically generated and should be regarded as a code template only.
- * // It will require modifications to work:
- * // - It may require correct/in-range values for request initialization.
- * // - It may require specifying regional endpoints when creating the service client as shown in
- * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
- * try (GatewayServiceClient gatewayServiceClient = GatewayServiceClient.create()) {
- * HttpBody request =
- * HttpBody.newBuilder()
- * .setContentType("contentType-389131437")
- * .setData(ByteString.EMPTY)
- * .addAllExtensions(new ArrayList())
- * .build();
- * HttpBody response = gatewayServiceClient.deleteResource(request);
- * }
- * }
- *
- * @param request The request object containing all of the parameters for the API call.
- * @throws com.google.api.gax.rpc.ApiException if the remote call fails
- */
- public final HttpBody deleteResource(HttpBody request) {
- return deleteResourceCallable().call(request);
- }
-
- // AUTO-GENERATED DOCUMENTATION AND METHOD.
- /**
- * DeleteResource performs an HTTP DELETE on the Kubernetes API Server.
- *
- * Sample code: - * - *
{@code
- * // This snippet has been automatically generated and should be regarded as a code template only.
- * // It will require modifications to work:
- * // - It may require correct/in-range values for request initialization.
- * // - It may require specifying regional endpoints when creating the service client as shown in
- * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
- * try (GatewayServiceClient gatewayServiceClient = GatewayServiceClient.create()) {
- * HttpBody request =
- * HttpBody.newBuilder()
- * .setContentType("contentType-389131437")
- * .setData(ByteString.EMPTY)
- * .addAllExtensions(new ArrayList())
- * .build();
- * ApiFuture future =
- * gatewayServiceClient.deleteResourceCallable().futureCall(request);
- * // Do something.
- * HttpBody response = future.get();
- * }
- * }
- */
- public final UnaryCallableSample code: - * - *
{@code
- * // This snippet has been automatically generated and should be regarded as a code template only.
- * // It will require modifications to work:
- * // - It may require correct/in-range values for request initialization.
- * // - It may require specifying regional endpoints when creating the service client as shown in
- * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
- * try (GatewayServiceClient gatewayServiceClient = GatewayServiceClient.create()) {
- * HttpBody request =
- * HttpBody.newBuilder()
- * .setContentType("contentType-389131437")
- * .setData(ByteString.EMPTY)
- * .addAllExtensions(new ArrayList())
- * .build();
- * HttpBody response = gatewayServiceClient.putResource(request);
- * }
- * }
- *
- * @param request The request object containing all of the parameters for the API call.
- * @throws com.google.api.gax.rpc.ApiException if the remote call fails
- */
- public final HttpBody putResource(HttpBody request) {
- return putResourceCallable().call(request);
- }
-
- // AUTO-GENERATED DOCUMENTATION AND METHOD.
- /**
- * PutResource performs an HTTP PUT on the Kubernetes API Server.
- *
- * Sample code: - * - *
{@code
- * // This snippet has been automatically generated and should be regarded as a code template only.
- * // It will require modifications to work:
- * // - It may require correct/in-range values for request initialization.
- * // - It may require specifying regional endpoints when creating the service client as shown in
- * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
- * try (GatewayServiceClient gatewayServiceClient = GatewayServiceClient.create()) {
- * HttpBody request =
- * HttpBody.newBuilder()
- * .setContentType("contentType-389131437")
- * .setData(ByteString.EMPTY)
- * .addAllExtensions(new ArrayList())
- * .build();
- * ApiFuture future = gatewayServiceClient.putResourceCallable().futureCall(request);
- * // Do something.
- * HttpBody response = future.get();
- * }
- * }
- */
- public final UnaryCallableSample code: - * - *
{@code
- * // This snippet has been automatically generated and should be regarded as a code template only.
- * // It will require modifications to work:
- * // - It may require correct/in-range values for request initialization.
- * // - It may require specifying regional endpoints when creating the service client as shown in
- * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
- * try (GatewayServiceClient gatewayServiceClient = GatewayServiceClient.create()) {
- * HttpBody request =
- * HttpBody.newBuilder()
- * .setContentType("contentType-389131437")
- * .setData(ByteString.EMPTY)
- * .addAllExtensions(new ArrayList())
- * .build();
- * HttpBody response = gatewayServiceClient.patchResource(request);
- * }
- * }
- *
- * @param request The request object containing all of the parameters for the API call.
- * @throws com.google.api.gax.rpc.ApiException if the remote call fails
- */
- public final HttpBody patchResource(HttpBody request) {
- return patchResourceCallable().call(request);
- }
-
- // AUTO-GENERATED DOCUMENTATION AND METHOD.
- /**
- * PatchResource performs an HTTP PATCH on the Kubernetes API Server.
- *
- * Sample code: - * - *
{@code
- * // This snippet has been automatically generated and should be regarded as a code template only.
- * // It will require modifications to work:
- * // - It may require correct/in-range values for request initialization.
- * // - It may require specifying regional endpoints when creating the service client as shown in
- * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
- * try (GatewayServiceClient gatewayServiceClient = GatewayServiceClient.create()) {
- * HttpBody request =
- * HttpBody.newBuilder()
- * .setContentType("contentType-389131437")
- * .setData(ByteString.EMPTY)
- * .addAllExtensions(new ArrayList())
- * .build();
- * ApiFuture future = gatewayServiceClient.patchResourceCallable().futureCall(request);
- * // Do something.
- * HttpBody response = future.get();
- * }
- * }
- */
- public final UnaryCallableThe interfaces provided are listed below, along with usage samples. * - *
======================= GatewayServiceClient ======================= + *
======================= GatewayControlClient ======================= * - *
Service Description: Gateway service is a public API which works as a Kubernetes resource - * model proxy between end users and registered Kubernetes clusters. Each RPC in this service - * matches with an HTTP verb. End user will initiate kubectl commands against the Gateway service, - * and Gateway service will forward user requests to clusters. + *
Service Description: GatewayControl is the control plane API for Connect Gateway. * - *
Sample for GatewayServiceClient: + *
Sample for GatewayControlClient: * *
{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
@@ -34,14 +31,15 @@
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
- * try (GatewayServiceClient gatewayServiceClient = GatewayServiceClient.create()) {
- * HttpBody request =
- * HttpBody.newBuilder()
- * .setContentType("contentType-389131437")
- * .setData(ByteString.EMPTY)
- * .addAllExtensions(new ArrayList())
+ * try (GatewayControlClient gatewayControlClient = GatewayControlClient.create()) {
+ * GenerateCredentialsRequest request =
+ * GenerateCredentialsRequest.newBuilder()
+ * .setName("name3373707")
+ * .setForceUseAgent(true)
+ * .setVersion("version351608024")
+ * .setKubernetesNamespace("kubernetesNamespace-1862862667")
* .build();
- * HttpBody response = gatewayServiceClient.getResource(request);
+ * GenerateCredentialsResponse response = gatewayControlClient.generateCredentials(request);
* }
* }
*/
diff --git a/java-gke-connect-gateway/google-cloud-gke-connect-gateway/src/main/java/com/google/cloud/gkeconnect/gateway/v1beta1/stub/GatewayServiceStub.java b/java-gke-connect-gateway/google-cloud-gke-connect-gateway/src/main/java/com/google/cloud/gkeconnect/gateway/v1beta1/stub/GatewayControlStub.java
similarity index 55%
rename from java-gke-connect-gateway/google-cloud-gke-connect-gateway/src/main/java/com/google/cloud/gkeconnect/gateway/v1beta1/stub/GatewayServiceStub.java
rename to java-gke-connect-gateway/google-cloud-gke-connect-gateway/src/main/java/com/google/cloud/gkeconnect/gateway/v1beta1/stub/GatewayControlStub.java
index 0ed62ceb76f1..be146b4eaef5 100644
--- a/java-gke-connect-gateway/google-cloud-gke-connect-gateway/src/main/java/com/google/cloud/gkeconnect/gateway/v1beta1/stub/GatewayServiceStub.java
+++ b/java-gke-connect-gateway/google-cloud-gke-connect-gateway/src/main/java/com/google/cloud/gkeconnect/gateway/v1beta1/stub/GatewayControlStub.java
@@ -16,40 +16,26 @@
package com.google.cloud.gkeconnect.gateway.v1beta1.stub;
-import com.google.api.HttpBody;
import com.google.api.core.BetaApi;
import com.google.api.gax.core.BackgroundResource;
import com.google.api.gax.rpc.UnaryCallable;
+import com.google.cloud.gkeconnect.gateway.v1beta1.GenerateCredentialsRequest;
+import com.google.cloud.gkeconnect.gateway.v1beta1.GenerateCredentialsResponse;
import javax.annotation.Generated;
// AUTO-GENERATED DOCUMENTATION AND CLASS.
/**
- * Base stub class for the GatewayService service API.
+ * Base stub class for the GatewayControl service API.
*
* This class is for advanced usage and reflects the underlying API directly.
*/
@BetaApi
@Generated("by gapic-generator-java")
-public abstract class GatewayServiceStub implements BackgroundResource {
+public abstract class GatewayControlStub implements BackgroundResource {
- public UnaryCallable The default instance has everything set to sensible defaults:
*
@@ -57,7 +59,7 @@
* The builder of this class is recursive, so contained classes are themselves builders. When
* build() is called, the tree of builders is called to create the complete settings object.
*
- * For example, to set the total timeout of getResource to 30 seconds:
+ * For example, to set the total timeout of generateCredentials to 30 seconds:
*
* This class is for advanced usage.
*/
@BetaApi
@Generated("by gapic-generator-java")
-public class GrpcGatewayServiceCallableFactory implements GrpcStubCallableFactory {
+public class GrpcGatewayControlCallableFactory implements GrpcStubCallableFactory {
@Override
public This class is for advanced usage and reflects the underlying API directly.
+ */
+@BetaApi
+@Generated("by gapic-generator-java")
+public class GrpcGatewayControlStub extends GatewayControlStub {
+ private static final MethodDescriptor This class is for advanced usage and reflects the underlying API directly.
- */
-@BetaApi
-@Generated("by gapic-generator-java")
-public class GrpcGatewayServiceStub extends GatewayServiceStub {
- private static final MethodDescriptor{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
@@ -65,63 +67,41 @@
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
- * GatewayServiceStubSettings.Builder gatewayServiceSettingsBuilder =
- * GatewayServiceStubSettings.newBuilder();
- * gatewayServiceSettingsBuilder
- * .getResourceSettings()
+ * GatewayControlStubSettings.Builder gatewayControlSettingsBuilder =
+ * GatewayControlStubSettings.newBuilder();
+ * gatewayControlSettingsBuilder
+ * .generateCredentialsSettings()
* .setRetrySettings(
- * gatewayServiceSettingsBuilder
- * .getResourceSettings()
+ * gatewayControlSettingsBuilder
+ * .generateCredentialsSettings()
* .getRetrySettings()
* .toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30))
* .build());
- * GatewayServiceStubSettings gatewayServiceSettings = gatewayServiceSettingsBuilder.build();
+ * GatewayControlStubSettings gatewayControlSettings = gatewayControlSettingsBuilder.build();
* }
*/
@BetaApi
@Generated("by gapic-generator-java")
-public class GatewayServiceStubSettings extends StubSettings