google-cloud-tasks 0.3.0 → 0.4.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.
@@ -20,7 +20,8 @@ module Google
20
20
  # A unit of scheduled work.
21
21
  # @!attribute [rw] name
22
22
  # @return [String]
23
- # Optionally caller-specified in {Google::Cloud::Tasks::V2beta2::CloudTasks::CreateTask CreateTask}.
23
+ # Optionally caller-specified in
24
+ # {Google::Cloud::Tasks::V2beta2::CloudTasks::CreateTask CreateTask}.
24
25
  #
25
26
  # The task name.
26
27
  #
@@ -30,7 +31,8 @@ module Google
30
31
  # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
31
32
  # hyphens (-), colons (:), or periods (.).
32
33
  # For more information, see
33
- # [Identifying projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
34
+ # [Identifying
35
+ # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
34
36
  # * `LOCATION_ID` is the canonical ID for the task's location.
35
37
  # The list of available locations can be obtained by calling
36
38
  # {Google::Cloud::Location::Locations::ListLocations ListLocations}.
@@ -43,16 +45,21 @@ module Google
43
45
  # @return [Google::Cloud::Tasks::V2beta2::AppEngineHttpRequest]
44
46
  # App Engine HTTP request that is sent to the task's target. Can
45
47
  # be set only if
46
- # {Google::Cloud::Tasks::V2beta2::Queue#app_engine_http_target app_engine_http_target} is set
47
- # on the queue.
48
+ # {Google::Cloud::Tasks::V2beta2::Queue#app_engine_http_target app_engine_http_target}
49
+ # is set on the queue.
48
50
  #
49
- # An App Engine task is a task that has {Google::Cloud::Tasks::V2beta2::AppEngineHttpRequest AppEngineHttpRequest} set.
51
+ # An App Engine task is a task that has
52
+ # {Google::Cloud::Tasks::V2beta2::AppEngineHttpRequest AppEngineHttpRequest}
53
+ # set.
50
54
  # @!attribute [rw] pull_message
51
55
  # @return [Google::Cloud::Tasks::V2beta2::PullMessage]
52
- # {Google::Cloud::Tasks::V2beta2::CloudTasks::LeaseTasks LeaseTasks} to process the task. Can be
53
- # set only if {Google::Cloud::Tasks::V2beta2::Queue#pull_target pull_target} is set on the queue.
56
+ # {Google::Cloud::Tasks::V2beta2::CloudTasks::LeaseTasks LeaseTasks} to process
57
+ # the task. Can be set only if
58
+ # {Google::Cloud::Tasks::V2beta2::Queue#pull_target pull_target} is set on the
59
+ # queue.
54
60
  #
55
- # A pull task is a task that has {Google::Cloud::Tasks::V2beta2::PullMessage PullMessage} set.
61
+ # A pull task is a task that has
62
+ # {Google::Cloud::Tasks::V2beta2::PullMessage PullMessage} set.
56
63
  # @!attribute [rw] schedule_time
57
64
  # @return [Google::Protobuf::Timestamp]
58
65
  # The time when the task is scheduled to be attempted.
@@ -62,7 +69,8 @@ module Google
62
69
  # For pull queues, this is the time when the task is available to
63
70
  # be leased; if a task is currently leased, this is the time when
64
71
  # the current lease expires, that is, the time that the task was
65
- # leased plus the {Google::Cloud::Tasks::V2beta2::LeaseTasksRequest#lease_duration lease_duration}.
72
+ # leased plus the
73
+ # {Google::Cloud::Tasks::V2beta2::LeaseTasksRequest#lease_duration lease_duration}.
66
74
  #
67
75
  # `schedule_time` will be truncated to the nearest microsecond.
68
76
  # @!attribute [rw] create_time
@@ -75,10 +83,11 @@ module Google
75
83
  # Output only. The task status.
76
84
  # @!attribute [rw] view
77
85
  # @return [Google::Cloud::Tasks::V2beta2::Task::View]
78
- # Output only. The view specifies which subset of the {Google::Cloud::Tasks::V2beta2::Task Task} has
79
- # been returned.
86
+ # Output only. The view specifies which subset of the
87
+ # {Google::Cloud::Tasks::V2beta2::Task Task} has been returned.
80
88
  class Task
