google-cloud-tasks 0.7.1 → 1.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (28) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +1 -1
  3. data/lib/google/cloud/tasks.rb +1 -1
  4. data/lib/google/cloud/tasks/v2.rb +1 -1
  5. data/lib/google/cloud/tasks/v2/cloud_tasks_client.rb +17 -16
  6. data/lib/google/cloud/tasks/v2/cloudtasks_pb.rb +3 -3
  7. data/lib/google/cloud/tasks/v2/cloudtasks_services_pb.rb +12 -9
  8. data/lib/google/cloud/tasks/v2/doc/google/cloud/tasks/v2/cloudtasks.rb +9 -7
  9. data/lib/google/cloud/tasks/v2/doc/google/cloud/tasks/v2/target.rb +11 -10
  10. data/lib/google/cloud/tasks/v2/doc/google/iam/v1/iam_policy.rb +3 -6
  11. data/lib/google/cloud/tasks/v2/doc/google/iam/v1/policy.rb +29 -10
  12. data/lib/google/cloud/tasks/v2/doc/google/type/expr.rb +45 -0
  13. data/lib/google/cloud/tasks/v2beta2/cloud_tasks_client.rb +3 -6
  14. data/lib/google/cloud/tasks/v2beta2/doc/google/iam/v1/iam_policy.rb +3 -6
  15. data/lib/google/cloud/tasks/v2beta2/doc/google/iam/v1/policy.rb +29 -10
  16. data/lib/google/cloud/tasks/v2beta2/doc/google/type/expr.rb +45 -0
  17. data/lib/google/cloud/tasks/v2beta3/cloud_tasks_client.rb +17 -16
  18. data/lib/google/cloud/tasks/v2beta3/cloudtasks_pb.rb +3 -3
  19. data/lib/google/cloud/tasks/v2beta3/cloudtasks_services_pb.rb +12 -9
  20. data/lib/google/cloud/tasks/v2beta3/doc/google/cloud/tasks/v2beta3/cloudtasks.rb +9 -7
  21. data/lib/google/cloud/tasks/v2beta3/doc/google/cloud/tasks/v2beta3/queue.rb +15 -6
  22. data/lib/google/cloud/tasks/v2beta3/doc/google/cloud/tasks/v2beta3/target.rb +22 -23
  23. data/lib/google/cloud/tasks/v2beta3/doc/google/cloud/tasks/v2beta3/task.rb +0 -4
  24. data/lib/google/cloud/tasks/v2beta3/doc/google/iam/v1/iam_policy.rb +3 -6
  25. data/lib/google/cloud/tasks/v2beta3/doc/google/iam/v1/policy.rb +29 -10
  26. data/lib/google/cloud/tasks/v2beta3/doc/google/type/expr.rb +45 -0
  27. data/lib/google/cloud/tasks/v2beta3/queue_pb.rb +5 -1
  28. metadata +5 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: fa7e42c029deb06246e3db6fad541287255f1a8aee3e204b0770069d513425b9
4
- data.tar.gz: cb4ac480bcb37ce8cf4a50303be16be5b55609c93414566c9cac274e0bdd4f91
3
+ metadata.gz: 68276f6d3bf73a7e96df8ed994831cd8dcadc05509c6a2f005fbe21f322731a9
4
+ data.tar.gz: 417b2264daab779a25cfc450238df81f2e1ab7b0a501f833eaa3b4aaf172853e
5
5
  SHA512:
6
- metadata.gz: e511bc420bced872e0404e69bdf289ee275094622352e33247f343159f707c574ce7c630cf94edaf01706ea45f0980401e6b36349e7df9f332f02e2fea96a04b
7
- data.tar.gz: 7f014699dd95d6d5c003f2b370c9e504bcbd54580f59118520114e783014693919507d61e53bd2b99d5be7596a38664dabd9c9f56284f07274e64ba2a0802122
6
+ metadata.gz: c52c448268b89ed10d852aa6c05e10dc0b129ca52f48c11fab5864036739a332304a73ab9d39082b7d64f83bbf1a066257ba72d9a6c336226ccc58343564517c
7
+ data.tar.gz: 72f9424f4b4c9f407cbb6564a938f5eb5b41146c8859ae5d08514a59aafebd6847a2ce2e89fc01221823b0372ce852862b352d280fc2a0ba66c58938368edc04
data/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # Ruby Client for Cloud Tasks API ([Alpha](https://github.com/googleapis/google-cloud-ruby#versioning))
1
+ # Ruby Client for Cloud Tasks API ([GA](https://github.com/googleapis/google-cloud-ruby#versioning))
2
2
 
3
3
  [Cloud Tasks API][Product Documentation]:
4
4
  Manages the execution of large numbers of distributed requests.
@@ -21,7 +21,7 @@ module Google
21
21
  # rubocop:disable LineLength
22
22
 
23
23
  ##
24
- # # Ruby Client for Cloud Tasks API ([Alpha](https://github.com/googleapis/google-cloud-ruby#versioning))
24
+ # # Ruby Client for Cloud Tasks API ([GA](https://github.com/googleapis/google-cloud-ruby#versioning))
25
25
  #
26
26
  # [Cloud Tasks API][Product Documentation]:
27
27
  # Manages the execution of large numbers of distributed requests.
@@ -22,7 +22,7 @@ module Google
22
22
  # rubocop:disable LineLength
23
23
 
24
24
  ##
25
- # # Ruby Client for Cloud Tasks API ([Alpha](https://github.com/googleapis/google-cloud-ruby#versioning))
25
+ # # Ruby Client for Cloud Tasks API ([GA](https://github.com/googleapis/google-cloud-ruby#versioning))
26
26
  #
27
27
  # [Cloud Tasks API][Product Documentation]:
28
28
  # Manages the execution of large numbers of distributed requests.
@@ -393,7 +393,8 @@ module Google
393
393
  # field can be used as a filter and several operators as supported.
394
394
  # For example: `<=, <, >=, >, !=, =, :`. The filter syntax is the same as
395
395
  # described in
396
- # [Stackdriver's Advanced Logs Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
396
+ # [Stackdriver's Advanced Logs
397
+ # Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
397
398
  #
398
399
  # Sample filter "state: PAUSED".
399
400
  #
@@ -493,8 +494,9 @@ module Google
493
494
  # WARNING: Using this method may have unintended side effects if you are
494
495
  # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
495
496
  # Read
496
- # [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
497
- # before using this method.
497
+ # [Overview of Queue Management and
498
+ # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
499
+ # this method.
498
500
  #
499
501
  # @param parent [String]
500
502
  # Required.
@@ -556,8 +558,9 @@ module Google
556
558
  # WARNING: Using this method may have unintended side effects if you are
557
559
  # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
558
560
  # Read
559
- # [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
560
- # before using this method.
561
+ # [Overview of Queue Management and
562
+ # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
563
+ # this method.
561
564
  #
562
565
  # @param queue [Google::Cloud::Tasks::V2::Queue | Hash]
563
566
  # Required.
@@ -617,8 +620,9 @@ module Google
617
620
  # WARNING: Using this method may have unintended side effects if you are
618
621
  # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
619
622
  # Read
620
- # [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
621
- # before using this method.
623
+ # [Overview of Queue Management and
624
+ # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
625
+ # this method.
622
626
  #
