Reference documentation and code samples for the Google Cloud Storage Transfer V1 Client class Schedule.
Transfers can be scheduled to recur or to run just once.
Generated from protobuf message google.storagetransfer.v1.Schedule
Namespace
Google \ Cloud \ StorageTransfer \ V1Methods
__construct
Constructor.
Parameters | |
---|---|
Name | Description |
data |
array
Optional. Data for populating the Message object. |
↳ schedule_start_date |
Google\Type\Date
Required. The start date of a transfer. Date boundaries are determined relative to UTC time. If |
↳ schedule_end_date |
Google\Type\Date
The last day a transfer runs. Date boundaries are determined relative to UTC time. A job runs once per 24 hours within the following guidelines: * * If |
↳ start_time_of_day |
Google\Type\TimeOfDay
The time in UTC that a transfer job is scheduled to run. Transfers may start later than this time. If |
↳ end_time_of_day |
Google\Type\TimeOfDay
The time in UTC that no further transfer operations are scheduled. Combined with schedule_end_date, |
↳ repeat_interval |
Google\Protobuf\Duration
Interval between the start of each scheduled TransferOperation. If unspecified, the default value is 24 hours. This value may not be less than 1 hour. |
getScheduleStartDate
Required. The start date of a transfer. Date boundaries are determined
relative to UTC time. If schedule_start_date
and
start_time_of_day
are in the past relative to the job's creation time, the transfer starts
the day after you schedule the transfer request.
Note: When starting jobs at or near midnight UTC it is possible that
a job starts later than expected. For example, if you send an outbound
request on June 1 one millisecond prior to midnight UTC and the Storage
Transfer Service server receives the request on June 2, then it creates
a TransferJob with schedule_start_date
set to June 2 and a
start_time_of_day
set to midnight UTC. The first scheduled
TransferOperation takes
place on June 3 at midnight UTC.
Returns | |
---|---|
Type | Description |
Google\Type\Date|null |
hasScheduleStartDate
clearScheduleStartDate
setScheduleStartDate
Required. The start date of a transfer. Date boundaries are determined
relative to UTC time. If schedule_start_date
and
start_time_of_day
are in the past relative to the job's creation time, the transfer starts
the day after you schedule the transfer request.
Note: When starting jobs at or near midnight UTC it is possible that
a job starts later than expected. For example, if you send an outbound
request on June 1 one millisecond prior to midnight UTC and the Storage
Transfer Service server receives the request on June 2, then it creates
a TransferJob with schedule_start_date
set to June 2 and a
start_time_of_day
set to midnight UTC. The first scheduled
TransferOperation takes
place on June 3 at midnight UTC.
Parameter | |
---|---|
Name | Description |
var |
Google\Type\Date
|
Returns | |
---|---|
Type | Description |
$this |
getScheduleEndDate
The last day a transfer runs. Date boundaries are determined relative to UTC time. A job runs once per 24 hours within the following guidelines:
If
schedule_end_date
and schedule_start_date are the same and in the future relative to UTC, the transfer is executed only one time.If
schedule_end_date
is later thanschedule_start_date
andschedule_end_date
is in the future relative to UTC, the job runs each day at start_time_of_day throughschedule_end_date
.
Returns | |
---|---|
Type | Description |
Google\Type\Date|null |
hasScheduleEndDate
clearScheduleEndDate
setScheduleEndDate
The last day a transfer runs. Date boundaries are determined relative to UTC time. A job runs once per 24 hours within the following guidelines:
If
schedule_end_date
and schedule_start_date are the same and in the future relative to UTC, the transfer is executed only one time.If
schedule_end_date
is later thanschedule_start_date
andschedule_end_date
is in the future relative to UTC, the job runs each day at start_time_of_day throughschedule_end_date
.
Parameter | |
---|---|
Name | Description |
var |
Google\Type\Date
|
Returns | |
---|---|
Type | Description |
$this |
getStartTimeOfDay
The time in UTC that a transfer job is scheduled to run. Transfers may start later than this time.
If start_time_of_day
is not specified:
- One-time transfers run immediately.
- Recurring transfers run immediately, and each day at midnight UTC,
through
schedule_end_date.
If
start_time_of_day
is specified: - One-time transfers run at the specified time.
- Recurring transfers run at the specified time each day, through
schedule_end_date
.
Returns | |
---|---|
Type | Description |
Google\Type\TimeOfDay|null |
hasStartTimeOfDay
clearStartTimeOfDay
setStartTimeOfDay
The time in UTC that a transfer job is scheduled to run. Transfers may start later than this time.
If start_time_of_day
is not specified:
- One-time transfers run immediately.
- Recurring transfers run immediately, and each day at midnight UTC,
through
schedule_end_date.
If
start_time_of_day
is specified: - One-time transfers run at the specified time.
- Recurring transfers run at the specified time each day, through
schedule_end_date
.
Parameter | |
---|---|
Name | Description |
var |
Google\Type\TimeOfDay
|
Returns | |
---|---|
Type | Description |
$this |
getEndTimeOfDay
The time in UTC that no further transfer operations are scheduled. Combined
with
schedule_end_date,
end_time_of_day
specifies the end date and time for starting new transfer
operations. This field must be greater than or equal to the timestamp
corresponding to the combintation of
schedule_start_date
and
start_time_of_day,
and is subject to the following:
If
end_time_of_day
is not set andschedule_end_date
is set, then a default value of23:59:59
is used forend_time_of_day
.If
end_time_of_day
is set andschedule_end_date
is not set, then INVALID_ARGUMENT is returned.
Returns | |
---|---|
Type | Description |
Google\Type\TimeOfDay|null |
hasEndTimeOfDay
clearEndTimeOfDay
setEndTimeOfDay
The time in UTC that no further transfer operations are scheduled. Combined
with
schedule_end_date,
end_time_of_day
specifies the end date and time for starting new transfer
operations. This field must be greater than or equal to the timestamp
corresponding to the combintation of
schedule_start_date
and
start_time_of_day,
and is subject to the following:
If
end_time_of_day
is not set andschedule_end_date
is set, then a default value of23:59:59
is used forend_time_of_day
.If
end_time_of_day
is set andschedule_end_date
is not set, then INVALID_ARGUMENT is returned.
Parameter | |
---|---|
Name | Description |
var |
Google\Type\TimeOfDay
|
Returns | |
---|---|
Type | Description |
$this |
getRepeatInterval
Interval between the start of each scheduled TransferOperation. If unspecified, the default value is 24 hours. This value may not be less than 1 hour.
Returns | |
---|---|
Type | Description |
Google\Protobuf\Duration|null |
hasRepeatInterval
clearRepeatInterval
setRepeatInterval
Interval between the start of each scheduled TransferOperation. If unspecified, the default value is 24 hours. This value may not be less than 1 hour.
Parameter | |
---|---|
Name | Description |
var |
Google\Protobuf\Duration
|
Returns | |
---|---|
Type | Description |
$this |