81
- # The view specifies a subset of {Google::Cloud::Tasks::V2beta2::Task Task} data.
89
+ # The view specifies a subset of {Google::Cloud::Tasks::V2beta2::Task Task}
90
+ # data.
82
91
  #
83
92
  # When a task is returned in a response, not all
84
93
  # information is retrieved by default because some data, such as
@@ -93,18 +102,21 @@ module Google
93
102
  # sensitive data.
94
103
  #
95
104
  # This view does not include the
96
- # ({Google::Cloud::Tasks::V2beta2::AppEngineHttpRequest payload in AppEngineHttpRequest} and
97
- # {Google::Cloud::Tasks::V2beta2::PullMessage#payload payload in PullMessage}). These payloads are
98
- # desirable to return only when needed, because they can be large
99
- # and because of the sensitivity of the data that you choose to
100
- # store in it.
105
+ # ([payload in
106
+ # AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest]
107
+ # and [payload in
108
+ # PullMessage][google.cloud.tasks.v2beta2.PullMessage.payload]). These
109
+ # payloads are desirable to return only when needed, because they can be
110
+ # large and because of the sensitivity of the data that you choose to store
111
+ # in it.
101
112
  BASIC = 1
102
113
 
103
114
  # All information is returned.
104
115
  #
105
- # Authorization for {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL} requires
106
- # `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
107
- # permission on the {Google::Cloud::Tasks::V2beta2::Queue Queue} resource.
116
+ # Authorization for {Google::Cloud::Tasks::V2beta2::Task::View::FULL FULL}
117
+ # requires `cloudtasks.tasks.fullView` [Google
118
+ # IAM](https://cloud.google.com/iam/) permission on the
119
+ # {Google::Cloud::Tasks::V2beta2::Queue Queue} resource.
108
120
  FULL = 2
109
121
  end
110
122
  end
@@ -120,20 +132,26 @@ module Google
120
132
  # @return [Integer]
121
133
  # Output only. The number of attempts which have received a response.
122
134
  #
123
- # This field is not calculated for {Google::Cloud::Tasks::V2beta2::PullMessage pull tasks}.
135
+ # This field is not calculated for [pull
136
+ # tasks][google.cloud.tasks.v2beta2.PullMessage].
124
137
  # @!attribute [rw] first_attempt_status
125
138
  # @return [Google::Cloud::Tasks::V2beta2::AttemptStatus]
126
139
  # Output only. The status of the task's first attempt.
127
140
  #
128
- # Only {Google::Cloud::Tasks::V2beta2::AttemptStatus#dispatch_time dispatch_time} will be set.
129
- # The other {Google::Cloud::Tasks::V2beta2::AttemptStatus AttemptStatus} information is not retained by Cloud Tasks.
141
+ # Only
142
+ # {Google::Cloud::Tasks::V2beta2::AttemptStatus#dispatch_time dispatch_time}
143
+ # will be set. The other
144
+ # {Google::Cloud::Tasks::V2beta2::AttemptStatus AttemptStatus} information is
145
+ # not retained by Cloud Tasks.
130
146
  #
131
- # This field is not calculated for {Google::Cloud::Tasks::V2beta2::PullMessage pull tasks}.
147
+ # This field is not calculated for [pull
148
+ # tasks][google.cloud.tasks.v2beta2.PullMessage].
132
149
  # @!attribute [rw] last_attempt_status
133
150
  # @return [Google::Cloud::Tasks::V2beta2::AttemptStatus]
134
151
  # Output only. The status of the task's last attempt.
135
152
  #
136
- # This field is not calculated for {Google::Cloud::Tasks::V2beta2::PullMessage pull tasks}.
153
+ # This field is not calculated for [pull
154
+ # tasks][google.cloud.tasks.v2beta2.PullMessage].
137
155
  class TaskStatus; end
138
156
 
139
157
  # The status of a task attempt.
@@ -15,24 +15,25 @@
15
15
 
16
16
  module Google
17
17
  module Rpc