623
627
  # @param name [String]
624
628
  # Required.
@@ -739,7 +743,8 @@ module Google
739
743
  # WARNING: Resuming many high-QPS queues at the same time can
740
744
  # lead to target overloading. If you are resuming high-QPS
741
745
  # queues, follow the 500/50/5 pattern described in
742
- # [Managing Cloud Tasks Scaling Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
746
+ # [Managing Cloud Tasks Scaling
747
+ # Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
743
748
  #
744
749
  # @param name [String]
745
750
  # Required.
@@ -784,8 +789,7 @@ module Google
784
789
  #
785
790
  # @param resource [String]
786
791
  # REQUIRED: The resource for which the policy is being requested.
787
- # `resource` is usually specified as a path. For example, a Project
788
- # resource is specified as `projects/{project}`.
792
+ # See the operation documentation for the appropriate value for this field.
789
793
  # @param options [Google::Gax::CallOptions]
790
794
  # Overrides the default settings for this call, e.g, timeout,
791
795
  # retries, etc.
@@ -826,8 +830,7 @@ module Google
826
830
  #
827
831
  # @param resource [String]
828
832
  # REQUIRED: The resource for which the policy is being specified.
829
- # `resource` is usually specified as a path. For example, a Project
830
- # resource is specified as `projects/{project}`.
833
+ # See the operation documentation for the appropriate value for this field.
831
834
  # @param policy [Google::Iam::V1::Policy | Hash]
832
835
  # REQUIRED: The complete policy to be applied to the `resource`. The size of
833
836
  # the policy is limited to a few 10s of KB. An empty policy is a
@@ -876,8 +879,7 @@ module Google
876
879
  #
877
880
  # @param resource [String]
878
881
  # REQUIRED: The resource for which the policy detail is being requested.
879
- # `resource` is usually specified as a path. For example, a Project
880
- # resource is specified as `projects/{project}`.
882
+ # See the operation documentation for the appropriate value for this field.
881
883
  # @param permissions [Array<String>]
882
884
  # The set of permissions to check for the `resource`. Permissions with
883
885
  # wildcards (such as '*' or 'storage.*') are not allowed. For more
@@ -1046,8 +1048,7 @@ module Google
1046
1048
  #
1047
1049
  # Tasks cannot be updated after creation; there is no UpdateTask command.
1048
1050
  #
1049
- # * For {Google::Cloud::Tasks::V2::AppEngineHttpQueue App Engine queues}, the maximum task size is
1050
- # 100KB.
1051
+ # * The maximum task size is 100KB.
1051
1052
  #
1052
1053
  # @param parent [String]
1053
1054
  # Required.
@@ -5,12 +5,12 @@
5
5
  require 'google/protobuf'
6
6
 
7
7
  require 'google/api/annotations_pb'
8
- require 'google/protobuf/empty_pb'
9
- require 'google/protobuf/field_mask_pb'
10
- require 'google/cloud/tasks/v2/task_pb'
11
8
  require 'google/cloud/tasks/v2/queue_pb'
9
+ require 'google/cloud/tasks/v2/task_pb'
12
10
  require 'google/iam/v1/iam_policy_pb'
13
11
  require 'google/iam/v1/policy_pb'
12
+ require 'google/protobuf/empty_pb'
13
+ require 'google/protobuf/field_mask_pb'
14
14
  require 'google/rpc/code_pb'
15
15
  Google::Protobuf::DescriptorPool.generated_pool.build do
16
16
  add_message "google.cloud.tasks.v2.ListQueuesRequest" do
@@ -51,8 +51,9 @@ module Google
51
51
  # WARNING: Using this method may have unintended side effects if you are
52
52
  # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
53
53
  # Read
54
- # [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
55
- # before using this method.
54
+ # [Overview of Queue Management and
55
+ # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
56
+ # this method.
56
57
  rpc :CreateQueue, CreateQueueRequest, Queue
57
58
  # Updates a queue.
58
59
  #
@@ -66,8 +67,9 @@ module Google
66
67
  # WARNING: Using this method may have unintended side effects if you are
67
68
  # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
68
69
  # Read
69
- # [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
70
- # before using this method.
70
+ # [Overview of Queue Management and
71
+ # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
72
+ # this method.
71
73
  rpc :UpdateQueue, UpdateQueueRequest, Queue
72
74
  # Deletes a queue.
73
75
  #
@@ -79,8 +81,9 @@ module Google
79
81
  # WARNING: Using this method may have unintended side effects if you are
80
82
  # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
81
83
  # Read
82
- # [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
83
- # before using this method.
84
+ # [Overview of Queue Management and
85
+ # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
86
+ # this method.
84
87
  rpc :DeleteQueue, DeleteQueueRequest, Google::Protobuf::Empty
85
88
  # Purges a queue by deleting all of its tasks.
86
89
  #
@@ -108,7 +111,8 @@ module Google
108
111
  # WARNING: Resuming many high-QPS queues at the same time can
109
112
  # lead to target overloading. If you are resuming high-QPS
110
113
  # queues, follow the 500/50/5 pattern described in
111
- # [Managing Cloud Tasks Scaling Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
114
+ # [Managing Cloud Tasks Scaling
115
+ # Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
112
116
  rpc :ResumeQueue, ResumeQueueRequest, Queue
113
117
  # Gets the access control policy for a [Queue][google.cloud.tasks.v2.Queue].
114
118
  # Returns an empty policy if the resource exists and does not have a policy
@@ -156,8 +160,7 @@ module Google
156
160
  #
157
161
  # Tasks cannot be updated after creation; there is no UpdateTask command.
158
162
  #
159
- # * For [App Engine queues][google.cloud.tasks.v2.AppEngineHttpQueue], the maximum task size is
160
- # 100KB.
163
+ # * The maximum task size is 100KB.
161
164
  rpc :CreateTask, CreateTaskRequest, Task
162
165
  # Deletes a task.
163
166
  #
@@ -30,7 +30,8 @@ module Google
30
30
  # field can be used as a filter and several operators as supported.
31
31
  # For example: `<=, <, >=, >, !=, =, :`. The filter syntax is the same as
32
32
  # described in
33
- # [Stackdriver's Advanced Logs Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
33
+ # [Stackdriver's Advanced Logs
34
+ # Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
34
35
  #
35
36
  # Sample filter "state: PAUSED".
36
37
  #
@@ -181,13 +182,14 @@ module Google
181
182
  # permission on the {Google::Cloud::Tasks::V2::Task Task} resource.
182
183
  # @!attribute [rw] page_size
183
184
  # @return [Integer]
184
- # Requested page size. Fewer tasks than requested might be returned.
185
+ # Maximum page size.
185
186
  #
186
- # The maximum page size is 1000. If unspecified, the page size will
187
- # be the maximum. Fewer tasks than requested might be returned,
188
- # even if more tasks exist; use
189
- # {Google::Cloud::Tasks::V2::ListTasksResponse#next_page_token next_page_token} in the
190
- # response to determine if more tasks exist.
187
+ # Fewer tasks than requested might be returned, even if more tasks exist; use
188
+ # {Google::Cloud::Tasks::V2::ListTasksResponse#next_page_token next_page_token} in the response to
189
+ # determine if more tasks exist.
190
+ #
191
+ # The maximum page size is 1000. If unspecified, the page size will be the
192
+ # maximum.
191
193
  # @!attribute [rw] page_token
