google-apis-cloudtasks_v2beta3 0.32.0 → 0.34.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 4d864ec9286264bedcc3cd51b7043b7bab84c878674983fc0cbfce6836adbe19
4
- data.tar.gz: 1a83e315a61aac38f40b0308bb1441517476b6ce422149fce50d0d13fbff4beb
3
+ metadata.gz: 117662d12fea3ac42121c89af9b2d5dcf38e09fb932c390ef8d9003b7b4f0e1d
4
+ data.tar.gz: 544244681a90e9608396ebe38c0a48bd2599827abce0739fa1235109630b0db8
5
5
  SHA512:
6
- metadata.gz: aae1afd246350477928abce8d7dc3dee67340f897462684511d5f5109db7e1de8e8a2506e811a36ff9cb6a68930b51dd5e1450d3043a381922ff6e50c0bce62f
7
- data.tar.gz: 41d475438886132c195e048cd8a4cfb29442e8be7cd13843883ebb65b5310934341f303b8bd5af81d70377ea96441a0d0bc4861bbe3aa99496ececaeec62a518
6
+ metadata.gz: a4464f30eb7f3f3c3cb3d2c5ef54d177a61127666c862de28975df03484a0433bf58eccbe826f4dfd0dd244a73ac906a28f8cfcf3d7ed6de386412c92799ca58
7
+ data.tar.gz: ef1d0b757cd55ecbcc58bc98c18c40674aeda7db3c1307659d2c5bd12eedb55db74c641188cc539a430e0324a9ef5b1d884151a78d70541e7b2e43787baa3bd6
data/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # Release history for google-apis-cloudtasks_v2beta3
2
2
 
3
+ ### v0.34.0 (2023-10-08)
4
+
5
+ * Regenerated from discovery document revision 20230927
6
+
7
+ ### v0.33.0 (2023-09-17)
8
+
9
+ * Regenerated from discovery document revision 20230906
10
+
3
11
  ### v0.32.0 (2023-08-27)
4
12
 
5
13
  * Regenerated from discovery document revision 20230809
@@ -414,6 +414,37 @@ module Google
414
414
  end
415
415
  end
416
416
 
417
+ # CMEK, or Customer Managed Encryption Keys, enables GCP products to put control
418
+ # over encryption and key management in their customer’s hands.
419
+ class CmekConfig
420
+ include Google::Apis::Core::Hashable
421
+
422
+ # Resource name of the Cloud KMS key, of the form `projects/PROJECT_ID/locations/
423
+ # LOCATION_ID/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID`, that will be used to
424
+ # encrypt the Queues & Tasks in the region. Setting this as blank will turn off
425
+ # CMEK encryption.
426
+ # Corresponds to the JSON property `kmsKey`
427
+ # @return [String]
428
+ attr_accessor :kms_key
429
+
430
+ # Output only. The config resource name which includes the project and location
431
+ # and must end in 'cmekConfig', in the format projects/PROJECT_ID/locations/
432
+ # LOCATION_ID/cmekConfig`
433
+ # Corresponds to the JSON property `name`
434
+ # @return [String]
435
+ attr_accessor :name
436
+
437
+ def initialize(**args)
438
+ update!(**args)
439
+ end
440
+
441
+ # Update properties of this object
442
+ def update!(**args)
443
+ @kms_key = args[:kms_key] if args.key?(:kms_key)
444
+ @name = args[:name] if args.key?(:name)
445
+ end
446
+ end
447
+
417
448
  # Request message for CreateTask.
418
449
  class CreateTaskRequest
419
450
  include Google::Apis::Core::Hashable
@@ -1271,13 +1302,16 @@ module Google
1271
1302
  # @return [Google::Apis::CloudtasksV2beta3::QueueStats]
1272
1303
  attr_accessor :stats
1273
1304
 
