google-cloud-scheduler-v1 0.5.0 → 0.6.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 600a316861acd382f1fae073595ead8194192bbf0a4ec31552640a66141f52eb
4
- data.tar.gz: 692f62f0f2f986eec79c659abc4663bbee64fe19683b293dc2c1f7e4ede346fd
3
+ metadata.gz: 44a906b54e0e36764993fcac04af6dd2a9c2eb63fc50c3b3199f9134b541741a
4
+ data.tar.gz: cbae72abe1596ceb929b9f722f4e209ce0656d1ef8c05838e4380d4a895d3803
5
5
  SHA512:
6
- metadata.gz: '094854a382b07bbb25f426bfcd50cf20519fdddde33d092c98b04aa76393f66db3368da4a80ad4dc603988694afad9f5e08601fd021587517879fd88f5ce66f2'
7
- data.tar.gz: 458d10dd00b9a5ea72d04d158fdb079e70d2788e078c9e85cac06894be6d89e11a98bcc83f0cd66e372a5c5c2d59907508492c131894f4a22cba23f11feafc0b
6
+ metadata.gz: 658f3ac3c788acbbfb338eec570c23a6f3cda149c2410ef30b4612c698d35250265c41a56924d343e7f3038cc90d9403f36ed73e3ccd2c0982f33fd6c5a76b25
7
+ data.tar.gz: 98bc35f2055aae27fe7914b6c9650d3d32799f797596e29f1532ecbf3c18b68271648081a98d70d298dc74ce9c9dc15df7de2a3f3ad2079f918e9eee53b1d2e0
data/AUTHENTICATION.md CHANGED
@@ -114,7 +114,7 @@ credentials are discovered.
114
114
  To configure your system for this, simply:
115
115
 
116
116
  1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
117
- 2. Authenticate using OAuth 2.0 `$ gcloud auth login`
117
+ 2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
118
118
  3. Write code as if already authenticated.
119
119
 
120
120
  **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
data/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Ruby Client for the Cloud Scheduler V1 API
2
2
 
3
- API Client library for the Cloud Scheduler V1 API
3
+ Creates and manages jobs run on a regular recurring schedule.
4
4
 
5
5
  Cloud Scheduler is a fully managed enterprise-grade cron job scheduler. It allows you to schedule virtually any job, including batch, big data jobs, cloud infrastructure operations, and more. You can automate everything, including retries in case of failure to reduce manual toil and intervention. Cloud Scheduler even acts as a single pane of glass, allowing you to manage all your automation tasks from one place.
6
6
 
@@ -46,7 +46,7 @@ for general usage information.
46
46
  ## Enabling Logging
47
47
 
48
48
  To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
49
+ The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
50
  or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
51
51
  that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
52
  and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
@@ -18,6 +18,7 @@
18
18
 
19
19
  require "google/cloud/errors"
20
20
  require "google/cloud/scheduler/v1/cloudscheduler_pb"
21
+ require "google/cloud/location"
21
22
 
22
23
  module Google
23
24
  module Cloud
@@ -159,6 +160,12 @@ module Google
159
160
  @quota_project_id = @config.quota_project
160
161
  @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
161
162
 
163
+ @location_client = Google::Cloud::Location::Locations::Client.new do |config|
164
+ config.credentials = credentials
165
+ config.quota_project = @quota_project_id
166
+ config.endpoint = @config.endpoint
167
+ end
168
+
162
169
  @cloud_scheduler_stub = ::Gapic::ServiceStub.new(
163
170
  ::Google::Cloud::Scheduler::V1::CloudScheduler::Stub,
164
171
  credentials: credentials,
@@ -168,6 +175,13 @@ module Google
168
175
  )
169
176
  end
170
177
 
178
+ ##
179
+ # Get the associated client for mix-in of the Locations.
180
+ #
181
+ # @return [Google::Cloud::Location::Locations::Client]
182
+ #
183
+ attr_reader :location_client
184
+
171
185
  # Service calls
172
186
 
173
187
  ##
@@ -202,10 +216,13 @@ module Google
202
216
  # A token identifying a page of results the server will return. To
203
217
  # request the first page results, page_token must be empty. To
204
218
  # request the next page of results, page_token must be the value of
205
- # {::Google::Cloud::Scheduler::V1::ListJobsResponse#next_page_token next_page_token} returned from
206
- # the previous call to {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#list_jobs ListJobs}. It is an error to
207
- # switch the value of [filter][google.cloud.scheduler.v1.ListJobsRequest.filter] or
208
- # [order_by][google.cloud.scheduler.v1.ListJobsRequest.order_by] while iterating through pages.
219
+ # {::Google::Cloud::Scheduler::V1::ListJobsResponse#next_page_token next_page_token}
220
+ # returned from the previous call to
221
+ # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#list_jobs ListJobs}. It is an
222
+ # error to switch the value of
223
+ # [filter][google.cloud.scheduler.v1.ListJobsRequest.filter] or
224
+ # [order_by][google.cloud.scheduler.v1.ListJobsRequest.order_by] while
225
+ # iterating through pages.
209
226
  #
210
227
  # @yield [response, operation] Access the result along with the RPC operation
211
228
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Scheduler::V1::Job>]
@@ -227,13 +244,11 @@ module Google
227
244
  # # Call the list_jobs method.
228
245
  # result = client.list_jobs request
229
246
  #
230
- # # The returned object is of type Gapic::PagedEnumerable. You can
231
- # # iterate over all elements by calling #each, and the enumerable
232
- # # will lazily make API calls to fetch subsequent pages. Other
233
- # # methods are also available for managing paging directly.
234
- # result.each do |response|
247
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
248
+ # # over elements, and API calls will be issued to fetch pages as needed.
249
+ # result.each do |item|
235
250
  # # Each element is of type ::Google::Cloud::Scheduler::V1::Job.
236
- # p response
251
+ # p item
237
252
  # end
238
253
  #
239
254
  def list_jobs request, options = nil
@@ -387,7 +402,8 @@ module Google
387
402
  # `projects/PROJECT_ID/locations/LOCATION_ID`.
388
403
  # @param job [::Google::Cloud::Scheduler::V1::Job, ::Hash]
389
404
  # Required. The job to add. The user can optionally specify a name for the
390
- # job in {::Google::Cloud::Scheduler::V1::Job#name name}. {::Google::Cloud::Scheduler::V1::Job#name name} cannot be the same as an
405
+ # job in {::Google::Cloud::Scheduler::V1::Job#name name}.
406
+ # {::Google::Cloud::Scheduler::V1::Job#name name} cannot be the same as an
391
407
  # existing job. If a name is not specified then the system will
392
408
  # generate a random unique name that will be returned
393
409
  # ({::Google::Cloud::Scheduler::V1::Job#name name}) in the response.
@@ -459,13 +475,14 @@ module Google
459
475
  ##
460
476
  # Updates a job.
461
477
  #
462
- # If successful, the updated {::Google::Cloud::Scheduler::V1::Job Job} is returned. If the job does
463
- # not exist, `NOT_FOUND` is returned.
478
+ # If successful, the updated {::Google::Cloud::Scheduler::V1::Job Job} is
479
+ # returned. If the job does not exist, `NOT_FOUND` is returned.
464
480
  #
465
481
  # If UpdateJob does not successfully return, it is possible for the
466
- # job to be in an {::Google::Cloud::Scheduler::V1::Job::State::UPDATE_FAILED Job.State.UPDATE_FAILED} state. A job in this state may
467
- # not be executed. If this happens, retry the UpdateJob request
468
- # until a successful response is received.
482
+ # job to be in an
483
+ # {::Google::Cloud::Scheduler::V1::Job::State::UPDATE_FAILED Job.State.UPDATE_FAILED}
484
+ # state. A job in this state may not be executed. If this happens, retry the
485
+ # UpdateJob request until a successful response is received.
469
486
  #