18
- # The `Status` type defines a logical error model that is suitable for different
19
- # programming environments, including REST APIs and RPC APIs. It is used by
20
- # [gRPC](https://github.com/grpc). The error model is designed to be:
18
+ # The `Status` type defines a logical error model that is suitable for
19
+ # different programming environments, including REST APIs and RPC APIs. It is
20
+ # used by [gRPC](https://github.com/grpc). The error model is designed to be:
21
21
  #
22
22
  # * Simple to use and understand for most users
23
23
  # * Flexible enough to meet unexpected needs
24
24
  #
25
25
  # = Overview
26
26
  #
27
- # The `Status` message contains three pieces of data: error code, error message,
28
- # and error details. The error code should be an enum value of
29
- # {Google::Rpc::Code}, but it may accept additional error codes if needed. The
30
- # error message should be a developer-facing English message that helps
31
- # developers *understand* and *resolve* the error. If a localized user-facing
32
- # error message is needed, put the localized message in the error details or
33
- # localize it in the client. The optional error details may contain arbitrary
34
- # information about the error. There is a predefined set of error detail types
35
- # in the package `google.rpc` that can be used for common error conditions.
27
+ # The `Status` message contains three pieces of data: error code, error
28
+ # message, and error details. The error code should be an enum value of
29
+ # {Google::Rpc::Code}, but it may accept additional error codes
30
+ # if needed. The error message should be a developer-facing English message
31
+ # that helps developers *understand* and *resolve* the error. If a localized
32
+ # user-facing error message is needed, put the localized message in the error
33
+ # details or localize it in the client. The optional error details may contain
34
+ # arbitrary information about the error. There is a predefined set of error
35
+ # detail types in the package `google.rpc` that can be used for common error
36
+ # conditions.
36
37
  #
37
38
  # = Language mapping
38
39
  #
@@ -69,12 +70,14 @@ module Google
69
70
  # be used directly after any stripping needed for security/privacy reasons.
70
71
  # @!attribute [rw] code
71
72
  # @return [Integer]
72
- # The status code, which should be an enum value of {Google::Rpc::Code}.
73
+ # The status code, which should be an enum value of
74
+ # {Google::Rpc::Code}.
73
75
  # @!attribute [rw] message
74
76
  # @return [String]
75
77
  # A developer-facing error message, which should be in English. Any
76
78
  # user-facing error message should be localized and sent in the
77
- # {Google::Rpc::Status#details} field, or localized by the client.
79
+ # {Google::Rpc::Status#details} field, or localized
80
+ # by the client.
78
81
  # @!attribute [rw] details
79
82
  # @return [Array<Google::Protobuf::Any>]
80
83
  # A list of messages that carry the error details. There is a common set of
@@ -389,11 +389,11 @@ module Google
389
389
  # The location name.
390
390
  # For example: `projects/PROJECT_ID/locations/LOCATION_ID`
391
391
  # @param filter [String]
392
- # `filter` can be used to specify a subset of queues. Any {Google::Cloud::Tasks::V2beta3::Queue Queue}
393
- # field can be used as a filter and several operators as supported.
394
- # For example: `<=, <, >=, >, !=, =, :`. The filter syntax is the same as
395
- # described in
396
- # [Stackdriver's Advanced Logs Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
392
+ # `filter` can be used to specify a subset of queues. Any
393
+ # {Google::Cloud::Tasks::V2beta3::Queue Queue} field can be used as a filter and
394
+ # several operators as supported. For example: `<=, <, >=, >, !=, =, :`. The
395
+ # filter syntax is the same as described in [Stackdriver's Advanced Logs
396
+ # Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
397
397
  #
398
398
  # Sample filter "state: PAUSED".
399
399
  #
@@ -487,14 +487,15 @@ module Google
487
487
  # Creates a queue.
488
488
  #
489
489
  # Queues created with this method allow tasks to live for a maximum of 31
490
- # days. After a task is 31 days old, the task will be deleted regardless of whether
491
- # it was dispatched or not.
490
+ # days. After a task is 31 days old, the task will be deleted regardless of
491
+ # whether it was dispatched or not.
492
492
  #
493
493
  # WARNING: Using this method may have unintended side effects if you are
494
494
  # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
495
495
  # Read
496
- # [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
497
- # before using this method.
496
+ # [Overview of Queue Management and
497
+ # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
498
+ # this method.
498
499
  #
