google-cloud-tasks-v2beta3 0.3.3 → 0.6.2

Sign up to get free protection for your applications and to get access to all the features.
@@ -61,90 +61,66 @@ module Google
61
61
  parent_config = while namespace.any?
62
62
  parent_name = namespace.join "::"
63
63
  parent_const = const_get parent_name
64
- break parent_const.configure if parent_const&.respond_to? :configure
64
+ break parent_const.configure if parent_const.respond_to? :configure
65
65
  namespace.pop
66
66
  end
67
67
  default_config = Client::Configuration.new parent_config
68
68
 
69
- default_config.rpcs.list_queues.timeout = 10.0
69
+ default_config.rpcs.list_queues.timeout = 20.0
70
70
  default_config.rpcs.list_queues.retry_policy = {
71
- initial_delay: 0.1,
72
- max_delay: 10.0,
73
- multiplier: 1.3,
74
- retry_codes: [4, 14]
71
+ initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
75
72
  }
76
73
 
77
- default_config.rpcs.get_queue.timeout = 10.0
74
+ default_config.rpcs.get_queue.timeout = 20.0
78
75
  default_config.rpcs.get_queue.retry_policy = {
79
- initial_delay: 0.1,
80
- max_delay: 10.0,
81
- multiplier: 1.3,
82
- retry_codes: [4, 14]
76
+ initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
83
77
  }
84
78
 
85
- default_config.rpcs.create_queue.timeout = 10.0
79
+ default_config.rpcs.create_queue.timeout = 20.0
86
80
 
87
- default_config.rpcs.update_queue.timeout = 10.0
81
+ default_config.rpcs.update_queue.timeout = 20.0
88
82
 
89
- default_config.rpcs.delete_queue.timeout = 10.0
83
+ default_config.rpcs.delete_queue.timeout = 20.0
90
84
  default_config.rpcs.delete_queue.retry_policy = {
91
- initial_delay: 0.1,
92
- max_delay: 10.0,
93
- multiplier: 1.3,
94
- retry_codes: [4, 14]
85
+ initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
95
86
  }
96
87
 
97
- default_config.rpcs.purge_queue.timeout = 10.0
88
+ default_config.rpcs.purge_queue.timeout = 20.0
98
89
 
99
- default_config.rpcs.pause_queue.timeout = 10.0
90
+ default_config.rpcs.pause_queue.timeout = 20.0
100
91
 
101
- default_config.rpcs.resume_queue.timeout = 10.0
92
+ default_config.rpcs.resume_queue.timeout = 20.0
102
93
 
103
- default_config.rpcs.get_iam_policy.timeout = 10.0
94
+ default_config.rpcs.get_iam_policy.timeout = 20.0
104
95
  default_config.rpcs.get_iam_policy.retry_policy = {
105
- initial_delay: 0.1,
106
- max_delay: 10.0,
107
- multiplier: 1.3,
108
- retry_codes: [4, 14]
96
+ initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
109
97
  }
110
98
 
111
- default_config.rpcs.set_iam_policy.timeout = 10.0
99
+ default_config.rpcs.set_iam_policy.timeout = 20.0
112
100
 
113
- default_config.rpcs.test_iam_permissions.timeout = 10.0
101
+ default_config.rpcs.test_iam_permissions.timeout = 20.0
114
102
  default_config.rpcs.test_iam_permissions.retry_policy = {
115
- initial_delay: 0.1,
116
- max_delay: 10.0,
117
- multiplier: 1.3,
118
- retry_codes: [4, 14]
103
+ initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
119
104
  }
120
105
 
121
- default_config.rpcs.list_tasks.timeout = 10.0
106
+ default_config.rpcs.list_tasks.timeout = 20.0
122
107
  default_config.rpcs.list_tasks.retry_policy = {
123
- initial_delay: 0.1,
124
- max_delay: 10.0,
125
- multiplier: 1.3,
126
- retry_codes: [4, 14]
108
+ initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
127
109
  }
128
110
 
129
- default_config.rpcs.get_task.timeout = 10.0
111
+ default_config.rpcs.get_task.timeout = 20.0
130
112
  default_config.rpcs.get_task.retry_policy = {
131
- initial_delay: 0.1,
132
- max_delay: 10.0,
133
- multiplier: 1.3,
134
- retry_codes: [4, 14]
113
+ initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
135
114
  }
