Skip to main content

downtimes

Creates, updates, deletes, gets or lists a downtimes resource.

Overview

Namedowntimes
TypeResource
Iddatadog.monitoring.downtimes

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringThe downtime ID. (example: 00000000-0000-1234-0000-000000000000)
attributesobjectDowntime match details.
typestringMonitor Downtime Match resource type. (default: downtime_match, example: downtime_match)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_monitor_downtimesselectmonitor_id, regionpage[offset], page[limit]Get all active downtimes for the specified monitor.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
monitor_idinteger (int64)The id of the monitor.
regionstring(default: datadoghq.com)
page[limit]integer (int64)Maximum number of downtimes in the response. (example: 100)
page[offset]integer (int64)Specific offset to use as the beginning of the returned page.

SELECT examples

Get all active downtimes for the specified monitor.

SELECT
id,
attributes,
type
FROM datadog.monitoring.downtimes
WHERE monitor_id = '{{ monitor_id }}' -- required
AND region = '{{ region }}' -- required
AND page[offset] = '{{ page[offset] }}'
AND page[limit] = '{{ page[limit] }}'
;