google-cloud-batch-v1 0.5.0 → 0.7.0

data/lib/google/iam/v1/iam_policy/rest/service_stub.rb

@@ -0,0 +1,226 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "google/iam/v1/iam_policy_pb"
+
+module Google
+  module Iam
+    module V1
+      module IAMPolicy
+        module Rest
+          ##
+          # REST service stub for the IAMPolicy service.
+          # Service stub contains baseline method implementations
+          # including transcoding, making the REST call, and deserialing the response.
+          #
+          class ServiceStub
+            def initialize endpoint:, credentials:
+              # These require statements are intentionally placed here to initialize
+              # the REST modules only when it's required.
+              require "gapic/rest"
+
+              @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials,
+                                                           numeric_enums: true,
+                                                           raise_faraday_errors: false
+            end
+
+            ##
+            # Baseline implementation for the set_iam_policy REST call
+            #
+            # @param request_pb [::Google::Iam::V1::SetIamPolicyRequest]
+            #   A request object representing the call parameters. Required.
+            # @param options [::Gapic::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+            #
+            # @yield [result, operation] Access the result along with the TransportOperation object
+            # @yieldparam result [::Google::Iam::V1::Policy]
+            # @yieldparam operation [::Gapic::Rest::TransportOperation]
+            #
+            # @return [::Google::Iam::V1::Policy]
+            #   A result object deserialized from the server's reply
+            def set_iam_policy request_pb, options = nil
+              raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+              verb, uri, query_string_params, body = ServiceStub.transcode_set_iam_policy_request request_pb
+              query_string_params = if query_string_params.any?
+                                      query_string_params.to_h { |p| p.split("=", 2) }
+                                    else
+                                      {}
+                                    end
+
+              response = @client_stub.make_http_request(
+                verb,
+                uri:     uri,
+                body:    body || "",
+                params:  query_string_params,
+                options: options
+              )
+              operation = ::Gapic::Rest::TransportOperation.new response
+              result = ::Google::Iam::V1::Policy.decode_json response.body, ignore_unknown_fields: true
+
+              yield result, operation if block_given?
+              result
+            end
+
+            ##
+            # Baseline implementation for the get_iam_policy REST call
+            #
+            # @param request_pb [::Google::Iam::V1::GetIamPolicyRequest]
+            #   A request object representing the call parameters. Required.
+            # @param options [::Gapic::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+            #
+            # @yield [result, operation] Access the result along with the TransportOperation object
+            # @yieldparam result [::Google::Iam::V1::Policy]
+            # @yieldparam operation [::Gapic::Rest::TransportOperation]
+            #
+            # @return [::Google::Iam::V1::Policy]
+            #   A result object deserialized from the server's reply
+            def get_iam_policy request_pb, options = nil
+              raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+              verb, uri, query_string_params, body = ServiceStub.transcode_get_iam_policy_request request_pb
+              query_string_params = if query_string_params.any?
+                                      query_string_params.to_h { |p| p.split("=", 2) }
+                                    else
+                                      {}
+                                    end
+
+              response = @client_stub.make_http_request(
+                verb,
+                uri:     uri,
+                body:    body || "",
+                params:  query_string_params,
+                options: options
+              )
+              operation = ::Gapic::Rest::TransportOperation.new response
+              result = ::Google::Iam::V1::Policy.decode_json response.body, ignore_unknown_fields: true
+
+              yield result, operation if block_given?
+              result
+            end
+
+            ##
+            # Baseline implementation for the test_iam_permissions REST call
+            #
+            # @param request_pb [::Google::Iam::V1::TestIamPermissionsRequest]
+            #   A request object representing the call parameters. Required.
+            # @param options [::Gapic::CallOptions]
+            #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+            #
+            # @yield [result, operation] Access the result along with the TransportOperation object
+            # @yieldparam result [::Google::Iam::V1::TestIamPermissionsResponse]
+            # @yieldparam operation [::Gapic::Rest::TransportOperation]
+            #
+            # @return [::Google::Iam::V1::TestIamPermissionsResponse]
+            #   A result object deserialized from the server's reply
+            def test_iam_permissions request_pb, options = nil
+              raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+              verb, uri, query_string_params, body = ServiceStub.transcode_test_iam_permissions_request request_pb
+              query_string_params = if query_string_params.any?
+                                      query_string_params.to_h { |p| p.split("=", 2) }
+                                    else
+                                      {}
+                                    end
+
+              response = @client_stub.make_http_request(
+                verb,
+                uri:     uri,
+                body:    body || "",
+                params:  query_string_params,
+                options: options
+              )
+              operation = ::Gapic::Rest::TransportOperation.new response
+              result = ::Google::Iam::V1::TestIamPermissionsResponse.decode_json response.body, ignore_unknown_fields: true
+
+              yield result, operation if block_given?
+              result
+            end
+
+            ##
+            # @private
+            #
+            # GRPC transcoding helper method for the set_iam_policy REST call
+            #
+            # @param request_pb [::Google::Iam::V1::SetIamPolicyRequest]
+            #   A request object representing the call parameters. Required.
+            # @return [Array(String, [String, nil], Hash{String => String})]
+            #   Uri, Body, Query string parameters
+            def self.transcode_set_iam_policy_request request_pb
+              transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                      .with_bindings(
+                                                        uri_method: :post,
+                                                        uri_template: "/v1/{resource}:setIamPolicy",
+                                                        body: "*",
+                                                        matches: [
+                                                          ["resource", %r{^.*$}, true]
+                                                        ]
+                                                      )
+              transcoder.transcode request_pb
+            end
+
+            ##
+            # @private
+            #
+            # GRPC transcoding helper method for the get_iam_policy REST call
+            #
+            # @param request_pb [::Google::Iam::V1::GetIamPolicyRequest]
+            #   A request object representing the call parameters. Required.
+            # @return [Array(String, [String, nil], Hash{String => String})]
+            #   Uri, Body, Query string parameters
+            def self.transcode_get_iam_policy_request request_pb
+              transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                      .with_bindings(
+                                                        uri_method: :post,
+                                                        uri_template: "/v1/{resource}:getIamPolicy",
+                                                        body: "*",
+                                                        matches: [
+                                                          ["resource", %r{^.*$}, true]
+                                                        ]
+                                                      )
+              transcoder.transcode request_pb
+            end
+
+            ##
+            # @private
+            #
+            # GRPC transcoding helper method for the test_iam_permissions REST call
+            #
+            # @param request_pb [::Google::Iam::V1::TestIamPermissionsRequest]
+            #   A request object representing the call parameters. Required.
+            # @return [Array(String, [String, nil], Hash{String => String})]
+            #   Uri, Body, Query string parameters
+            def self.transcode_test_iam_permissions_request request_pb
+              transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                      .with_bindings(
+                                                        uri_method: :post,
+                                                        uri_template: "/v1/{resource}:testIamPermissions",
+                                                        body: "*",
+                                                        matches: [
+                                                          ["resource", %r{^.*$}, true]
+                                                        ]
+                                                      )
+              transcoder.transcode request_pb
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/iam/v1/iam_policy/rest.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "gapic/rest"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/batch/v1/version"
+require "google/iam/v1/bindings_override"
+
+require "google/iam/v1/iam_policy/credentials"
+require "google/iam/v1/iam_policy/rest/client"
+
+module Google
+  module Iam
+    module V1
+      ##
+      # API Overview
+      #
+      #
+      # Manages Identity and Access Management (IAM) policies.
+      #
+      # Any implementation of an API that offers access control features
+      # implements the google.iam.v1.IAMPolicy interface.
+      #
+      # ## Data model
+      #
+      # Access control is applied when a principal (user or service account), takes
+      # some action on a resource exposed by a service. Resources, identified by
+      # URI-like names, are the unit of access control specification. Service
+      # implementations can choose the granularity of access control and the
+      # supported permissions for their resources.
+      # For example one database service may allow access control to be
+      # specified only at the Table level, whereas another might allow access control
+      # to also be specified at the Column level.
+      #
+      # ## Policy Structure
+      #
+      # See google.iam.v1.Policy
+      #
+      # This is intentionally not a CRUD style API because access control policies
+      # are created and deleted implicitly with the resources to which they are
+      # attached.
+      #
+      # To load this service and instantiate a REST client:
+      #
+      #     require "google/iam/v1/iam_policy/rest"
+      #     client = ::Google::Iam::V1::IAMPolicy::Rest::Client.new
+      #
+      module IAMPolicy
+        # Client for the REST transport
+        module Rest
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "rest", "helpers.rb"
+require "google/iam/v1/iam_policy/rest/helpers" if ::File.file? helper_path