192
194
  # @return [String]
193
195
  # A token identifying the page of results to return.
@@ -22,9 +22,6 @@ module Google
22
22
  # The message defines the HTTP request that is sent to an App Engine app when
23
23
  # the task is dispatched.
24
24
  #
25
- # This proto can only be used for tasks in a queue which has
26
- # {Queue#app_engine_http_queue app_engine_http_queue} set.
27
- #
28
25
  # Using {Google::Cloud::Tasks::V2::AppEngineHttpRequest AppEngineHttpRequest} requires
29
26
  # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control)
30
27
  # Google IAM permission for the project
@@ -70,13 +67,17 @@ module Google
70
67
  # required`](https://cloud.google.com/appengine/docs/standard/python/config/appref)
71
68
  # Task dispatches also do not follow redirects.
72
69
  #
73
- # The task attempt has succeeded if the app's request handler returns
74
- # an HTTP response code in the range [`200` - `299`]. `503` is
75
- # considered an App Engine system error instead of an application
76
- # error. Requests returning error `503` will be retried regardless of
77
- # retry configuration and not counted against retry counts.
78
- # Any other response code or a failure to receive a response before the
79
- # deadline is a failed attempt.
70
+ # The task attempt has succeeded if the app's request handler returns an HTTP
71
+ # response code in the range [`200` - `299`]. The task attempt has failed if
72
+ # the app's handler returns a non-2xx response code or Cloud Tasks does
73
+ # not receive response before the {Google::Cloud::Tasks::V2::Task#dispatch_deadline deadline}. Failed
74
+ # tasks will be retried according to the
75
+ # {Queue::RetryConfig retry configuration}. `503` (Service Unavailable) is
76
+ # considered an App Engine system error instead of an application error and
77
+ # will cause Cloud Tasks' traffic congestion control to temporarily throttle
78
+ # the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
79
+ # Requests) response from an app handler does not cause traffic congestion
80
+ # control to throttle the queue.
80
81
  # @!attribute [rw] http_method
81
82
  # @return [Google::Cloud::Tasks::V2::HttpMethod]
82
83
  # The HTTP method to use for the request. The default is POST.
@@ -20,8 +20,7 @@ module Google
20
20
  # @!attribute [rw] resource
21
21
  # @return [String]
22
22
  # REQUIRED: The resource for which the policy is being specified.
23
- # `resource` is usually specified as a path. For example, a Project
24
- # resource is specified as `projects/{project}`.
23
+ # See the operation documentation for the appropriate value for this field.
25
24
  # @!attribute [rw] policy
26
25
  # @return [Google::Iam::V1::Policy]
27
26
  # REQUIRED: The complete policy to be applied to the `resource`. The size of
@@ -34,16 +33,14 @@ module Google
34
33
  # @!attribute [rw] resource
35
34
  # @return [String]
36
35
  # REQUIRED: The resource for which the policy is being requested.
37
- # `resource` is usually specified as a path. For example, a Project
38
- # resource is specified as `projects/{project}`.
36
+ # See the operation documentation for the appropriate value for this field.
39
37
  class GetIamPolicyRequest; end
40
38
 
41
39
  # Request message for `TestIamPermissions` method.
42
40
  # @!attribute [rw] resource
43
41
  # @return [String]
44
42
  # REQUIRED: The resource for which the policy detail is being requested.
45
- # `resource` is usually specified as a path. For example, a Project
46
- # resource is specified as `projects/{project}`.
43
+ # See the operation documentation for the appropriate value for this field.
47
44
  # @!attribute [rw] permissions
48
45
  # @return [Array<String>]
49
46
  # The set of permissions to check for the `resource`. Permissions with
@@ -20,12 +20,12 @@ module Google
20
20
  # specify access control policies for Cloud Platform resources.
21
21
  #
22
22
  #
23
- # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
23
+ # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
24
24
  # `members` to a `role`, where the members can be user accounts, Google groups,
25
25
  # Google domains, and service accounts. A `role` is a named list of permissions
26
26
  # defined by IAM.
27
27
  #
28
- # **Example**
28
+ # **JSON Example**
29
29
  #
30
30
  # {
31
31
  # "bindings": [
@@ -35,7 +35,7 @@ module Google
35
35
  # "user:mike@example.com",
36
36
  # "group:admins@example.com",
37
37
  # "domain:google.com",
38
- # "serviceAccount:my-other-app@appspot.gserviceaccount.com",
38
+ # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
39
39
  # ]
40
40
  # },
41
41
  # {
@@ -45,15 +45,28 @@ module Google
45
45
  # ]
46
46
  # }
47
47
  #
48
- # For a description of IAM and its features, see the
49
- # [IAM developer's guide](https://cloud.google.com/iam).
48
+ # **YAML Example**
49
+ #
50
+ # bindings:
51
+ # * members:
52
+ # * user:mike@example.com
53
+ # * group:admins@example.com
54
+ # * domain:google.com
55
+ # * serviceAccount:my-other-app@appspot.gserviceaccount.com
56
+ # role: roles/owner
57
+ # * members:
58
+ # * user:sean@example.com
59
+ # role: roles/viewer
60
+ #
61
+ #
62
+ # For a description of IAM and its features, see the
63
+ # [IAM developer's guide](https://cloud.google.com/iam/docs).
50
64
  # @!attribute [rw] version
51
65
  # @return [Integer]
52
- # Version of the `Policy`. The default version is 0.
66
+ # Deprecated.
53
67
  # @!attribute [rw] bindings
54
68
  # @return [Array<Google::Iam::V1::Binding>]
55
69
  # Associates a list of `members` to a `role`.
56
- # Multiple `bindings` must not be specified for the same `role`.
57
70
  # `bindings` with no members will result in an error.
58
71
  # @!attribute [rw] etag
59
72
  # @return [String]
@@ -74,7 +87,6 @@ module Google
74
87
  # @return [String]
75
88
  # Role that is assigned to `members`.
76
89
  # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
77
- # Required
78
90
  # @!attribute [rw] members
79
91
  # @return [Array<String>]
80
92
  # Specifies the identities requesting access for a Cloud Platform resource.
@@ -87,7 +99,7 @@ module Google
87
99
  # who is authenticated with a Google account or a service account.
88
100
  #
89
101
  # * `user:{emailid}`: An email address that represents a specific Google
90
- # account. For example, `alice@gmail.com` or `joe@example.com`.
102
+ # account. For example, `alice@gmail.com` .
91
103
  #
92
104
  #
93
105
  # * `serviceAccount:{emailid}`: An email address that represents a service
@@ -96,8 +108,15 @@ module Google
96
108
  # * `group:{emailid}`: An email address that represents a Google group.
97
109
  # For example, `admins@example.com`.
98
110
  #
99
- # * `domain:{domain}`: A Google Apps domain name that represents all the
111
+ #
112
+ # * `domain:{domain}`: The G Suite domain (primary) that represents all the
100
113
  # users of that domain. For example, `google.com` or `example.com`.
