docs: [google-cloud-batch] Refine description for field task_execution (#12693)

- [ ] Regenerate this pull request now.

PiperOrigin-RevId: 633367898

Source-Link:
googleapis/googleapis@7e73d48

Source-Link:
googleapis/googleapis-gen@7a9547f
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWJhdGNoLy5Pd2xCb3QueWFtbCIsImgiOiI3YTk1NDdmYmEwNjdmYTNiNDU3ZmI5YWEyOTY4NmNiNWI2MDhkOTMwIn0=

BEGIN_NESTED_COMMIT
docs: [google-cloud-batch] Refine description for field `task_execution`
PiperOrigin-RevId: 633294486

Source-Link:
googleapis/googleapis@d9fe642

Source-Link:
googleapis/googleapis-gen@fd49345
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWJhdGNoLy5Pd2xCb3QueWFtbCIsImgiOiJmZDQ5MzQ1OTI2Y2FhMDNmYTJhMjUyMTRkODNlMDZiM2JjMzU3NTA5In0=
END_NESTED_COMMIT

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Anthonios Partheniou <partheniou@google.com>

Author: gcf-owl-bot[bot]

packages/google-cloud-batch/google/cloud/batch_v1/types/task.py

@@ -155,9 +155,22 @@ class TaskExecution(proto.Message):
 
     Attributes:
         exit_code (int):
-            When task is completed as the status of
-            FAILED or SUCCEEDED, exit code is for one task
-            execution result, default is 0 as success.
+            The exit code of a finished task.
+
+            If the task succeeded, the exit code will be 0.
+            If the task failed but not due to the following
+            reasons, the exit code will be 50000.
+
+            Otherwise, it can be from different sources:
+
+            - Batch known failures as
+              https://cloud.google.com/batch/docs/troubleshooting#reserved-exit-codes.
+            - Batch runnable execution failures: You can
+              rely on Batch logs for further diagnose:
+              https://cloud.google.com/batch/docs/analyze-job-using-logs.
+              If there are multiple runnables failures,
+              Batch only exposes the first error caught for
+              now.
     """
 
     exit_code: int = proto.Field(

packages/google-cloud-batch/google/cloud/batch_v1alpha/types/task.py

@@ -164,9 +164,22 @@ class TaskExecution(proto.Message):
 
     Attributes:
         exit_code (int):
-            When task is completed as the status of
-            FAILED or SUCCEEDED, exit code is for one task
-            execution result, default is 0 as success.
+            The exit code of a finished task.
+
+            If the task succeeded, the exit code will be 0.
+            If the task failed but not due to the following
+            reasons, the exit code will be 50000.
+
+            Otherwise, it can be from different sources:
+
+            - Batch known failures as
+              https://cloud.google.com/batch/docs/troubleshooting#reserved-exit-codes.
+            - Batch runnable execution failures: You can
+              rely on Batch logs for further diagnose:
+              https://cloud.google.com/batch/docs/analyze-job-using-logs.
+              If there are multiple runnables failures,
+              Batch only exposes the first error caught for
+              now.
         stderr_snippet (str):
             Optional. The tail end of any content written
             to standard error by the task execution. This