470
487
  # @overload update_job(request, options = nil)
471
488
  # Pass arguments to `update_job` via a request object, either of type
@@ -483,7 +500,8 @@ module Google
483
500
  # the default parameter values, pass an empty Hash as a request object (see above).
484
501
  #
485
502
  # @param job [::Google::Cloud::Scheduler::V1::Job, ::Hash]
486
- # Required. The new job properties. {::Google::Cloud::Scheduler::V1::Job#name name} must be specified.
503
+ # Required. The new job properties.
504
+ # {::Google::Cloud::Scheduler::V1::Job#name name} must be specified.
487
505
  #
488
506
  # Output only fields cannot be modified using UpdateJob.
489
507
  # Any value specified for an output only field will be ignored.
@@ -644,10 +662,13 @@ module Google
644
662
  # Pauses a job.
645
663
  #
646
664
  # If a job is paused then the system will stop executing the job
647
- # until it is re-enabled via {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#resume_job ResumeJob}. The
648
- # state of the job is stored in {::Google::Cloud::Scheduler::V1::Job#state state}; if paused it
649
- # will be set to {::Google::Cloud::Scheduler::V1::Job::State::PAUSED Job.State.PAUSED}. A job must be in {::Google::Cloud::Scheduler::V1::Job::State::ENABLED Job.State.ENABLED}
650
- # to be paused.
665
+ # until it is re-enabled via
666
+ # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#resume_job ResumeJob}. The state
667
+ # of the job is stored in {::Google::Cloud::Scheduler::V1::Job#state state}; if
668
+ # paused it will be set to
669
+ # {::Google::Cloud::Scheduler::V1::Job::State::PAUSED Job.State.PAUSED}. A job must
670
+ # be in {::Google::Cloud::Scheduler::V1::Job::State::ENABLED Job.State.ENABLED} to
671
+ # be paused.
651
672
  #
652
673
  # @overload pause_job(request, options = nil)
653
674
  # Pass arguments to `pause_job` via a request object, either of type
@@ -735,10 +756,13 @@ module Google
735
756
  ##
736
757
  # Resume a job.
737
758
  #
738
- # This method reenables a job after it has been {::Google::Cloud::Scheduler::V1::Job::State::PAUSED Job.State.PAUSED}. The
739
- # state of a job is stored in {::Google::Cloud::Scheduler::V1::Job#state Job.state}; after calling this method it
740
- # will be set to {::Google::Cloud::Scheduler::V1::Job::State::ENABLED Job.State.ENABLED}. A job must be in
741
- # {::Google::Cloud::Scheduler::V1::Job::State::PAUSED Job.State.PAUSED} to be resumed.
759
+ # This method reenables a job after it has been
760
+ # {::Google::Cloud::Scheduler::V1::Job::State::PAUSED Job.State.PAUSED}. The state
761
+ # of a job is stored in {::Google::Cloud::Scheduler::V1::Job#state Job.state};
762
+ # after calling this method it will be set to
763
+ # {::Google::Cloud::Scheduler::V1::Job::State::ENABLED Job.State.ENABLED}. A job
764
+ # must be in {::Google::Cloud::Scheduler::V1::Job::State::PAUSED Job.State.PAUSED}
765
+ # to be resumed.
742
766
  #
743
767
  # @overload resume_job(request, options = nil)
744
768
  # Pass arguments to `resume_job` via a request object, either of type
@@ -34,7 +34,7 @@ module Google
34
34
  # The Cloud Scheduler API allows external entities to reliably
35
35
  # schedule asynchronous jobs.
36
36
  #
37
- # To load this service and instantiate a client:
37
+ # @example Load this service and instantiate a gRPC client
38
38
  #
39
39
  # require "google/cloud/scheduler/v1/cloud_scheduler"
40
40
  # client = ::Google::Cloud::Scheduler::V1::CloudScheduler::Client.new
@@ -1,7 +1,7 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # Source: google/cloud/scheduler/v1/cloudscheduler.proto for package 'google.cloud.scheduler.v1'
3
3
  # Original file comments:
4
- # Copyright 2019 Google LLC.
4
+ # Copyright 2022 Google LLC
5
5
  #
6
6
  # Licensed under the Apache License, Version 2.0 (the "License");
7
7
  # you may not use this file except in compliance with the License.
@@ -15,7 +15,6 @@
15
15
  # See the License for the specific language governing permissions and
16
16
  # limitations under the License.
17
17
  #
18
- #
19
18
 
20
19
  require 'grpc'
21
20
  require 'google/cloud/scheduler/v1/cloudscheduler_pb'
@@ -43,30 +42,37 @@ module Google
43
42
  rpc :CreateJob, ::Google::Cloud::Scheduler::V1::CreateJobRequest, ::Google::Cloud::Scheduler::V1::Job
44
43
  # Updates a job.
45
44
  #
46
- # If successful, the updated [Job][google.cloud.scheduler.v1.Job] is returned. If the job does
47
- # not exist, `NOT_FOUND` is returned.
45
+ # If successful, the updated [Job][google.cloud.scheduler.v1.Job] is
46
+ # returned. If the job does not exist, `NOT_FOUND` is returned.
48
47
  #
49
48
  # If UpdateJob does not successfully return, it is possible for the
50
- # job to be in an [Job.State.UPDATE_FAILED][google.cloud.scheduler.v1.Job.State.UPDATE_FAILED] state. A job in this state may
51
- # not be executed. If this happens, retry the UpdateJob request
52
- # until a successful response is received.
49
+ # job to be in an
50
+ # [Job.State.UPDATE_FAILED][google.cloud.scheduler.v1.Job.State.UPDATE_FAILED]
51
+ # state. A job in this state may not be executed. If this happens, retry the
52
+ # UpdateJob request until a successful response is received.
53
53
  rpc :UpdateJob, ::Google::Cloud::Scheduler::V1::UpdateJobRequest, ::Google::Cloud::Scheduler::V1::Job
54
54
  # Deletes a job.
55
55
  rpc :DeleteJob, ::Google::Cloud::Scheduler::V1::DeleteJobRequest, ::Google::Protobuf::Empty
56
56
  # Pauses a job.
57
57
  #
58
58
  # If a job is paused then the system will stop executing the job
59
- # until it is re-enabled via [ResumeJob][google.cloud.scheduler.v1.CloudScheduler.ResumeJob]. The
60
- # state of the job is stored in [state][google.cloud.scheduler.v1.Job.state]; if paused it
61
- # will be set to [Job.State.PAUSED][google.cloud.scheduler.v1.Job.State.PAUSED]. A job must be in [Job.State.ENABLED][google.cloud.scheduler.v1.Job.State.ENABLED]
62
- # to be paused.
59
+ # until it is re-enabled via
60
+ # [ResumeJob][google.cloud.scheduler.v1.CloudScheduler.ResumeJob]. The state
61
+ # of the job is stored in [state][google.cloud.scheduler.v1.Job.state]; if
62
+ # paused it will be set to
63
+ # [Job.State.PAUSED][google.cloud.scheduler.v1.Job.State.PAUSED]. A job must
64
+ # be in [Job.State.ENABLED][google.cloud.scheduler.v1.Job.State.ENABLED] to
65
+ # be paused.
63
66
  rpc :PauseJob, ::Google::Cloud::Scheduler::V1::PauseJobRequest, ::Google::Cloud::Scheduler::V1::Job
64
67
  # Resume a job.
65
68
  #