1274
- # The maximum amount of time that a task will be retained in this queue. Queues
1275
- # created by Cloud Tasks have a default `task_ttl` of 31 days. After a task has
1276
- # lived for `task_ttl`, the task will be deleted regardless of whether it was
1277
- # dispatched or not. The `task_ttl` for queues created via queue.yaml/xml is
1278
- # equal to the maximum duration because there is a [storage quota](https://cloud.
1279
- # google.com/appengine/quotas#Task_Queue) for these queues. To view the maximum
1280
- # valid duration, see the documentation for Duration.
1305
+ # The maximum amount of time that a task will be retained in this queue. After a
1306
+ # task has lived for `task_ttl`, the task will be deleted regardless of whether
1307
+ # it was dispatched or not. The minimum value is 10 days. The maximum value is
1308
+ # 10 years. The value must be given as a string that indicates the length of
1309
+ # time (in seconds) followed by `s` (for "seconds"). For more information on the
1310
+ # format, see the documentation for [Duration](https://protobuf.dev/reference/
1311
+ # protobuf/google.protobuf/#duration). Queues created by Cloud Tasks have a
1312
+ # default `task_ttl` of 31 days. . Queues created by queue.yaml/xml have a fixed
1313
+ # `task_ttl` of the maximum duration, because there is a [storage quota](https://
1314
+ # cloud.google.com/appengine/quotas#Task_Queue) for these queues.
1281
1315
  # Corresponds to the JSON property `taskTtl`
1282
1316
  # @return [String]
1283
1317
  attr_accessor :task_ttl
@@ -1287,8 +1321,12 @@ module Google
1287
1321
  # tombstone_ttl`. The tombstone is used by task de-duplication; another task
1288
1322
  # with the same name can't be created until the tombstone has expired. For more
1289
1323
  # information about task de-duplication, see the documentation for
1290
- # CreateTaskRequest. Queues created by Cloud Tasks have a default `tombstone_ttl`
1291
- # of 1 hour.
1324
+ # CreateTaskRequest. The minimum value is 1 hour. The maximum value is 9 days.
1325
+ # The value must be given as a string that indicates the length of time (in
1326
+ # seconds) followed by `s` (for "seconds"). For more information on the format,
1327
+ # see the documentation for [Duration](https://protobuf.dev/reference/protobuf/
1328
+ # google.protobuf/#duration). Queues created by Cloud Tasks have a default `
1329
+ # tombstone_ttl` of 1 hour.
1292
1330
  # Corresponds to the JSON property `tombstoneTtl`
1293
1331
  # @return [String]
1294
1332
  attr_accessor :tombstone_ttl
@@ -1465,10 +1503,13 @@ module Google
1465
1503
  # A task will be scheduled for retry between min_backoff and max_backoff
1466
1504
  # duration after it fails, if the queue's RetryConfig specifies that the task
1467
1505
  # should be retried. If unspecified when the queue is created, Cloud Tasks will
1468
- # pick the default. `max_backoff` will be truncated to the nearest second. This
1469
- # field has the same meaning as [max_backoff_seconds in queue.yaml/xml](https://
1470
- # cloud.google.com/appengine/docs/standard/python/config/queueref#
1471
- # retry_parameters).
1506
+ # pick the default. The value must be given as a string that indicates the
1507
+ # length of time (in seconds) followed by `s` (for "seconds"). For more
1508
+ # information on the format, see the documentation for [Duration](https://
1509
+ # protobuf.dev/reference/protobuf/google.protobuf/#duration). `max_backoff` will
1510
+ # be truncated to the nearest second. This field has the same meaning as [
1511
+ # max_backoff_seconds in queue.yaml/xml](https://cloud.google.com/appengine/docs/
1512
+ # standard/python/config/queueref#retry_parameters).
1472
1513
  # Corresponds to the JSON property `maxBackoff`
1473
1514
  # @return [String]
1474
1515
  attr_accessor :max_backoff
@@ -1494,10 +1535,14 @@ module Google
1494
1535
  # max_retry_duration` time has passed *and* the task has been attempted
1495
1536
  # max_attempts times, no further attempts will be made and the task will be
1496
1537
  # deleted. If zero, then the task age is unlimited. If unspecified when the
1497
- # queue is created, Cloud Tasks will pick the default. `max_retry_duration` will
1498
- # be truncated to the nearest second. This field has the same meaning as [
1499
- # task_age_limit in queue.yaml/xml](https://cloud.google.com/appengine/docs/
1500
- # standard/python/config/queueref#retry_parameters).
1538
+ # queue is created, Cloud Tasks will pick the default. The value must be given
1539
+ # as a string that indicates the length of time (in seconds) followed by `s` (
1540
+ # for "seconds"). For the maximum possible value or the format, see the
1541
+ # documentation for [Duration](https://protobuf.dev/reference/protobuf/google.
1542
+ # protobuf/#duration). `max_retry_duration` will be truncated to the nearest
1543
+ # second. This field has the same meaning as [task_age_limit in queue.yaml/xml](
1544
+ # https://cloud.google.com/appengine/docs/standard/python/config/queueref#
1545
+ # retry_parameters).
1501
1546
  # Corresponds to the JSON property `maxRetryDuration`
