google-apis-cloudtasks_v2beta3 0.32.0 → 0.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4d864ec9286264bedcc3cd51b7043b7bab84c878674983fc0cbfce6836adbe19
-  data.tar.gz: 1a83e315a61aac38f40b0308bb1441517476b6ce422149fce50d0d13fbff4beb
+  metadata.gz: 117662d12fea3ac42121c89af9b2d5dcf38e09fb932c390ef8d9003b7b4f0e1d
+  data.tar.gz: 544244681a90e9608396ebe38c0a48bd2599827abce0739fa1235109630b0db8
 SHA512:
-  metadata.gz: aae1afd246350477928abce8d7dc3dee67340f897462684511d5f5109db7e1de8e8a2506e811a36ff9cb6a68930b51dd5e1450d3043a381922ff6e50c0bce62f
-  data.tar.gz: 41d475438886132c195e048cd8a4cfb29442e8be7cd13843883ebb65b5310934341f303b8bd5af81d70377ea96441a0d0bc4861bbe3aa99496ececaeec62a518
+  metadata.gz: a4464f30eb7f3f3c3cb3d2c5ef54d177a61127666c862de28975df03484a0433bf58eccbe826f4dfd0dd244a73ac906a28f8cfcf3d7ed6de386412c92799ca58
+  data.tar.gz: ef1d0b757cd55ecbcc58bc98c18c40674aeda7db3c1307659d2c5bd12eedb55db74c641188cc539a430e0324a9ef5b1d884151a78d70541e7b2e43787baa3bd6

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-cloudtasks_v2beta3
 
+### v0.34.0 (2023-10-08)
+
+* Regenerated from discovery document revision 20230927
+
+### v0.33.0 (2023-09-17)
+
+* Regenerated from discovery document revision 20230906
+
 ### v0.32.0 (2023-08-27)
 
 * Regenerated from discovery document revision 20230809

data/lib/google/apis/cloudtasks_v2beta3/classes.rb

@@ -414,6 +414,37 @@ module Google
         end
       end
       
+      # CMEK, or Customer Managed Encryption Keys, enables GCP products to put control
+      # over encryption and key management in their customer’s hands.
+      class CmekConfig
+        include Google::Apis::Core::Hashable
+      
+        # Resource name of the Cloud KMS key, of the form `projects/PROJECT_ID/locations/
+        # LOCATION_ID/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID`, that will be used to
+        # encrypt the Queues & Tasks in the region. Setting this as blank will turn off
+        # CMEK encryption.
+        # Corresponds to the JSON property `kmsKey`
+        # @return [String]
+        attr_accessor :kms_key
+      
+        # Output only. The config resource name which includes the project and location
+        # and must end in 'cmekConfig', in the format projects/PROJECT_ID/locations/
+        # LOCATION_ID/cmekConfig`
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kms_key = args[:kms_key] if args.key?(:kms_key)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # Request message for CreateTask.
       class CreateTaskRequest
         include Google::Apis::Core::Hashable
@@ -1271,13 +1302,16 @@ module Google
         # @return [Google::Apis::CloudtasksV2beta3::QueueStats]
         attr_accessor :stats
       
-        # The maximum amount of time that a task will be retained in this queue. Queues
-        # created by Cloud Tasks have a default `task_ttl` of 31 days. After a task has
-        # lived for `task_ttl`, the task will be deleted regardless of whether it was
-        # dispatched or not. The `task_ttl` for queues created via queue.yaml/xml is
-        # equal to the maximum duration because there is a [storage quota](https://cloud.
-        # google.com/appengine/quotas#Task_Queue) for these queues. To view the maximum
-        # valid duration, see the documentation for Duration.
+        # The maximum amount of time that a task will be retained in this queue. After a
+        # task has lived for `task_ttl`, the task will be deleted regardless of whether
+        # it was dispatched or not. The minimum value is 10 days. The maximum value is
+        # 10 years. The value must be given as a string that indicates the length of
+        # time (in seconds) followed by `s` (for "seconds"). For more information on the
+        # format, see the documentation for [Duration](https://protobuf.dev/reference/
+        # protobuf/google.protobuf/#duration). Queues created by Cloud Tasks have a
+        # default `task_ttl` of 31 days. . Queues created by queue.yaml/xml have a fixed
+        # `task_ttl` of the maximum duration, because there is a [storage quota](https://
+        # cloud.google.com/appengine/quotas#Task_Queue) for these queues.
         # Corresponds to the JSON property `taskTtl`
         # @return [String]
         attr_accessor :task_ttl