66
- # This method reenables a job after it has been [Job.State.PAUSED][google.cloud.scheduler.v1.Job.State.PAUSED]. The
67
- # state of a job is stored in [Job.state][google.cloud.scheduler.v1.Job.state]; after calling this method it
68
- # will be set to [Job.State.ENABLED][google.cloud.scheduler.v1.Job.State.ENABLED]. A job must be in
69
- # [Job.State.PAUSED][google.cloud.scheduler.v1.Job.State.PAUSED] to be resumed.
69
+ # This method reenables a job after it has been
70
+ # [Job.State.PAUSED][google.cloud.scheduler.v1.Job.State.PAUSED]. The state
71
+ # of a job is stored in [Job.state][google.cloud.scheduler.v1.Job.state];
72
+ # after calling this method it will be set to
73
+ # [Job.State.ENABLED][google.cloud.scheduler.v1.Job.State.ENABLED]. A job
74
+ # must be in [Job.State.PAUSED][google.cloud.scheduler.v1.Job.State.PAUSED]
75
+ # to be resumed.
70
76
  rpc :ResumeJob, ::Google::Cloud::Scheduler::V1::ResumeJobRequest, ::Google::Cloud::Scheduler::V1::Job
71
77
  # Forces a job to run now.
72
78
  #
@@ -8,7 +8,6 @@ require 'google/cloud/scheduler/v1/target_pb'
8
8
  require 'google/protobuf/duration_pb'
9
9
  require 'google/protobuf/timestamp_pb'
10
10
  require 'google/rpc/status_pb'
11
- require 'google/api/annotations_pb'
12
11
 
13
12
  Google::Protobuf::DescriptorPool.generated_pool.build do
14
13
  add_file("google/cloud/scheduler/v1/job.proto", :syntax => :proto3) do
@@ -4,7 +4,6 @@
4
4
  require 'google/protobuf'
5
5
 
6
6
  require 'google/api/resource_pb'
7
- require 'google/api/annotations_pb'
8
7
 
9
8
  Google::Protobuf::DescriptorPool.generated_pool.build do
10
9
  add_file("google/cloud/scheduler/v1/target.proto", :syntax => :proto3) do
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Scheduler
23
23
  module V1
24
- VERSION = "0.5.0"
24
+ VERSION = "0.6.0"
25
25
  end
26
26
  end
27
27
  end
@@ -23,9 +23,9 @@ module Google
23
23
  module Cloud
24
24
  module Scheduler
25
25
  ##
26
- # To load this package, including all its services, and instantiate a client:
26
+ # API client module.
27
27
  #
28
- # @example
28
+ # @example Load this package, including all its services, and instantiate a gRPC client
29
29
  #
30
30
  # require "google/cloud/scheduler/v1"
31
31
  # client = ::Google::Cloud::Scheduler::V1::CloudScheduler::Client.new
