@@ -360,14 +360,22 @@ class Job
360
360
# @return [Google::Apis::CloudschedulerV1::PubsubTarget]
361
361
attr_accessor :pubsub_target
362
362
363
- # Settings that determine the retry behavior. By default, if a job does not
364
- # complete successfully (meaning that an acknowledgement is not received from
365
- # the handler, then it will be retried with exponential backoff according to the
366
- # settings in RetryConfig.
363
+ # Settings that determine the retry behavior. For more information, see [Retry
364
+ # jobs](https://cloud.google.com/scheduler/docs/configuring/retry-jobs). By
365
+ # default, if a job does not complete successfully (meaning that an
366
+ # acknowledgement is not received from the handler, then it will be retried with
367
+ # exponential backoff according to the settings in RetryConfig.
367
368
# Corresponds to the JSON property `retryConfig`
368
369
# @return [Google::Apis::CloudschedulerV1::RetryConfig]
369
370
attr_accessor :retry_config
370
371
372
+ # Output only. Whether or not this Job satisfies the requirements of physical
373
+ # zone separation
374
+ # Corresponds to the JSON property `satisfiesPzs`
375
+ # @return [Boolean]
376
+ attr_accessor :satisfies_pzs
377
+ alias_method :satisfies_pzs? , :satisfies_pzs
378
+
371
379
# Required, except when used with UpdateJob. Describes the schedule on which the
372
380
# job will be executed. The schedule can be either of the following types: * [
373
381
# Crontab](https://en.wikipedia.org/wiki/Cron#Overview) * English-like [schedule]
@@ -439,6 +447,7 @@ def update!(**args)
439
447
@name = args [ :name ] if args . key? ( :name )
440
448
@pubsub_target = args [ :pubsub_target ] if args . key? ( :pubsub_target )
441
449
@retry_config = args [ :retry_config ] if args . key? ( :retry_config )
450
+ @satisfies_pzs = args [ :satisfies_pzs ] if args . key? ( :satisfies_pzs )
442
451
@schedule = args [ :schedule ] if args . key? ( :schedule )
443
452
@schedule_time = args [ :schedule_time ] if args . key? ( :schedule_time )
444
453
@state = args [ :state ] if args . key? ( :state )
@@ -887,10 +896,11 @@ def update!(**args)
887
896
end
888
897
end
889
898
890
- # Settings that determine the retry behavior. By default, if a job does not
891
- # complete successfully (meaning that an acknowledgement is not received from
892
- # the handler, then it will be retried with exponential backoff according to the
893
- # settings in RetryConfig.
899
+ # Settings that determine the retry behavior. For more information, see [Retry
900
+ # jobs](https://cloud.google.com/scheduler/docs/configuring/retry-jobs). By
901
+ # default, if a job does not complete successfully (meaning that an
902
+ # acknowledgement is not received from the handler, then it will be retried with
903
+ # exponential backoff according to the settings in RetryConfig.
894
904
class RetryConfig
895
905
include Google ::Apis ::Core ::Hashable
896
906
@@ -903,21 +913,18 @@ class RetryConfig
903
913
# The time between retries will double `max_doublings` times. A job's retry
904
914
# interval starts at min_backoff_duration, then doubles `max_doublings` times,
905
915
# then increases linearly, and finally retries at intervals of
906
- # max_backoff_duration up to retry_count times. For example, if
907
- # min_backoff_duration is 10s, max_backoff_duration is 300s, and `max_doublings`
908
- # is 3, then the job will first be retried in 10s. The retry interval will
909
- # double three times, and then increase linearly by 2^3 * 10s. Finally, the job
910
- # will retry at intervals of max_backoff_duration until the job has been
911
- # attempted retry_count times. Thus, the requests will retry at 10s, 20s, 40s,
912
- # 80s, 160s, 240s, 300s, 300s, .... The default value of this field is 5.
916
+ # max_backoff_duration up to retry_count times. For examples, see [Retry jobs](
917
+ # https://cloud.google.com/scheduler/docs/configuring/retry-jobs#max-doublings).
918
+ # The default value of this field is 5.
913
919
# Corresponds to the JSON property `maxDoublings`
914
920
# @return [Fixnum]
915
921
attr_accessor :max_doublings
916
922
917
- # The time limit for retrying a failed job, measured from time when an execution
918
- # was first attempted. If specified with retry_count, the job will be retried
919
- # until both limits are reached. The default value for max_retry_duration is
920
- # zero, which means retry duration is unlimited.
923
+ # The time limit for retrying a failed job, measured from the time when an
924
+ # execution was first attempted. If specified with retry_count, the job will be
925
+ # retried until both limits are reached. The default value for
926
+ # max_retry_duration is zero, which means retry duration is unlimited. However,
927
+ # if retry_count is also 0, a job attempt won't be retried if it fails.
921
928
# Corresponds to the JSON property `maxRetryDuration`
922
929
# @return [String]
923
930
attr_accessor :max_retry_duration
@@ -930,14 +937,15 @@ class RetryConfig
930
937
931
938
# The number of attempts that the system will make to run a job using the
932
939
# exponential backoff procedure described by max_doublings. The default value of
933
- # retry_count is zero. If retry_count is 0, a job attempt will not be retried if
934
- # it fails. Instead the Cloud Scheduler system will wait for the next scheduled
935
- # execution time. Setting retry_count to 0 does not prevent failed jobs from
936
- # running according to schedule after the failure. If retry_count is set to a
937
- # non-zero number then Cloud Scheduler will retry failed attempts, using
938
- # exponential backoff, retry_count times, or until the next scheduled execution
939
- # time, whichever comes first. Values greater than 5 and negative values are not
940
- # allowed.
940
+ # retry_count is zero. If retry_count is 0 (and if max_retry_duration is also 0),
941
+ # a job attempt won't be retried if it fails. Instead, Cloud Scheduler system
942
+ # will wait for the next scheduled execution time. Setting retry_count to 0
943
+ # doesn't prevent failed jobs from running according to schedule after the
944
+ # failure. If retry_count is set to a non-zero number, Cloud Scheduler will
945
+ # retry the failed job, using exponential backoff, for retry_count times until
946
+ # the job succeeds or the number of retries is exhausted. Note that the next
947
+ # scheduled execution time might be skipped if the retries continue through that
948
+ # time. Values greater than 5 and negative values are not allowed.
941
949
# Corresponds to the JSON property `retryCount`
942
950
# @return [Fixnum]
943
951
attr_accessor :retry_count
0 commit comments