google-apis-cloudtasks_v2beta2 0.37.0 → 0.38.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e238178537fcdfc04d3c894d5a46be8b65945970e556793f161e252aace8216c
-  data.tar.gz: ae7e6aaa897ebc9be1345c9e7c76b15db49f220ca5a34f83a9c8804e5c789352
+  metadata.gz: 67ba36f234ae86326cb2eff11b7265a82acb65983d568eedbced72ee4372f525
+  data.tar.gz: 9bf2c1e9c19d902e14a877984f3679ed15cb2ef9d7d732256d36465fc05ba6d1
 SHA512:
-  metadata.gz: 62e79c8e6af97e89bac1498e7afe81e54217c1579b8a9a1912a6fa4411cf9016f544b1a63818357897970b6d1ef85e3cac2b27ccba028253c2adf28c41f298ff
-  data.tar.gz: a8441bc67340f6e0d3c525e335db20f875b31cc4874af389b57631df97aa102607b2ab0ed3e0475ac333bf007c7a7bd01b7c3bbc66db90784d49241808ba8aa0
+  metadata.gz: 1fb1135fceb37d95c01bb90729734917ceafc9da012262d0de9aa80042f04bbefc145cd5c4ad27cac11d3a832d72352e15915952ddf4d820c8406b5ab6bf6310
+  data.tar.gz: 252f054e16df029e51e173d79fec9544cf1bddf32f768d0ca6d8eeb27133a2710aca70e94f185cdef3b239a9dbfda7b5210feb388e6695233c1c18737a501376

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-cloudtasks_v2beta2
 
+### v0.38.0 (2023-09-17)
+
+* Regenerated from discovery document revision 20230906
+
 ### v0.37.0 (2023-08-27)
 
 * Regenerated from discovery document revision 20230809

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

@@ -487,6 +487,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

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module CloudtasksV2beta2
       # Version of the google-apis-cloudtasks_v2beta2 gem
-      GEM_VERSION = "0.37.0"
+      GEM_VERSION = "0.38.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 = "20230906"
     end
   end
 end

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

@@ -76,6 +76,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
       
@@ -392,6 +398,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_v2beta2/service.rb

@@ -117,6 +117,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. 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::CloudtasksV2beta2::CmekConfig] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudtasksV2beta2::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, 'v2beta2/{+name}', options)
+          command.response_representation = Google::Apis::CloudtasksV2beta2::CmekConfig::Representation
+          command.response_class = Google::Apis::CloudtasksV2beta2::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.
@@ -160,6 +192,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::CloudtasksV2beta2::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::CloudtasksV2beta2::CmekConfig] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudtasksV2beta2::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, 'v2beta2/projects/{projectsId}/locations/{locationsId}/cmekConfig', options)
+          command.request_representation = Google::Apis::CloudtasksV2beta2::CmekConfig::Representation
+          command.request_object = cmek_config_object
+          command.response_representation = Google::Apis::CloudtasksV2beta2::CmekConfig::Representation
+          command.response_class = Google::Apis::CloudtasksV2beta2::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
@@ -202,11 +274,18 @@ module Google
         end
         
         # Deletes a queue. This command will delete the queue even if it has tasks in it.
-        # Note: If you delete a queue, a queue with the same name can't be created for
-        # 7 days. WARNING: Using this method may have unintended side effects if you are
-        # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
-        # Read [Overview of Queue Management and queue.yaml](https://cloud.google.com/
-        # tasks/docs/queue-yaml) before using this method.
+        # Note: If you delete a queue, you may be prevented from creating a new queue
+        # with the same name as the deleted queue for a tombstone window of up to 3 days.
+        # During this window, the CreateQueue operation may appear to recreate the
+        # queue, but this can be misleading. If you attempt to create a queue with the
+        # same name as one that is in the tombstone window, run GetQueue to confirm that
+        # the queue creation was successful. If GetQueue returns 200 response code, your
+        # queue was successfully created with the name of the previously deleted queue.
+        # Otherwise, your queue did not successfully recreate. WARNING: Using this
+        # method may have unintended side effects if you are using an App Engine `queue.
+        # yaml` or `queue.xml` file to manage your queues. Read [Overview of Queue
+        # Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
+        # before using this method.
         # @param [String] name
         #   Required. The queue name. For example: `projects/PROJECT_ID/locations/
         #   LOCATION_ID/queues/QUEUE_ID`

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-cloudtasks_v2beta2
 version: !ruby/object:Gem::Version
-  version: 0.37.0
+  version: 0.38.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-27 00:00:00.000000000 Z
+date: 2023-09-17 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_v2beta2/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudtasks_v2beta2/v0.37.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudtasks_v2beta2/v0.38.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudtasks_v2beta2
 post_install_message: 
 rdoc_options: []