114
+ # @!attribute [rw] condition
115
+ # @return [Google::Type::Expr]
116
+ # The condition that is associated with this binding.
117
+ # NOTE: An unsatisfied condition will not allow user access via current
118
+ # binding. Different bindings, including their conditions, are examined
119
+ # independently.
101
120
  class Binding; end
102
121
  end
103
122
  end
@@ -0,0 +1,45 @@
1
+ # Copyright 2019 Google LLC
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # https://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+
16
+ module Google
17
+ module Type
18
+ # Represents an expression text. Example:
19
+ #
20
+ # title: "User account presence"
21
+ # description: "Determines whether the request has a user account"
22
+ # expression: "size(request.user) > 0"
23
+ # @!attribute [rw] expression
24
+ # @return [String]
25
+ # Textual representation of an expression in
26
+ # Common Expression Language syntax.
27
+ #
28
+ # The application context of the containing message determines which
29
+ # well-known feature set of CEL is supported.
30
+ # @!attribute [rw] title
31
+ # @return [String]
32
+ # An optional title for the expression, i.e. a short string describing
33
+ # its purpose. This can be used e.g. in UIs which allow to enter the
34
+ # expression.
35
+ # @!attribute [rw] description
36
+ # @return [String]
37
+ # An optional description of the expression. This is a longer text which
38
+ # describes the expression, e.g. when hovered over it in a UI.
39
+ # @!attribute [rw] location
40
+ # @return [String]
41
+ # An optional string indicating the location of the expression for error
42
+ # reporting, e.g. a file name and a position in the file.
43
+ class Expr; end
44
+ end
45
+ end
@@ -826,8 +826,7 @@ module Google
826
826
  #
827
827
  # @param resource [String]
828
828
  # REQUIRED: The resource for which the policy is being requested.
829
- # `resource` is usually specified as a path. For example, a Project
830
- # resource is specified as `projects/{project}`.
829
+ # See the operation documentation for the appropriate value for this field.
831
830
  # @param options [Google::Gax::CallOptions]
832
831
  # Overrides the default settings for this call, e.g, timeout,
833
832
  # retries, etc.
@@ -868,8 +867,7 @@ module Google
868
867
  #
869
868
  # @param resource [String]
870
869
  # REQUIRED: The resource for which the policy is being specified.
871
- # `resource` is usually specified as a path. For example, a Project
872
- # resource is specified as `projects/{project}`.
870
+ # See the operation documentation for the appropriate value for this field.
873
871
  # @param policy [Google::Iam::V1::Policy | Hash]
874
872
  # REQUIRED: The complete policy to be applied to the `resource`. The size of
875
873
  # the policy is limited to a few 10s of KB. An empty policy is a
@@ -919,8 +917,7 @@ module Google
919
917
  #
920
918
  # @param resource [String]
921
919
  # REQUIRED: The resource for which the policy detail is being requested.
922
- # `resource` is usually specified as a path. For example, a Project
923
- # resource is specified as `projects/{project}`.
920
+ # See the operation documentation for the appropriate value for this field.
924
921
  # @param permissions [Array<String>]
925
922
  # The set of permissions to check for the `resource`. Permissions with
926
923
  # wildcards (such as '*' or 'storage.*') are not allowed. For more
@@ -20,8 +20,7 @@ module Google
20
20
  # @!attribute [rw] resource
21
21
  # @return [String]
22
22
  # REQUIRED: The resource for which the policy is being specified.
23
- # `resource` is usually specified as a path. For example, a Project
24
- # resource is specified as `projects/{project}`.
23
+ # See the operation documentation for the appropriate value for this field.
25
24
  # @!attribute [rw] policy
26
25
  # @return [Google::Iam::V1::Policy]
27
26
  # REQUIRED: The complete policy to be applied to the `resource`. The size of
@@ -34,16 +33,14 @@ module Google
34
33
  # @!attribute [rw] resource
35
34
  # @return [String]
36
35
  # REQUIRED: The resource for which the policy is being requested.
37
- # `resource` is usually specified as a path. For example, a Project
38
- # resource is specified as `projects/{project}`.
36
+ # See the operation documentation for the appropriate value for this field.
39
37
  class GetIamPolicyRequest; end
40
38
 
41
39
  # Request message for `TestIamPermissions` method.
42
40
  # @!attribute [rw] resource
43
41
  # @return [String]
44
42
  # REQUIRED: The resource for which the policy detail is being requested.
45
- # `resource` is usually specified as a path. For example, a Project
46
- # resource is specified as `projects/{project}`.
43
+ # See the operation documentation for the appropriate value for this field.
47
44
  # @!attribute [rw] permissions
48
45
  # @return [Array<String>]
49
46
  # The set of permissions to check for the `resource`. Permissions with
@@ -20,12 +20,12 @@ module Google
20
20
  # specify access control policies for Cloud Platform resources.
21
21
  #
22
22
  #
23
- # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
23
+ # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
24
24
  # `members` to a `role`, where the members can be user accounts, Google groups,
25
25
  # Google domains, and service accounts. A `role` is a named list of permissions
26
26
  # defined by IAM.
27
27
  #
28
- # **Example**
28
+ # **JSON Example**
29
29
  #
30
30
  # {
31
31
  # "bindings": [
@@ -35,7 +35,7 @@ module Google
35
35
  # "user:mike@example.com",
36
36
  # "group:admins@example.com",
37
37
  # "domain:google.com",
38
- # "serviceAccount:my-other-app@appspot.gserviceaccount.com",
38
+ # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
39
39
  # ]
40
40
  # },
41
41
  # {
@@ -45,15 +45,28 @@ module Google
45
45
  # ]
46
46
  # }
47
47
  #
48
- # For a description of IAM and its features, see the
49
- # [IAM developer's guide](https://cloud.google.com/iam).
48
+ # **YAML Example**
49
+ #
50
+ # bindings:
51
+ # * members:
52
+ # * user:mike@example.com
53
+ # * group:admins@example.com
54
+ # * domain:google.com
55
+ # * serviceAccount:my-other-app@appspot.gserviceaccount.com
56
+ # role: roles/owner
57
+ # * members:
58
+ # * user:sean@example.com
59
+ # role: roles/viewer
60
+ #
61
+ #
62
+ # For a description of IAM and its features, see the
63
+ # [IAM developer's guide](https://cloud.google.com/iam/docs).
50
64
  # @!attribute [rw] version
51
65
  # @return [Integer]
52
- # Version of the `Policy`. The default version is 0.
66
+ # Deprecated.
53
67
  # @!attribute [rw] bindings
54
68
  # @return [Array<Google::Iam::V1::Binding>]
55
69
  # Associates a list of `members` to a `role`.
56
- # Multiple `bindings` must not be specified for the same `role`.
57
70
  # `bindings` with no members will result in an error.
58
71
  # @!attribute [rw] etag
59
72
  # @return [String]
@@ -74,7 +87,6 @@ module Google
74
87
  # @return [String]
75
88
  # Role that is assigned to `members`.
76
89
  # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
77
- # Required
78
90
  # @!attribute [rw] members
79
91
  # @return [Array<String>]
80
92
  # Specifies the identities requesting access for a Cloud Platform resource.
@@ -87,7 +99,7 @@ module Google
87
99
  # who is authenticated with a Google account or a service account.