@@ -1287,8 +1321,12 @@ module Google
         # tombstone_ttl`. The tombstone is used by task de-duplication; another task
         # with the same name can't be created until the tombstone has expired. For more
         # information about task de-duplication, see the documentation for
-        # CreateTaskRequest. Queues created by Cloud Tasks have a default `tombstone_ttl`
-        # of 1 hour.
+        # CreateTaskRequest. The minimum value is 1 hour. The maximum value is 9 days.
+        # The value must be given as a string that indicates the length of time (in
+        # seconds) followed by `s` (for "seconds"). For more information on the format,
+        # see the documentation for [Duration](https://protobuf.dev/reference/protobuf/
+        # google.protobuf/#duration). Queues created by Cloud Tasks have a default `
+        # tombstone_ttl` of 1 hour.
         # Corresponds to the JSON property `tombstoneTtl`
         # @return [String]
         attr_accessor :tombstone_ttl
@@ -1465,10 +1503,13 @@ module Google
         # A task will be scheduled for retry between min_backoff and max_backoff
         # duration after it fails, if the queue's RetryConfig specifies that the task
         # should be retried. If unspecified when the queue is created, Cloud Tasks will
-        # pick the default. `max_backoff` will be truncated to the nearest second. This
-        # field has the same meaning as [max_backoff_seconds in queue.yaml/xml](https://
-        # cloud.google.com/appengine/docs/standard/python/config/queueref#
-        # retry_parameters).
+        # pick the default. The value must be given as a string that indicates the
+        # length of time (in seconds) followed by `s` (for "seconds"). For more
+        # information on the format, see the documentation for [Duration](https://
+        # protobuf.dev/reference/protobuf/google.protobuf/#duration). `max_backoff` will
+        # be truncated to the nearest second. This field has the same meaning as [
+        # max_backoff_seconds in queue.yaml/xml](https://cloud.google.com/appengine/docs/
+        # standard/python/config/queueref#retry_parameters).
         # Corresponds to the JSON property `maxBackoff`
         # @return [String]
         attr_accessor :max_backoff
@@ -1494,10 +1535,14 @@ module Google
         # max_retry_duration` time has passed *and* the task has been attempted
         # max_attempts times, no further attempts will be made and the task will be
         # deleted. If zero, then the task age is unlimited. If unspecified when the
-        # queue is created, Cloud Tasks will pick the default. `max_retry_duration` will
-        # be truncated to the nearest second. This field has the same meaning as [
-        # task_age_limit in queue.yaml/xml](https://cloud.google.com/appengine/docs/
-        # standard/python/config/queueref#retry_parameters).
+        # queue is created, Cloud Tasks will pick the default. The value must be given
+        # as a string that indicates the length of time (in seconds) followed by `s` (
+        # for "seconds"). For the maximum possible value or the format, see the
+        # documentation for [Duration](https://protobuf.dev/reference/protobuf/google.
+        # protobuf/#duration). `max_retry_duration` will be truncated to the nearest
+        # second. This field has the same meaning as [task_age_limit in queue.yaml/xml](
+        # https://cloud.google.com/appengine/docs/standard/python/config/queueref#
+        # retry_parameters).
         # Corresponds to the JSON property `maxRetryDuration`
         # @return [String]
         attr_accessor :max_retry_duration
@@ -1505,10 +1550,13 @@ module Google
         # A task will be scheduled for retry between min_backoff and max_backoff
         # duration after it fails, if the queue's RetryConfig specifies that the task
         # should be retried. If unspecified when the queue is created, Cloud Tasks will
-        # pick the default. `min_backoff` will be truncated to the nearest second. This
-        # field has the same meaning as [min_backoff_seconds in queue.yaml/xml](https://
-        # cloud.google.com/appengine/docs/standard/python/config/queueref#
-        # retry_parameters).
+        # pick the default. The value must be given as a string that indicates the
+        # length of time (in seconds) followed by `s` (for "seconds"). For more
+        # information on the format, see the documentation for [Duration](https://
+        # protobuf.dev/reference/protobuf/google.protobuf/#duration). `min_backoff` will
+        # be truncated to the nearest second. This field has the same meaning as [
+        # min_backoff_seconds in queue.yaml/xml](https://cloud.google.com/appengine/docs/
+        # standard/python/config/queueref#retry_parameters).
         # Corresponds to the JSON property `minBackoff`
         # @return [String]
         attr_accessor :min_backoff
