Struct google_api_proto::google::storagetransfer::v1::Schedule

pub struct Schedule {
    pub schedule_start_date: Option<Date>,
    pub schedule_end_date: Option<Date>,
    pub start_time_of_day: Option<TimeOfDay>,
    pub end_time_of_day: Option<TimeOfDay>,
    pub repeat_interval: Option<Duration>,
}

Transfers can be scheduled to recur or to run just once.

Fields

schedule_start_date: Option<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: Option<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: Option<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: Option<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: Option<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.

Trait Implementations

impl Clone for Schedule

fn clone(&self) -> Schedule

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Schedule

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Schedule

fn default() -> Self

Returns the “default value” for a type.

impl Message for Schedule

fn encoded_len(&self) -> usize

Returns the encoded length of the message without a length delimiter.

fn clear(&mut self)

Clears the message, resetting all fields to their default.

fn encode<B>(&self, buf: &mut B) -> Result<(), EncodeError>

where B: BufMut, Self: Sized,

Encodes the message to a buffer.

fn encode_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message to a newly allocated buffer.

fn encode_length_delimited<B>(&self, buf: &mut B) -> Result<(), EncodeError>

where B: BufMut, Self: Sized,

Encodes the message with a length-delimiter to a buffer.

fn encode_length_delimited_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message with a length-delimiter to a newly allocated buffer.

fn decode<B>(buf: B) -> Result<Self, DecodeError>

where B: Buf, Self: Default,

Decodes an instance of the message from a buffer.

fn decode_length_delimited<B>(buf: B) -> Result<Self, DecodeError>

where B: Buf, Self: Default,

Decodes a length-delimited instance of the message from the buffer.

fn merge<B>(&mut self, buf: B) -> Result<(), DecodeError>

where B: Buf, Self: Sized,

Decodes an instance of the message from a buffer, and merges it into self.

fn merge_length_delimited<B>(&mut self, buf: B) -> Result<(), DecodeError>

where B: Buf, Self: Sized,

Decodes a length-delimited instance of the message from buffer, and merges it into self.

impl PartialEq for Schedule

fn eq(&self, other: &Schedule) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Schedule