google-cloud-tasks-v2beta3 0.18.0 → 0.20.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 +4 -4
- data/README.md +1 -1
- data/lib/google/cloud/tasks/v2beta3/cloud_tasks/client.rb +476 -9
- data/lib/google/cloud/tasks/v2beta3/cloud_tasks/operations.rb +843 -0
- data/lib/google/cloud/tasks/v2beta3/cloud_tasks/paths.rb +38 -0
- data/lib/google/cloud/tasks/v2beta3/cloud_tasks/rest/client.rb +448 -9
- data/lib/google/cloud/tasks/v2beta3/cloud_tasks/rest/operations.rb +927 -0
- data/lib/google/cloud/tasks/v2beta3/cloud_tasks/rest/service_stub.rb +247 -0
- data/lib/google/cloud/tasks/v2beta3/cloud_tasks/rest.rb +1 -0
- data/lib/google/cloud/tasks/v2beta3/cloud_tasks.rb +1 -0
- data/lib/google/cloud/tasks/v2beta3/cloudtasks_pb.rb +15 -1
- data/lib/google/cloud/tasks/v2beta3/cloudtasks_services_pb.rb +39 -4
- data/lib/google/cloud/tasks/v2beta3/cmek_config_pb.rb +24 -0
- data/lib/google/cloud/tasks/v2beta3/task_pb.rb +3 -1
- data/lib/google/cloud/tasks/v2beta3/version.rb +1 -1
- data/proto_docs/google/api/client.rb +149 -29
- data/proto_docs/google/api/field_info.rb +88 -0
- data/proto_docs/google/cloud/tasks/v2beta3/cloudtasks.rb +202 -5
- data/proto_docs/google/cloud/tasks/v2beta3/cmek_config.rb +44 -0
- data/proto_docs/google/cloud/tasks/v2beta3/queue.rb +63 -30
- data/proto_docs/google/cloud/tasks/v2beta3/target.rb +38 -22
- data/proto_docs/google/cloud/tasks/v2beta3/task.rb +9 -0
- data/proto_docs/google/longrunning/operations.rb +191 -0
- metadata +9 -3
|
@@ -71,8 +71,8 @@ module Google
|
|
|
71
71
|
# queue, regardless of whether the dispatch is from a first
|
|
72
72
|
# attempt or a retry).
|
|
73
73
|
# * {::Google::Cloud::Tasks::V2beta3::Queue#retry_config retry_config} controls
|
|
74
|
-
# what happens to
|
|
75
|
-
# particular
|
|
74
|
+
# what happens to a
|
|
75
|
+
# particular task after its first attempt fails. That is,
|
|
76
76
|
# {::Google::Cloud::Tasks::V2beta3::Queue#retry_config retry_config} controls
|
|
77
77
|
# task retries (the second attempt, third attempt, etc).
|
|
78
78
|
#
|
|
@@ -126,17 +126,23 @@ module Google
|
|
|
126
126
|
# @!attribute [rw] task_ttl
|
|
127
127
|
# @return [::Google::Protobuf::Duration]
|
|
128
128
|
# The maximum amount of time that a task will be retained in
|
|
129
|
-
# this queue.
|
|
129
|
+
# this queue. After a task has lived for `task_ttl`, the task will be deleted
|
|
130
|
+
# regardless of whether it was dispatched or not.
|
|
131
|
+
#
|
|
132
|
+
# The minimum value is 10 days. The maximum value is 10 years. The value
|
|
133
|
+
# must be given as a string that indicates the length of time (in seconds)
|
|
134
|
+
# followed by `s` (for "seconds"). For more information on the format, see
|
|
135
|
+
# the documentation for
|
|
136
|
+
# [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration).
|
|
130
137
|
#
|
|
131
138
|
# Queues created by Cloud Tasks have a default `task_ttl` of 31 days.
|
|
132
|
-
#
|
|
133
|
-
# regardless of whether it was dispatched or not.
|
|
139
|
+
# .
|
|
134
140
|
#
|
|
135
|
-
#
|
|
136
|
-
#
|
|
137
|
-
# [storage
|
|
138
|
-
#
|
|
139
|
-
#
|
|
141
|
+
# Queues created by queue.yaml/xml have a fixed `task_ttl` of the maximum
|
|
142
|
+
# duration, because there is a
|
|
143
|
+
# [storage
|
|
144
|
+
# quota](https://docs.cloud.google.com/appengine/docs/standard/quotas#Task_Queue)
|
|
145
|
+
# for these queues.
|
|
140
146
|
# @!attribute [rw] tombstone_ttl
|
|
141
147
|
# @return [::Google::Protobuf::Duration]
|
|
142
148
|
# The task tombstone time to live (TTL).
|
|
@@ -148,6 +154,12 @@ module Google
|
|
|
148
154
|
# about task de-duplication, see the documentation for
|
|
149
155
|
# {::Google::Cloud::Tasks::V2beta3::CreateTaskRequest#task CreateTaskRequest}.
|
|
150
156
|
#
|
|
157
|
+
# The minimum value is 1 hour. The maximum value is 9 days. The value
|
|
158
|
+
# must be given as a string that indicates the length of time (in seconds)
|
|
159
|
+
# followed by `s` (for "seconds"). For more information on the format, see
|
|
160
|
+
# the documentation for
|
|
161
|
+
# [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration).
|
|
162
|
+
#
|
|
151
163
|
# Queues created by Cloud Tasks have a default `tombstone_ttl` of 1 hour.
|
|
152
164
|
# @!attribute [rw] stackdriver_logging_config
|
|
153
165
|
# @return [::Google::Cloud::Tasks::V2beta3::StackdriverLoggingConfig]
|
|
@@ -236,9 +248,8 @@ module Google
|
|
|
236
248
|
# If unspecified when the queue is created, Cloud Tasks will pick the
|
|
237
249
|
# default.
|
|
238
250
|
#
|
|
239
|
-
#
|
|
240
|
-
#
|
|
241
|
-
# is 500.
|
|
251
|
+
# For {::Google::Cloud::Tasks::V2beta3::AppEngineHttpQueue App Engine queues}, the
|
|
252
|
+
# maximum allowed value is 500.
|
|
242
253
|
#
|
|
243
254
|
#
|
|
244
255
|
# This field has the same meaning as
|
|
@@ -306,17 +317,25 @@ module Google
|
|
|
306
317
|
# These settings determine when a failed task attempt is retried.
|
|
307
318
|
# @!attribute [rw] max_attempts
|
|
308
319
|
# @return [::Integer]
|
|
309
|
-
# Number of attempts per task.
|
|
320
|
+
# Number of attempts per task, including the first attempt. (If the
|
|
321
|
+
# first attempt fails, there will be `max_attempts - 1` retries.)
|
|
310
322
|
#
|
|
311
|
-
#
|
|
312
|
-
#
|
|
313
|
-
#
|
|
323
|
+
# Must be greater than or equal to -1, which indicates unlimited attempts.
|
|
324
|
+
#
|
|
325
|
+
#
|
|
326
|
+
# Cloud Tasks stops retrying only when `max_attempts` and
|
|
327
|
+
# `max_retry_duration` are both satisfied, or when the task is successfully
|
|
328
|
+
# executed. When the task has been attempted
|
|
329
|
+
# `max_attempts` times and when the `max_retry_duration` time has passed, no
|
|
330
|
+
# further attempts are made, and the task is deleted. If `max_attempts` is
|
|
331
|
+
# set to -1 and `max_retry_duration` is set to 0, the task is retried
|
|
332
|
+
# until the [maximum task
|
|
333
|
+
# retention](https://docs.cloud.google.com/tasks/docs/quotas#limits) limit is
|
|
334
|
+
# reached.
|
|
314
335
|
#
|
|
315
336
|
# If unspecified when the queue is created, Cloud Tasks will pick the
|
|
316
337
|
# default.
|
|
317
338
|
#
|
|
318
|
-
# -1 indicates unlimited attempts.
|
|
319
|
-
#
|
|
320
339
|
# This field has the same meaning as
|
|
321
340
|
# [task_retry_limit in
|
|
322
341
|
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
|
|
@@ -327,16 +346,22 @@ module Google
|
|
|
327
346
|
# attempted. Once `max_retry_duration` time has passed *and* the
|
|
328
347
|
# task has been attempted
|
|
329
348
|
# {::Google::Cloud::Tasks::V2beta3::RetryConfig#max_attempts max_attempts} times,
|
|
330
|
-
# no further attempts
|
|
349
|
+
# no further attempts are made and the task is deleted.
|
|
331
350
|
#
|
|
332
|
-
#
|
|
333
|
-
#
|
|
334
|
-
#
|
|
335
|
-
# default.
|
|
351
|
+
# A zero (0) indicates an unlimited duration, up to the
|
|
352
|
+
# [maximum task
|
|
353
|
+
# retention](https://docs.cloud.google.com/tasks/docs/quotas#limits) limit.
|
|
336
354
|
#
|
|
337
355
|
#
|
|
356
|
+
# The value must be given as a string that indicates the length of time
|
|
357
|
+
# (in seconds) followed by `s` (for "seconds"). For the maximum possible
|
|
358
|
+
# value or the format, see the documentation for
|
|
359
|
+
# [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration).
|
|
338
360
|
# `max_retry_duration` will be truncated to the nearest second.
|
|
339
361
|
#
|
|
362
|
+
# If unspecified when the queue is created, Cloud Tasks will pick the
|
|
363
|
+
# default.
|
|
364
|
+
#
|
|
340
365
|
# This field has the same meaning as
|
|
341
366
|
# [task_age_limit in
|
|
342
367
|
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
|
|
@@ -350,12 +375,16 @@ module Google
|
|
|
350
375
|
# {::Google::Cloud::Tasks::V2beta3::RetryConfig RetryConfig} specifies that the
|
|
351
376
|
# task should be retried.
|
|
352
377
|
#
|
|
353
|
-
# If unspecified when the queue is created, Cloud Tasks will pick the
|
|
354
|
-
# default.
|
|
355
|
-
#
|
|
356
378
|
#
|
|
379
|
+
# The value must be given as a string that indicates the length of time
|
|
380
|
+
# (in seconds) followed by `s` (for "seconds"). For more information on the
|
|
381
|
+
# format, see the documentation for
|
|
382
|
+
# [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration).
|
|
357
383
|
# `min_backoff` will be truncated to the nearest second.
|
|
358
384
|
#
|
|
385
|
+
# If unspecified when the queue is created, Cloud Tasks will pick the
|
|
386
|
+
# default.
|
|
387
|
+
#
|
|
359
388
|
# This field has the same meaning as
|
|
360
389
|
# [min_backoff_seconds in
|
|
361
390
|
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
|
|
@@ -369,12 +398,16 @@ module Google
|
|
|
369
398
|
# {::Google::Cloud::Tasks::V2beta3::RetryConfig RetryConfig} specifies that the
|
|
370
399
|
# task should be retried.
|
|
371
400
|
#
|
|
372
|
-
# If unspecified when the queue is created, Cloud Tasks will pick the
|
|
373
|
-
# default.
|
|
374
|
-
#
|
|
375
401
|
#
|
|
402
|
+
# The value must be given as a string that indicates the length of time
|
|
403
|
+
# (in seconds) followed by `s` (for "seconds"). For more information on the
|
|
404
|
+
# format, see the documentation for
|
|
405
|
+
# [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration).
|
|
376
406
|
# `max_backoff` will be truncated to the nearest second.
|
|
377
407
|
#
|
|
408
|
+
# If unspecified when the queue is created, Cloud Tasks will pick the
|
|
409
|
+
# default.
|
|
410
|
+
#
|
|
378
411
|
# This field has the same meaning as
|
|
379
412
|
# [max_backoff_seconds in
|
|
380
413
|
# queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
|
|
@@ -27,9 +27,9 @@ module Google
|
|
|
27
27
|
# {::Google::Cloud::Tasks::V2beta3::Queue#type PULL} type. It currently exists for
|
|
28
28
|
# backwards compatibility with the App Engine Task Queue SDK. This message type
|
|
29
29
|
# maybe returned with methods
|
|
30
|
-
#
|
|
31
|
-
#
|
|
32
|
-
# is
|
|
30
|
+
# {::Google::Cloud::Tasks::V2beta3::CloudTasks::Client#list_tasks list} and
|
|
31
|
+
# {::Google::Cloud::Tasks::V2beta3::CloudTasks::Client#list_tasks get}, when the response
|
|
32
|
+
# view is {::Google::Cloud::Tasks::V2beta3::Task::View::FULL FULL}.
|
|
33
33
|
# @!attribute [rw] payload
|
|
34
34
|
# @return [::String]
|
|
35
35
|
# A data payload consumed by the worker to execute the task.
|
|
@@ -95,9 +95,10 @@ module Google
|
|
|
95
95
|
# Port override.
|
|
96
96
|
#
|
|
97
97
|
# When specified, replaces the port part of the task URI. For instance,
|
|
98
|
-
# for a URI
|
|
99
|
-
# becomes
|
|
100
|
-
# positive integer. Setting the port to 0 (Zero) clears the URI
|
|
98
|
+
# for a URI "https://www.example.com/example" and port=123, the overridden
|
|
99
|
+
# URI becomes "https://www.example.com:123/example". Note that the port value
|
|
100
|
+
# must be a positive integer. Setting the port to 0 (Zero) clears the URI
|
|
101
|
+
# port.
|
|
101
102
|
# @!attribute [rw] path_override
|
|
102
103
|
# @return [::Google::Cloud::Tasks::V2beta3::PathOverride]
|
|
103
104
|
# URI path.
|
|
@@ -125,12 +126,12 @@ module Google
|
|
|
125
126
|
# Scheme unspecified. Defaults to HTTPS.
|
|
126
127
|
SCHEME_UNSPECIFIED = 0
|
|
127
128
|
|
|
128
|
-
# Convert the scheme to HTTP, e.g., https://www.
|
|
129
|
-
# http://www.
|
|
129
|
+
# Convert the scheme to HTTP, e.g., "https://www.example.com" will change
|
|
130
|
+
# to "http://www.example.com".
|
|
130
131
|
HTTP = 1
|
|
131
132
|
|
|
132
|
-
# Convert the scheme to HTTPS, e.g., http://www.
|
|
133
|
-
# https://www.
|
|
133
|
+
# Convert the scheme to HTTPS, e.g., "http://www.example.com" will change
|
|
134
|
+
# to "https://www.example.com".
|
|
134
135
|
HTTPS = 2
|
|
135
136
|
end
|
|
136
137
|
|
|
@@ -152,8 +153,8 @@ module Google
|
|
|
152
153
|
|
|
153
154
|
# HTTP target.
|
|
154
155
|
#
|
|
155
|
-
# When specified as a
|
|
156
|
-
# will be overridden according to the target.
|
|
156
|
+
# When specified as a {::Google::Cloud::Tasks::V2beta3::Queue Queue}, all the tasks
|
|
157
|
+
# with [HttpRequest] will be overridden according to the target.
|
|
157
158
|
# @!attribute [rw] uri_override
|
|
158
159
|
# @return [::Google::Cloud::Tasks::V2beta3::UriOverride]
|
|
159
160
|
# URI override.
|
|
@@ -164,9 +165,11 @@ module Google
|
|
|
164
165
|
# The HTTP method to use for the request.
|
|
165
166
|
#
|
|
166
167
|
# When specified, it overrides
|
|
167
|
-
# {::Google::Cloud::Tasks::V2beta3::
|
|
168
|
-
# task. Note that if the value is set to
|
|
169
|
-
#
|
|
168
|
+
# {::Google::Cloud::Tasks::V2beta3::HttpRequest#http_method HttpRequest.http_method}
|
|
169
|
+
# for the task. Note that if the value is set to
|
|
170
|
+
# {::Google::Cloud::Tasks::V2beta3::HttpMethod::GET HttpMethod.GET} the
|
|
171
|
+
# {::Google::Cloud::Tasks::V2beta3::HttpRequest#body HttpRequest.body} of the task
|
|
172
|
+
# will be ignored at execution time.
|
|
170
173
|
# @!attribute [rw] header_overrides
|
|
171
174
|
# @return [::Array<::Google::Cloud::Tasks::V2beta3::HttpTarget::HeaderOverride>]
|
|
172
175
|
# HTTP target headers.
|
|
@@ -200,27 +203,35 @@ module Google
|
|
|
200
203
|
#
|
|
201
204
|
# The size of the headers must be less than 80KB.
|
|
202
205
|
# Queue-level headers to override headers of all the tasks in the queue.
|
|
206
|
+
#
|
|
207
|
+
# Do not put business sensitive or personally identifying data in the HTTP
|
|
208
|
+
# Header Override Configuration or other similar fields in accordance with
|
|
209
|
+
# Section 12 (Resource Fields) of the
|
|
210
|
+
# [Service Specific Terms](https://cloud.google.com/terms/service-terms).
|
|
203
211
|
# @!attribute [rw] oauth_token
|
|
204
212
|
# @return [::Google::Cloud::Tasks::V2beta3::OAuthToken]
|
|
205
213
|
# If specified, an
|
|
206
214
|
# [OAuth token](https://developers.google.com/identity/protocols/OAuth2)
|
|
207
|
-
#
|
|
215
|
+
# is generated and attached as the `Authorization` header in the HTTP
|
|
208
216
|
# request.
|
|
209
217
|
#
|
|
210
|
-
# This type of authorization should generally
|
|
211
|
-
# Google APIs hosted on *.googleapis.com.
|
|
218
|
+
# This type of authorization should generally be used only when calling
|
|
219
|
+
# Google APIs hosted on *.googleapis.com. Note that both the service
|
|
220
|
+
# account email and the scope MUST be specified when using the queue-level
|
|
221
|
+
# authorization override.
|
|
212
222
|
#
|
|
213
223
|
# Note: The following fields are mutually exclusive: `oauth_token`, `oidc_token`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
|
214
224
|
# @!attribute [rw] oidc_token
|
|
215
225
|
# @return [::Google::Cloud::Tasks::V2beta3::OidcToken]
|
|
216
226
|
# If specified, an
|
|
217
227
|
# [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect)
|
|
218
|
-
# token
|
|
228
|
+
# token is generated and attached as an `Authorization` header in the
|
|
219
229
|
# HTTP request.
|
|
220
230
|
#
|
|
221
231
|
# This type of authorization can be used for many scenarios, including
|
|
222
232
|
# calling Cloud Run, or endpoints where you intend to validate the token
|
|
223
|
-
# yourself.
|
|
233
|
+
# yourself. Note that both the service account email and the audience MUST
|
|
234
|
+
# be specified when using the queue-level authorization override.
|
|
224
235
|
#
|
|
225
236
|
# Note: The following fields are mutually exclusive: `oidc_token`, `oauth_token`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
|
226
237
|
class HttpTarget
|
|
@@ -242,7 +253,12 @@ module Google
|
|
|
242
253
|
# Wraps the Header object.
|
|
243
254
|
# @!attribute [rw] header
|
|
244
255
|
# @return [::Google::Cloud::Tasks::V2beta3::HttpTarget::Header]
|
|
245
|
-
#
|
|
256
|
+
# Header embodying a key and a value.
|
|
257
|
+
#
|
|
258
|
+
# Do not put business sensitive or personally identifying data in the HTTP
|
|
259
|
+
# Header Override Configuration or other similar fields in accordance with
|
|
260
|
+
# Section 12 (Resource Fields) of the
|
|
261
|
+
# [Service Specific Terms](https://cloud.google.com/terms/service-terms).
|
|
246
262
|
class HeaderOverride
|
|
247
263
|
include ::Google::Protobuf::MessageExts
|
|
248
264
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
@@ -309,7 +325,7 @@ module Google
|
|
|
309
325
|
#
|
|
310
326
|
# * Any header that is prefixed with "X-CloudTasks-" will be treated
|
|
311
327
|
# as service header. Service headers define properties of the task and are
|
|
312
|
-
# predefined in
|
|
328
|
+
# predefined in Cloud Tasks.
|
|
313
329
|
# * Host: This will be computed by Cloud Tasks and derived from
|
|
314
330
|
# {::Google::Cloud::Tasks::V2beta3::HttpRequest#url HttpRequest.url}.
|
|
315
331
|
# * Content-Length: This will be computed by Cloud Tasks.
|
|
@@ -119,6 +119,10 @@ module Google
|
|
|
119
119
|
# information see
|
|
120
120
|
# [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
|
|
121
121
|
#
|
|
122
|
+
# The value must be given as a string that indicates the length of time
|
|
123
|
+
# (in seconds) followed by `s` (for "seconds"). For more information on the
|
|
124
|
+
# format, see the documentation for
|
|
125
|
+
# [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration).
|
|
122
126
|
# `dispatch_deadline` will be truncated to the nearest millisecond. The
|
|
123
127
|
# deadline is an approximate deadline.
|
|
124
128
|
# @!attribute [rw] dispatch_count
|
|
@@ -144,6 +148,11 @@ module Google
|
|
|
144
148
|
# @return [::Google::Cloud::Tasks::V2beta3::Task::View]
|
|
145
149
|
# Output only. The view specifies which subset of the
|
|
146
150
|
# {::Google::Cloud::Tasks::V2beta3::Task Task} has been returned.
|
|
151
|
+
# @!attribute [rw] retry_config
|
|
152
|
+
# @return [::Google::Cloud::Tasks::V2beta3::RetryConfig]
|
|
153
|
+
# Optional. Specifies the task-level retry config.
|
|
154
|
+
#
|
|
155
|
+
# If present, this overrides the queue-level retry config for this task.
|
|
147
156
|
class Task
|
|
148
157
|
include ::Google::Protobuf::MessageExts
|
|
149
158
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
# Copyright 2026 Google LLC
|
|
4
|
+
#
|
|
5
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
6
|
+
# you may not use this file except in compliance with the License.
|
|
7
|
+
# You may obtain a copy of the License at
|
|
8
|
+
#
|
|
9
|
+
# https://www.apache.org/licenses/LICENSE-2.0
|
|
10
|
+
#
|
|
11
|
+
# Unless required by applicable law or agreed to in writing, software
|
|
12
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
13
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
14
|
+
# See the License for the specific language governing permissions and
|
|
15
|
+
# limitations under the License.
|
|
16
|
+
|
|
17
|
+
# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
module Google
|
|
21
|
+
module Longrunning
|
|
22
|
+
# This resource represents a long-running operation that is the result of a
|
|
23
|
+
# network API call.
|
|
24
|
+
# @!attribute [rw] name
|
|
25
|
+
# @return [::String]
|
|
26
|
+
# The server-assigned name, which is only unique within the same service that
|
|
27
|
+
# originally returns it. If you use the default HTTP mapping, the
|
|
28
|
+
# `name` should be a resource name ending with `operations/{unique_id}`.
|
|
29
|
+
# @!attribute [rw] metadata
|
|
30
|
+
# @return [::Google::Protobuf::Any]
|
|
31
|
+
# Service-specific metadata associated with the operation. It typically
|
|
32
|
+
# contains progress information and common metadata such as create time.
|
|
33
|
+
# Some services might not provide such metadata. Any method that returns a
|
|
34
|
+
# long-running operation should document the metadata type, if any.
|
|
35
|
+
# @!attribute [rw] done
|
|
36
|
+
# @return [::Boolean]
|
|
37
|
+
# If the value is `false`, it means the operation is still in progress.
|
|
38
|
+
# If `true`, the operation is completed, and either `error` or `response` is
|
|
39
|
+
# available.
|
|
40
|
+
# @!attribute [rw] error
|
|
41
|
+
# @return [::Google::Rpc::Status]
|
|
42
|
+
# The error result of the operation in case of failure or cancellation.
|
|
43
|
+
#
|
|
44
|
+
# Note: The following fields are mutually exclusive: `error`, `response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
|
45
|
+
# @!attribute [rw] response
|
|
46
|
+
# @return [::Google::Protobuf::Any]
|
|
47
|
+
# The normal, successful response of the operation. If the original
|
|
48
|
+
# method returns no data on success, such as `Delete`, the response is
|
|
49
|
+
# `google.protobuf.Empty`. If the original method is standard
|
|
50
|
+
# `Get`/`Create`/`Update`, the response should be the resource. For other
|
|
51
|
+
# methods, the response should have the type `XxxResponse`, where `Xxx`
|
|
52
|
+
# is the original method name. For example, if the original method name
|
|
53
|
+
# is `TakeSnapshot()`, the inferred response type is
|
|
54
|
+
# `TakeSnapshotResponse`.
|
|
55
|
+
#
|
|
56
|
+
# Note: The following fields are mutually exclusive: `response`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
|
|
57
|
+
class Operation
|
|
58
|
+
include ::Google::Protobuf::MessageExts
|
|
59
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
60
|
+
end
|
|
61
|
+
|
|
62
|
+
# The request message for
|
|
63
|
+
# Operations.GetOperation.
|
|
64
|
+
# @!attribute [rw] name
|
|
65
|
+
# @return [::String]
|
|
66
|
+
# The name of the operation resource.
|
|
67
|
+
class GetOperationRequest
|
|
68
|
+
include ::Google::Protobuf::MessageExts
|
|
69
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
70
|
+
end
|
|
71
|
+
|
|
72
|
+
# The request message for
|
|
73
|
+
# Operations.ListOperations.
|
|
74
|
+
# @!attribute [rw] name
|
|
75
|
+
# @return [::String]
|
|
76
|
+
# The name of the operation's parent resource.
|
|
77
|
+
# @!attribute [rw] filter
|
|
78
|
+
# @return [::String]
|
|
79
|
+
# The standard list filter.
|
|
80
|
+
# @!attribute [rw] page_size
|
|
81
|
+
# @return [::Integer]
|
|
82
|
+
# The standard list page size.
|
|
83
|
+
# @!attribute [rw] page_token
|
|
84
|
+
# @return [::String]
|
|
85
|
+
# The standard list page token.
|
|
86
|
+
# @!attribute [rw] return_partial_success
|
|
87
|
+
# @return [::Boolean]
|
|
88
|
+
# When set to `true`, operations that are reachable are returned as normal,
|
|
89
|
+
# and those that are unreachable are returned in the
|
|
90
|
+
# [ListOperationsResponse.unreachable] field.
|
|
91
|
+
#
|
|
92
|
+
# This can only be `true` when reading across collections e.g. when `parent`
|
|
93
|
+
# is set to `"projects/example/locations/-"`.
|
|
94
|
+
#
|
|
95
|
+
# This field is not by default supported and will result in an
|
|
96
|
+
# `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
|
|
97
|
+
# service or product specific documentation.
|
|
98
|
+
class ListOperationsRequest
|
|
99
|
+
include ::Google::Protobuf::MessageExts
|
|
100
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
101
|
+
end
|
|
102
|
+
|
|
103
|
+
# The response message for
|
|
104
|
+
# Operations.ListOperations.
|
|
105
|
+
# @!attribute [rw] operations
|
|
106
|
+
# @return [::Array<::Google::Longrunning::Operation>]
|
|
107
|
+
# A list of operations that matches the specified filter in the request.
|
|
108
|
+
# @!attribute [rw] next_page_token
|
|
109
|
+
# @return [::String]
|
|
110
|
+
# The standard List next-page token.
|
|
111
|
+
# @!attribute [rw] unreachable
|
|
112
|
+
# @return [::Array<::String>]
|
|
113
|
+
# Unordered list. Unreachable resources. Populated when the request sets
|
|
114
|
+
# `ListOperationsRequest.return_partial_success` and reads across
|
|
115
|
+
# collections e.g. when attempting to list all resources across all supported
|
|
116
|
+
# locations.
|
|
117
|
+
class ListOperationsResponse
|
|
118
|
+
include ::Google::Protobuf::MessageExts
|
|
119
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
120
|
+
end
|
|
121
|
+
|
|
122
|
+
# The request message for
|
|
123
|
+
# Operations.CancelOperation.
|
|
124
|
+
# @!attribute [rw] name
|
|
125
|
+
# @return [::String]
|
|
126
|
+
# The name of the operation resource to be cancelled.
|
|
127
|
+
class CancelOperationRequest
|
|
128
|
+
include ::Google::Protobuf::MessageExts
|
|
129
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
130
|
+
end
|
|
131
|
+
|
|
132
|
+
# The request message for
|
|
133
|
+
# Operations.DeleteOperation.
|
|
134
|
+
# @!attribute [rw] name
|
|
135
|
+
# @return [::String]
|
|
136
|
+
# The name of the operation resource to be deleted.
|
|
137
|
+
class DeleteOperationRequest
|
|
138
|
+
include ::Google::Protobuf::MessageExts
|
|
139
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
140
|
+
end
|
|
141
|
+
|
|
142
|
+
# The request message for
|
|
143
|
+
# Operations.WaitOperation.
|
|
144
|
+
# @!attribute [rw] name
|
|
145
|
+
# @return [::String]
|
|
146
|
+
# The name of the operation resource to wait on.
|
|
147
|
+
# @!attribute [rw] timeout
|
|
148
|
+
# @return [::Google::Protobuf::Duration]
|
|
149
|
+
# The maximum duration to wait before timing out. If left blank, the wait
|
|
150
|
+
# will be at most the time permitted by the underlying HTTP/RPC protocol.
|
|
151
|
+
# If RPC context deadline is also specified, the shorter one will be used.
|
|
152
|
+
class WaitOperationRequest
|
|
153
|
+
include ::Google::Protobuf::MessageExts
|
|
154
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
155
|
+
end
|
|
156
|
+
|
|
157
|
+
# A message representing the message types used by a long-running operation.
|
|
158
|
+
#
|
|
159
|
+
# Example:
|
|
160
|
+
#
|
|
161
|
+
# rpc Export(ExportRequest) returns (google.longrunning.Operation) {
|
|
162
|
+
# option (google.longrunning.operation_info) = {
|
|
163
|
+
# response_type: "ExportResponse"
|
|
164
|
+
# metadata_type: "ExportMetadata"
|
|
165
|
+
# };
|
|
166
|
+
# }
|
|
167
|
+
# @!attribute [rw] response_type
|
|
168
|
+
# @return [::String]
|
|
169
|
+
# Required. The message name of the primary return type for this
|
|
170
|
+
# long-running operation.
|
|
171
|
+
# This type will be used to deserialize the LRO's response.
|
|
172
|
+
#
|
|
173
|
+
# If the response is in a different package from the rpc, a fully-qualified
|
|
174
|
+
# message name must be used (e.g. `google.protobuf.Struct`).
|
|
175
|
+
#
|
|
176
|
+
# Note: Altering this value constitutes a breaking change.
|
|
177
|
+
# @!attribute [rw] metadata_type
|
|
178
|
+
# @return [::String]
|
|
179
|
+
# Required. The message name of the metadata type for this long-running
|
|
180
|
+
# operation.
|
|
181
|
+
#
|
|
182
|
+
# If the response is in a different package from the rpc, a fully-qualified
|
|
183
|
+
# message name must be used (e.g. `google.protobuf.Struct`).
|
|
184
|
+
#
|
|
185
|
+
# Note: Altering this value constitutes a breaking change.
|
|
186
|
+
class OperationInfo
|
|
187
|
+
include ::Google::Protobuf::MessageExts
|
|
188
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
|
189
|
+
end
|
|
190
|
+
end
|
|
191
|
+
end
|
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: google-cloud-tasks-v2beta3
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.20.0
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Google LLC
|
|
@@ -15,14 +15,14 @@ dependencies:
|
|
|
15
15
|
requirements:
|
|
16
16
|
- - "~>"
|
|
17
17
|
- !ruby/object:Gem::Version
|
|
18
|
-
version: '1.
|
|
18
|
+
version: '1.3'
|
|
19
19
|
type: :runtime
|
|
20
20
|
prerelease: false
|
|
21
21
|
version_requirements: !ruby/object:Gem::Requirement
|
|
22
22
|
requirements:
|
|
23
23
|
- - "~>"
|
|
24
24
|
- !ruby/object:Gem::Version
|
|
25
|
-
version: '1.
|
|
25
|
+
version: '1.3'
|
|
26
26
|
- !ruby/object:Gem::Dependency
|
|
27
27
|
name: google-cloud-errors
|
|
28
28
|
requirement: !ruby/object:Gem::Requirement
|
|
@@ -86,12 +86,15 @@ files:
|
|
|
86
86
|
- lib/google/cloud/tasks/v2beta3/cloud_tasks.rb
|
|
87
87
|
- lib/google/cloud/tasks/v2beta3/cloud_tasks/client.rb
|
|
88
88
|
- lib/google/cloud/tasks/v2beta3/cloud_tasks/credentials.rb
|
|
89
|
+
- lib/google/cloud/tasks/v2beta3/cloud_tasks/operations.rb
|
|
89
90
|
- lib/google/cloud/tasks/v2beta3/cloud_tasks/paths.rb
|
|
90
91
|
- lib/google/cloud/tasks/v2beta3/cloud_tasks/rest.rb
|
|
91
92
|
- lib/google/cloud/tasks/v2beta3/cloud_tasks/rest/client.rb
|
|
93
|
+
- lib/google/cloud/tasks/v2beta3/cloud_tasks/rest/operations.rb
|
|
92
94
|
- lib/google/cloud/tasks/v2beta3/cloud_tasks/rest/service_stub.rb
|
|
93
95
|
- lib/google/cloud/tasks/v2beta3/cloudtasks_pb.rb
|
|
94
96
|
- lib/google/cloud/tasks/v2beta3/cloudtasks_services_pb.rb
|
|
97
|
+
- lib/google/cloud/tasks/v2beta3/cmek_config_pb.rb
|
|
95
98
|
- lib/google/cloud/tasks/v2beta3/queue_pb.rb
|
|
96
99
|
- lib/google/cloud/tasks/v2beta3/rest.rb
|
|
97
100
|
- lib/google/cloud/tasks/v2beta3/target_pb.rb
|
|
@@ -100,15 +103,18 @@ files:
|
|
|
100
103
|
- proto_docs/README.md
|
|
101
104
|
- proto_docs/google/api/client.rb
|
|
102
105
|
- proto_docs/google/api/field_behavior.rb
|
|
106
|
+
- proto_docs/google/api/field_info.rb
|
|
103
107
|
- proto_docs/google/api/launch_stage.rb
|
|
104
108
|
- proto_docs/google/api/resource.rb
|
|
105
109
|
- proto_docs/google/cloud/tasks/v2beta3/cloudtasks.rb
|
|
110
|
+
- proto_docs/google/cloud/tasks/v2beta3/cmek_config.rb
|
|
106
111
|
- proto_docs/google/cloud/tasks/v2beta3/queue.rb
|
|
107
112
|
- proto_docs/google/cloud/tasks/v2beta3/target.rb
|
|
108
113
|
- proto_docs/google/cloud/tasks/v2beta3/task.rb
|
|
109
114
|
- proto_docs/google/iam/v1/iam_policy.rb
|
|
110
115
|
- proto_docs/google/iam/v1/options.rb
|
|
111
116
|
- proto_docs/google/iam/v1/policy.rb
|
|
117
|
+
- proto_docs/google/longrunning/operations.rb
|
|
112
118
|
- proto_docs/google/protobuf/any.rb
|
|
113
119
|
- proto_docs/google/protobuf/duration.rb
|
|
114
120
|
- proto_docs/google/protobuf/empty.rb
|