data/lib/google/iam/v1/iam_policy.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "gapic/common"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/batch/v1/version"
+
+require "google/iam/v1/iam_policy/credentials"
+require "google/iam/v1/iam_policy/client"
+require "google/iam/v1/iam_policy/rest"
+
+module Google
+  module Iam
+    module V1
+      ##
+      # API Overview
+      #
+      #
+      # Manages Identity and Access Management (IAM) policies.
+      #
+      # Any implementation of an API that offers access control features
+      # implements the google.iam.v1.IAMPolicy interface.
+      #
+      # ## Data model
+      #
+      # Access control is applied when a principal (user or service account), takes
+      # some action on a resource exposed by a service. Resources, identified by
+      # URI-like names, are the unit of access control specification. Service
+      # implementations can choose the granularity of access control and the
+      # supported permissions for their resources.
+      # For example one database service may allow access control to be
+      # specified only at the Table level, whereas another might allow access control
+      # to also be specified at the Column level.
+      #
+      # ## Policy Structure
+      #
+      # See google.iam.v1.Policy
+      #
+      # This is intentionally not a CRUD style API because access control policies
+      # are created and deleted implicitly with the resources to which they are
+      # attached.
+      #
+      # @example Load this service and instantiate a gRPC client
+      #
+      #     require "google/iam/v1/iam_policy"
+      #     client = ::Google::Iam::V1::IAMPolicy::Client.new
+      #
+      # @example Load this service and instantiate a REST client
+      #
+      #     require "google/iam/v1/iam_policy/rest"
+      #     client = ::Google::Iam::V1::IAMPolicy::Rest::Client.new
+      #
+      module IAMPolicy
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "iam_policy", "helpers.rb"
+require "google/iam/v1/iam_policy/helpers" if ::File.file? helper_path