499
500
  # @param parent [String]
500
501
  # Required.
@@ -510,7 +511,8 @@ module Google
510
511
  #
511
512
  # The queue to create.
512
513
  #
513
- # {Google::Cloud::Tasks::V2beta3::Queue#name Queue's name} cannot be the same as an existing queue.
514
+ # {Google::Cloud::Tasks::V2beta3::Queue#name Queue's name} cannot be the same as
515
+ # an existing queue.
514
516
  # A hash of the same form as `Google::Cloud::Tasks::V2beta3::Queue`
515
517
  # can also be provided.
516
518
  # @param options [Google::Gax::CallOptions]
@@ -550,25 +552,28 @@ module Google
550
552
  # the queue if it does exist.
551
553
  #
552
554
  # Queues created with this method allow tasks to live for a maximum of 31
553
- # days. After a task is 31 days old, the task will be deleted regardless of whether
554
- # it was dispatched or not.
555
+ # days. After a task is 31 days old, the task will be deleted regardless of
556
+ # whether it was dispatched or not.
555
557
  #
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.
564
567
  #
565
568
  # The queue to create or update.
566
569
  #
567
- # The queue's {Google::Cloud::Tasks::V2beta3::Queue#name name} must be specified.
570
+ # The queue's {Google::Cloud::Tasks::V2beta3::Queue#name name} must be
571
+ # specified.
568
572
  #
569
573
  # Output only fields cannot be modified using UpdateQueue.
570
574
  # Any value specified for an output only field will be ignored.
571
- # The queue's {Google::Cloud::Tasks::V2beta3::Queue#name name} cannot be changed.
575
+ # The queue's {Google::Cloud::Tasks::V2beta3::Queue#name name} cannot be
576
+ # changed.
572
577
  # A hash of the same form as `Google::Cloud::Tasks::V2beta3::Queue`
573
578
  # can also be provided.
574
579
  # @param update_mask [Google::Protobuf::FieldMask | Hash]
@@ -617,8 +622,9 @@ module Google
617
622
  # WARNING: Using this method may have unintended side effects if you are
618
623
  # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
619
624
  # Read
620
- # [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
621
- # before using this method.
625
+ # [Overview of Queue Management and
626
+ # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
627
+ # this method.
622
628
  #
623
629
  # @param name [String]
624
630
  # Required.
@@ -693,9 +699,10 @@ module Google
693
699
  #
694
700
  # If a queue is paused then the system will stop dispatching tasks
695
701
  # until the queue is resumed via
696
- # {Google::Cloud::Tasks::V2beta3::CloudTasks::ResumeQueue ResumeQueue}. Tasks can still be added
697
- # when the queue is paused. A queue is paused if its
698
- # {Google::Cloud::Tasks::V2beta3::Queue#state state} is {Google::Cloud::Tasks::V2beta3::Queue::State::PAUSED PAUSED}.
702
+ # {Google::Cloud::Tasks::V2beta3::CloudTasks::ResumeQueue ResumeQueue}. Tasks can
703
+ # still be added when the queue is paused. A queue is paused if its
704
+ # {Google::Cloud::Tasks::V2beta3::Queue#state state} is
705
+ # {Google::Cloud::Tasks::V2beta3::Queue::State::PAUSED PAUSED}.
699
706
  #
700
707
  # @param name [String]
701
708
  # Required.
@@ -732,14 +739,17 @@ module Google
732
739
  #
733
740
  # This method resumes a queue after it has been
734
741
  # {Google::Cloud::Tasks::V2beta3::Queue::State::PAUSED PAUSED} or
735
- # {Google::Cloud::Tasks::V2beta3::Queue::State::DISABLED DISABLED}. The state of a queue is stored
736
- # in the queue's {Google::Cloud::Tasks::V2beta3::Queue#state state}; after calling this method it
737
- # will be set to {Google::Cloud::Tasks::V2beta3::Queue::State::RUNNING RUNNING}.
742
+ # {Google::Cloud::Tasks::V2beta3::Queue::State::DISABLED DISABLED}. The state of a
743
+ # queue is stored in the queue's
744
+ # {Google::Cloud::Tasks::V2beta3::Queue#state state}; after calling this method
745
+ # it will be set to
746
+ # {Google::Cloud::Tasks::V2beta3::Queue::State::RUNNING RUNNING}.
738
747
  #