@@ -0,0 +1,318 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2022 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Api
22
+ # Required information for every language.
23
+ # @!attribute [rw] reference_docs_uri
24
+ # @return [::String]
25
+ # Link to automatically generated reference documentation. Example:
26
+ # https://cloud.google.com/nodejs/docs/reference/asset/latest
27
+ # @!attribute [rw] destinations
28
+ # @return [::Array<::Google::Api::ClientLibraryDestination>]
29
+ # The destination where API teams want this client library to be published.
30
+ class CommonLanguageSettings
31
+ include ::Google::Protobuf::MessageExts
32
+ extend ::Google::Protobuf::MessageExts::ClassMethods
33
+ end
34
+
35
+ # Details about how and where to publish client libraries.
36
+ # @!attribute [rw] version
37
+ # @return [::String]
38
+ # Version of the API to apply these settings to.
39
+ # @!attribute [rw] launch_stage
40
+ # @return [::Google::Api::LaunchStage]
41
+ # Launch stage of this version of the API.
42
+ # @!attribute [rw] rest_numeric_enums
43
+ # @return [::Boolean]
44
+ # When using transport=rest, the client request will encode enums as
45
+ # numbers rather than strings.
46
+ # @!attribute [rw] java_settings
47
+ # @return [::Google::Api::JavaSettings]
48
+ # Settings for legacy Java features, supported in the Service YAML.
49
+ # @!attribute [rw] cpp_settings
50
+ # @return [::Google::Api::CppSettings]
51
+ # Settings for C++ client libraries.
52
+ # @!attribute [rw] php_settings
53
+ # @return [::Google::Api::PhpSettings]
54
+ # Settings for PHP client libraries.
55
+ # @!attribute [rw] python_settings
56
+ # @return [::Google::Api::PythonSettings]
57
+ # Settings for Python client libraries.
58
+ # @!attribute [rw] node_settings
59
+ # @return [::Google::Api::NodeSettings]
60
+ # Settings for Node client libraries.
61
+ # @!attribute [rw] dotnet_settings
62
+ # @return [::Google::Api::DotnetSettings]
63
+ # Settings for .NET client libraries.
64
+ # @!attribute [rw] ruby_settings
65
+ # @return [::Google::Api::RubySettings]
66
+ # Settings for Ruby client libraries.
67
+ # @!attribute [rw] go_settings
68
+ # @return [::Google::Api::GoSettings]
69
+ # Settings for Go client libraries.
70
+ class ClientLibrarySettings
71
+ include ::Google::Protobuf::MessageExts
72
+ extend ::Google::Protobuf::MessageExts::ClassMethods
73
+ end
74
+
75
+ # This message configures the settings for publishing [Google Cloud Client
76
+ # libraries](https://cloud.google.com/apis/docs/cloud-client-libraries)
77
+ # generated from the service config.
78
+ # @!attribute [rw] method_settings
79
+ # @return [::Array<::Google::Api::MethodSettings>]
80
+ # A list of API method settings, e.g. the behavior for methods that use the
81
+ # long-running operation pattern.
82
+ # @!attribute [rw] new_issue_uri
83
+ # @return [::String]
84
+ # Link to a place that API users can report issues. Example:
85
+ # https://issuetracker.google.com/issues/new?component=190865&template=1161103
86
+ # @!attribute [rw] documentation_uri
87
+ # @return [::String]
88
+ # Link to product home page. Example:
89
+ # https://cloud.google.com/asset-inventory/docs/overview
90
+ # @!attribute [rw] api_short_name
91
+ # @return [::String]
92
+ # Used as a tracking tag when collecting data about the APIs developer
93
+ # relations artifacts like docs, packages delivered to package managers,
94
+ # etc. Example: "speech".
95
+ # @!attribute [rw] github_label
96
+ # @return [::String]
97
+ # GitHub label to apply to issues and pull requests opened for this API.
98
+ # @!attribute [rw] codeowner_github_teams
99
+ # @return [::Array<::String>]
100
+ # GitHub teams to be added to CODEOWNERS in the directory in GitHub
101
+ # containing source code for the client libraries for this API.
102
+ # @!attribute [rw] doc_tag_prefix
103
+ # @return [::String]
104
+ # A prefix used in sample code when demarking regions to be included in
105
+ # documentation.
106
+ # @!attribute [rw] organization
107
+ # @return [::Google::Api::ClientLibraryOrganization]
108
+ # For whom the client library is being published.
109
+ # @!attribute [rw] library_settings
110
+ # @return [::Array<::Google::Api::ClientLibrarySettings>]
111
+ # Client library settings. If the same version string appears multiple
112
+ # times in this list, then the last one wins. Settings from earlier
113
+ # settings with the same version string are discarded.
114
+ class Publishing
115
+ include ::Google::Protobuf::MessageExts
116
+ extend ::Google::Protobuf::MessageExts::ClassMethods
117
+ end
118
+
119
+ # Settings for Java client libraries.
120
+ # @!attribute [rw] library_package
121
+ # @return [::String]
122
+ # The package name to use in Java. Clobbers the java_package option
123
+ # set in the protobuf. This should be used **only** by APIs
124
+ # who have already set the language_settings.java.package_name" field
125
+ # in gapic.yaml. API teams should use the protobuf java_package option
126
+ # where possible.
127
+ #
128
+ # Example of a YAML configuration::
129
+ #
130
+ # publishing:
131
+ # java_settings:
132
+ # library_package: com.google.cloud.pubsub.v1
133
+ # @!attribute [rw] service_class_names
134
+ # @return [::Google::Protobuf::Map{::String => ::String}]
135
+ # Configure the Java class name to use instead of the service's for its
136
+ # corresponding generated GAPIC client. Keys are fully-qualified
137
+ # service names as they appear in the protobuf (including the full
138
+ # the language_settings.java.interface_names" field in gapic.yaml. API
139
+ # teams should otherwise use the service name as it appears in the
140
+ # protobuf.
141
+ #
142
+ # Example of a YAML configuration::
143
+ #
144
+ # publishing:
145
+ # java_settings:
146
+ # service_class_names:
147
+ # - google.pubsub.v1.Publisher: TopicAdmin
148
+ # - google.pubsub.v1.Subscriber: SubscriptionAdmin
149
+ # @!attribute [rw] common
150
+ # @return [::Google::Api::CommonLanguageSettings]
151
+ # Some settings.
152
+ class JavaSettings
153
+ include ::Google::Protobuf::MessageExts
154
+ extend ::Google::Protobuf::MessageExts::ClassMethods
155
+
156
+ # @!attribute [rw] key
157
+ # @return [::String]
158
+ # @!attribute [rw] value
159
+ # @return [::String]
160
+ class ServiceClassNamesEntry
161
+ include ::Google::Protobuf::MessageExts
162
+ extend ::Google::Protobuf::MessageExts::ClassMethods
163
+ end
164
+ end
165
+
166
+ # Settings for C++ client libraries.
167
+ # @!attribute [rw] common
168
+ # @return [::Google::Api::CommonLanguageSettings]
169
+ # Some settings.
170
+ class CppSettings
171
+ include ::Google::Protobuf::MessageExts
172
+ extend ::Google::Protobuf::MessageExts::ClassMethods
173
+ end
174
+
175
+ # Settings for Php client libraries.
176
+ # @!attribute [rw] common
177
+ # @return [::Google::Api::CommonLanguageSettings]
178
+ # Some settings.
179
+ class PhpSettings
180
+ include ::Google::Protobuf::MessageExts
181
+ extend ::Google::Protobuf::MessageExts::ClassMethods
182
+ end
183
+
184
+ # Settings for Python client libraries.
185
+ # @!attribute [rw] common
186
+ # @return [::Google::Api::CommonLanguageSettings]
187
+ # Some settings.
188
+ class PythonSettings
189
+ include ::Google::Protobuf::MessageExts
190
+ extend ::Google::Protobuf::MessageExts::ClassMethods
191
+ end
192
+
193
+ # Settings for Node client libraries.
194
+ # @!attribute [rw] common
195
+ # @return [::Google::Api::CommonLanguageSettings]
196
+ # Some settings.
197
+ class NodeSettings
198
+ include ::Google::Protobuf::MessageExts
199
+ extend ::Google::Protobuf::MessageExts::ClassMethods
200
+ end
201
+
202
+ # Settings for Dotnet client libraries.
203
+ # @!attribute [rw] common
204
+ # @return [::Google::Api::CommonLanguageSettings]
205
+ # Some settings.
206
+ class DotnetSettings
207
+ include ::Google::Protobuf::MessageExts
208
+ extend ::Google::Protobuf::MessageExts::ClassMethods
209
+ end
210
+
211
+ # Settings for Ruby client libraries.
212
+ # @!attribute [rw] common
213
+ # @return [::Google::Api::CommonLanguageSettings]
214
+ # Some settings.
215
+ class RubySettings
216
+ include ::Google::Protobuf::MessageExts
217
+ extend ::Google::Protobuf::MessageExts::ClassMethods
218
+ end
219
+
220
+ # Settings for Go client libraries.
221
+ # @!attribute [rw] common
222
+ # @return [::Google::Api::CommonLanguageSettings]
223
+ # Some settings.
224
+ class GoSettings
225
+ include ::Google::Protobuf::MessageExts
226
+ extend ::Google::Protobuf::MessageExts::ClassMethods
227
+ end
228
+
229
+ # Describes the generator configuration for a method.
230
+ # @!attribute [rw] selector
231
+ # @return [::String]
232
+ # The fully qualified name of the method, for which the options below apply.
233
+ # This is used to find the method to apply the options.
234
+ # @!attribute [rw] long_running
235
+ # @return [::Google::Api::MethodSettings::LongRunning]
236
+ # Describes settings to use for long-running operations when generating
237
+ # API methods for RPCs. Complements RPCs that use the annotations in
238
+ # google/longrunning/operations.proto.
239
+ #
240
+ # Example of a YAML configuration::
241
+ #
242
+ # publishing:
243
+ # method_behavior:
244
+ # - selector: CreateAdDomain
245
+ # long_running:
246
+ # initial_poll_delay:
247
+ # seconds: 60 # 1 minute
248
+ # poll_delay_multiplier: 1.5
249
+ # max_poll_delay:
250
+ # seconds: 360 # 6 minutes
251
+ # total_poll_timeout:
252
+ # seconds: 54000 # 90 minutes
253
+ class MethodSettings
254
+ include ::Google::Protobuf::MessageExts
255
+ extend ::Google::Protobuf::MessageExts::ClassMethods
256
+
257
+ # Describes settings to use when generating API methods that use the
258
+ # long-running operation pattern.
259
+ # All default values below are from those used in the client library
260
+ # generators (e.g.
261
+ # [Java](https://github.com/googleapis/gapic-generator-java/blob/04c2faa191a9b5a10b92392fe8482279c4404803/src/main/java/com/google/api/generator/gapic/composer/common/RetrySettingsComposer.java)).
262
+ # @!attribute [rw] initial_poll_delay
263
+ # @return [::Google::Protobuf::Duration]
264
+ # Initial delay after which the first poll request will be made.
265
+ # Default value: 5 seconds.
266
+ # @!attribute [rw] poll_delay_multiplier
267
+ # @return [::Float]
268
+ # Multiplier to gradually increase delay between subsequent polls until it
269
+ # reaches max_poll_delay.
270
+ # Default value: 1.5.
271
+ # @!attribute [rw] max_poll_delay
272
+ # @return [::Google::Protobuf::Duration]
273
+ # Maximum time between two subsequent poll requests.
274
+ # Default value: 45 seconds.
275
+ # @!attribute [rw] total_poll_timeout
276
+ # @return [::Google::Protobuf::Duration]
277
+ # Total polling timeout.
278
+ # Default value: 5 minutes.
279
+ class LongRunning
280
+ include ::Google::Protobuf::MessageExts
281
+ extend ::Google::Protobuf::MessageExts::ClassMethods
282
+ end
283
+ end
284
+
285
+ # The organization for which the client libraries are being published.
286
+ # Affects the url where generated docs are published, etc.
287
+ module ClientLibraryOrganization
288
+ # Not useful.
289
+ CLIENT_LIBRARY_ORGANIZATION_UNSPECIFIED = 0
290
+
291
+ # Google Cloud Platform Org.
292
+ CLOUD = 1
293
+
294
+ # Ads (Advertising) Org.
295
+ ADS = 2
296
+
297
+ # Photos Org.
298
+ PHOTOS = 3
299
+
300
+ # Street View Org.
301
+ STREET_VIEW = 4
302
+ end
303
+
304
+ # To where should client libraries be published?
305
+ module ClientLibraryDestination
306
+ # Client libraries will neither be generated nor published to package
307
+ # managers.
308
+ CLIENT_LIBRARY_DESTINATION_UNSPECIFIED = 0
309
+
310
+ # Generate the client library in a repo under github.com/googleapis,
311
+ # but don't publish it to package managers.
312
+ GITHUB = 10
313
+
314
+ # Publish the library to package managers like nuget.org and npmjs.com.
315
+ PACKAGE_MANAGER = 20
316
+ end
317
+ end
318
+ end
@@ -0,0 +1,71 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2022 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Api
22
+ # The launch stage as defined by [Google Cloud Platform
23
+ # Launch Stages](https://cloud.google.com/terms/launch-stages).
24
+ module LaunchStage
25
+ # Do not use this default value.
26
+ LAUNCH_STAGE_UNSPECIFIED = 0
27
+
28
+ # The feature is not yet implemented. Users can not use it.
29
+ UNIMPLEMENTED = 6
30
+
31
+ # Prelaunch features are hidden from users and are only visible internally.
32
+ PRELAUNCH = 7
33
+
34
+ # Early Access features are limited to a closed group of testers. To use
35
+ # these features, you must sign up in advance and sign a Trusted Tester
36
+ # agreement (which includes confidentiality provisions). These features may
37
+ # be unstable, changed in backward-incompatible ways, and are not
38
+ # guaranteed to be released.
39
+ EARLY_ACCESS = 1
40
+
41
+ # Alpha is a limited availability test for releases before they are cleared
42
+ # for widespread use. By Alpha, all significant design issues are resolved
43
+ # and we are in the process of verifying functionality. Alpha customers
44
+ # need to apply for access, agree to applicable terms, and have their
45
+ # projects allowlisted. Alpha releases don't have to be feature complete,
46
+ # no SLAs are provided, and there are no technical support obligations, but
47
+ # they will be far enough along that customers can actually use them in
48
+ # test environments or for limited-use tests -- just like they would in
49
+ # normal production cases.
50
+ ALPHA = 2
51
+
52
+ # Beta is the point at which we are ready to open a release for any
53
+ # customer to use. There are no SLA or technical support obligations in a
54
+ # Beta release. Products will be complete from a feature perspective, but
55
+ # may have some open outstanding issues. Beta releases are suitable for
56
+ # limited production use cases.
57
+ BETA = 3
58
+
59
+ # GA features are open to all developers and are considered stable and
60
+ # fully qualified for production use.
61
+ GA = 4
62
+
63
+ # Deprecated features are scheduled to be shut down and removed. For more
64
+ # information, see the "Deprecation Policy" section of our [Terms of
65
+ # Service](https://cloud.google.com/terms/)
66
+ # and the [Google Cloud Platform Subject to the Deprecation
67
+ # Policy](https://cloud.google.com/terms/deprecation) documentation.
68
+ DEPRECATED = 5
69
+ end
70
+ end
71
+ end
@@ -21,7 +21,8 @@ module Google
21
21
  module Cloud
