Schedule(mapping=None, *, ignore_unknown_fields=False, **kwargs)
Transfers can be scheduled to recur or to run just once.
Attributes | |
---|---|
Name | Description |
schedule_start_date |
google.type.date_pb2.Date
Required. The start date of a transfer. Date boundaries are determined relative to UTC time. If schedule_start_date
and
start_time_of_day][google.storagetransfer.v1.Schedule.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][google.storagetransfer.v1.TransferOperation]
takes place on June 3 at midnight UTC.
|
schedule_end_date |
google.type.date_pb2.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 schedule_end_date and
schedule_start_date][google.storagetransfer.v1.Schedule.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 than
schedule_start_date and schedule_end_date is in
the future relative to UTC, the job runs each day at
start_time_of_day][google.storagetransfer.v1.Schedule.start_time_of_day]
through schedule_end_date .
|
start_time_of_day |
google.type.timeofday_pb2.TimeOfDay
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][google.storagetransfer.v1.Schedule.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 .
|
end_time_of_day |
google.type.timeofday_pb2.TimeOfDay
The time in UTC that no further transfer operations are scheduled. Combined with schedule_end_date][google.storagetransfer.v1.Schedule.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][google.storagetransfer.v1.Schedule.schedule_start_date]
and
start_time_of_day][google.storagetransfer.v1.Schedule.start_time_of_day] ,
and is subject to the following:
- If end_time_of_day is not set and
schedule_end_date is set, then a default value of
23:59:59 is used for end_time_of_day .
- If end_time_of_day is set and schedule_end_date
is not set, then
INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT] is
returned.
|
repeat_interval |
google.protobuf.duration_pb2.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. |