739
748
  # WARNING: Resuming many high-QPS queues at the same time can
740
749
  # lead to target overloading. If you are resuming high-QPS
741
750
  # 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).
751
+ # [Managing Cloud Tasks Scaling
752
+ # Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
743
753
  #
744
754
  # @param name [String]
745
755
  # Required.
@@ -772,9 +782,9 @@ module Google
772
782
  @resume_queue.call(req, options, &block)
773
783
  end
774
784
 
775
- # Gets the access control policy for a {Google::Cloud::Tasks::V2beta3::Queue Queue}.
776
- # Returns an empty policy if the resource exists and does not have a policy
777
- # set.
785
+ # Gets the access control policy for a
786
+ # {Google::Cloud::Tasks::V2beta3::Queue Queue}. Returns an empty policy if the
787
+ # resource exists and does not have a policy set.
778
788
  #
779
789
  # Authorization requires the following
780
790
  # [Google IAM](https://cloud.google.com/iam) permission on the specified
@@ -812,8 +822,8 @@ module Google
812
822
  @get_iam_policy.call(req, options, &block)
813
823
  end
814
824
 
815
- # Sets the access control policy for a {Google::Cloud::Tasks::V2beta3::Queue Queue}. Replaces any existing
816
- # policy.
825
+ # Sets the access control policy for a
826
+ # {Google::Cloud::Tasks::V2beta3::Queue Queue}. Replaces any existing policy.
817
827
  #
818
828
  # Note: The Cloud Console does not check queue-level IAM permissions yet.
819
829
  # Project-level permissions are required to use the Cloud Console.
@@ -866,9 +876,10 @@ module Google
866
876
  @set_iam_policy.call(req, options, &block)
867
877
  end
868
878
 
869
- # Returns permissions that a caller has on a {Google::Cloud::Tasks::V2beta3::Queue Queue}.
870
- # If the resource does not exist, this will return an empty set of
871
- # permissions, not a {Google::Rpc::Code::NOT_FOUND NOT_FOUND} error.
879
+ # Returns permissions that a caller has on a
880
+ # {Google::Cloud::Tasks::V2beta3::Queue Queue}. If the resource does not exist,
881
+ # this will return an empty set of permissions, not a
882
+ # {Google::Rpc::Code::NOT_FOUND NOT_FOUND} error.
872
883
  #
873
884
  # Note: This operation is designed to be used for building permission-aware
874
885
  # UIs and command-line tools, not for authorization checking. This operation
@@ -916,10 +927,10 @@ module Google
916
927
 
917
928
  # Lists the tasks in a queue.
918
929
  #
919
- # By default, only the {Google::Cloud::Tasks::V2beta3::Task::View::BASIC BASIC} view is retrieved
920
- # due to performance considerations;
921
- # {Google::Cloud::Tasks::V2beta3::ListTasksRequest#response_view response_view} controls the
922
- # subset of information which is returned.
930
+ # By default, only the {Google::Cloud::Tasks::V2beta3::Task::View::BASIC BASIC}
931
+ # view is retrieved due to performance considerations;
932
+ # {Google::Cloud::Tasks::V2beta3::ListTasksRequest#response_view response_view}
933
+ # controls the subset of information which is returned.
923
934
  #
924
935
  # The tasks may be returned in any order. The ordering may change at any
925
936
  # time.
@@ -930,18 +941,19 @@ module Google
930
941
  # The queue name. For example:
931
942
  # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
932
943
  # @param response_view [Google::Cloud::Tasks::V2beta3::Task::View]