22
22
  module Scheduler
23
23
  module V1
24
- # Request message for listing jobs using {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#list_jobs ListJobs}.
24
+ # Request message for listing jobs using
25
+ # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#list_jobs ListJobs}.
25
26
  # @!attribute [rw] parent
26
27
  # @return [::String]
27
28
  # Required. The location name. For example:
@@ -39,26 +40,31 @@ module Google
39
40
  # A token identifying a page of results the server will return. To
40
41
  # request the first page results, page_token must be empty. To
41
42
  # request the next page of results, page_token must be the value of
42
- # {::Google::Cloud::Scheduler::V1::ListJobsResponse#next_page_token next_page_token} returned from
43
- # the previous call to {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#list_jobs ListJobs}. It is an error to
44
- # switch the value of [filter][google.cloud.scheduler.v1.ListJobsRequest.filter] or
45
- # [order_by][google.cloud.scheduler.v1.ListJobsRequest.order_by] while iterating through pages.
43
+ # {::Google::Cloud::Scheduler::V1::ListJobsResponse#next_page_token next_page_token}
44
+ # returned from the previous call to
45
+ # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#list_jobs ListJobs}. It is an
46
+ # error to switch the value of
47
+ # [filter][google.cloud.scheduler.v1.ListJobsRequest.filter] or
48
+ # [order_by][google.cloud.scheduler.v1.ListJobsRequest.order_by] while
49
+ # iterating through pages.
46
50
  class ListJobsRequest
47
51
  include ::Google::Protobuf::MessageExts
48
52
  extend ::Google::Protobuf::MessageExts::ClassMethods
49
53
  end
50
54
 
51
- # Response message for listing jobs using {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#list_jobs ListJobs}.
55
+ # Response message for listing jobs using
56
+ # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#list_jobs ListJobs}.
52
57
  # @!attribute [rw] jobs
53
58
  # @return [::Array<::Google::Cloud::Scheduler::V1::Job>]
54
59
  # The list of jobs.
55
60
  # @!attribute [rw] next_page_token
56
61
  # @return [::String]
57
62
  # A token to retrieve next page of results. Pass this value in the
58
- # {::Google::Cloud::Scheduler::V1::ListJobsRequest#page_token page_token} field in the subsequent call to
59
- # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#list_jobs ListJobs} to retrieve the next page of results.
60
- # If this is empty it indicates that there are no more results
61
- # through which to paginate.
63
+ # {::Google::Cloud::Scheduler::V1::ListJobsRequest#page_token page_token} field in
64
+ # the subsequent call to
65
+ # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#list_jobs ListJobs} to retrieve
66
+ # the next page of results. If this is empty it indicates that there are no
67
+ # more results through which to paginate.
62
68
  #
63
69
  # The page token is valid for only 2 hours.
64
70
  class ListJobsResponse
@@ -66,7 +72,8 @@ module Google
66
72
  extend ::Google::Protobuf::MessageExts::ClassMethods
67
73
  end
68
74
 
69
- # Request message for {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#get_job GetJob}.
75
+ # Request message for
76
+ # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#get_job GetJob}.
70
77
  # @!attribute [rw] name
71
78
  # @return [::String]
72
79
  # Required. The job name. For example:
@@ -76,7 +83,8 @@ module Google
76
83
  extend ::Google::Protobuf::MessageExts::ClassMethods
77
84
  end
78
85
 
79
- # Request message for {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#create_job CreateJob}.
86
+ # Request message for
87
+ # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#create_job CreateJob}.
80
88
  # @!attribute [rw] parent
81
89
  # @return [::String]
82
90
  # Required. The location name. For example:
@@ -84,7 +92,8 @@ module Google
84
92
  # @!attribute [rw] job
85
93
  # @return [::Google::Cloud::Scheduler::V1::Job]
86
94
  # Required. The job to add. The user can optionally specify a name for the
87
- # job in {::Google::Cloud::Scheduler::V1::Job#name name}. {::Google::Cloud::Scheduler::V1::Job#name name} cannot be the same as an
95
+ # job in {::Google::Cloud::Scheduler::V1::Job#name name}.
96
+ # {::Google::Cloud::Scheduler::V1::Job#name name} cannot be the same as an
88
97
  # existing job. If a name is not specified then the system will
89
98
  # generate a random unique name that will be returned
90
99
  # ({::Google::Cloud::Scheduler::V1::Job#name name}) in the response.