88
100
  #
89
101
  # * `user:{emailid}`: An email address that represents a specific Google
90
- # account. For example, `alice@gmail.com` or `joe@example.com`.
102
+ # account. For example, `alice@gmail.com` .
91
103
  #
92
104
  #
93
105
  # * `serviceAccount:{emailid}`: An email address that represents a service
@@ -96,8 +108,15 @@ module Google
96
108
  # * `group:{emailid}`: An email address that represents a Google group.
97
109
  # For example, `admins@example.com`.
98
110
  #
99
- # * `domain:{domain}`: A Google Apps domain name that represents all the
111
+ #
112
+ # * `domain:{domain}`: The G Suite domain (primary) that represents all the
100
113
  # users of that domain. For example, `google.com` or `example.com`.
114
+ # @!attribute [rw] condition
115
+ # @return [Google::Type::Expr]
116
+ # The condition that is associated with this binding.
117
+ # NOTE: An unsatisfied condition will not allow user access via current
118
+ # binding. Different bindings, including their conditions, are examined
119
+ # independently.
101
120
  class Binding; end
102
121
  end
103
122
  end
@@ -0,0 +1,45 @@
1
+ # Copyright 2019 Google LLC
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # https://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+
16
+ module Google
17
+ module Type
18
+ # Represents an expression text. Example:
19
+ #
20
+ # title: "User account presence"
21
+ # description: "Determines whether the request has a user account"
22
+ # expression: "size(request.user) > 0"
23
+ # @!attribute [rw] expression
24
+ # @return [String]
25
+ # Textual representation of an expression in
26
+ # Common Expression Language syntax.
27
+ #
28
+ # The application context of the containing message determines which
29
+ # well-known feature set of CEL is supported.
30
+ # @!attribute [rw] title
31
+ # @return [String]
32
+ # An optional title for the expression, i.e. a short string describing
33
+ # its purpose. This can be used e.g. in UIs which allow to enter the
34
+ # expression.
35
+ # @!attribute [rw] description
36
+ # @return [String]
37
+ # An optional description of the expression. This is a longer text which
38
+ # describes the expression, e.g. when hovered over it in a UI.
39
+ # @!attribute [rw] location
40
+ # @return [String]
41
+ # An optional string indicating the location of the expression for error
42
+ # reporting, e.g. a file name and a position in the file.
43
+ class Expr; end
44
+ end
45
+ end
@@ -393,7 +393,8 @@ module Google
393
393
  # field can be used as a filter and several operators as supported.
394
394
  # For example: `<=, <, >=, >, !=, =, :`. The filter syntax is the same as
395
395
  # described in
396
- # [Stackdriver's Advanced Logs Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
396
+ # [Stackdriver's Advanced Logs
397
+ # Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
397
398
  #
398
399
  # Sample filter "state: PAUSED".
399
400
  #
@@ -493,8 +494,9 @@ module Google
493
494
  # WARNING: Using this method may have unintended side effects if you are
494
495
  # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
495
496
  # Read
496
- # [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
497
- # before using this method.
497
+ # [Overview of Queue Management and
498
+ # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
499
+ # this method.
498
500
  #
499
501
  # @param parent [String]
500
502
  # Required.
@@ -556,8 +558,9 @@ module Google
556
558
  # WARNING: Using this method may have unintended side effects if you are
557
559
  # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
558
560
  # Read
559
- # [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
560
- # before using this method.
561
+ # [Overview of Queue Management and
562
+ # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
563
+ # this method.
561
564
  #
562
565
  # @param queue [Google::Cloud::Tasks::V2beta3::Queue | Hash]
563
566
  # Required.
@@ -617,8 +620,9 @@ module Google
617
620
  # WARNING: Using this method may have unintended side effects if you are
618
621
  # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
619
622
  # Read
620
- # [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
621
- # before using this method.
623
+ # [Overview of Queue Management and
624
+ # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
625
+ # this method.
622
626
  #
623
627
  # @param name [String]
624
628
  # Required.
@@ -739,7 +743,8 @@ module Google
739
743
  # WARNING: Resuming many high-QPS queues at the same time can
740
744
  # lead to target overloading. If you are resuming high-QPS
741
745
  # queues, follow the 500/50/5 pattern described in
742
- # [Managing Cloud Tasks Scaling Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
746
+ # [Managing Cloud Tasks Scaling
747
+ # Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
743
748
  #
744
749
  # @param name [String]
745
750
  # Required.
@@ -784,8 +789,7 @@ module Google
784
789
  #
785
790
  # @param resource [String]
786
791
  # REQUIRED: The resource for which the policy is being requested.
787
- # `resource` is usually specified as a path. For example, a Project
788
- # resource is specified as `projects/{project}`.
792
+ # See the operation documentation for the appropriate value for this field.
789
793
  # @param options [Google::Gax::CallOptions]
790
794
  # Overrides the default settings for this call, e.g, timeout,
791
795
  # retries, etc.
@@ -826,8 +830,7 @@ module Google
826
830
  #
827
831
  # @param resource [String]
828
832
  # REQUIRED: The resource for which the policy is being specified.
829
- # `resource` is usually specified as a path. For example, a Project
830
- # resource is specified as `projects/{project}`.
833
+ # See the operation documentation for the appropriate value for this field.
831
834
  # @param policy [Google::Iam::V1::Policy | Hash]
832
835
  # REQUIRED: The complete policy to be applied to the `resource`. The size of
833
836
  # the policy is limited to a few 10s of KB. An empty policy is a
@@ -876,8 +879,7 @@ module Google
876
879
  #
877
880
  # @param resource [String]
878
881
  # REQUIRED: The resource for which the policy detail is being requested.
879
- # `resource` is usually specified as a path. For example, a Project
880
- # resource is specified as `projects/{project}`.
882
+ # See the operation documentation for the appropriate value for this field.
881
883
  # @param permissions [Array<String>]
882
884
  # The set of permissions to check for the `resource`. Permissions with
883
885
  # wildcards (such as '*' or 'storage.*') are not allowed. For more
@@ -1046,8 +1048,7 @@ module Google
1046
1048
  #
1047
1049
  # Tasks cannot be updated after creation; there is no UpdateTask command.
1048
1050
  #
1049
- # * For {Google::Cloud::Tasks::V2beta3::AppEngineHttpQueue App Engine queues}, the maximum task size is
1050
- # 100KB.
1051
+ # * The maximum task size is 100KB.
1051
1052
  #
1052
1053
  # @param parent [String]
1053
1054
  # Required.
@@ -6,12 +6,12 @@ require 'google/protobuf'
6
6
 
7
7
  require 'google/api/annotations_pb'
8
8
  require 'google/api/resource_pb'
9
- require 'google/protobuf/empty_pb'
10
- require 'google/protobuf/field_mask_pb'
11
- require 'google/cloud/tasks/v2beta3/task_pb'
12
9
  require 'google/cloud/tasks/v2beta3/queue_pb'
10
+ require 'google/cloud/tasks/v2beta3/task_pb'
13
11
  require 'google/iam/v1/iam_policy_pb'
14
12
  require 'google/iam/v1/policy_pb'