@@ -1729,8 +1777,11 @@ module Google
         # service's timeout. We recommend setting the `dispatch_deadline` to at most a
         # few seconds more than the app handler's timeout. For more information see [
         # Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#
-        # timeouts). `dispatch_deadline` will be truncated to the nearest millisecond.
-        # The deadline is an approximate deadline.
+        # timeouts). The value must be given as a string that indicates the length of
+        # time (in seconds) followed by `s` (for "seconds"). For more information on the
+        # format, see the documentation for [Duration](https://protobuf.dev/reference/
+        # protobuf/google.protobuf/#duration). `dispatch_deadline` will be truncated to
+        # the nearest millisecond. The deadline is an approximate deadline.
         # Corresponds to the JSON property `dispatchDeadline`
         # @return [String]
         attr_accessor :dispatch_deadline

data/lib/google/apis/cloudtasks_v2beta3/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module CloudtasksV2beta3
       # Version of the google-apis-cloudtasks_v2beta3 gem
-      GEM_VERSION = "0.32.0"
+      GEM_VERSION = "0.34.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230809"
+      REVISION = "20230927"
     end
   end
 end

data/lib/google/apis/cloudtasks_v2beta3/representations.rb

@@ -64,6 +64,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CmekConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class CreateTaskRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -341,6 +347,14 @@ module Google
         end
       end
       
+      class CmekConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :kms_key, as: 'kmsKey'
+          property :name, as: 'name'
+        end
+      end
+      
       class CreateTaskRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/cloudtasks_v2beta3/service.rb

@@ -79,6 +79,38 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets the CMEK config. Gets the Customer Managed Encryption Key configured with
+        # the Cloud Tasks lcoation. By default there is no kms_key configured.
+        # @param [String] name
+        #   Required. The config resource name. For example: projects/PROJECT_ID/locations/
+        #   LOCATION_ID/cmekConfig`
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudtasksV2beta3::CmekConfig] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudtasksV2beta3::CmekConfig]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project_location_cmek_config(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2beta3/{+name}', options)
+          command.response_representation = Google::Apis::CloudtasksV2beta3::CmekConfig::Representation
+          command.response_class = Google::Apis::CloudtasksV2beta3::CmekConfig
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Lists information about the supported locations for this service.
         # @param [String] name
         #   The resource that owns the locations collection, if applicable.
@@ -122,6 +154,46 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates or Updates a CMEK config. Updates the Customer Managed Encryption Key
+        # assotiated with the Cloud Tasks location (Creates if the key does not already
+        # exist). All new tasks created in the location will be encrypted at-rest with
+        # the KMS-key provided in the config.
+        # @param [String] projects_id
+        # @param [String] locations_id
+        # @param [Google::Apis::CloudtasksV2beta3::CmekConfig] cmek_config_object
+        # @param [String] update_mask
+        #   List of fields to be updated in this request.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudtasksV2beta3::CmekConfig] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudtasksV2beta3::CmekConfig]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def update_project_location_cmek_config(projects_id, locations_id, cmek_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v2beta3/projects/{projectsId}/locations/{locationsId}/cmekConfig', options)
+          command.request_representation = Google::Apis::CloudtasksV2beta3::CmekConfig::Representation
+          command.request_object = cmek_config_object
+          command.response_representation = Google::Apis::CloudtasksV2beta3::CmekConfig::Representation
+          command.response_class = Google::Apis::CloudtasksV2beta3::CmekConfig
+          command.params['projectsId'] = projects_id unless projects_id.nil?
+          command.params['locationsId'] = locations_id unless locations_id.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Creates a queue. Queues created with this method allow tasks to live for a
         # maximum of 31 days. After a task is 31 days old, the task will be deleted
         # regardless of whether it was dispatched or not. WARNING: Using this method may

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-cloudtasks_v2beta3
 version: !ruby/object:Gem::Version
-  version: 0.32.0
+  version: 0.34.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-27 00:00:00.000000000 Z
+date: 2023-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudtasks_v2beta3/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudtasks_v2beta3/v0.32.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudtasks_v2beta3/v0.34.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudtasks_v2beta3
 post_install_message: 
 rdoc_options: []