933
- # The response_view specifies which subset of the {Google::Cloud::Tasks::V2beta3::Task Task} will be
934
- # returned.
935
- #
936
- # By default response_view is {Google::Cloud::Tasks::V2beta3::Task::View::BASIC BASIC}; not all
937
- # information is retrieved by default because some data, such as
938
- # payloads, might be desirable to return only when needed because
939
- # of its large size or because of the sensitivity of data that it
940
- # contains.
941
- #
942
- # Authorization for {Google::Cloud::Tasks::V2beta3::Task::View::FULL FULL} requires
943
- # `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
944
- # permission on the {Google::Cloud::Tasks::V2beta3::Task Task} resource.
944
+ # The response_view specifies which subset of the
945
+ # {Google::Cloud::Tasks::V2beta3::Task Task} will be returned.
946
+ #
947
+ # By default response_view is
948
+ # {Google::Cloud::Tasks::V2beta3::Task::View::BASIC BASIC}; not all information is
949
+ # retrieved by default because some data, such as payloads, might be
950
+ # desirable to return only when needed because of its large size or because
951
+ # of the sensitivity of data that it contains.
952
+ #
953
+ # Authorization for {Google::Cloud::Tasks::V2beta3::Task::View::FULL FULL}
954
+ # requires `cloudtasks.tasks.fullView` [Google
955
+ # IAM](https://cloud.google.com/iam/) permission on the
956
+ # {Google::Cloud::Tasks::V2beta3::Task Task} resource.
945
957
  # @param page_size [Integer]
946
958
  # The maximum number of resources contained in the underlying API
947
959
  # response. If page streaming is performed per-resource, this
@@ -1002,18 +1014,19 @@ module Google
1002
1014
  # The task name. For example:
1003
1015
  # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
1004
1016
  # @param response_view [Google::Cloud::Tasks::V2beta3::Task::View]
1005
- # The response_view specifies which subset of the {Google::Cloud::Tasks::V2beta3::Task Task} will be
1006
- # returned.
1007
- #
1008
- # By default response_view is {Google::Cloud::Tasks::V2beta3::Task::View::BASIC BASIC}; not all
1009
- # information is retrieved by default because some data, such as
1010
- # payloads, might be desirable to return only when needed because
1011
- # of its large size or because of the sensitivity of data that it
1012
- # contains.
1013
- #
1014
- # Authorization for {Google::Cloud::Tasks::V2beta3::Task::View::FULL FULL} requires
1015
- # `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
1016
- # permission on the {Google::Cloud::Tasks::V2beta3::Task Task} resource.
1017
+ # The response_view specifies which subset of the
1018
+ # {Google::Cloud::Tasks::V2beta3::Task Task} will be returned.
1019
+ #
1020
+ # By default response_view is
1021
+ # {Google::Cloud::Tasks::V2beta3::Task::View::BASIC BASIC}; not all information is
1022
+ # retrieved by default because some data, such as payloads, might be
1023
+ # desirable to return only when needed because of its large size or because
1024
+ # of the sensitivity of data that it contains.
1025
+ #
1026
+ # Authorization for {Google::Cloud::Tasks::V2beta3::Task::View::FULL FULL}
1027
+ # requires `cloudtasks.tasks.fullView` [Google
1028
+ # IAM](https://cloud.google.com/iam/) permission on the
1029
+ # {Google::Cloud::Tasks::V2beta3::Task Task} resource.
1017
1030
  # @param options [Google::Gax::CallOptions]
1018
1031
  # Overrides the default settings for this call, e.g, timeout,
1019
1032
  # retries, etc.
@@ -1046,7 +1059,8 @@ module Google
1046
1059
  #
1047
1060
  # Tasks cannot be updated after creation; there is no UpdateTask command.
1048
1061
  #
1049
- # * For {Google::Cloud::Tasks::V2beta3::AppEngineHttpQueue App Engine queues}, the maximum task size is
1062
+ # * For {Google::Cloud::Tasks::V2beta3::AppEngineHttpQueue App Engine queues},
1063
+ # the maximum task size is
1050
1064
  # 100KB.
1051
1065
  #
1052
1066
  # @param parent [String]
@@ -1063,13 +1077,13 @@ module Google
1063
1077
  #
1064
1078
  # Task names have the following format:
1065
1079
  # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`.
1066
- # The user can optionally specify a task {Google::Cloud::Tasks::V2beta3::Task#name name}. If a
1067
- # name is not specified then the system will generate a random
1068
- # unique task id, which will be set in the task returned in the
1069
- # {Google::Cloud::Tasks::V2beta3::Task#name response}.
1080
+ # The user can optionally specify a task
1081
+ # {Google::Cloud::Tasks::V2beta3::Task#name name}. If a name is not specified
1082
+ # then the system will generate a random unique task id, which will be set in
1083
+ # the task returned in the {Google::Cloud::Tasks::V2beta3::Task#name response}.
1070
1084
  #