data/lib/google/iam/v1/rest.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "google/iam/v1/iam_policy/rest"
+require "google/iam/v1/bindings_override"
+require "google/cloud/batch/v1/version"
+
+module Google
+  module Iam
+    ##
+    # To load just the REST part of this package, including all its services, and instantiate a REST client:
+    #
+    # @example
+    #
+    #     require "google/iam/v1/rest"
+    #     client = ::Google::Iam::V1::IAMPolicy::Rest::Client.new
+    #
+    module V1
+    end
+  end
+end

data/lib/google/iam/v1.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "google/iam/v1/iam_policy"
+require "google/cloud/batch/v1/version"
+
+module Google
+  module Iam
+    ##
+    # API client module.
+    #
+    # @example Load this package, including all its services, and instantiate a gRPC client
+    #
+    #     require "google/iam/v1"
+    #     client = ::Google::Iam::V1::IAMPolicy::Client.new
+    #
+    # @example Load this package, including all its services, and instantiate a REST client
+    #
+    #     require "google/iam/v1"
+    #     client = ::Google::Iam::V1::IAMPolicy::Rest::Client.new
+    #
+    module V1
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "v1", "_helpers.rb"
+require "google/iam/v1/_helpers" if ::File.file? helper_path

data/lib/google-cloud-batch-v1.rb

@@ -19,3 +19,4 @@
 # This gem does not autoload during Bundler.require. To load this gem,
 # issue explicit require statements for the packages desired, e.g.:
 # require "google/cloud/batch/v1"
+# require "google/iam/v1"

data/proto_docs/google/cloud/batch/v1/batch.rb

@@ -42,13 +42,13 @@ module Google
         #     Required. The Job to create.
         # @!attribute [rw] request_id
         #   @return [::String]
-        #     Optional. An optional request ID to identify requests. Specify a unique request ID
-        #     so that if you must retry your request, the server will know to ignore
-        #     the request if it has already been completed. The server will guarantee
-        #     that for at least 60 minutes since the first request.
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server will know to
+        #     ignore the request if it has already been completed. The server will
+        #     guarantee that for at least 60 minutes since the first request.
         #
-        #     For example, consider a situation where you make an initial request and t
-        #     he request times out. If you make the request again with the same request
+        #     For example, consider a situation where you make an initial request and
+        #     the request times out. If you make the request again with the same request
         #     ID, the server can check if original operation with the same request ID
         #     was received, and if so, will ignore the second request. This prevents
         #     clients from accidentally creating duplicate commitments.
@@ -78,13 +78,13 @@ module Google
         #     Optional. Reason for this deletion.
         # @!attribute [rw] request_id
         #   @return [::String]
