docs: [google-cloud-batch] state one Resource Allowance per region per project limitation on v1alpha (#12536)

BEGIN_COMMIT_OVERRIDE
docs: state one Resource Allowance per region per project limitation on
v1alpha


---
docs: A comment for field `max_run_duration` in message
`.google.cloud.batch.v1alpha.TaskSpec` and
`.google.cloud.batch.v1.TaskSpec` is changed


---
docs: add non-negative restriction comment for
usage_resource_allowance.spec.limit.limit exposed on v1alpha


END_COMMIT_OVERRIDE

- [ ] Regenerate this pull request now.

---
docs: A comment for field `max_run_duration` in message
`.google.cloud.batch.v1alpha.TaskSpec` and
`.google.cloud.batch.v1.TaskSpec` is changed

---
docs: add non-negative restriction comment for
usage_resource_allowance.spec.limit.limit exposed on v1alpha
PiperOrigin-RevId: 620950825

Source-Link:
googleapis/googleapis@08f330c

Source-Link:
googleapis/googleapis-gen@300d2ef
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWJhdGNoLy5Pd2xCb3QueWFtbCIsImgiOiIzMDBkMmVmNjVkNDViZTE2OGFiMzc5MzY3ZmNhNzFiYTgwYjk0ZDE4In0=

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: ohmayr <omairnaveed@ymail.com>

Author: gcf-owl-bot[bot]

packages/google-cloud-batch/google/cloud/batch/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.17.15"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-cloud-batch/google/cloud/batch_v1/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.17.15"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-cloud-batch/google/cloud/batch_v1alpha/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.17.15"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-cloud-batch/google/cloud/batch_v1alpha/services/batch_service/async_client.py

@@ -1084,7 +1084,9 @@ async def sample_create_resource_allowance():
         Returns:
             google.cloud.batch_v1alpha.types.ResourceAllowance:
                 The Resource Allowance description
-                for Cloud Batch.
+                for Cloud Batch. Only one Resource
+                Allowance is supported now under a
+                specific location and project.
 
         """
         # Create or coerce a protobuf request object.
@@ -1191,7 +1193,9 @@ async def sample_get_resource_allowance():
         Returns:
             google.cloud.batch_v1alpha.types.ResourceAllowance:
                 The Resource Allowance description
-                for Cloud Batch.
+                for Cloud Batch. Only one Resource
+                Allowance is supported now under a
+                specific location and project.
 
         """
         # Create or coerce a protobuf request object.
@@ -1576,7 +1580,9 @@ async def sample_update_resource_allowance():
         Returns:
             google.cloud.batch_v1alpha.types.ResourceAllowance:
                 The Resource Allowance description
-                for Cloud Batch.
+                for Cloud Batch. Only one Resource
+                Allowance is supported now under a
+                specific location and project.
 
         """
         # Create or coerce a protobuf request object.

packages/google-cloud-batch/google/cloud/batch_v1alpha/services/batch_service/client.py

@@ -1524,7 +1524,9 @@ def sample_create_resource_allowance():
         Returns:
             google.cloud.batch_v1alpha.types.ResourceAllowance:
                 The Resource Allowance description
-                for Cloud Batch.
+                for Cloud Batch. Only one Resource
+                Allowance is supported now under a
+                specific location and project.
 
         """
         # Create or coerce a protobuf request object.
@@ -1633,7 +1635,9 @@ def sample_get_resource_allowance():
         Returns:
             google.cloud.batch_v1alpha.types.ResourceAllowance:
                 The Resource Allowance description
-                for Cloud Batch.
+                for Cloud Batch. Only one Resource
+                Allowance is supported now under a
+                specific location and project.
 
         """
         # Create or coerce a protobuf request object.
@@ -2002,7 +2006,9 @@ def sample_update_resource_allowance():
         Returns:
             google.cloud.batch_v1alpha.types.ResourceAllowance:
                 The Resource Allowance description
-                for Cloud Batch.
+                for Cloud Batch. Only one Resource
+                Allowance is supported now under a
+                specific location and project.
 
         """
         # Create or coerce a protobuf request object.

packages/google-cloud-batch/google/cloud/batch_v1alpha/services/batch_service/transports/rest.py

@@ -823,7 +823,9 @@ def __call__(
             Returns:
                 ~.gcb_resource_allowance.ResourceAllowance:
                     The Resource Allowance description
-                for Cloud Batch.
+                for Cloud Batch. Only one Resource
+                Allowance is supported now under a
+                specific location and project.
 
             """
 
@@ -1167,7 +1169,9 @@ def __call__(
             Returns:
                 ~.resource_allowance.ResourceAllowance:
                     The Resource Allowance description
-                for Cloud Batch.
+                for Cloud Batch. Only one Resource
+                Allowance is supported now under a
+                specific location and project.
 
             """
 
@@ -1589,7 +1593,9 @@ def __call__(
             Returns:
                 ~.gcb_resource_allowance.ResourceAllowance:
                     The Resource Allowance description
-                for Cloud Batch.
+                for Cloud Batch. Only one Resource
+                Allowance is supported now under a
+                specific location and project.
 
             """
 

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

@@ -86,6 +86,9 @@ class ResourceAllowanceState(proto.Enum):
 
 class ResourceAllowance(proto.Message):
     r"""The Resource Allowance description for Cloud Batch.
+    Only one Resource Allowance is supported now under a specific
+    location and project.
+
 
     .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
 
@@ -208,11 +211,14 @@ class Limit(proto.Message):
                 This field is a member of `oneof`_ ``duration``.
             limit (float):
                 Required. Limit value of a UsageResourceAllowance within its
-                one duration. Default is 0. For example, you can set
-                ``limit`` as 10000.0 with duration of the current month by
-                setting ``calendar_period`` field as monthly. That means in
-                your current month, 10000.0 is the cour hour limitation that
-                your resources are allowed to consume.
+                one duration.
+
+                Limit cannot be a negative value. Default is 0. For example,
+                you can set ``limit`` as 10000.0 with duration of the
+                current month by setting ``calendar_period`` field as
+                monthly. That means in your current month, 10000.0 is the
+                core hour limitation that your resources are allowed to
+                consume.
 
                 This field is a member of `oneof`_ ``_limit``.
         """

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

@@ -591,9 +591,10 @@ class TaskSpec(proto.Message):
         compute_resource (google.cloud.batch_v1alpha.types.ComputeResource):
             ComputeResource requirements.
         max_run_duration (google.protobuf.duration_pb2.Duration):
-            Maximum duration the task should run.
-            The task will be killed and marked as FAILED if
-            over this limit.
+            Maximum duration the task should run. The task will be
+            killed and marked as FAILED if over this limit. The valid
+            value range for max_run_duration in seconds is [0,
+            315576000000.999999999],
         max_retry_count (int):
             Maximum number of retries on failures. The default, 0, which
             means never retry. The valid value range is [0, 10].

packages/google-cloud-batch/samples/generated_samples/snippet_metadata_google.cloud.batch.v1.json

@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-batch",
-    "version": "0.17.15"
+    "version": "0.1.0"
   },
   "snippets": [
     {

packages/google-cloud-batch/samples/generated_samples/snippet_metadata_google.cloud.batch.v1alpha.json

@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-batch",
-    "version": "0.17.15"
+    "version": "0.1.0"
   },
   "snippets": [
     {