13
+ require 'google/protobuf/empty_pb'
14
+ require 'google/protobuf/field_mask_pb'
15
15
  require 'google/rpc/code_pb'
16
16
  Google::Protobuf::DescriptorPool.generated_pool.build do
17
17
  add_message "google.cloud.tasks.v2beta3.ListQueuesRequest" do
@@ -51,8 +51,9 @@ module Google
51
51
  # WARNING: Using this method may have unintended side effects if you are
52
52
  # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
53
53
  # Read
54
- # [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
55
- # before using this method.
54
+ # [Overview of Queue Management and
55
+ # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
56
+ # this method.
56
57
  rpc :CreateQueue, CreateQueueRequest, Queue
57
58
  # Updates a queue.
58
59
  #
@@ -66,8 +67,9 @@ module Google
66
67
  # WARNING: Using this method may have unintended side effects if you are
67
68
  # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
68
69
  # Read
69
- # [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
70
- # before using this method.
70
+ # [Overview of Queue Management and
71
+ # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
72
+ # this method.
71
73
  rpc :UpdateQueue, UpdateQueueRequest, Queue
72
74
  # Deletes a queue.
73
75
  #
@@ -79,8 +81,9 @@ module Google
79
81
  # WARNING: Using this method may have unintended side effects if you are
80
82
  # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
81
83
  # Read
82
- # [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
83
- # before using this method.
84
+ # [Overview of Queue Management and
85
+ # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
86
+ # this method.
84
87
  rpc :DeleteQueue, DeleteQueueRequest, Google::Protobuf::Empty
85
88
  # Purges a queue by deleting all of its tasks.
86
89
  #
@@ -108,7 +111,8 @@ module Google
108
111
  # WARNING: Resuming many high-QPS queues at the same time can
109
112
  # lead to target overloading. If you are resuming high-QPS
110
113
  # queues, follow the 500/50/5 pattern described in
111
- # [Managing Cloud Tasks Scaling Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
114
+ # [Managing Cloud Tasks Scaling
115
+ # Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
112
116
  rpc :ResumeQueue, ResumeQueueRequest, Queue
113
117
  # Gets the access control policy for a [Queue][google.cloud.tasks.v2beta3.Queue].
114
118
  # Returns an empty policy if the resource exists and does not have a policy
@@ -156,8 +160,7 @@ module Google
156
160
  #
157
161
  # Tasks cannot be updated after creation; there is no UpdateTask command.
158
162
  #
159
- # * For [App Engine queues][google.cloud.tasks.v2beta3.AppEngineHttpQueue], the maximum task size is
160
- # 100KB.
163
+ # * The maximum task size is 100KB.
161
164
  rpc :CreateTask, CreateTaskRequest, Task
162
165
  # Deletes a task.
163
166
  #
@@ -30,7 +30,8 @@ module Google
30
30
  # field can be used as a filter and several operators as supported.
31
31
  # For example: `<=, <, >=, >, !=, =, :`. The filter syntax is the same as
32
32
  # described in
33
- # [Stackdriver's Advanced Logs Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
33
+ # [Stackdriver's Advanced Logs
34
+ # Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
34
35
  #
35
36
  # Sample filter "state: PAUSED".
36
37
  #
@@ -181,13 +182,14 @@ module Google
181
182
  # permission on the {Google::Cloud::Tasks::V2beta3::Task Task} resource.
182
183
  # @!attribute [rw] page_size
183
184
  # @return [Integer]
184
- # Requested page size. Fewer tasks than requested might be returned.
185
+ # Maximum page size.
185
186
  #
186
- # The maximum page size is 1000. If unspecified, the page size will
187
- # be the maximum. Fewer tasks than requested might be returned,
188
- # even if more tasks exist; use
189
- # {Google::Cloud::Tasks::V2beta3::ListTasksResponse#next_page_token next_page_token} in the
190
- # response to determine if more tasks exist.
187
+ # Fewer tasks than requested might be returned, even if more tasks exist; use
188
+ # {Google::Cloud::Tasks::V2beta3::ListTasksResponse#next_page_token next_page_token} in the response to
189
+ # determine if more tasks exist.
190
+ #
191
+ # The maximum page size is 1000. If unspecified, the page size will be the
192
+ # maximum.
191
193
  # @!attribute [rw] page_token
192
194
  # @return [String]
193
195
  # A token identifying the page of results to return.
@@ -106,12 +106,11 @@ module Google
106
106
  #
107
107
  # Purge time will be truncated to the nearest microsecond. Purge
108
108
  # time will be unset if the queue has never been purged.
109
- # @!attribute [rw] log_sampling_ratio
110
- # @return [Float]
111
- # Specifies the fraction of operations to write to
112
- # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
113
- # This field may contain any value between 0.0 and 1.0, inclusive.
114
- # 0.0 is the default and means that no operations are logged.
109
+ # @!attribute [rw] stackdriver_logging_config
110
+ # @return [Google::Cloud::Tasks::V2beta3::StackdriverLoggingConfig]
111
+ # Configuration options for writing logs to
112
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
113
+ # field is unset, then no logs are written.
115
114
  class Queue
116
115
  # State of the queue.
117
116
  module State
@@ -327,6 +326,16 @@ module Google
327
326
  # [max_doublings in
328
327
  # queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
329
328
  class RetryConfig; end
329
+
330
+ # Configuration options for writing logs to
331
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
332
+ # @!attribute [rw] sampling_ratio
333
+ # @return [Float]
334
+ # Specifies the fraction of operations to write to
335
+ # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
336
+ # This field may contain any value between 0.0 and 1.0, inclusive.
337
+ # 0.0 is the default and means that no operations are logged.
338
+ class StackdriverLoggingConfig; end
330
339
  end
331
340
  end
332
341
  end
@@ -19,10 +19,6 @@ module Google
19
19
  module V2beta3
20
20
  # HTTP request.
21
21
  #
22
- # Warning: This is an [alpha](https://cloud.google.com/terms/launch-stages)
23
- # feature. If you haven't already joined, you can [use this form to sign
24
- # up](https://docs.google.com/forms/d/e/1FAIpQLSfc4uEy9CBHKYUSdnY1hdhKDCX7julVZHy3imOiR-XrU7bUNQ/viewform).
25
- #
26
22
  # The task will be pushed to the worker as an HTTP request. If the worker
27
23
  # or the redirected worker acknowledges the task by returning a successful HTTP
28
24
  # response code ([`200` - `299`]), the task will removed from the queue. If
@@ -107,8 +103,8 @@ module Google
107
103
  # will be generated and attached as an `Authorization` header in the HTTP
108
104
  # request.
109
105
  #
110
- # This type of authorization should be used when sending requests to a GCP
111
- # endpoint.
106
+ # This type of authorization should generally only be used when calling
107
+ # Google APIs hosted on *.googleapis.com.
112
108
  # @!attribute [rw] oidc_token
113
109
  # @return [Google::Cloud::Tasks::V2beta3::OidcToken]
114
110
  # If specified, an
@@ -116,8 +112,9 @@ module Google
116
112
  # token will be generated and attached as an `Authorization` header in the
117
113
  # HTTP request.
118
114
  #