-        #     Optional. An optional request ID to identify requests. Specify a unique request ID
-        #     so that if you must retry your request, the server will know to ignore
-        #     the request if it has already been completed. The server will guarantee
-        #     that for at least 60 minutes after the first request.
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server will know to
+        #     ignore the request if it has already been completed. The server will
+        #     guarantee that for at least 60 minutes after the first request.
         #
-        #     For example, consider a situation where you make an initial request and t
-        #     he request times out. If you make the request again with the same request
+        #     For example, consider a situation where you make an initial request and
+        #     the request times out. If you make the request again with the same request
         #     ID, the server can check if original operation with the same request ID
         #     was received, and if so, will ignore the second request. This prevents
         #     clients from accidentally creating duplicate commitments.
@@ -195,8 +195,9 @@ module Google
         #   @return [::Boolean]
         #     Output only. Identifies whether the user has requested cancellation
         #     of the operation. Operations that have successfully been cancelled
-        #     have [Operation.error][] value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
-        #     corresponding to `Code.CANCELLED`.
+        #     have [Operation.error][] value with a
+        #     {::Google::Rpc::Status#code google.rpc.Status.code} of 1, corresponding to
+        #     `Code.CANCELLED`.
         # @!attribute [r] api_version
         #   @return [::String]
         #     Output only. API version used to start the operation.

data/proto_docs/google/cloud/batch/v1/job.rb

@@ -32,7 +32,8 @@ module Google
         # @!attribute [rw] priority
         #   @return [::Integer]
         #     Priority of the Job.
-        #     The valid value range is [0, 100).
+        #     The valid value range is [0, 100). Default value is 0.
+        #     Higher value indicates higher priority.
         #     A job with higher priority value is more likely to run earlier if all other
         #     requirements are satisfied.
         # @!attribute [rw] task_groups
@@ -137,6 +138,9 @@ module Google
           # @!attribute [rw] task_pack
           #   @return [::Integer]
           #     The max number of tasks can be assigned to this instance type.
+          # @!attribute [rw] boot_disk
+          #   @return [::Google::Cloud::Batch::V1::AllocationPolicy::Disk]
+          #     The VM boot disk.
           class InstanceStatus
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -301,19 +305,36 @@ module Google
           # @!attribute [rw] image
           #   @return [::String]
           #     Name of a public or custom image used as the data source.
+          #     For example, the following are all valid URLs:
+          #     (1) Specify the image by its family name:
+          #     projects/\\{project}/global/images/family/\\{image_family}
+          #     (2) Specify the image version:
+          #     projects/\\{project}/global/images/\\{image_version}
+          #     You can also use Batch customized image in short names.
+          #     The following image values are supported for a boot disk:
+          #     "batch-debian": use Batch Debian images.
+          #     "batch-centos": use Batch CentOS images.
+          #     "batch-cos": use Batch Container-Optimized images.
           # @!attribute [rw] snapshot
           #   @return [::String]
           #     Name of a snapshot used as the data source.
           # @!attribute [rw] type
           #   @return [::String]
-          #     Disk type as shown in `gcloud compute disk-types list`
-          #     For example, "pd-ssd", "pd-standard", "pd-balanced", "local-ssd".
+          #     Disk type as shown in `gcloud compute disk-types list`.
+          #     For example, local SSD uses type "local-ssd".
+          #     Persistent disks and boot disks use "pd-balanced", "pd-extreme", "pd-ssd"
+          #     or "pd-standard".
           # @!attribute [rw] size_gb
           #   @return [::Integer]
           #     Disk size in GB.
-          #     This field is ignored if `data_source` is `disk` or `image`.
-          #     If `type` is `local-ssd`, size_gb should be a multiple of 375GB,
+          #     For persistent disk, this field is ignored if `data_source` is `image` or
+          #     `snapshot`.
+          #     For local SSD, size_gb should be a multiple of 375GB,
           #     otherwise, the final size will be the next greater multiple of 375 GB.
+          #     For boot disk, Batch will calculate the boot disk size based on source
+          #     image and task requirements if you do not speicify the size.
+          #     If both this field and the boot_disk_mib field in task spec's
+          #     compute_resource are defined, Batch will only honor this field.
           # @!attribute [rw] disk_interface
           #   @return [::String]
           #     Local SSDs are available through both "SCSI" and "NVMe" interfaces.
