The APIs given below allow you to work with downtime schedules in Applications Manager:
The common parameters involved in these API requests are described below:
Field | Description |
---|---|
apikey | The key generated from the Generate API Key option in the Settings tab. |
taskName | The name of the maintenance task. This should be a unique value. |
taskType | The type of task to be created. Possible values are monitor (for an individual monitor) and group (for a monitor group) .You can configure a schedule for a monitor group by providing the tasktype as group. |
taskStatus | Current status of the schedule. You have to choose from either 'enable' or 'disable' |
dataCollectionType | This option allows you to stop either monitoring or alarms during maintenance. Possible parameter values are suppressMonitoring and suppressAlarms. |
taskid | The unique identifier for the task |
resourceid | The resource id of the monitor or monitor group for which the schedule has to be created |
This example helps you to create a downtime schedule in Applications Manager:
https://apm-prod-server:8443/AppManager/xml/CreateMaintenanceTask?apikey=aaaaaabbbbbbccccccddddddeeeeee&taskMethod=daily&taskStartTime=20:00&taskEndTime=21:00&taskStatus=disable&taskEffectFrom=2010-05-24%2016:48&taskName=dr1&taskType=monitor&resourceid=10000055
If the API is not executed correctly, the request will fail and errors will be thrown. Refer this page for a list of common error conditions.