1502
1547
  # @return [String]
1503
1548
  attr_accessor :max_retry_duration
@@ -1505,10 +1550,13 @@ module Google
1505
1550
  # A task will be scheduled for retry between min_backoff and max_backoff
1506
1551
  # duration after it fails, if the queue's RetryConfig specifies that the task
1507
1552
  # should be retried. If unspecified when the queue is created, Cloud Tasks will
1508
- # pick the default. `min_backoff` will be truncated to the nearest second. This
1509
- # field has the same meaning as [min_backoff_seconds in queue.yaml/xml](https://
1510
- # cloud.google.com/appengine/docs/standard/python/config/queueref#
1511
- # retry_parameters).
1553
+ # pick the default. The value must be given as a string that indicates the
1554
+ # length of time (in seconds) followed by `s` (for "seconds"). For more
1555
+ # information on the format, see the documentation for [Duration](https://
1556
+ # protobuf.dev/reference/protobuf/google.protobuf/#duration). `min_backoff` will
1557
+ # be truncated to the nearest second. This field has the same meaning as [
1558
+ # min_backoff_seconds in queue.yaml/xml](https://cloud.google.com/appengine/docs/
1559
+ # standard/python/config/queueref#retry_parameters).
1512
1560
  # Corresponds to the JSON property `minBackoff`
1513
1561
  # @return [String]
1514
1562
  attr_accessor :min_backoff
@@ -1729,8 +1777,11 @@ module Google
1729
1777
  # service's timeout. We recommend setting the `dispatch_deadline` to at most a
1730
1778
  # few seconds more than the app handler's timeout. For more information see [
1731
1779
  # Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#
1732
- # timeouts). `dispatch_deadline` will be truncated to the nearest millisecond.
1733
- # The deadline is an approximate deadline.
1780
+ # timeouts). The value must be given as a string that indicates the length of
1781
+ # time (in seconds) followed by `s` (for "seconds"). For more information on the
1782
+ # format, see the documentation for [Duration](https://protobuf.dev/reference/
1783
+ # protobuf/google.protobuf/#duration). `dispatch_deadline` will be truncated to
1784
+ # the nearest millisecond. The deadline is an approximate deadline.
1734
1785
  # Corresponds to the JSON property `dispatchDeadline`
1735
1786
  # @return [String]
1736
1787
  attr_accessor :dispatch_deadline
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module CloudtasksV2beta3
18
18
  # Version of the google-apis-cloudtasks_v2beta3 gem
19
- GEM_VERSION = "0.32.0"
19
+ GEM_VERSION = "0.34.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.12.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20230809"
25
+ REVISION = "20230927"
26
26
  end
27
27
  end
28
28
  end
@@ -64,6 +64,12 @@ module Google
64
64
  include Google::Apis::Core::JsonObjectSupport
65
65
  end
66
66
 
67
+ class CmekConfig
68
+ class Representation < Google::Apis::Core::JsonRepresentation; end
69
+
70
+ include Google::Apis::Core::JsonObjectSupport
71
+ end
72
+
67
73
  class CreateTaskRequest
68
74
  class Representation < Google::Apis::Core::JsonRepresentation; end
69
75
 
@@ -341,6 +347,14 @@ module Google
341
347
  end
342
348
  end
343
349
 
350
+ class CmekConfig
351
+ # @private
352
+ class Representation < Google::Apis::Core::JsonRepresentation
353
+ property :kms_key, as: 'kmsKey'
354
+ property :name, as: 'name'
355
+ end
356
+ end
357
+
344
358
  class CreateTaskRequest
345
359
  # @private
346
360
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -79,6 +79,38 @@ module Google
79
79
  execute_or_queue_command(command, &block)
80
80
  end
81
81
 