@@ -375,6 +396,10 @@ module Google
           # @!attribute [rw] accelerators
           #   @return [::Array<::Google::Cloud::Batch::V1::AllocationPolicy::Accelerator>]
           #     The accelerators attached to each VM instance.
+          # @!attribute [rw] boot_disk
+          #   @return [::Google::Cloud::Batch::V1::AllocationPolicy::Disk]
+          #     Book disk to be created and attached to each VM by this InstancePolicy.
+          #     Boot disk will be deleted when the VM is deleted.
           # @!attribute [rw] disks
           #   @return [::Array<::Google::Cloud::Batch::V1::AllocationPolicy::AttachedDisk>]
           #     Non-boot disks to be attached for each VM created by this InstancePolicy.
@@ -532,6 +557,10 @@ module Google
         #     Compute Engine service account for the project will be used. If instance
         #     template is being used, the service account has to be specified in the
         #     instance template and it has to match the email field here.
+        # @!attribute [rw] scopes
+        #   @return [::Array<::String>]
+        #     List of scopes to be enabled for this service account on the VM, in
+        #     addition to the cloud-platform API scope that will be added by default.
         class ServiceAccount
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/batch/v1/task.rb

@@ -49,6 +49,9 @@ module Google
         # @!attribute [rw] task_execution
         #   @return [::Google::Cloud::Batch::V1::TaskExecution]
         #     Task Execution
+        # @!attribute [rw] task_state
+        #   @return [::Google::Cloud::Batch::V1::TaskStatus::State]
+        #     Task State
         class StatusEvent
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -184,9 +187,23 @@ module Google
           # @!attribute [rw] path
           #   @return [::String]
           #     Script file path on the host VM.
+          #
+          #     To specify an interpreter, please add a `#!<interpreter>`(also known as
+          #     [shebang line](https://en.wikipedia.org/wiki/Shebang_(Unix))) as the
+          #     first line of the file.(For example, to execute the script using bash,
+          #     `#!/bin/bash` should be the first line of the file. To execute the
+          #     script using`Python3`, `#!/usr/bin/env python3` should be the first
+          #     line of the file.) Otherwise, the file will by default be excuted by
+          #     `/bin/sh`.
           # @!attribute [rw] text
           #   @return [::String]
           #     Shell script text.
+          #
+          #     To specify an interpreter, please add a `#!<interpreter>\n` at the
+          #     beginning of the text.(For example, to execute the script using bash,
+          #     `#!/bin/bash\n` should be added. To execute the script using`Python3`,
+          #     `#!/usr/bin/env python3\n` should be added.) Otherwise, the script will
+          #     by default be excuted by `/bin/sh`.
           class Script
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -231,13 +248,12 @@ module Google
         # @!attribute [rw] lifecycle_policies
         #   @return [::Array<::Google::Cloud::Batch::V1::LifecyclePolicy>]
         #     Lifecycle management schema when any task in a task group is failed.
-        #     The valid size of lifecycle policies are [0, 10].
-        #     For each lifecycle policy, when the condition is met,
-        #     the action in that policy will execute.
-        #     If there are multiple policies that the task execution result matches,
-        #     we use the action from the first matched policy. If task execution result
-        #     does not meet with any of the defined lifecycle policy, we consider it as
-        #     the default policy. Default policy means if the exit code is 0, exit task.
+        #     Currently we only support one lifecycle policy.
+        #     When the lifecycle policy condition is met,
+        #     the action in the policy will execute.
+        #     If task execution result does not meet with the defined lifecycle
+        #     policy, we consider it as the default policy.
+        #     Default policy means if the exit code is 0, exit task.
         #     If task ends with non-zero exit code, retry the task with max_retry_count.
         # @!attribute [rw] environments
         #   @return [::Google::Protobuf::Map{::String => ::String}]
@@ -267,6 +283,10 @@ module Google
         # @!attribute [rw] action
         #   @return [::Google::Cloud::Batch::V1::LifecyclePolicy::Action]
         #     Action to execute when ActionCondition is true.
+        #     When RETRY_TASK is specified, we will retry failed tasks
+        #     if we notice any exit code match and fail tasks if no match is found.
+        #     Likewise, when FAIL_TASK is specified, we will fail tasks
+        #     if we notice any exit code match and retry tasks if no match is found.
         # @!attribute [rw] action_condition
         #   @return [::Google::Cloud::Batch::V1::LifecyclePolicy::ActionCondition]
         #     Conditions that decide why a task failure is dealt with a specific action.