119
- # This type of authorization should be used when sending requests to third
120
- # party endpoints.
115
+ # This type of authorization can be used for many scenarios, including
116
+ # calling Cloud Run, or endpoints where you intend to validate the token
117
+ # yourself.
121
118
  class HttpRequest; end
122
119
 
123
120
  # App Engine HTTP queue.
@@ -148,9 +145,6 @@ module Google
148
145
  # The message defines the HTTP request that is sent to an App Engine app when
149
146
  # the task is dispatched.
150
147
  #
151
- # This proto can only be used for tasks in a queue which has
152
- # {Google::Cloud::Tasks::V2beta3::Queue#app_engine_http_queue app_engine_http_queue} set.
153
- #
154
148
  # Using {Google::Cloud::Tasks::V2beta3::AppEngineHttpRequest AppEngineHttpRequest} requires
155
149
  # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control)
156
150
  # Google IAM permission for the project
@@ -196,13 +190,17 @@ module Google
196
190
  # required`](https://cloud.google.com/appengine/docs/standard/python/config/appref)
197
191
  # Task dispatches also do not follow redirects.
198
192
  #
199
- # The task attempt has succeeded if the app's request handler returns
200
- # an HTTP response code in the range [`200` - `299`]. `503` is
201
- # considered an App Engine system error instead of an application
202
- # error. Requests returning error `503` will be retried regardless of
203
- # retry configuration and not counted against retry counts.
204
- # Any other response code or a failure to receive a response before the
205
- # deadline is a failed attempt.
193
+ # The task attempt has succeeded if the app's request handler returns an HTTP
194
+ # response code in the range [`200` - `299`]. The task attempt has failed if
195
+ # the app's handler returns a non-2xx response code or Cloud Tasks does
196
+ # not receive response before the {Google::Cloud::Tasks::V2beta3::Task#dispatch_deadline deadline}. Failed
197
+ # tasks will be retried according to the
198
+ # {Queue::RetryConfig retry configuration}. `503` (Service Unavailable) is
199
+ # considered an App Engine system error instead of an application error and
200
+ # will cause Cloud Tasks' traffic congestion control to temporarily throttle
201
+ # the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
202
+ # Requests) response from an app handler does not cause traffic congestion
203
+ # control to throttle the queue.
206
204
  # @!attribute [rw] http_method
207
205
  # @return [Google::Cloud::Tasks::V2beta3::HttpMethod]
208
206
  # The HTTP method to use for the request. The default is POST.
@@ -366,8 +364,8 @@ module Google
366
364
 
367
365
  # Contains information needed for generating an
368
366
  # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
369
- # This type of authorization should be used when sending requests to a GCP
370
- # endpoint.
367
+ # This type of authorization should generally only be used when calling Google
368
+ # APIs hosted on *.googleapis.com.
371
369
  # @!attribute [rw] service_account_email
372
370
  # @return [String]
373
371
  # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
@@ -384,9 +382,10 @@ module Google
384
382
 
385
383
  # Contains information needed for generating an
386
384
  # [OpenID Connect
387
- # token](https://developers.google.com/identity/protocols/OpenIDConnect). This
388
- # type of authorization should be used when sending requests to third party
389
- # endpoints.
385
+ # token](https://developers.google.com/identity/protocols/OpenIDConnect).
386
+ # This type of authorization can be used for many scenarios, including
387
+ # calling Cloud Run, or endpoints where you intend to validate the token
388
+ # yourself.
390
389
  # @!attribute [rw] service_account_email
391
390
  # @return [String]
392
391
  # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
@@ -49,10 +49,6 @@ module Google
49
49
  # @return [Google::Cloud::Tasks::V2beta3::HttpRequest]
50
50
  # HTTP request that is sent to the task's target.
51
51
  #
52
- # Warning: This is an [alpha](https://cloud.google.com/terms/launch-stages)
53
- # feature. If you haven't already joined, you can [use this form to sign
54
- # up](https://docs.google.com/forms/d/e/1FAIpQLSfc4uEy9CBHKYUSdnY1hdhKDCX7julVZHy3imOiR-XrU7bUNQ/viewform).
55
- #
56
52
  # An HTTP task is a task that has {Google::Cloud::Tasks::V2beta3::HttpRequest HttpRequest} set.
57
53
  # @!attribute [rw] schedule_time
58
54
  # @return [Google::Protobuf::Timestamp]
@@ -20,8 +20,7 @@ module Google
20
20
  # @!attribute [rw] resource
21
21
  # @return [String]
22
22
  # REQUIRED: The resource for which the policy is being specified.
23
- # `resource` is usually specified as a path. For example, a Project
24
- # resource is specified as `projects/{project}`.
23
+ # See the operation documentation for the appropriate value for this field.
25
24
  # @!attribute [rw] policy
26
25
  # @return [Google::Iam::V1::Policy]
27
26
  # REQUIRED: The complete policy to be applied to the `resource`. The size of
@@ -34,16 +33,14 @@ module Google
34
33
  # @!attribute [rw] resource
35
34
  # @return [String]
36
35
  # REQUIRED: The resource for which the policy is being requested.
37
- # `resource` is usually specified as a path. For example, a Project
38
- # resource is specified as `projects/{project}`.
36
+ # See the operation documentation for the appropriate value for this field.
39
37
  class GetIamPolicyRequest; end
40
38
 
41
39
  # Request message for `TestIamPermissions` method.
42
40
  # @!attribute [rw] resource
43
41
  # @return [String]
44
42
  # REQUIRED: The resource for which the policy detail is being requested.
45
- # `resource` is usually specified as a path. For example, a Project
46
- # resource is specified as `projects/{project}`.
43
+ # See the operation documentation for the appropriate value for this field.
47
44
  # @!attribute [rw] permissions
48
45
  # @return [Array<String>]
49
46
  # The set of permissions to check for the `resource`. Permissions with
@@ -20,12 +20,12 @@ module Google
20
20
  # specify access control policies for Cloud Platform resources.
21
21
  #
22
22
  #
23
- # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
23
+ # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
24
24
  # `members` to a `role`, where the members can be user accounts, Google groups,
25
25
  # Google domains, and service accounts. A `role` is a named list of permissions
26
26
  # defined by IAM.
27
27
  #
28
- # **Example**
28
+ # **JSON Example**
29
29
  #
30
30
  # {
31
31
  # "bindings": [
@@ -35,7 +35,7 @@ module Google
35
35
  # "user:mike@example.com",
36
36
  # "group:admins@example.com",
37
37
  # "domain:google.com",
38
- # "serviceAccount:my-other-app@appspot.gserviceaccount.com",
38
+ # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
39
39
  # ]
40
40
  # },
41
41
  # {
@@ -45,15 +45,28 @@ module Google
45
45
  # ]
46
46
  # }
47
47
  #
48
- # For a description of IAM and its features, see the
49
- # [IAM developer's guide](https://cloud.google.com/iam).
48
+ # **YAML Example**
49
+ #
50
+ # bindings:
51
+ # * members:
52
+ # * user:mike@example.com
53
+ # * group:admins@example.com
54
+ # * domain:google.com
55
+ # * serviceAccount:my-other-app@appspot.gserviceaccount.com
56
+ # role: roles/owner
57
+ # * members:
58
+ # * user:sean@example.com
59
+ # role: roles/viewer
60
+ #
61
+ #
62
+ # For a description of IAM and its features, see the
63
+ # [IAM developer's guide](https://cloud.google.com/iam/docs).
50
64
  # @!attribute [rw] version