@@ -93,10 +102,12 @@ module Google
93
102
  extend ::Google::Protobuf::MessageExts::ClassMethods
94
103
  end
95
104
 
96
- # Request message for {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#update_job UpdateJob}.
105
+ # Request message for
106
+ # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#update_job UpdateJob}.
97
107
  # @!attribute [rw] job
98
108
  # @return [::Google::Cloud::Scheduler::V1::Job]
99
- # Required. The new job properties. {::Google::Cloud::Scheduler::V1::Job#name name} must be specified.
109
+ # Required. The new job properties.
110
+ # {::Google::Cloud::Scheduler::V1::Job#name name} must be specified.
100
111
  #
101
112
  # Output only fields cannot be modified using UpdateJob.
102
113
  # Any value specified for an output only field will be ignored.
@@ -119,7 +130,8 @@ module Google
119
130
  extend ::Google::Protobuf::MessageExts::ClassMethods
120
131
  end
121
132
 
122
- # Request message for {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#pause_job PauseJob}.
133
+ # Request message for
134
+ # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#pause_job PauseJob}.
123
135
  # @!attribute [rw] name
124
136
  # @return [::String]
125
137
  # Required. The job name. For example:
@@ -129,7 +141,8 @@ module Google
129
141
  extend ::Google::Protobuf::MessageExts::ClassMethods
130
142
  end
131
143
 
132
- # Request message for {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#resume_job ResumeJob}.
144
+ # Request message for
145
+ # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#resume_job ResumeJob}.
133
146
  # @!attribute [rw] name
134
147
  # @return [::String]
135
148
  # Required. The job name. For example:
@@ -22,10 +22,11 @@ module Google
22
22
  module Scheduler
23
23
  module V1
24
24
  # Configuration for a job.
25
- # The maximum allowed size for a job is 100KB.
25
+ # The maximum allowed size for a job is 1MB.
26
26
  # @!attribute [rw] name
27
27
  # @return [::String]
28
- # Optionally caller-specified in {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#create_job CreateJob}, after
28
+ # Optionally caller-specified in
29
+ # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#create_job CreateJob}, after
29
30
  # which it becomes output only.
30
31
  #
31
32
  # The job name. For example:
@@ -38,13 +39,14 @@ module Google
38
39
  # projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
39
40
  # * `LOCATION_ID` is the canonical ID for the job's location.
40
41
  # The list of available locations can be obtained by calling
41
- # [ListLocations][google.cloud.location.Locations.ListLocations].
42
+ # ListLocations.
42
43
  # For more information, see https://cloud.google.com/about/locations/.
43
44
  # * `JOB_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
44
45
  # hyphens (-), or underscores (_). The maximum length is 500 characters.
45
46
  # @!attribute [rw] description
46
47
  # @return [::String]
47
- # Optionally caller-specified in {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#create_job CreateJob} or
48
+ # Optionally caller-specified in
49
+ # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#create_job CreateJob} or
48
50
  # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#update_job UpdateJob}.
49
51
  #
50
52
  # A human-readable description for the job. This string must not contain
@@ -60,13 +62,14 @@ module Google
60
62
  # HTTP target.
61
63
  # @!attribute [rw] schedule
62
64
  # @return [::String]
63
- # Required, except when used with {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#update_job UpdateJob}.
65
+ # Required, except when used with
66
+ # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#update_job UpdateJob}.
64
67
  #
65
68
  # Describes the schedule on which the job will be executed.
66
69
  #
67
70
  # The schedule can be either of the following types:
68
71
  #
69
- # * [Crontab](http://en.wikipedia.org/wiki/Cron#Overview)
72
+ # * [Crontab](https://en.wikipedia.org/wiki/Cron#Overview)
70
73
  # * English-like
71
74
  # [schedule](https://cloud.google.com/scheduler/docs/configuring/cron-job-schedules)
72
75
  #
@@ -79,15 +82,16 @@ module Google
79
82
  # A scheduled start time will be delayed if the previous
80
83
  # execution has not ended when its scheduled time occurs.
81
84
  #
82
- # If {::Google::Cloud::Scheduler::V1::RetryConfig#retry_count retry_count} > 0 and a job attempt fails,
83
- # the job will be tried a total of {::Google::Cloud::Scheduler::V1::RetryConfig#retry_count retry_count}
84
- # times, with exponential backoff, until the next scheduled start
85
- # time.
85
+ # If {::Google::Cloud::Scheduler::V1::RetryConfig#retry_count retry_count} > 0 and
86
+ # a job attempt fails, the job will be tried a total of
87
+ # {::Google::Cloud::Scheduler::V1::RetryConfig#retry_count retry_count} times,
88
+ # with exponential backoff, until the next scheduled start time.
86
89
  # @!attribute [rw] time_zone
87
90
  # @return [::String]
88
91
  # Specifies the time zone to be used in interpreting
89
- # {::Google::Cloud::Scheduler::V1::Job#schedule schedule}. The value of this field must be a time
90
- # zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database).
92
+ # {::Google::Cloud::Scheduler::V1::Job#schedule schedule}. The value of this field
93
+ # must be a time zone name from the [tz
94
+ # database](http://en.wikipedia.org/wiki/Tz_database).
91
95
  #
92
96
  # Note that some time zones include a provision for
93
97
  # daylight savings time. The rules for daylight saving time are
@@ -122,10 +126,22 @@ module Google
122
126
  # execution logs. Cloud Scheduler will retry the job according
123
127
  # to the {::Google::Cloud::Scheduler::V1::RetryConfig RetryConfig}.
124
128
  #
125
- # The allowed duration for this deadline is:
126
- # * For {::Google::Cloud::Scheduler::V1::Job#http_target HTTP targets}, between 15 seconds and 30 minutes.
127
- # * For {::Google::Cloud::Scheduler::V1::Job#app_engine_http_target App Engine HTTP targets}, between 15
128
- # seconds and 24 hours.
129
+ # The default and the allowed values depend on the type of target:
130
+ #
131
+ # * For {::Google::Cloud::Scheduler::V1::Job#http_target HTTP targets}, the
132
+ # default is 3 minutes. The deadline must be in the interval [15 seconds, 30
133
+ # minutes].
134
+ #
135
+ # * For [App Engine HTTP
136
+ # targets][google.cloud.scheduler.v1.Job.app_engine_http_target], 0 indicates
137
+ # that the request has the default deadline. The default deadline depends on
138
+ # the scaling type of the service: 10 minutes for standard apps with
139
+ # automatic scaling, 24 hours for standard apps with manual and basic
140
+ # scaling, and 60 minutes for flex apps. If the request deadline is set, it
141
+ # must be in the interval [15 seconds, 24 hours 15 seconds].
142
+ #
143
+ # * For [Pub/Sub targets][google.cloud.scheduler.v1.Job.pubsub_target], this
144
+ # field is ignored.
129
145
  class Job
130
146
  include ::Google::Protobuf::MessageExts
131
147
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -147,9 +163,11 @@ module Google
147
163
  # cannot directly set a job to be disabled.
148
164
  DISABLED = 3
149
165
 
150
- # The job state resulting from a failed {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#update_job CloudScheduler.UpdateJob}
166
+ # The job state resulting from a failed
167
+ # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#update_job CloudScheduler.UpdateJob}
151
168
  # operation. To recover a job from this state, retry
152
- # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#update_job CloudScheduler.UpdateJob} until a successful response is received.
169
+ # {::Google::Cloud::Scheduler::V1::CloudScheduler::Client#update_job CloudScheduler.UpdateJob}
170
+ # until a successful response is received.
153
171
  UPDATE_FAILED = 4
154
172
  end
155
173
  end