136
115
 
137
- default_config.rpcs.create_task.timeout = 10.0
116
+ default_config.rpcs.create_task.timeout = 20.0
138
117
 
139
- default_config.rpcs.delete_task.timeout = 10.0
118
+ default_config.rpcs.delete_task.timeout = 20.0
140
119
  default_config.rpcs.delete_task.retry_policy = {
141
- initial_delay: 0.1,
142
- max_delay: 10.0,
143
- multiplier: 1.3,
144
- retry_codes: [4, 14]
120
+ initial_delay: 0.1, max_delay: 10.0, multiplier: 1.3, retry_codes: [4, 14]
145
121
  }
146
122
 
147
- default_config.rpcs.run_task.timeout = 10.0
123
+ default_config.rpcs.run_task.timeout = 20.0
148
124
 
149
125
  default_config
150
126
  end
@@ -207,8 +183,14 @@ module Google
207
183
 
208
184
  # Create credentials
209
185
  credentials = @config.credentials
210
- credentials ||= Credentials.default scope: @config.scope
211
- if credentials.is_a?(String) || credentials.is_a?(Hash)
186
+ # Use self-signed JWT if the scope and endpoint are unchanged from default,
187
+ # but only if the default endpoint does not have a region prefix.
188
+ enable_self_signed_jwt = @config.scope == Client.configure.scope &&
189
+ @config.endpoint == Client.configure.endpoint &&
190
+ !@config.endpoint.split(".").first.include?("-")
191
+ credentials ||= Credentials.default scope: @config.scope,
192
+ enable_self_signed_jwt: enable_self_signed_jwt
193
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
212
194
  credentials = Credentials.new credentials, scope: @config.scope
213
195
  end
214
196
  @quota_project_id = @config.quota_project
@@ -240,7 +222,7 @@ module Google
240
222
  # @param options [::Gapic::CallOptions, ::Hash]
241
223
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
242
224
  #
243
- # @overload list_queues(parent: nil, filter: nil, page_size: nil, page_token: nil)
225
+ # @overload list_queues(parent: nil, filter: nil, page_size: nil, page_token: nil, read_mask: nil)
244
226
  # Pass arguments to `list_queues` via keyword arguments. Note that at
245
227
  # least one keyword argument is required. To specify no parameters, or to keep all
246
228
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -277,6 +259,11 @@ module Google
277
259
  # from the previous call to {::Google::Cloud::Tasks::V2beta3::CloudTasks::Client#list_queues ListQueues}
278
260
  # method. It is an error to switch the value of the
279
261
  # {::Google::Cloud::Tasks::V2beta3::ListQueuesRequest#filter filter} while iterating through pages.
262
+ # @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
263
+ # Optional. Read mask is used for a more granular control over what the API returns.
264
+ # If the mask is not present all fields will be returned except
265
+ # [Queue.stats]. [Queue.stats] will be returned only if it was explicitly
266
+ # specified in the mask.
280
267
  #
281
268
  # @yield [response, operation] Access the result along with the RPC operation
282
269
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Tasks::V2beta3::Queue>]
@@ -337,7 +324,7 @@ module Google
337
324
  # @param options [::Gapic::CallOptions, ::Hash]
338
325
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
339
326
  #
340
- # @overload get_queue(name: nil)
327
+ # @overload get_queue(name: nil, read_mask: nil)
341
328
  # Pass arguments to `get_queue` via keyword arguments. Note that at
342
329
  # least one keyword argument is required. To specify no parameters, or to keep all
343
330
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -345,6 +332,11 @@ module Google
345
332
  # @param name [::String]
346
333
  # Required. The resource name of the queue. For example:
347
334
  # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
335
+ # @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
336
+ # Optional. Read mask is used for a more granular control over what the API returns.
337
+ # If the mask is not present all fields will be returned except
338
+ # [Queue.stats]. [Queue.stats] will be returned only if it was explicitly
339
+ # specified in the mask.
348
340
  #
349
341
  # @yield [response, operation] Access the result along with the RPC operation
350
342
  # @yieldparam response [::Google::Cloud::Tasks::V2beta3::Queue]