51
65
  # @return [Integer]
52
- # Version of the `Policy`. The default version is 0.
66
+ # Deprecated.
53
67
  # @!attribute [rw] bindings
54
68
  # @return [Array<Google::Iam::V1::Binding>]
55
69
  # Associates a list of `members` to a `role`.
56
- # Multiple `bindings` must not be specified for the same `role`.
57
70
  # `bindings` with no members will result in an error.
58
71
  # @!attribute [rw] etag
59
72
  # @return [String]
@@ -74,7 +87,6 @@ module Google
74
87
  # @return [String]
75
88
  # Role that is assigned to `members`.
76
89
  # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
77
- # Required
78
90
  # @!attribute [rw] members
79
91
  # @return [Array<String>]
80
92
  # Specifies the identities requesting access for a Cloud Platform resource.
@@ -87,7 +99,7 @@ module Google
87
99
  # who is authenticated with a Google account or a service account.
88
100
  #
89
101
  # * `user:{emailid}`: An email address that represents a specific Google
90
- # account. For example, `alice@gmail.com` or `joe@example.com`.
102
+ # account. For example, `alice@gmail.com` .
91
103
  #
92
104
  #
93
105
  # * `serviceAccount:{emailid}`: An email address that represents a service
@@ -96,8 +108,15 @@ module Google
96
108
  # * `group:{emailid}`: An email address that represents a Google group.
97
109
  # For example, `admins@example.com`.
98
110
  #
99
- # * `domain:{domain}`: A Google Apps domain name that represents all the
111
+ #
112
+ # * `domain:{domain}`: The G Suite domain (primary) that represents all the
100
113
  # users of that domain. For example, `google.com` or `example.com`.
114
+ # @!attribute [rw] condition
115
+ # @return [Google::Type::Expr]
116
+ # The condition that is associated with this binding.
117
+ # NOTE: An unsatisfied condition will not allow user access via current
118
+ # binding. Different bindings, including their conditions, are examined
119
+ # independently.
101
120
  class Binding; end
102
121
  end
103
122
  end
@@ -0,0 +1,45 @@
1
+ # Copyright 2019 Google LLC
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # https://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+
16
+ module Google
17
+ module Type
18
+ # Represents an expression text. Example:
19
+ #
20
+ # title: "User account presence"
21
+ # description: "Determines whether the request has a user account"
22
+ # expression: "size(request.user) > 0"
23
+ # @!attribute [rw] expression
24
+ # @return [String]
25
+ # Textual representation of an expression in
26
+ # Common Expression Language syntax.
27
+ #
28
+ # The application context of the containing message determines which
29
+ # well-known feature set of CEL is supported.
30
+ # @!attribute [rw] title
31
+ # @return [String]
32
+ # An optional title for the expression, i.e. a short string describing
33
+ # its purpose. This can be used e.g. in UIs which allow to enter the
34
+ # expression.
35
+ # @!attribute [rw] description
36
+ # @return [String]
37
+ # An optional description of the expression. This is a longer text which
38
+ # describes the expression, e.g. when hovered over it in a UI.
39
+ # @!attribute [rw] location
40
+ # @return [String]
41
+ # An optional string indicating the location of the expression for error
42
+ # reporting, e.g. a file name and a position in the file.
43
+ class Expr; end
44
+ end
45
+ end
@@ -16,7 +16,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
16
16
  optional :retry_config, :message, 5, "google.cloud.tasks.v2beta3.RetryConfig"
17
17
  optional :state, :enum, 6, "google.cloud.tasks.v2beta3.Queue.State"
18
18
  optional :purge_time, :message, 7, "google.protobuf.Timestamp"
19
- optional :log_sampling_ratio, :double, 10
19
+ optional :stackdriver_logging_config, :message, 10, "google.cloud.tasks.v2beta3.StackdriverLoggingConfig"
20
20
  oneof :queue_type do
21
21
  optional :app_engine_http_queue, :message, 3, "google.cloud.tasks.v2beta3.AppEngineHttpQueue"
22
22
  end
@@ -39,6 +39,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
39
39
  optional :max_backoff, :message, 4, "google.protobuf.Duration"
40
40
  optional :max_doublings, :int32, 5
41
41
  end
42
+ add_message "google.cloud.tasks.v2beta3.StackdriverLoggingConfig" do
43
+ optional :sampling_ratio, :double, 1
44
+ end
42
45
  end
43
46
 
44
47
  module Google
@@ -49,6 +52,7 @@ module Google
49
52
  Queue::State = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tasks.v2beta3.Queue.State").enummodule
50
53
  RateLimits = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tasks.v2beta3.RateLimits").msgclass
51
54
  RetryConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tasks.v2beta3.RetryConfig").msgclass
55
+ StackdriverLoggingConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.tasks.v2beta3.StackdriverLoggingConfig").msgclass
52
56
  end
53
57
  end
54
58
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-tasks
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.7.1
4
+ version: 1.0.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: 2019-04-30 00:00:00.000000000 Z
11
+ date: 2019-05-28 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-gax
@@ -157,6 +157,7 @@ files:
157
157
  - lib/google/cloud/tasks/v2/doc/google/protobuf/field_mask.rb
158
158
  - lib/google/cloud/tasks/v2/doc/google/protobuf/timestamp.rb
159
159
  - lib/google/cloud/tasks/v2/doc/google/rpc/status.rb
160
+ - lib/google/cloud/tasks/v2/doc/google/type/expr.rb
160
161
  - lib/google/cloud/tasks/v2/helpers.rb
161
162
  - lib/google/cloud/tasks/v2/queue_pb.rb
162
163
  - lib/google/cloud/tasks/v2/target_pb.rb
@@ -179,6 +180,7 @@ files:
179
180
  - lib/google/cloud/tasks/v2beta2/doc/google/protobuf/field_mask.rb
180
181
  - lib/google/cloud/tasks/v2beta2/doc/google/protobuf/timestamp.rb
181
182
  - lib/google/cloud/tasks/v2beta2/doc/google/rpc/status.rb
183
+ - lib/google/cloud/tasks/v2beta2/doc/google/type/expr.rb
182
184
  - lib/google/cloud/tasks/v2beta2/helpers.rb
183
185
  - lib/google/cloud/tasks/v2beta2/queue_pb.rb
184
186
  - lib/google/cloud/tasks/v2beta2/target_pb.rb
@@ -201,6 +203,7 @@ files:
201
203
  - lib/google/cloud/tasks/v2beta3/doc/google/protobuf/field_mask.rb
202
204
  - lib/google/cloud/tasks/v2beta3/doc/google/protobuf/timestamp.rb
203
205
  - lib/google/cloud/tasks/v2beta3/doc/google/rpc/status.rb
206
+ - lib/google/cloud/tasks/v2beta3/doc/google/type/expr.rb
204
207
  - lib/google/cloud/tasks/v2beta3/helpers.rb
205
208
  - lib/google/cloud/tasks/v2beta3/queue_pb.rb
206
209
  - lib/google/cloud/tasks/v2beta3/target_pb.rb