public interface JobOrBuilder extends MessageOrBuilder
Implements
MessageOrBuilderMethods
getAppEngineHttpTarget()
public abstract AppEngineHttpTarget getAppEngineHttpTarget()
App Engine HTTP target.
.google.events.cloud.scheduler.v1.AppEngineHttpTarget app_engine_http_target = 5;
Returns | |
---|---|
Type | Description |
AppEngineHttpTarget |
The appEngineHttpTarget. |
getAppEngineHttpTargetOrBuilder()
public abstract AppEngineHttpTargetOrBuilder getAppEngineHttpTargetOrBuilder()
App Engine HTTP target.
.google.events.cloud.scheduler.v1.AppEngineHttpTarget app_engine_http_target = 5;
Returns | |
---|---|
Type | Description |
AppEngineHttpTargetOrBuilder |
getAttemptDeadline()
public abstract Duration getAttemptDeadline()
The deadline for job attempts. If the request handler does not respond by
this deadline then the request is cancelled and the attempt is marked as a
DEADLINE_EXCEEDED
failure. The failed attempt can be viewed in
execution logs. Cloud Scheduler will retry the job according
to the RetryConfig.
The default and the allowed values depend on the type of target:
- For HTTP targets, the default is 3 minutes. The deadline must be in the interval [15 seconds, 30 minutes].
- For App Engine HTTP targets, 0 indicates that the request has the default deadline. The default deadline depends on the scaling type of the service: 10 minutes for standard apps with automatic scaling, 24 hours for standard apps with manual and basic scaling, and 60 minutes for flex apps. If the request deadline is set, it must be in the interval [15 seconds, 24 hours 15 seconds].
- For Pub/Sub targets, this field is ignored.
.google.protobuf.Duration attempt_deadline = 22;
Returns | |
---|---|
Type | Description |
Duration |
The attemptDeadline. |
getAttemptDeadlineOrBuilder()
public abstract DurationOrBuilder getAttemptDeadlineOrBuilder()
The deadline for job attempts. If the request handler does not respond by
this deadline then the request is cancelled and the attempt is marked as a
DEADLINE_EXCEEDED
failure. The failed attempt can be viewed in
execution logs. Cloud Scheduler will retry the job according
to the RetryConfig.
The default and the allowed values depend on the type of target:
- For HTTP targets, the default is 3 minutes. The deadline must be in the interval [15 seconds, 30 minutes].
- For App Engine HTTP targets, 0 indicates that the request has the default deadline. The default deadline depends on the scaling type of the service: 10 minutes for standard apps with automatic scaling, 24 hours for standard apps with manual and basic scaling, and 60 minutes for flex apps. If the request deadline is set, it must be in the interval [15 seconds, 24 hours 15 seconds].
- For Pub/Sub targets, this field is ignored.
.google.protobuf.Duration attempt_deadline = 22;
Returns | |
---|---|
Type | Description |
DurationOrBuilder |
getDescription()
public abstract String getDescription()
Optionally caller-specified in CreateJob or UpdateJob. A human-readable description for the job. This string must not contain more than 500 characters.
string description = 2;
Returns | |
---|---|
Type | Description |
String |
The description. |
getDescriptionBytes()
public abstract ByteString getDescriptionBytes()
Optionally caller-specified in CreateJob or UpdateJob. A human-readable description for the job. This string must not contain more than 500 characters.
string description = 2;
Returns | |
---|---|
Type | Description |
ByteString |
The bytes for description. |
getHttpTarget()
public abstract HttpTarget getHttpTarget()
HTTP target.
.google.events.cloud.scheduler.v1.HttpTarget http_target = 6;
Returns | |
---|---|
Type | Description |
HttpTarget |
The httpTarget. |
getHttpTargetOrBuilder()
public abstract HttpTargetOrBuilder getHttpTargetOrBuilder()
HTTP target.
.google.events.cloud.scheduler.v1.HttpTarget http_target = 6;
Returns | |
---|---|
Type | Description |
HttpTargetOrBuilder |
getLastAttemptTime()
public abstract Timestamp getLastAttemptTime()
Output only. The time the last job attempt started.
.google.protobuf.Timestamp last_attempt_time = 18;
Returns | |
---|---|
Type | Description |
Timestamp |
The lastAttemptTime. |
getLastAttemptTimeOrBuilder()
public abstract TimestampOrBuilder getLastAttemptTimeOrBuilder()
Output only. The time the last job attempt started.
.google.protobuf.Timestamp last_attempt_time = 18;
Returns | |
---|---|
Type | Description |
TimestampOrBuilder |
getName()
public abstract String getName()
Optionally caller-specified in
CreateJob, after
which it becomes output only.
The job name. For example:
projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID
.
PROJECT_ID
can contain letters ([A-Za-z]), numbers ([0-9]), hyphens (-), colons (:), or periods (.). For more information, see Identifying projectsLOCATION_ID
is the canonical ID for the job's location. The list of available locations can be obtained by calling ListLocations. For more information, see https://cloud.google.com/about/locations/.JOB_ID
can contain only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), or underscores (_). The maximum length is 500 characters.
string name = 1;
Returns | |
---|---|
Type | Description |
String |
The name. |
getNameBytes()
public abstract ByteString getNameBytes()
Optionally caller-specified in
CreateJob, after
which it becomes output only.
The job name. For example:
projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID
.
PROJECT_ID
can contain letters ([A-Za-z]), numbers ([0-9]), hyphens (-), colons (:), or periods (.). For more information, see Identifying projectsLOCATION_ID
is the canonical ID for the job's location. The list of available locations can be obtained by calling ListLocations. For more information, see https://cloud.google.com/about/locations/.JOB_ID
can contain only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), or underscores (_). The maximum length is 500 characters.
string name = 1;
Returns | |
---|---|
Type | Description |
ByteString |
The bytes for name. |
getPubsubTarget()
public abstract PubsubTarget getPubsubTarget()
Pub/Sub target.
.google.events.cloud.scheduler.v1.PubsubTarget pubsub_target = 4;
Returns | |
---|---|
Type | Description |
PubsubTarget |
The pubsubTarget. |
getPubsubTargetOrBuilder()
public abstract PubsubTargetOrBuilder getPubsubTargetOrBuilder()
Pub/Sub target.
.google.events.cloud.scheduler.v1.PubsubTarget pubsub_target = 4;
Returns | |
---|---|
Type | Description |
PubsubTargetOrBuilder |
getRetryConfig()
public abstract RetryConfig getRetryConfig()
Settings that determine the retry behavior.
.google.events.cloud.scheduler.v1.RetryConfig retry_config = 19;
Returns | |
---|---|
Type | Description |
RetryConfig |
The retryConfig. |
getRetryConfigOrBuilder()
public abstract RetryConfigOrBuilder getRetryConfigOrBuilder()
Settings that determine the retry behavior.
.google.events.cloud.scheduler.v1.RetryConfig retry_config = 19;
Returns | |
---|---|
Type | Description |
RetryConfigOrBuilder |
getSchedule()
public abstract String getSchedule()
Required, except when used with UpdateJob. Describes the schedule on which the job will be executed. The schedule can be either of the following types:
- Crontab
- English-like
schedule
As a general rule, execution
n + 1
of a job will not begin until executionn
has finished. Cloud Scheduler will never allow two simultaneously outstanding executions. For example, this implies that if then+1
th execution is scheduled to run at 16:00 but then
th execution takes until 16:15, then+1
th execution will not start until16:15
. A scheduled start time will be delayed if the previous execution has not ended when its scheduled time occurs. If retry_count > 0 and a job attempt fails, the job will be tried a total of retry_count times, with exponential backoff, until the next scheduled start time. If retry_count is 0, a job attempt will not be retried if it fails. Instead the Cloud Scheduler system will wait for the next scheduled execution time. Setting retry_count to 0 does not prevent failed jobs from running according to schedule after the failure.
string schedule = 20;
Returns | |
---|---|
Type | Description |
String |
The schedule. |
getScheduleBytes()
public abstract ByteString getScheduleBytes()
Required, except when used with UpdateJob. Describes the schedule on which the job will be executed. The schedule can be either of the following types:
- Crontab
- English-like
schedule
As a general rule, execution
n + 1
of a job will not begin until executionn
has finished. Cloud Scheduler will never allow two simultaneously outstanding executions. For example, this implies that if then+1
th execution is scheduled to run at 16:00 but then
th execution takes until 16:15, then+1
th execution will not start until16:15
. A scheduled start time will be delayed if the previous execution has not ended when its scheduled time occurs. If retry_count > 0 and a job attempt fails, the job will be tried a total of retry_count times, with exponential backoff, until the next scheduled start time. If retry_count is 0, a job attempt will not be retried if it fails. Instead the Cloud Scheduler system will wait for the next scheduled execution time. Setting retry_count to 0 does not prevent failed jobs from running according to schedule after the failure.
string schedule = 20;
Returns | |
---|---|
Type | Description |
ByteString |
The bytes for schedule. |
getScheduleTime()
public abstract Timestamp getScheduleTime()
Output only. The next time the job is scheduled. Note that this may be a retry of a previously failed attempt or the next execution time according to the schedule.
.google.protobuf.Timestamp schedule_time = 17;
Returns | |
---|---|
Type | Description |
Timestamp |
The scheduleTime. |
getScheduleTimeOrBuilder()
public abstract TimestampOrBuilder getScheduleTimeOrBuilder()
Output only. The next time the job is scheduled. Note that this may be a retry of a previously failed attempt or the next execution time according to the schedule.
.google.protobuf.Timestamp schedule_time = 17;
Returns | |
---|---|
Type | Description |
TimestampOrBuilder |
getState()
public abstract Job.State getState()
Output only. State of the job.
.google.events.cloud.scheduler.v1.Job.State state = 10;
Returns | |
---|---|
Type | Description |
Job.State |
The state. |
getStateValue()
public abstract int getStateValue()
Output only. State of the job.
.google.events.cloud.scheduler.v1.Job.State state = 10;
Returns | |
---|---|
Type | Description |
int |
The enum numeric value on the wire for state. |
getStatus()
public abstract Status getStatus()
Output only. The response from the target for the last attempted execution.
.google.rpc.Status status = 11;
Returns | |
---|---|
Type | Description |
com.google.rpc.Status |
The status. |
getStatusOrBuilder()
public abstract StatusOrBuilder getStatusOrBuilder()
Output only. The response from the target for the last attempted execution.
.google.rpc.Status status = 11;
Returns | |
---|---|
Type | Description |
com.google.rpc.StatusOrBuilder |
getTargetCase()
public abstract Job.TargetCase getTargetCase()
Returns | |
---|---|
Type | Description |
Job.TargetCase |
getTimeZone()
public abstract String getTimeZone()
Specifies the time zone to be used in interpreting schedule. The value of this field must be a time zone name from the tz database. Note that some time zones include a provision for daylight savings time. The rules for daylight saving time are determined by the chosen tz. For UTC use the string "utc". If a time zone is not specified, the default will be in UTC (also known as GMT).
string time_zone = 21;
Returns | |
---|---|
Type | Description |
String |
The timeZone. |
getTimeZoneBytes()
public abstract ByteString getTimeZoneBytes()
Specifies the time zone to be used in interpreting schedule. The value of this field must be a time zone name from the tz database. Note that some time zones include a provision for daylight savings time. The rules for daylight saving time are determined by the chosen tz. For UTC use the string "utc". If a time zone is not specified, the default will be in UTC (also known as GMT).
string time_zone = 21;
Returns | |
---|---|
Type | Description |
ByteString |
The bytes for timeZone. |
getUserUpdateTime()
public abstract Timestamp getUserUpdateTime()
Output only. The creation time of the job.
.google.protobuf.Timestamp user_update_time = 9;
Returns | |
---|---|
Type | Description |
Timestamp |
The userUpdateTime. |
getUserUpdateTimeOrBuilder()
public abstract TimestampOrBuilder getUserUpdateTimeOrBuilder()
Output only. The creation time of the job.
.google.protobuf.Timestamp user_update_time = 9;
Returns | |
---|---|
Type | Description |
TimestampOrBuilder |
hasAppEngineHttpTarget()
public abstract boolean hasAppEngineHttpTarget()
App Engine HTTP target.
.google.events.cloud.scheduler.v1.AppEngineHttpTarget app_engine_http_target = 5;
Returns | |
---|---|
Type | Description |
boolean |
Whether the appEngineHttpTarget field is set. |
hasAttemptDeadline()
public abstract boolean hasAttemptDeadline()
The deadline for job attempts. If the request handler does not respond by
this deadline then the request is cancelled and the attempt is marked as a
DEADLINE_EXCEEDED
failure. The failed attempt can be viewed in
execution logs. Cloud Scheduler will retry the job according
to the RetryConfig.
The default and the allowed values depend on the type of target:
- For HTTP targets, the default is 3 minutes. The deadline must be in the interval [15 seconds, 30 minutes].
- For App Engine HTTP targets, 0 indicates that the request has the default deadline. The default deadline depends on the scaling type of the service: 10 minutes for standard apps with automatic scaling, 24 hours for standard apps with manual and basic scaling, and 60 minutes for flex apps. If the request deadline is set, it must be in the interval [15 seconds, 24 hours 15 seconds].
- For Pub/Sub targets, this field is ignored.
.google.protobuf.Duration attempt_deadline = 22;
Returns | |
---|---|
Type | Description |
boolean |
Whether the attemptDeadline field is set. |
hasHttpTarget()
public abstract boolean hasHttpTarget()
HTTP target.
.google.events.cloud.scheduler.v1.HttpTarget http_target = 6;
Returns | |
---|---|
Type | Description |
boolean |
Whether the httpTarget field is set. |
hasLastAttemptTime()
public abstract boolean hasLastAttemptTime()
Output only. The time the last job attempt started.
.google.protobuf.Timestamp last_attempt_time = 18;
Returns | |
---|---|
Type | Description |
boolean |
Whether the lastAttemptTime field is set. |
hasPubsubTarget()
public abstract boolean hasPubsubTarget()
Pub/Sub target.
.google.events.cloud.scheduler.v1.PubsubTarget pubsub_target = 4;
Returns | |
---|---|
Type | Description |
boolean |
Whether the pubsubTarget field is set. |
hasRetryConfig()
public abstract boolean hasRetryConfig()
Settings that determine the retry behavior.
.google.events.cloud.scheduler.v1.RetryConfig retry_config = 19;
Returns | |
---|---|
Type | Description |
boolean |
Whether the retryConfig field is set. |
hasScheduleTime()
public abstract boolean hasScheduleTime()
Output only. The next time the job is scheduled. Note that this may be a retry of a previously failed attempt or the next execution time according to the schedule.
.google.protobuf.Timestamp schedule_time = 17;
Returns | |
---|---|
Type | Description |
boolean |
Whether the scheduleTime field is set. |
hasStatus()
public abstract boolean hasStatus()
Output only. The response from the target for the last attempted execution.
.google.rpc.Status status = 11;
Returns | |
---|---|
Type | Description |
boolean |
Whether the status field is set. |
hasUserUpdateTime()
public abstract boolean hasUserUpdateTime()
Output only. The creation time of the job.
.google.protobuf.Timestamp user_update_time = 9;
Returns | |
---|---|
Type | Description |
boolean |
Whether the userUpdateTime field is set. |