@@ -158,7 +176,8 @@ module Google
158
176
  #
159
177
  # By default, if a job does not complete successfully (meaning that
160
178
  # an acknowledgement is not received from the handler, then it will be retried
161
- # with exponential backoff according to the settings in {::Google::Cloud::Scheduler::V1::RetryConfig RetryConfig}.
179
+ # with exponential backoff according to the settings in
180
+ # {::Google::Cloud::Scheduler::V1::RetryConfig RetryConfig}.
162
181
  # @!attribute [rw] retry_count
163
182
  # @return [::Integer]
164
183
  # The number of attempts that the system will make to run a job using the
@@ -181,8 +200,8 @@ module Google
181
200
  # @return [::Google::Protobuf::Duration]
182
201
  # The time limit for retrying a failed job, measured from time when an
183
202
  # execution was first attempted. If specified with
184
- # {::Google::Cloud::Scheduler::V1::RetryConfig#retry_count retry_count}, the job will be retried until both
185
- # limits are reached.
203
+ # {::Google::Cloud::Scheduler::V1::RetryConfig#retry_count retry_count}, the job
204
+ # will be retried until both limits are reached.
186
205
  #
187
206
  # The default value for max_retry_duration is zero, which means retry
188
207
  # duration is unlimited.
@@ -203,20 +222,25 @@ module Google
203
222
  # The time between retries will double `max_doublings` times.
204
223
  #
205
224
  # A job's retry interval starts at
206
- # {::Google::Cloud::Scheduler::V1::RetryConfig#min_backoff_duration min_backoff_duration}, then doubles
207
- # `max_doublings` times, then increases linearly, and finally
208
- # retries retries at intervals of
209
- # {::Google::Cloud::Scheduler::V1::RetryConfig#max_backoff_duration max_backoff_duration} up to
225
+ # {::Google::Cloud::Scheduler::V1::RetryConfig#min_backoff_duration min_backoff_duration},
226
+ # then doubles `max_doublings` times, then increases linearly, and finally
227
+ # retries at intervals of
228
+ # {::Google::Cloud::Scheduler::V1::RetryConfig#max_backoff_duration max_backoff_duration}
229
+ # up to {::Google::Cloud::Scheduler::V1::RetryConfig#retry_count retry_count}
230
+ # times.
231
+ #
232
+ # For example, if
233
+ # {::Google::Cloud::Scheduler::V1::RetryConfig#min_backoff_duration min_backoff_duration}
234
+ # is 10s,
235
+ # {::Google::Cloud::Scheduler::V1::RetryConfig#max_backoff_duration max_backoff_duration}
236
+ # is 300s, and `max_doublings` is 3, then the a job will first be retried in
237
+ # 10s. The retry interval will double three times, and then increase linearly
238
+ # by 2^3 * 10s. Finally, the job will retry at intervals of
239
+ # {::Google::Cloud::Scheduler::V1::RetryConfig#max_backoff_duration max_backoff_duration}
240
+ # until the job has been attempted
210
241
  # {::Google::Cloud::Scheduler::V1::RetryConfig#retry_count retry_count} times.
211
- #
212
- # For example, if {::Google::Cloud::Scheduler::V1::RetryConfig#min_backoff_duration min_backoff_duration} is
213
- # 10s, {::Google::Cloud::Scheduler::V1::RetryConfig#max_backoff_duration max_backoff_duration} is 300s, and
214
- # `max_doublings` is 3, then the a job will first be retried in 10s. The
215
- # retry interval will double three times, and then increase linearly by
216
- # 2^3 * 10s. Finally, the job will retry at intervals of
217
- # {::Google::Cloud::Scheduler::V1::RetryConfig#max_backoff_duration max_backoff_duration} until the job has
218
- # been attempted {::Google::Cloud::Scheduler::V1::RetryConfig#retry_count retry_count} times. Thus, the
219
- # requests will retry at 10s, 20s, 40s, 80s, 160s, 240s, 300s, 300s, ....
242
+ # Thus, the requests will retry at 10s, 20s, 40s, 80s, 160s, 240s, 300s,
243
+ # 300s, ....
220
244
  #
221
245
  # The default value of this field is 5.
222
246
  class RetryConfig
@@ -22,7 +22,8 @@ module Google
22
22
  module Scheduler
23
23
  module V1
24
24
  # Http target. The job will be pushed to the job handler by means of
25
- # an HTTP request via an {::Google::Cloud::Scheduler::V1::HttpTarget#http_method http_method} such as HTTP
25
+ # an HTTP request via an
26
+ # {::Google::Cloud::Scheduler::V1::HttpTarget#http_method http_method} such as HTTP
26
27
  # POST, HTTP GET, etc. The job is acknowledged by means of an HTTP
27
28
  # response code in the range [200 - 299]. A failure to receive a response
28
29
  # constitutes a failed execution. For a redirected request, the response
@@ -53,6 +54,11 @@ module Google
53
54
  # * `User-Agent`: This will be set to `"Google-Cloud-Scheduler"`.
54
55
  # * `X-Google-*`: Google internal use only.
55
56
  # * `X-AppEngine-*`: Google internal use only.
57
+ # * `X-CloudScheduler`: This header will be set to true.
58
+ # * `X-CloudScheduler-JobName`: This header will contain the job name.
59
+ # * `X-CloudScheduler-ScheduleTime`: For Cloud Scheduler jobs specified in
60
+ # the unix-cron format, this header will contain the job schedule time in
61
+ # RFC3339 UTC "Zulu" format.
56
62
  #
57
63
  # The total size of headers must be less than 80KB.
58
64
  # @!attribute [rw] body
@@ -94,7 +100,8 @@ module Google
94
100
  end
95
101
 
96
102
  # App Engine target. The job will be pushed to a job handler by means
97
- # of an HTTP request via an {::Google::Cloud::Scheduler::V1::AppEngineHttpTarget#http_method http_method} such
103
+ # of an HTTP request via an
104
+ # {::Google::Cloud::Scheduler::V1::AppEngineHttpTarget#http_method http_method} such
98
105
  # as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
99
106
  # HTTP response code in the range [200 - 299]. Error 503 is
100
107
  # considered an App Engine system error instead of an application
@@ -132,9 +139,14 @@ module Google
132
139
  # `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
133
140
  # modified `User-Agent`.
134
141
  # * `X-CloudScheduler`: This header will be set to true.
142
+ # * `X-CloudScheduler-JobName`: This header will contain the job name.
143
+ # * `X-CloudScheduler-ScheduleTime`: For Cloud Scheduler jobs specified in
144
+ # the unix-cron format, this header will contain the job schedule time in
145
+ # RFC3339 UTC "Zulu" format.
135
146
  #
136
- # If the job has an {::Google::Cloud::Scheduler::V1::AppEngineHttpTarget#body body}, Cloud Scheduler sets
137
- # the following headers:
147
+ # If the job has an
148
+ # {::Google::Cloud::Scheduler::V1::AppEngineHttpTarget#body body}, Cloud Scheduler
149
+ # sets the following headers:
138
150
  #
139
151
  # * `Content-Type`: By default, the `Content-Type` header is set to
140
152
  # `"application/octet-stream"`. The default can be overridden by explictly
@@ -157,7 +169,8 @@ module Google
157
169
  #
158
170
  # HTTP request body. A request body is allowed only if the HTTP method is
159
171
  # POST or PUT. It will result in invalid argument error to set a body on a
160
- # job with an incompatible {::Google::Cloud::Scheduler::V1::HttpMethod HttpMethod}.
172
+ # job with an incompatible
173
+ # {::Google::Cloud::Scheduler::V1::HttpMethod HttpMethod}.
161
174
  class AppEngineHttpTarget
