google-cloud-tasks 0.7.1 → 1.0.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.
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