Table of Contents
> Maintenance object
The following objects are directly related to the maintenance API.
Maintenance
The maintenance object has the following properties.
| Property | Type | Description |
|---|---|---|
| maintenanceid | string | (readonly) ID of the maintenance. |
| name (required) |
string | Name of the maintenance. |
| active_since (required) |
timestamp | Time when the maintenance becomes active. |
| active_till (required) |
timestamp | Time when the maintenance stops being active. |
| description | string | Description of the maintenance. |
| maintenance_type | integer | Type of maintenance. Possible values: 0 - (default) with data collection; 1 - without data collection. |
| tags_evaltype | integer | Problem tag evaluation method. Possible values: 0 - (default) And/Or; 2 - Or. |
Note that for some methods (update, delete) the required/optional parameter combination is different.
Time period
The time period object is used to define periods when the maintenance must come into effect. It has the following properties.
| Property | Type | Description |
|---|---|---|
| timeperiodid | string | (readonly) ID of the maintenance. |
| day | integer | Day of the month when the maintenance must come into effect. Required only for monthly time periods. |
| dayofweek | integer | Days of the week when the maintenance must come into effect. Possible bitmap values are: 1 - Monday; 2 - Tuesday; 4 - Wednesday; 8 - Thursday; 16 - Friday; 32 - Saturday; 64 - Sunday. This is a bitmask field; any sum of possible bitmap values is acceptable (for example, 21 for Monday, Wednesday, and Friday). Used for weekly and monthly time periods. Required only for weekly time periods. |
| every | integer | For daily and weekly periods every defines day or week intervals at which the maintenance must come into effect.For monthly periods every defines the week of the month when the maintenance must come into effect.Possible values: 1 - first week; 2 - second week; 3 - third week; 4 - fourth week; 5 - last week. |
| month | integer | Months when the maintenance must come into effect. Possible bitmap values are: 1 - January; 2 - February; 4 - March; 8 - April; 16 - May; 32 - June; 64 - July; 128 - August; 256 - September; 512 - October; 1024 - November; 2048 - December. This is a bitmask field; any sum of possible bitmap values is acceptable (for example, 585 for January, April, July, and October). Required only for monthly time periods. |
| period | integer | Duration of the maintenance period in seconds. Default: 3600. |
| start_date | timestamp | Date when the maintenance period must come into effect. Required only for one time periods. Default: current date. |
| start_time | integer | Time of day when the maintenance starts in seconds. Required for daily, weekly and monthly periods. |
| timeperiod_type | integer | Type of time period. Possible values: 0 - (default) one time only; 2 - daily; 3 - weekly; 4 - monthly. |
Problem tag
The problem tag object is used to define which problems must be suppressed when the maintenance comes into effect. It has the following properties.
| Property | Type | Description |
|---|---|---|
| tag (required) |
string | Problem tag name. |
| operator | integer | Condition operator. Possible values: 0 - Equals; 2 - (default) Contains. |
| value | string | Problem tag value. |
Tags can only be specified for maintenance periods with data collection ("maintenance_type":0).