1071
- # If {Google::Cloud::Tasks::V2beta3::Task#schedule_time schedule_time} is not set or is in the
1072
- # past then Cloud Tasks will set it to the current time.
1085
+ # If {Google::Cloud::Tasks::V2beta3::Task#schedule_time schedule_time} is not
1086
+ # set or is in the past then Cloud Tasks will set it to the current time.
1073
1087
  #
1074
1088
  # Task De-duplication:
1075
1089
  #
@@ -1084,10 +1098,10 @@ module Google
1084
1098
  # for ~9days after the original task was deleted or executed.
1085
1099
  #
1086
1100
  # Because there is an extra lookup cost to identify duplicate task
1087
- # names, these {Google::Cloud::Tasks::V2beta3::CloudTasks::CreateTask CreateTask} calls have significantly
1088
- # increased latency. Using hashed strings for the task id or for
1089
- # the prefix of the task id is recommended. Choosing task ids that
1090
- # are sequential or have sequential prefixes, for example using a
1101
+ # names, these {Google::Cloud::Tasks::V2beta3::CloudTasks::CreateTask CreateTask}
1102
+ # calls have significantly increased latency. Using hashed strings for the
1103
+ # task id or for the prefix of the task id is recommended. Choosing task ids
1104
+ # that are sequential or have sequential prefixes, for example using a
1091
1105
  # timestamp, causes an increase in latency and error rates in all
1092
1106
  # task commands. The infrastructure relies on an approximately
1093
1107
  # uniform distribution of task ids to store and serve tasks
@@ -1095,18 +1109,19 @@ module Google
1095
1109
  # A hash of the same form as `Google::Cloud::Tasks::V2beta3::Task`
1096
1110
  # can also be provided.
1097
1111
  # @param response_view [Google::Cloud::Tasks::V2beta3::Task::View]
1098
- # The response_view specifies which subset of the {Google::Cloud::Tasks::V2beta3::Task Task} will be
1099
- # returned.
1100
- #
1101
- # By default response_view is {Google::Cloud::Tasks::V2beta3::Task::View::BASIC BASIC}; not all
1102
- # information is retrieved by default because some data, such as
1103
- # payloads, might be desirable to return only when needed because
1104
- # of its large size or because of the sensitivity of data that it
1105
- # contains.
1106
- #
1107
- # Authorization for {Google::Cloud::Tasks::V2beta3::Task::View::FULL FULL} requires
1108
- # `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
1109
- # permission on the {Google::Cloud::Tasks::V2beta3::Task Task} resource.
1112
+ # The response_view specifies which subset of the
1113
+ # {Google::Cloud::Tasks::V2beta3::Task Task} will be returned.
1114
+ #
1115
+ # By default response_view is
1116
+ # {Google::Cloud::Tasks::V2beta3::Task::View::BASIC BASIC}; not all information is
1117
+ # retrieved by default because some data, such as payloads, might be
1118
+ # desirable to return only when needed because of its large size or because
1119
+ # of the sensitivity of data that it contains.
1120
+ #
1121
+ # Authorization for {Google::Cloud::Tasks::V2beta3::Task::View::FULL FULL}
1122
+ # requires `cloudtasks.tasks.fullView` [Google
1123
+ # IAM](https://cloud.google.com/iam/) permission on the
1124
+ # {Google::Cloud::Tasks::V2beta3::Task Task} resource.
1110
1125
  # @param options [Google::Gax::CallOptions]
1111
1126
  # Overrides the default settings for this call, e.g, timeout,
1112
1127
  # retries, etc.
@@ -1180,13 +1195,14 @@ module Google
1180
1195
  # Forces a task to run now.
1181
1196
  #
1182
1197
  # When this method is called, Cloud Tasks will dispatch the task, even if
