Infoblox::Grid::ScheduleSetting - a schedule setting object.


NAME

Infoblox::Grid::ScheduleSetting - a schedule setting object.


DESCRIPTION

An object that provides the ability to set the schedule for a discovery task.


CONSTRUCTOR

 my $schedule_setting = Infoblox::Grid::ScheduleSetting->new(
    frequency           => "DAILY" | "HOURLY" | "MONTHLY" | "WEEKLY",     # optional
    day_of_month        => $uint,                                         # optional
    every               => $uint,                                         # optional
    weekdays            => ["MONDAY", "THURSDAY", .... ],                 # optional
    hour_of_day         => $uint,                                         # optional
    minutes_past_hour   => $uint,                                         # optional
    month               => $uint,                                         # optional
    year                => $uint,                                         # optional
    repeat              => "ONCE" | "RECUR",                              # optional
    disable             => "true" | "false",                              # optional
    time_zone           => $time_zone,                                    # optional
 );


SESSION METHODS

The object does not support any session methods.


METHODS

This section describes all the methods that you can use to configure and retrieve attribute values of the scheduling object.

day_of_month( )

Use this method to set or retrieve the scheduled day of month when the discovery is triggered.

Parameter

Valid value is an unsigned integer between 1-31.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
 #Get attribute value
 my $value = $schedule_setting->day_of_month();
 #Modify attribute value
 $schedule_setting->day_of_month(10);

disable( )

Use this method to enable or disable scheduling of a discovery task.

Parameter

Specify "true" to disable scheduling or "false" to enable it. The default value is "false".

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
 #Get attribute value
 my $value = $schedule_setting->disable();
 #Modify attribute value
 $schedule_setting->disable("true");

every( )

Use this method to set or retrieve the recurrence pattern of a recurring discovery.

Parameter

Valid value is an unsigned integer.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
 #Get attribute value
 my $value = $schedule_setting->every();
 #Modify attribute value
 $schedule_setting->every(2);

frequency( )

Use this method ot set or retrieve the recurrence pattern of a recurring discovery.

Parameter

Valid value is "DAILY", "HOURLY", "MONTHLY" or "WEEKLY".

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
 #Get attribute value
 my $value = $schedule_setting->frequency();
 #Modify attribute value
 $schedule_setting->frequency("MONTHLY");

hour_of_day( )

Use this method to set or retrieve the hour, based on the 24-hour clock notation, when the discovery should start. For example, use 18 for 18:00.

Parameter

Valid value is an unsigned integer between 0-23.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
 #Get attribute value
 my $value = $schedule_setting->hour_of_day();
 #Modify attribute value
 $schedule_setting->hour_of_day(5);

month( )

Use this method to set or retrieve the month of the year when the discovery should start. For example, use 1 for January, 2 for February, and so on.

Parameter

Valid value is an unsigned integer between 1 and 12.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
 #Get attribute value
 my $value = $schedule_setting->month();
 #Modify attribute value
 $schedule_setting->month(10);

year( )

Use this method to set or retrieve the year when the discovery should start.

Parameter

Valid value is an unsigned integer.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
 #Get attribute value
 my $value = $schedule_setting->year();
 #Modify attribute value
 $schedule_setting->year(2015);

minutes_past_hour( )

Use this method to set or retrieve the minute, based on the 24-hour clock notation, when the discovery should start. For example, use 59 for 00:59.

Parameter

Valid value is an unsigned integer between 0-59.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
 #Get attribute value
 my $value = $schedule_setting->minutes_past_hour();
 #Modify attribute value
 $schedule_setting->minutes_past_hour(10);

repeat( )

Use this method to set or retrieve the flag that indicates if the discovery is scheduled for once or recurring.

Parameter

Valid value is "ONCE" or "RECUR".

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
 #Get attribute value
 my $value = $schedule_setting->repeat();
 #Modify attribute value
 $schedule_setting->repeat("RECUR");

time_zone( )

Use this method to set or retrieve the time zone.

Parameter

The UTC string that represents the time zone. For example "(UTC - 6:00) Central Time (US and Canada)". The default value is "(UTC) Coordinated Universal Time".

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
 #Get attribute value
 my $value = $schedule_setting->time_zone();
 #Modify attribute value
 $schedule_setting->time_zone("(UTC - 6:00) Central Time (US and Canada)");

weekdays( )

Use this method to set or retrieve the days of the week when the discovery is triggered.

Parameter

Valid value is a reference to an array that can contain the following values: 'SUNDAY', 'MONDAY', 'TUESDAY', 'WEDNESDAY', 'THURSDAY', 'FRIDAY' and 'SATURDAY'.

Returns

If you specified a parameter, the method returns true when the modification succeeds, and returns false when the operation fails.

If you did not specify a parameter, the method returns the attribute value.

Example
 #Get attribute value
 my $value = $schedule_setting->weekdays();
 #Modify attribute value
 $schedule_setting->weekdays(["MONDAY", "FRIDAY"]);


AUTHOR

Infoblox Inc. http://www.infoblox.com/


SEE ALSO

Infoblox::IPAM::DiscoveryTask


COPYRIGHT

Copyright (c) 2017 Infoblox Inc.