@@ -1682,7 +1674,7 @@ module Google
1682
1674
  config_attr :scope, nil, ::String, ::Array, nil
1683
1675
  config_attr :lib_name, nil, ::String, nil
1684
1676
  config_attr :lib_version, nil, ::String, nil
1685
- config_attr(:channel_args, { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
1677
+ config_attr(:channel_args, { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
1686
1678
  config_attr :interceptors, nil, ::Array, nil
1687
1679
  config_attr :timeout, nil, ::Numeric, nil
1688
1680
  config_attr :metadata, nil, ::Hash, nil
@@ -1703,7 +1695,7 @@ module Google
1703
1695
  def rpcs
1704
1696
  @rpcs ||= begin
1705
1697
  parent_rpcs = nil
1706
- parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
1698
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
1707
1699
  Rpcs.new parent_rpcs
1708
1700
  end
1709
1701
  end
@@ -1809,37 +1801,37 @@ module Google
1809
1801
 
1810
1802
  # @private
1811
1803
  def initialize parent_rpcs = nil
1812
- list_queues_config = parent_rpcs&.list_queues if parent_rpcs&.respond_to? :list_queues
1804
+ list_queues_config = parent_rpcs.list_queues if parent_rpcs.respond_to? :list_queues
1813
1805
  @list_queues = ::Gapic::Config::Method.new list_queues_config
1814
- get_queue_config = parent_rpcs&.get_queue if parent_rpcs&.respond_to? :get_queue
1806
+ get_queue_config = parent_rpcs.get_queue if parent_rpcs.respond_to? :get_queue
1815
1807
  @get_queue = ::Gapic::Config::Method.new get_queue_config
1816
- create_queue_config = parent_rpcs&.create_queue if parent_rpcs&.respond_to? :create_queue
1808
+ create_queue_config = parent_rpcs.create_queue if parent_rpcs.respond_to? :create_queue
1817
1809
  @create_queue = ::Gapic::Config::Method.new create_queue_config
1818
- update_queue_config = parent_rpcs&.update_queue if parent_rpcs&.respond_to? :update_queue
1810
+ update_queue_config = parent_rpcs.update_queue if parent_rpcs.respond_to? :update_queue
1819
1811
  @update_queue = ::Gapic::Config::Method.new update_queue_config
1820
- delete_queue_config = parent_rpcs&.delete_queue if parent_rpcs&.respond_to? :delete_queue
1812
+ delete_queue_config = parent_rpcs.delete_queue if parent_rpcs.respond_to? :delete_queue
1821
1813
  @delete_queue = ::Gapic::Config::Method.new delete_queue_config
1822
- purge_queue_config = parent_rpcs&.purge_queue if parent_rpcs&.respond_to? :purge_queue
1814
+ purge_queue_config = parent_rpcs.purge_queue if parent_rpcs.respond_to? :purge_queue
1823
1815
  @purge_queue = ::Gapic::Config::Method.new purge_queue_config
1824
- pause_queue_config = parent_rpcs&.pause_queue if parent_rpcs&.respond_to? :pause_queue
1816
+ pause_queue_config = parent_rpcs.pause_queue if parent_rpcs.respond_to? :pause_queue
1825
1817
  @pause_queue = ::Gapic::Config::Method.new pause_queue_config
1826
- resume_queue_config = parent_rpcs&.resume_queue if parent_rpcs&.respond_to? :resume_queue
1818
+ resume_queue_config = parent_rpcs.resume_queue if parent_rpcs.respond_to? :resume_queue
1827
1819
  @resume_queue = ::Gapic::Config::Method.new resume_queue_config
1828
- get_iam_policy_config = parent_rpcs&.get_iam_policy if parent_rpcs&.respond_to? :get_iam_policy
1820
+ get_iam_policy_config = parent_rpcs.get_iam_policy if parent_rpcs.respond_to? :get_iam_policy
1829
1821
  @get_iam_policy = ::Gapic::Config::Method.new get_iam_policy_config
1830
- set_iam_policy_config = parent_rpcs&.set_iam_policy if parent_rpcs&.respond_to? :set_iam_policy
1822
+ set_iam_policy_config = parent_rpcs.set_iam_policy if parent_rpcs.respond_to? :set_iam_policy
1831
1823
  @set_iam_policy = ::Gapic::Config::Method.new set_iam_policy_config
1832
- test_iam_permissions_config = parent_rpcs&.test_iam_permissions if parent_rpcs&.respond_to? :test_iam_permissions
1824
+ test_iam_permissions_config = parent_rpcs.test_iam_permissions if parent_rpcs.respond_to? :test_iam_permissions
1833
1825
  @test_iam_permissions = ::Gapic::Config::Method.new test_iam_permissions_config
1834
- list_tasks_config = parent_rpcs&.list_tasks if parent_rpcs&.respond_to? :list_tasks
1826
+ list_tasks_config = parent_rpcs.list_tasks if parent_rpcs.respond_to? :list_tasks
1835
1827
  @list_tasks = ::Gapic::Config::Method.new list_tasks_config
1836
- get_task_config = parent_rpcs&.get_task if parent_rpcs&.respond_to? :get_task
1828
+ get_task_config = parent_rpcs.get_task if parent_rpcs.respond_to? :get_task
1837
1829
  @get_task = ::Gapic::Config::Method.new get_task_config
1838
- create_task_config = parent_rpcs&.create_task if parent_rpcs&.respond_to? :create_task
1830
+ create_task_config = parent_rpcs.create_task if parent_rpcs.respond_to? :create_task
1839
1831
  @create_task = ::Gapic::Config::Method.new create_task_config
1840
- delete_task_config = parent_rpcs&.delete_task if parent_rpcs&.respond_to? :delete_task
1832
+ delete_task_config = parent_rpcs.delete_task if parent_rpcs.respond_to? :delete_task
1841
1833
  @delete_task = ::Gapic::Config::Method.new delete_task_config
1842
- run_task_config = parent_rpcs&.run_task if parent_rpcs&.respond_to? :run_task
1834
+ run_task_config = parent_rpcs.run_task if parent_rpcs.respond_to? :run_task
1843
1835
  @run_task = ::Gapic::Config::Method.new run_task_config
1844
1836
 
1845
1837
  yield self if block_given?
@@ -20,6 +20,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
20
20
  optional :filter, :string, 2
21
21
  optional :page_size, :int32, 3
22
22
  optional :page_token, :string, 4
23
+ optional :read_mask, :message, 5, "google.protobuf.FieldMask"
23
24
  end
24
25
  add_message "google.cloud.tasks.v2beta3.ListQueuesResponse" do
25
26
  repeated :queues, :message, 1, "google.cloud.tasks.v2beta3.Queue"
@@ -27,6 +28,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
27
28
  end
28
29
  add_message "google.cloud.tasks.v2beta3.GetQueueRequest" do
29
30
  optional :name, :string, 1
31
+ optional :read_mask, :message, 2, "google.protobuf.FieldMask"
30
32
  end
31
33
  add_message "google.cloud.tasks.v2beta3.CreateQueueRequest" do
32
34
  optional :parent, :string, 1
@@ -17,8 +17,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
17
17
  optional :retry_config, :message, 5, "google.cloud.tasks.v2beta3.RetryConfig"
18
18
  optional :state, :enum, 6, "google.cloud.tasks.v2beta3.Queue.State"
19
19
  optional :purge_time, :message, 7, "google.protobuf.Timestamp"
20
+ optional :task_ttl, :message, 8, "google.protobuf.Duration"
21
+ optional :tombstone_ttl, :message, 9, "google.protobuf.Duration"
20
22
  optional :stackdriver_logging_config, :message, 10, "google.cloud.tasks.v2beta3.StackdriverLoggingConfig"
21
23
  optional :type, :enum, 11, "google.cloud.tasks.v2beta3.Queue.Type"
24
+ optional :stats, :message, 12, "google.cloud.tasks.v2beta3.QueueStats"
22
25
  oneof :queue_type do
23
26
  optional :app_engine_http_queue, :message, 3, "google.cloud.tasks.v2beta3.AppEngineHttpQueue"
24
27
  end
@@ -49,6 +52,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
49
52
  add_message "google.cloud.tasks.v2beta3.StackdriverLoggingConfig" do
50
53
  optional :sampling_ratio, :double, 1
51
54
  end
55
+ add_message "google.cloud.tasks.v2beta3.QueueStats" do
56
+ optional :tasks_count, :int64, 1
57
+ optional :oldest_estimated_arrival_time, :message, 2, "google.protobuf.Timestamp"
58
+ optional :executed_last_minute_count, :int64, 3
59
+ optional :concurrent_dispatches_count, :int64, 4
60
+ optional :effective_execution_rate, :double, 5
61
+ end
52
62
  end
53
63
  end
54
64
 
@@ -62,6 +72,7 @@ module Google
62
72
  RateLimits = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tasks.v2beta3.RateLimits").msgclass
63
73
  RetryConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tasks.v2beta3.RetryConfig").msgclass
64
74
  StackdriverLoggingConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tasks.v2beta3.StackdriverLoggingConfig").msgclass
75
+ QueueStats = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tasks.v2beta3.QueueStats").msgclass
65
76
  end
66
77
  end
67
78
  end
@@ -6,6 +6,10 @@ require 'google/protobuf'
6
6
  require 'google/api/annotations_pb'
7
7
  Google::Protobuf::DescriptorPool.generated_pool.build do
8
8
  add_file("google/cloud/tasks/v2beta3/target.proto", :syntax => :proto3) do
9
+ add_message "google.cloud.tasks.v2beta3.PullMessage" do
10
+ optional :payload, :bytes, 1
11
+ optional :tag, :string, 2
12
+ end
9
13
  add_message "google.cloud.tasks.v2beta3.HttpRequest" do
10
14
  optional :url, :string, 1
11
15
  optional :http_method, :enum, 2, "google.cloud.tasks.v2beta3.HttpMethod"
@@ -57,6 +61,7 @@ module Google
57
61
  module Cloud
58
62
  module Tasks
59
63
  module V2beta3
64
+ PullMessage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tasks.v2beta3.PullMessage").msgclass
60
65
  HttpRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tasks.v2beta3.HttpRequest").msgclass
61
66
  AppEngineHttpQueue = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tasks.v2beta3.AppEngineHttpQueue").msgclass
62
67
  AppEngineHttpRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tasks.v2beta3.AppEngineHttpRequest").msgclass
@@ -24,6 +24,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
24
24
  oneof :payload_type do
25
25
  optional :app_engine_http_request, :message, 3, "google.cloud.tasks.v2beta3.AppEngineHttpRequest"
26
26
  optional :http_request, :message, 11, "google.cloud.tasks.v2beta3.HttpRequest"
27
+ optional :pull_message, :message, 13, "google.cloud.tasks.v2beta3.PullMessage"
27
28
  end
28
29
  end
29
30
  add_enum "google.cloud.tasks.v2beta3.Task.View" do
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Tasks
23
23
  module V2beta3
24
- VERSION = "0.3.3"
24
+ VERSION = "0.6.2"
25
25
  end
26
26
  end
27
27
  end
@@ -54,6 +54,18 @@ module Google
54
54
  # This indicates that the field may be set once in a request to create a
55
55
  # resource, but may not be changed thereafter.
56
56
  IMMUTABLE = 5
57
+
58
+ # Denotes that a (repeated) field is an unordered list.
59
+ # This indicates that the service may provide the elements of the list
60
+ # in any arbitrary order, rather than the order the user originally
61
+ # provided. Additionally, the list's order may or may not be stable.
62
+ UNORDERED_LIST = 6
63
+
64
+ # Denotes that this field returns a non-empty default value if not set.
65
+ # This indicates that if the user provides the empty value in a request,
66
+ # a non-empty value will be returned. The user will not be aware of what
67
+ # non-empty value to expect.
68
+ NON_EMPTY_DEFAULT = 7
57
69
  end
58
70
  end
59
71
  end
@@ -58,6 +58,12 @@ module Google
58
58
  # from the previous call to {::Google::Cloud::Tasks::V2beta3::CloudTasks::Client#list_queues ListQueues}
59
59
  # method. It is an error to switch the value of the
60
60
  # {::Google::Cloud::Tasks::V2beta3::ListQueuesRequest#filter filter} while iterating through pages.
61
+ # @!attribute [rw] read_mask
62
+ # @return [::Google::Protobuf::FieldMask]
63
+ # Optional. Read mask is used for a more granular control over what the API returns.
64
+ # If the mask is not present all fields will be returned except
65
+ # [Queue.stats]. [Queue.stats] will be returned only if it was explicitly
66
+ # specified in the mask.
61
67
  class ListQueuesRequest
62
68
  include ::Google::Protobuf::MessageExts
63
69
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -88,6 +94,12 @@ module Google
88
94
  # @return [::String]
89
95
  # Required. The resource name of the queue. For example:
90
96
  # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
97
+ # @!attribute [rw] read_mask
98
+ # @return [::Google::Protobuf::FieldMask]
99
+ # Optional. Read mask is used for a more granular control over what the API returns.
100
+ # If the mask is not present all fields will be returned except
101
+ # [Queue.stats]. [Queue.stats] will be returned only if it was explicitly
102
+ # specified in the mask.
91
103
  class GetQueueRequest
92
104
  include ::Google::Protobuf::MessageExts
93
105
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -92,7 +92,7 @@ module Google
92
92
  # @return [::Google::Cloud::Tasks::V2beta3::Queue::State]
93
93
  # Output only. The state of the queue.
94
94
  #
95
- # `state` can only be changed by called
95
+ # `state` can only be changed by calling
96
96
  # {::Google::Cloud::Tasks::V2beta3::CloudTasks::Client#pause_queue PauseQueue},
97
97
  # {::Google::Cloud::Tasks::V2beta3::CloudTasks::Client#resume_queue ResumeQueue}, or uploading
98
98
  # [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
@@ -110,6 +110,32 @@ module Google
110
110
  #
111
111
  # Purge time will be truncated to the nearest microsecond. Purge
112
112
  # time will be unset if the queue has never been purged.
113
+ # @!attribute [rw] task_ttl
114
+ # @return [::Google::Protobuf::Duration]
115
+ # The maximum amount of time that a task will be retained in
116
+ # this queue.
117
+ #
118
+ # Queues created by Cloud Tasks have a default `task_ttl` of 31 days.
119
+ # After a task has lived for `task_ttl`, the task will be deleted
120
+ # regardless of whether it was dispatched or not.
121
+ #
122
+ # The `task_ttl` for queues created via queue.yaml/xml is equal to the
123
+ # maximum duration because there is a
124
+ # [storage quota](https://cloud.google.com/appengine/quotas#Task_Queue) for
125
+ # these queues. To view the maximum valid duration, see the documentation for
126
+ # {::Google::Protobuf::Duration Duration}.
127
+ # @!attribute [rw] tombstone_ttl
128
+ # @return [::Google::Protobuf::Duration]
129
+ # The task tombstone time to live (TTL).
130
+ #
131
+ # After a task is deleted or executed, the task's tombstone is
132
+ # retained for the length of time specified by `tombstone_ttl`.
133
+ # The tombstone is used by task de-duplication; another task with the same
134
+ # name can't be created until the tombstone has expired. For more information
135
+ # about task de-duplication, see the documentation for
136
+ # {::Google::Cloud::Tasks::V2beta3::CreateTaskRequest#task CreateTaskRequest}.
137
+ #
138
+ # Queues created by Cloud Tasks have a default `tombstone_ttl` of 1 hour.
113
139
  # @!attribute [rw] stackdriver_logging_config
114
140
  # @return [::Google::Cloud::Tasks::V2beta3::StackdriverLoggingConfig]
115
141
  # Configuration options for writing logs to
@@ -122,6 +148,11 @@ module Google
122
148
  # `Queue.type` is an immutable property of the queue that is set at the queue
123
149
  # creation time. When left unspecified, the default value of `PUSH` is
124
150
  # selected.
151
+ # @!attribute [r] stats
152
+ # @return [::Google::Cloud::Tasks::V2beta3::QueueStats]
153
+ # Output only. The realtime, informational statistics for a queue. In order
154
+ # to receive the statistics the caller should include this field in the
155
+ # FieldMask.
125
156
  class Queue
126
157
  include ::Google::Protobuf::MessageExts
127
158
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -199,7 +230,7 @@ module Google
199
230
  # queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#rate).
200
231
  # @!attribute [rw] max_burst_size
201
232
  # @return [::Integer]
202
- # Output only. The max burst size.
233
+ # The max burst size.
203
234
  #
204
235
  # Max burst size limits how fast tasks in queue are processed when
205
236
  # many tasks are in the queue and the rate is high. This field
@@ -216,21 +247,21 @@ module Google
216
247
  # continuously refilled with new tokens based on
217
248
  # {::Google::Cloud::Tasks::V2beta3::RateLimits#max_dispatches_per_second max_dispatches_per_second}.
218
249
  #
219
- # Cloud Tasks will pick the value of `max_burst_size` based on the
220
- # value of
250
+ # The default value of `max_burst_size` is picked by Cloud Tasks
251
+ # based on the value of
221
252
  # {::Google::Cloud::Tasks::V2beta3::RateLimits#max_dispatches_per_second max_dispatches_per_second}.
222
253
  #
254
+ # The maximum value of `max_burst_size` is 500.
255
+ #
223
256
  # For App Engine queues that were created or updated using
224
257
  # `queue.yaml/xml`, `max_burst_size` is equal to
225
258
  # [bucket_size](https://cloud.google.com/appengine/docs/standard/python/config/queueref#bucket_size).
226
- # Since `max_burst_size` is output only, if
227
- # {::Google::Cloud::Tasks::V2beta3::CloudTasks::Client#update_queue UpdateQueue} is called on a queue
228
- # created by `queue.yaml/xml`, `max_burst_size` will be reset based
229
- # on the value of
230
- # {::Google::Cloud::Tasks::V2beta3::RateLimits#max_dispatches_per_second max_dispatches_per_second},
231
- # regardless of whether
232
- # {::Google::Cloud::Tasks::V2beta3::RateLimits#max_dispatches_per_second max_dispatches_per_second}
233
- # is updated.
259
+ # If
260
+ # {::Google::Cloud::Tasks::V2beta3::CloudTasks::Client#update_queue UpdateQueue} is called on a queue without
261
+ # explicitly setting a value for `max_burst_size`,
262
+ # `max_burst_size` value will get updated if
263
+ # {::Google::Cloud::Tasks::V2beta3::CloudTasks::Client#update_queue UpdateQueue} is updating
264
+ # {::Google::Cloud::Tasks::V2beta3::RateLimits#max_dispatches_per_second max_dispatches_per_second}.
234
265
  # @!attribute [rw] max_concurrent_dispatches
235
266
  # @return [::Integer]
236
267
  # The maximum number of concurrent tasks that Cloud Tasks allows
@@ -371,6 +402,37 @@ module Google
371
402
  include ::Google::Protobuf::MessageExts
372
403
  extend ::Google::Protobuf::MessageExts::ClassMethods
373
404
  end
405
+
406
+ # Statistics for a queue.
407
+ # @!attribute [r] tasks_count
408
+ # @return [::Integer]
409
+ # Output only. An estimation of the number of tasks in the queue, that is, the tasks in
410
+ # the queue that haven't been executed, the tasks in the queue which the
411
+ # queue has dispatched but has not yet received a reply for, and the failed
412
+ # tasks that the queue is retrying.
413
+ # @!attribute [r] oldest_estimated_arrival_time
414
+ # @return [::Google::Protobuf::Timestamp]
415
+ # Output only. An estimation of the nearest time in the future where a task in the queue
416
+ # is scheduled to be executed.
417
+ # @!attribute [r] executed_last_minute_count
418
+ # @return [::Integer]
419
+ # Output only. The number of tasks that the queue has dispatched and received a reply for
420
+ # during the last minute. This variable counts both successful and
421
+ # non-successful executions.
422
+ # @!attribute [r] concurrent_dispatches_count
423
+ # @return [::Integer]
424
+ # Output only. The number of requests that the queue has dispatched but has not received
425
+ # a reply for yet.
426
+ # @!attribute [r] effective_execution_rate
427
+ # @return [::Float]
428
+ # Output only. The current maximum number of tasks per second executed by the queue.
429
+ # The maximum value of this variable is controlled by the RateLimits of the
430
+ # Queue. However, this value could be less to avoid overloading the endpoints
431
+ # tasks in the queue are targeting.
432
+ class QueueStats
433
+ include ::Google::Protobuf::MessageExts
434
+ extend ::Google::Protobuf::MessageExts::ClassMethods
435
+ end
374
436
  end
375
437
  end
376
438
  end