1183
- # the task is already running, the queue has reached its {Google::Cloud::Tasks::V2beta3::RateLimits RateLimits} or
1184
- # is {Google::Cloud::Tasks::V2beta3::Queue::State::PAUSED PAUSED}.
1198
+ # the task is already running, the queue has reached its
1199
+ # {Google::Cloud::Tasks::V2beta3::RateLimits RateLimits} or is
1200
+ # {Google::Cloud::Tasks::V2beta3::Queue::State::PAUSED PAUSED}.
1185
1201
  #
1186
1202
  # This command is meant to be used for manual debugging. For
1187
- # example, {Google::Cloud::Tasks::V2beta3::CloudTasks::RunTask RunTask} can be used to retry a failed
1188
- # task after a fix has been made or to manually force a task to be
1189
- # dispatched now.
1203
+ # example, {Google::Cloud::Tasks::V2beta3::CloudTasks::RunTask RunTask} can be
1204
+ # used to retry a failed task after a fix has been made or to manually force
1205
+ # a task to be dispatched now.
1190
1206
  #
1191
1207
  # The dispatched task is returned. That is, the task that is returned
1192
1208
  # contains the {Task#status status} after the task is dispatched but
@@ -1194,9 +1210,11 @@ module Google
1194
1210
  #
1195
1211
  # If Cloud Tasks receives a successful response from the task's
1196
1212
  # target, then the task will be deleted; otherwise the task's
1197
- # {Google::Cloud::Tasks::V2beta3::Task#schedule_time schedule_time} will be reset to the time that
1198
- # {Google::Cloud::Tasks::V2beta3::CloudTasks::RunTask RunTask} was called plus the retry delay specified
1199
- # in the queue's {Google::Cloud::Tasks::V2beta3::RetryConfig RetryConfig}.
1213
+ # {Google::Cloud::Tasks::V2beta3::Task#schedule_time schedule_time} will be
1214
+ # reset to the time that
1215
+ # {Google::Cloud::Tasks::V2beta3::CloudTasks::RunTask RunTask} was called plus
1216
+ # the retry delay specified in the queue's
1217
+ # {Google::Cloud::Tasks::V2beta3::RetryConfig RetryConfig}.
1200
1218
  #
1201
1219
  # {Google::Cloud::Tasks::V2beta3::CloudTasks::RunTask RunTask} returns
1202
1220
  # {Google::Rpc::Code::NOT_FOUND NOT_FOUND} when it is called on a
@@ -1208,18 +1226,19 @@ module Google
1208
1226
  # The task name. For example:
1209
1227
  # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
1210
1228
  # @param response_view [Google::Cloud::Tasks::V2beta3::Task::View]
1211
- # The response_view specifies which subset of the {Google::Cloud::Tasks::V2beta3::Task Task} will be
1212
- # returned.
1213
- #
1214
- # By default response_view is {Google::Cloud::Tasks::V2beta3::Task::View::BASIC BASIC}; not all
1215
- # information is retrieved by default because some data, such as
1216
- # payloads, might be desirable to return only when needed because
1217
- # of its large size or because of the sensitivity of data that it
1218
- # contains.
1219
- #
1220
- # Authorization for {Google::Cloud::Tasks::V2beta3::Task::View::FULL FULL} requires
1221
- # `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
1222
- # permission on the {Google::Cloud::Tasks::V2beta3::Task Task} resource.
1229
+ # The response_view specifies which subset of the
1230
+ # {Google::Cloud::Tasks::V2beta3::Task Task} will be returned.
1231
+ #
1232
+ # By default response_view is
1233
+ # {Google::Cloud::Tasks::V2beta3::Task::View::BASIC BASIC}; not all information is
1234
+ # retrieved by default because some data, such as payloads, might be
1235
+ # desirable to return only when needed because of its large size or because
1236
+ # of the sensitivity of data that it contains.
1237
+ #
1238
+ # Authorization for {Google::Cloud::Tasks::V2beta3::Task::View::FULL FULL}
1239
+ # requires `cloudtasks.tasks.fullView` [Google
1240
+ # IAM](https://cloud.google.com/iam/) permission on the
1241
+ # {Google::Cloud::Tasks::V2beta3::Task Task} resource.
1223
1242
  # @param options [Google::Gax::CallOptions]
1224
1243
  # Overrides the default settings for this call, e.g, timeout,
1225
1244
  # retries, etc.