162
175
  include ::Google::Protobuf::MessageExts
163
176
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -178,7 +191,7 @@ module Google
178
191
  # @return [::String]
179
192
  # Required. The name of the Cloud Pub/Sub topic to which messages will
180
193
  # be published when a job is delivered. The topic name must be in the
181
- # same format as required by PubSub's
194
+ # same format as required by Pub/Sub's
182
195
  # [PublishRequest.name](https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#publishrequest),
183
196
  # for example `projects/PROJECT_ID/topics/TOPIC_ID`.
184
197
  #
@@ -241,7 +254,7 @@ module Google
241
254
  #
242
255
  # Requests can only be sent to a specific instance if
243
256
  # [manual scaling is used in App Engine
244
- # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
257
+ # Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?#scaling_types_and_instance_classes).
245
258
  # App Engine Flex does not support instances. For more information, see
246
259
  # [App Engine Standard request
247
260
  # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
@@ -278,7 +291,8 @@ module Google
278
291
  # {::Google::Cloud::Scheduler::V1::AppEngineRouting#version version} `+ '.' +`
279
292
  # {::Google::Cloud::Scheduler::V1::AppEngineRouting#service service}
280
293
  #
281
- # * `instance =` {::Google::Cloud::Scheduler::V1::AppEngineRouting#instance instance}
294
+ # * `instance =`
295
+ # {::Google::Cloud::Scheduler::V1::AppEngineRouting#instance instance}
282
296
  #
283
297
  # * `instance_dot_service =`
284
298
  # {::Google::Cloud::Scheduler::V1::AppEngineRouting#instance instance} `+ '.' +`
@@ -294,19 +308,23 @@ module Google
294
308
  # {::Google::Cloud::Scheduler::V1::AppEngineRouting#service service}
295
309
  #
296
310
  #
297
- # If {::Google::Cloud::Scheduler::V1::AppEngineRouting#service service} is empty, then the job will be sent
298
- # to the service which is the default service when the job is attempted.
311
+ # If {::Google::Cloud::Scheduler::V1::AppEngineRouting#service service} is empty,
312
+ # then the job will be sent to the service which is the default service when
313
+ # the job is attempted.
299
314
  #
300
- # If {::Google::Cloud::Scheduler::V1::AppEngineRouting#version version} is empty, then the job will be sent
301
- # to the version which is the default version when the job is attempted.
315
+ # If {::Google::Cloud::Scheduler::V1::AppEngineRouting#version version} is empty,
316
+ # then the job will be sent to the version which is the default version when
317
+ # the job is attempted.
302
318
  #
303
- # If {::Google::Cloud::Scheduler::V1::AppEngineRouting#instance instance} is empty, then the job will be
304
- # sent to an instance which is available when the job is attempted.
319
+ # If {::Google::Cloud::Scheduler::V1::AppEngineRouting#instance instance} is
320
+ # empty, then the job will be sent to an instance which is available when the
321
+ # job is attempted.
305
322
  #
306
323
  # If {::Google::Cloud::Scheduler::V1::AppEngineRouting#service service},
307
324
  # {::Google::Cloud::Scheduler::V1::AppEngineRouting#version version}, or
308
- # {::Google::Cloud::Scheduler::V1::AppEngineRouting#instance instance} is invalid, then the job will be sent
309
- # to the default version of the default service when the job is attempted.
325
+ # {::Google::Cloud::Scheduler::V1::AppEngineRouting#instance instance} is invalid,
326
+ # then the job will be sent to the default version of the default service
327
+ # when the job is attempted.
310
328
  class AppEngineRouting
311
329
  include ::Google::Protobuf::MessageExts
312
330
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -26,8 +26,6 @@ module Google
26
26
  # service Foo {
27
27
  # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
28
28
  # }
29
- #
30
- # The JSON representation for `Empty` is empty JSON object `{}`.
31
29
  class Empty
32
30
  include ::Google::Protobuf::MessageExts
33
31
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -28,12 +28,14 @@ module Google
28
28
  # [API Design Guide](https://cloud.google.com/apis/design/errors).
29
29
  # @!attribute [rw] code
30
30
  # @return [::Integer]
31
- # The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
31
+ # The status code, which should be an enum value of
32
+ # [google.rpc.Code][google.rpc.Code].
32
33
  # @!attribute [rw] message
33
34
  # @return [::String]
34
35
  # A developer-facing error message, which should be in English. Any
35
36
  # user-facing error message should be localized and sent in the
36
- # {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized by the client.
37
+ # {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized
38
+ # by the client.
37
39
  # @!attribute [rw] details
38
40
  # @return [::Array<::Google::Protobuf::Any>]
39
41
  # A list of messages that carry the error details. There is a common set of
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-scheduler-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.5.0
4
+ version: 0.6.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: 2022-07-07 00:00:00.000000000 Z
11
+ date: 2023-03-06 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: '0.10'
19
+ version: 0.18.0
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: '0.10'
29
+ version: 0.18.0
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -44,20 +44,40 @@ dependencies:
44
44
  - - "~>"
45
45
  - !ruby/object:Gem::Version
46
46
  version: '1.0'
47
+ - !ruby/object:Gem::Dependency
48
+ name: google-cloud-location
49
+ requirement: !ruby/object:Gem::Requirement
50
+ requirements:
51
+ - - ">="
52
+ - !ruby/object:Gem::Version
53
+ version: '0.4'
54
+ - - "<"
55
+ - !ruby/object:Gem::Version
56
+ version: 2.a
57
+ type: :runtime
58
+ prerelease: false
59
+ version_requirements: !ruby/object:Gem::Requirement
60
+ requirements:
61
+ - - ">="
62
+ - !ruby/object:Gem::Version
63
+ version: '0.4'
64
+ - - "<"
65
+ - !ruby/object:Gem::Version
66
+ version: 2.a
47
67
  - !ruby/object:Gem::Dependency
48
68
  name: google-style
49
69
  requirement: !ruby/object:Gem::Requirement
50
70
  requirements:
51
71
  - - "~>"
52
72
  - !ruby/object:Gem::Version
53
- version: 1.26.1
73
+ version: 1.26.3
54
74
  type: :development
55
75
  prerelease: false
56
76
  version_requirements: !ruby/object:Gem::Requirement
57
77
  requirements:
58
78
  - - "~>"
59
79
  - !ruby/object:Gem::Version
60
- version: 1.26.1
80
+ version: 1.26.3
61
81
  - !ruby/object:Gem::Dependency
62
82
  name: minitest
63
83
  requirement: !ruby/object:Gem::Requirement
@@ -185,7 +205,9 @@ files:
185
205
  - lib/google/cloud/scheduler/v1/target_pb.rb
186
206
  - lib/google/cloud/scheduler/v1/version.rb
187
207
  - proto_docs/README.md
208
+ - proto_docs/google/api/client.rb
188
209
  - proto_docs/google/api/field_behavior.rb
210
+ - proto_docs/google/api/launch_stage.rb
189
211
  - proto_docs/google/api/resource.rb
190
212
  - proto_docs/google/cloud/scheduler/v1/cloudscheduler.rb
191
213
  - proto_docs/google/cloud/scheduler/v1/job.rb
@@ -215,8 +237,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
215
237
  - !ruby/object:Gem::Version
216
238
  version: '0'
217
239
  requirements: []
218
- rubygems_version: 3.3.14
240
+ rubygems_version: 3.4.2
219
241
  signing_key:
220
242
  specification_version: 4
221
- summary: API Client library for the Cloud Scheduler V1 API
243
+ summary: Creates and manages jobs run on a regular recurring schedule.
222
244
  test_files: []