82
+ # Gets the CMEK config. Gets the Customer Managed Encryption Key configured with
83
+ # the Cloud Tasks lcoation. By default there is no kms_key configured.
84
+ # @param [String] name
85
+ # Required. The config resource name. For example: projects/PROJECT_ID/locations/
86
+ # LOCATION_ID/cmekConfig`
87
+ # @param [String] fields
88
+ # Selector specifying which fields to include in a partial response.
89
+ # @param [String] quota_user
90
+ # Available to use for quota purposes for server-side applications. Can be any
91
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
92
+ # @param [Google::Apis::RequestOptions] options
93
+ # Request-specific options
94
+ #
95
+ # @yield [result, err] Result & error if block supplied
96
+ # @yieldparam result [Google::Apis::CloudtasksV2beta3::CmekConfig] parsed result object
97
+ # @yieldparam err [StandardError] error object if request failed
98
+ #
99
+ # @return [Google::Apis::CloudtasksV2beta3::CmekConfig]
100
+ #
101
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
102
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
103
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
104
+ def get_project_location_cmek_config(name, fields: nil, quota_user: nil, options: nil, &block)
105
+ command = make_simple_command(:get, 'v2beta3/{+name}', options)
106
+ command.response_representation = Google::Apis::CloudtasksV2beta3::CmekConfig::Representation
107
+ command.response_class = Google::Apis::CloudtasksV2beta3::CmekConfig
108
+ command.params['name'] = name unless name.nil?
109
+ command.query['fields'] = fields unless fields.nil?
110
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
111
+ execute_or_queue_command(command, &block)
112
+ end
113
+
82
114
  # Lists information about the supported locations for this service.
83
115
  # @param [String] name
84
116
  # The resource that owns the locations collection, if applicable.
@@ -122,6 +154,46 @@ module Google
122
154
  execute_or_queue_command(command, &block)
123
155
  end
124
156
 
157
+ # Creates or Updates a CMEK config. Updates the Customer Managed Encryption Key
158
+ # assotiated with the Cloud Tasks location (Creates if the key does not already
159
+ # exist). All new tasks created in the location will be encrypted at-rest with
160
+ # the KMS-key provided in the config.
161
+ # @param [String] projects_id
162
+ # @param [String] locations_id
163
+ # @param [Google::Apis::CloudtasksV2beta3::CmekConfig] cmek_config_object
164
+ # @param [String] update_mask
165
+ # List of fields to be updated in this request.
166
+ # @param [String] fields
167
+ # Selector specifying which fields to include in a partial response.
168
+ # @param [String] quota_user
169
+ # Available to use for quota purposes for server-side applications. Can be any
170
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
171
+ # @param [Google::Apis::RequestOptions] options
172
+ # Request-specific options
173
+ #
174
+ # @yield [result, err] Result & error if block supplied
175
+ # @yieldparam result [Google::Apis::CloudtasksV2beta3::CmekConfig] parsed result object
176
+ # @yieldparam err [StandardError] error object if request failed
177
+ #
178
+ # @return [Google::Apis::CloudtasksV2beta3::CmekConfig]
179
+ #
180
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
181
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
182
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
183
+ 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)
184
+ command = make_simple_command(:patch, 'v2beta3/projects/{projectsId}/locations/{locationsId}/cmekConfig', options)
185
+ command.request_representation = Google::Apis::CloudtasksV2beta3::CmekConfig::Representation
186
+ command.request_object = cmek_config_object
187
+ command.response_representation = Google::Apis::CloudtasksV2beta3::CmekConfig::Representation
188
+ command.response_class = Google::Apis::CloudtasksV2beta3::CmekConfig
189
+ command.params['projectsId'] = projects_id unless projects_id.nil?
190
+ command.params['locationsId'] = locations_id unless locations_id.nil?
191
+ command.query['updateMask'] = update_mask unless update_mask.nil?
192
+ command.query['fields'] = fields unless fields.nil?
193
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
194
+ execute_or_queue_command(command, &block)
195
+ end
196
+
125
197
  # Creates a queue. Queues created with this method allow tasks to live for a
126
198
  # maximum of 31 days. After a task is 31 days old, the task will be deleted
127
199
  # regardless of whether it was dispatched or not. WARNING: Using this method may
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-cloudtasks_v2beta3
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.32.0
4
+ version: 0.34.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-08-27 00:00:00.000000000 Z
11
+ date: 2023-10-08 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudtasks_v2beta3/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-cloudtasks_v2beta3/v0.32.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-cloudtasks_v2beta3/v0.34.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudtasks_v2beta3
63
63
  post_install_message:
64
64
  rdoc_options: []