1. Packages
  2. Checkly
  3. API Docs
  4. DnsMonitor
Checkly v2.7.0 published on Tuesday, Nov 4, 2025 by Checkly
checkly/pulumi-checkly

checkly.DnsMonitor

Get Started
checkly logo
Checkly v2.7.0 published on Tuesday, Nov 4, 2025 by Checkly
checkly/pulumi-checkly

    Creates a DNS Monitor to check DNS record availability and response times.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as checkly from "@checkly/pulumi";

const example_dns_monitor = new checkly.DnsMonitor("example-dns-monitor", {
    name: "Example DNS monitor",
    activated: true,
    frequency: 2,
    useGlobalAlertSettings: true,
    locations: ["eu-west-1"],
    request: {
        recordType: "A",
        query: "welcome.checklyhq.com",
        nameServer: {
            host: "1.1.1.1",
            port: 53,
        },
        assertions: [{
            source: "RESPONSE_CODE",
            comparison: "EQUALS",
            target: "NOERROR",
        }],
    },
});

    import pulumi
import pulumi_checkly as checkly

example_dns_monitor = checkly.DnsMonitor("example-dns-monitor",
    name="Example DNS monitor",
    activated=True,
    frequency=2,
    use_global_alert_settings=True,
    locations=["eu-west-1"],
    request={
        "record_type": "A",
        "query": "welcome.checklyhq.com",
        "name_server": {
            "host": "1.1.1.1",
            "port": 53,
        },
        "assertions": [{
            "source": "RESPONSE_CODE",
            "comparison": "EQUALS",
            "target": "NOERROR",
        }],
    })

    package main

import (
	"github.com/checkly/pulumi-checkly/sdk/v2/go/checkly"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := checkly.NewDnsMonitor(ctx, "example-dns-monitor", &checkly.DnsMonitorArgs{
			Name:                   pulumi.String("Example DNS monitor"),
			Activated:              pulumi.Bool(true),
			Frequency:              pulumi.Int(2),
			UseGlobalAlertSettings: pulumi.Bool(true),
			Locations: pulumi.StringArray{
				pulumi.String("eu-west-1"),
			},
			Request: &checkly.DnsMonitorRequestArgs{
				RecordType: pulumi.String("A"),
				Query:      pulumi.String("welcome.checklyhq.com"),
				NameServer: &checkly.DnsMonitorRequestNameServerArgs{
					Host: pulumi.String("1.1.1.1"),
					Port: pulumi.Int(53),
				},
				Assertions: checkly.DnsMonitorRequestAssertionArray{
					&checkly.DnsMonitorRequestAssertionArgs{
						Source:     pulumi.String("RESPONSE_CODE"),
						Comparison: pulumi.String("EQUALS"),
						Target:     pulumi.String("NOERROR"),
					},
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Checkly = Pulumi.Checkly;

return await Deployment.RunAsync(() => 
{
    var example_dns_monitor = new Checkly.DnsMonitor("example-dns-monitor", new()
    {
        Name = "Example DNS monitor",
        Activated = true,
        Frequency = 2,
        UseGlobalAlertSettings = true,
        Locations = new[]
        {
            "eu-west-1",
        },
        Request = new Checkly.Inputs.DnsMonitorRequestArgs
        {
            RecordType = "A",
            Query = "welcome.checklyhq.com",
            NameServer = new Checkly.Inputs.DnsMonitorRequestNameServerArgs
            {
                Host = "1.1.1.1",
                Port = 53,
            },
            Assertions = new[]
            {
                new Checkly.Inputs.DnsMonitorRequestAssertionArgs
                {
                    Source = "RESPONSE_CODE",
                    Comparison = "EQUALS",
                    Target = "NOERROR",
                },
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.checkly.DnsMonitor;
import com.pulumi.checkly.DnsMonitorArgs;
import com.pulumi.checkly.inputs.DnsMonitorRequestArgs;
import com.pulumi.checkly.inputs.DnsMonitorRequestNameServerArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example_dns_monitor = new DnsMonitor("example-dns-monitor", DnsMonitorArgs.builder()
            .name("Example DNS monitor")
            .activated(true)
            .frequency(2)
            .useGlobalAlertSettings(true)
            .locations("eu-west-1")
            .request(DnsMonitorRequestArgs.builder()
                .recordType("A")
                .query("welcome.checklyhq.com")
                .nameServer(DnsMonitorRequestNameServerArgs.builder()
                    .host("1.1.1.1")
                    .port(53)
                    .build())
                .assertions(DnsMonitorRequestAssertionArgs.builder()
                    .source("RESPONSE_CODE")
                    .comparison("EQUALS")
                    .target("NOERROR")
                    .build())
                .build())
            .build());

    }
}

    resources:
  example-dns-monitor:
    type: checkly:DnsMonitor
    properties:
      name: Example DNS monitor
      activated: true
      frequency: 2
      useGlobalAlertSettings: true
      locations:
        - eu-west-1
      request:
        recordType: A
        query: welcome.checklyhq.com
        nameServer:
          host: 1.1.1.1
          port: 53
        assertions:
          - source: RESPONSE_CODE
            comparison: EQUALS
            target: NOERROR

    Create DnsMonitor Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new DnsMonitor(name: string, args: DnsMonitorArgs, opts?: CustomResourceOptions);
    @overload
def DnsMonitor(resource_name: str,
               args: DnsMonitorArgs,
               opts: Optional[ResourceOptions] = None)

@overload
def DnsMonitor(resource_name: str,
               opts: Optional[ResourceOptions] = None,
               request: Optional[DnsMonitorRequestArgs] = None,
               frequency: Optional[int] = None,
               activated: Optional[bool] = None,
               muted: Optional[bool] = None,
               max_response_time: Optional[int] = None,
               frequency_offset: Optional[int] = None,
               group_id: Optional[int] = None,
               group_order: Optional[int] = None,
               alert_channel_subscriptions: Optional[Sequence[DnsMonitorAlertChannelSubscriptionArgs]] = None,
               locations: Optional[Sequence[str]] = None,
               degraded_response_time: Optional[int] = None,
               name: Optional[str] = None,
               alert_settings: Optional[DnsMonitorAlertSettingsArgs] = None,
               retry_strategy: Optional[DnsMonitorRetryStrategyArgs] = None,
               run_parallel: Optional[bool] = None,
               tags: Optional[Sequence[str]] = None,
               trigger_incident: Optional[DnsMonitorTriggerIncidentArgs] = None,
               use_global_alert_settings: Optional[bool] = None)
    func NewDnsMonitor(ctx *Context, name string, args DnsMonitorArgs, opts ...ResourceOption) (*DnsMonitor, error)
    public DnsMonitor(string name, DnsMonitorArgs args, CustomResourceOptions? opts = null)
    public DnsMonitor(String name, DnsMonitorArgs args)
public DnsMonitor(String name, DnsMonitorArgs args, CustomResourceOptions options)

    type: checkly:DnsMonitor
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args DnsMonitorArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args DnsMonitorArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args DnsMonitorArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args DnsMonitorArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args DnsMonitorArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var dnsMonitorResource = new Checkly.DnsMonitor("dnsMonitorResource", new()
{
    Request = new Checkly.Inputs.DnsMonitorRequestArgs
    {
        Query = "string",
        RecordType = "string",
        Assertions = new[]
        {
            new Checkly.Inputs.DnsMonitorRequestAssertionArgs
            {
                Comparison = "string",
                Source = "string",
                Target = "string",
                Property = "string",
            },
        },
        NameServer = new Checkly.Inputs.DnsMonitorRequestNameServerArgs
        {
            Host = "string",
            Port = 0,
        },
        Protocol = "string",
    },
    Frequency = 0,
    Activated = false,
    Muted = false,
    MaxResponseTime = 0,
    FrequencyOffset = 0,
    GroupId = 0,
    GroupOrder = 0,
    AlertChannelSubscriptions = new[]
    {
        new Checkly.Inputs.DnsMonitorAlertChannelSubscriptionArgs
        {
            Activated = false,
            ChannelId = 0,
        },
    },
    Locations = new[]
    {
        "string",
    },
    DegradedResponseTime = 0,
    Name = "string",
    AlertSettings = new Checkly.Inputs.DnsMonitorAlertSettingsArgs
    {
        EscalationType = "string",
        ParallelRunFailureThresholds = new[]
        {
            new Checkly.Inputs.DnsMonitorAlertSettingsParallelRunFailureThresholdArgs
            {
                Enabled = false,
                Percentage = 0,
            },
        },
        Reminders = new[]
        {
            new Checkly.Inputs.DnsMonitorAlertSettingsReminderArgs
            {
                Amount = 0,
                Interval = 0,
            },
        },
        RunBasedEscalations = new[]
        {
            new Checkly.Inputs.DnsMonitorAlertSettingsRunBasedEscalationArgs
            {
                FailedRunThreshold = 0,
            },
        },
        TimeBasedEscalations = new[]
        {
            new Checkly.Inputs.DnsMonitorAlertSettingsTimeBasedEscalationArgs
            {
                MinutesFailingThreshold = 0,
            },
        },
    },
    RetryStrategy = new Checkly.Inputs.DnsMonitorRetryStrategyArgs
    {
        Type = "string",
        BaseBackoffSeconds = 0,
        MaxDurationSeconds = 0,
        MaxRetries = 0,
        OnlyOn = new Checkly.Inputs.DnsMonitorRetryStrategyOnlyOnArgs
        {
            NetworkError = false,
        },
        SameRegion = false,
    },
    RunParallel = false,
    Tags = new[]
    {
        "string",
    },
    TriggerIncident = new Checkly.Inputs.DnsMonitorTriggerIncidentArgs
    {
        Description = "string",
        Name = "string",
        NotifySubscribers = false,
        ServiceId = "string",
        Severity = "string",
    },
    UseGlobalAlertSettings = false,
});

    example, err := checkly.NewDnsMonitor(ctx, "dnsMonitorResource", &checkly.DnsMonitorArgs{
	Request: &checkly.DnsMonitorRequestArgs{
		Query:      pulumi.String("string"),
		RecordType: pulumi.String("string"),
		Assertions: checkly.DnsMonitorRequestAssertionArray{
			&checkly.DnsMonitorRequestAssertionArgs{
				Comparison: pulumi.String("string"),
				Source:     pulumi.String("string"),
				Target:     pulumi.String("string"),
				Property:   pulumi.String("string"),
			},
		},
		NameServer: &checkly.DnsMonitorRequestNameServerArgs{
			Host: pulumi.String("string"),
			Port: pulumi.Int(0),
		},
		Protocol: pulumi.String("string"),
	},
	Frequency:       pulumi.Int(0),
	Activated:       pulumi.Bool(false),
	Muted:           pulumi.Bool(false),
	MaxResponseTime: pulumi.Int(0),
	FrequencyOffset: pulumi.Int(0),
	GroupId:         pulumi.Int(0),
	GroupOrder:      pulumi.Int(0),
	AlertChannelSubscriptions: checkly.DnsMonitorAlertChannelSubscriptionArray{
		&checkly.DnsMonitorAlertChannelSubscriptionArgs{
			Activated: pulumi.Bool(false),
			ChannelId: pulumi.Int(0),
		},
	},
	Locations: pulumi.StringArray{
		pulumi.String("string"),
	},
	DegradedResponseTime: pulumi.Int(0),
	Name:                 pulumi.String("string"),
	AlertSettings: &checkly.DnsMonitorAlertSettingsArgs{
		EscalationType: pulumi.String("string"),
		ParallelRunFailureThresholds: checkly.DnsMonitorAlertSettingsParallelRunFailureThresholdArray{
			&checkly.DnsMonitorAlertSettingsParallelRunFailureThresholdArgs{
				Enabled:    pulumi.Bool(false),
				Percentage: pulumi.Int(0),
			},
		},
		Reminders: checkly.DnsMonitorAlertSettingsReminderArray{
			&checkly.DnsMonitorAlertSettingsReminderArgs{
				Amount:   pulumi.Int(0),
				Interval: pulumi.Int(0),
			},
		},
		RunBasedEscalations: checkly.DnsMonitorAlertSettingsRunBasedEscalationArray{
			&checkly.DnsMonitorAlertSettingsRunBasedEscalationArgs{
				FailedRunThreshold: pulumi.Int(0),
			},
		},
		TimeBasedEscalations: checkly.DnsMonitorAlertSettingsTimeBasedEscalationArray{
			&checkly.DnsMonitorAlertSettingsTimeBasedEscalationArgs{
				MinutesFailingThreshold: pulumi.Int(0),
			},
		},
	},
	RetryStrategy: &checkly.DnsMonitorRetryStrategyArgs{
		Type:               pulumi.String("string"),
		BaseBackoffSeconds: pulumi.Int(0),
		MaxDurationSeconds: pulumi.Int(0),
		MaxRetries:         pulumi.Int(0),
		OnlyOn: &checkly.DnsMonitorRetryStrategyOnlyOnArgs{
			NetworkError: pulumi.Bool(false),
		},
		SameRegion: pulumi.Bool(false),
	},
	RunParallel: pulumi.Bool(false),
	Tags: pulumi.StringArray{
		pulumi.String("string"),
	},
	TriggerIncident: &checkly.DnsMonitorTriggerIncidentArgs{
		Description:       pulumi.String("string"),
		Name:              pulumi.String("string"),
		NotifySubscribers: pulumi.Bool(false),
		ServiceId:         pulumi.String("string"),
		Severity:          pulumi.String("string"),
	},
	UseGlobalAlertSettings: pulumi.Bool(false),
})

    var dnsMonitorResource = new DnsMonitor("dnsMonitorResource", DnsMonitorArgs.builder()
    .request(DnsMonitorRequestArgs.builder()
        .query("string")
        .recordType("string")
        .assertions(DnsMonitorRequestAssertionArgs.builder()
            .comparison("string")
            .source("string")
            .target("string")
            .property("string")
            .build())
        .nameServer(DnsMonitorRequestNameServerArgs.builder()
            .host("string")
            .port(0)
            .build())
        .protocol("string")
        .build())
    .frequency(0)
    .activated(false)
    .muted(false)
    .maxResponseTime(0)
    .frequencyOffset(0)
    .groupId(0)
    .groupOrder(0)
    .alertChannelSubscriptions(DnsMonitorAlertChannelSubscriptionArgs.builder()
        .activated(false)
        .channelId(0)
        .build())
    .locations("string")
    .degradedResponseTime(0)
    .name("string")
    .alertSettings(DnsMonitorAlertSettingsArgs.builder()
        .escalationType("string")
        .parallelRunFailureThresholds(DnsMonitorAlertSettingsParallelRunFailureThresholdArgs.builder()
            .enabled(false)
            .percentage(0)
            .build())
        .reminders(DnsMonitorAlertSettingsReminderArgs.builder()
            .amount(0)
            .interval(0)
            .build())
        .runBasedEscalations(DnsMonitorAlertSettingsRunBasedEscalationArgs.builder()
            .failedRunThreshold(0)
            .build())
        .timeBasedEscalations(DnsMonitorAlertSettingsTimeBasedEscalationArgs.builder()
            .minutesFailingThreshold(0)
            .build())
        .build())
    .retryStrategy(DnsMonitorRetryStrategyArgs.builder()
        .type("string")
        .baseBackoffSeconds(0)
        .maxDurationSeconds(0)
        .maxRetries(0)
        .onlyOn(DnsMonitorRetryStrategyOnlyOnArgs.builder()
            .networkError(false)
            .build())
        .sameRegion(false)
        .build())
    .runParallel(false)
    .tags("string")
    .triggerIncident(DnsMonitorTriggerIncidentArgs.builder()
        .description("string")
        .name("string")
        .notifySubscribers(false)
        .serviceId("string")
        .severity("string")
        .build())
    .useGlobalAlertSettings(false)
    .build());

    dns_monitor_resource = checkly.DnsMonitor("dnsMonitorResource",
    request={
        "query": "string",
        "record_type": "string",
        "assertions": [{
            "comparison": "string",
            "source": "string",
            "target": "string",
            "property": "string",
        }],
        "name_server": {
            "host": "string",
            "port": 0,
        },
        "protocol": "string",
    },
    frequency=0,
    activated=False,
    muted=False,
    max_response_time=0,
    frequency_offset=0,
    group_id=0,
    group_order=0,
    alert_channel_subscriptions=[{
        "activated": False,
        "channel_id": 0,
    }],
    locations=["string"],
    degraded_response_time=0,
    name="string",
    alert_settings={
        "escalation_type": "string",
        "parallel_run_failure_thresholds": [{
            "enabled": False,
            "percentage": 0,
        }],
        "reminders": [{
            "amount": 0,
            "interval": 0,
        }],
        "run_based_escalations": [{
            "failed_run_threshold": 0,
        }],
        "time_based_escalations": [{
            "minutes_failing_threshold": 0,
        }],
    },
    retry_strategy={
        "type": "string",
        "base_backoff_seconds": 0,
        "max_duration_seconds": 0,
        "max_retries": 0,
        "only_on": {
            "network_error": False,
        },
        "same_region": False,
    },
    run_parallel=False,
    tags=["string"],
    trigger_incident={
        "description": "string",
        "name": "string",
        "notify_subscribers": False,
        "service_id": "string",
        "severity": "string",
    },
    use_global_alert_settings=False)

    const dnsMonitorResource = new checkly.DnsMonitor("dnsMonitorResource", {
    request: {
        query: "string",
        recordType: "string",
        assertions: [{
            comparison: "string",
            source: "string",
            target: "string",
            property: "string",
        }],
        nameServer: {
            host: "string",
            port: 0,
        },
        protocol: "string",
    },
    frequency: 0,
    activated: false,
    muted: false,
    maxResponseTime: 0,
    frequencyOffset: 0,
    groupId: 0,
    groupOrder: 0,
    alertChannelSubscriptions: [{
        activated: false,
        channelId: 0,
    }],
    locations: ["string"],
    degradedResponseTime: 0,
    name: "string",
    alertSettings: {
        escalationType: "string",
        parallelRunFailureThresholds: [{
            enabled: false,
            percentage: 0,
        }],
        reminders: [{
            amount: 0,
            interval: 0,
        }],
        runBasedEscalations: [{
            failedRunThreshold: 0,
        }],
        timeBasedEscalations: [{
            minutesFailingThreshold: 0,
        }],
    },
    retryStrategy: {
        type: "string",
        baseBackoffSeconds: 0,
        maxDurationSeconds: 0,
        maxRetries: 0,
        onlyOn: {
            networkError: false,
        },
        sameRegion: false,
    },
    runParallel: false,
    tags: ["string"],
    triggerIncident: {
        description: "string",
        name: "string",
        notifySubscribers: false,
        serviceId: "string",
        severity: "string",
    },
    useGlobalAlertSettings: false,
});

    type: checkly:DnsMonitor
properties:
    activated: false
    alertChannelSubscriptions:
        - activated: false
          channelId: 0
    alertSettings:
        escalationType: string
        parallelRunFailureThresholds:
            - enabled: false
              percentage: 0
        reminders:
            - amount: 0
              interval: 0
        runBasedEscalations:
            - failedRunThreshold: 0
        timeBasedEscalations:
            - minutesFailingThreshold: 0
    degradedResponseTime: 0
    frequency: 0
    frequencyOffset: 0
    groupId: 0
    groupOrder: 0
    locations:
        - string
    maxResponseTime: 0
    muted: false
    name: string
    request:
        assertions:
            - comparison: string
              property: string
              source: string
              target: string
        nameServer:
            host: string
            port: 0
        protocol: string
        query: string
        recordType: string
    retryStrategy:
        baseBackoffSeconds: 0
        maxDurationSeconds: 0
        maxRetries: 0
        onlyOn:
            networkError: false
        sameRegion: false
        type: string
    runParallel: false
    tags:
        - string
    triggerIncident:
        description: string
        name: string
        notifySubscribers: false
        serviceId: string
        severity: string
    useGlobalAlertSettings: false

    DnsMonitor Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The DnsMonitor resource accepts the following input properties:

    Activated bool
    Determines whether the monitor will run periodically or not after being deployed.
    Frequency int
    How often the monitor should run in minutes. Possible values are 0, 1, 2, 5, 10, 15, 30, 60, 120, 180, 360, 720, and 1440.
    Request DnsMonitorRequest
    The parameters of the HTTP request.
    AlertChannelSubscriptions List<DnsMonitorAlertChannelSubscription>
    An array of channel IDs and whether they're activated or not. If you don't set at least one alert subscription for your monitor, we won't be able to alert you.
    AlertSettings DnsMonitorAlertSettings
    Determines the alert escalation policy for the monitor.
    DegradedResponseTime int
    The response time in milliseconds where the monitor should be considered degraded. Possible values are between 0 and 5000. (Default 500).
    FrequencyOffset int
    To create a high frequency monitor, set frequency to 0 and frequency_offset to 10, 20, or 30.
    GroupId int
    The ID of the check group that this monitor is part of.
    GroupOrder int
    The position of the monitor in the check group. It determines in what order checks and monitors are run when a group is triggered from the API or from CI/CD.
    Locations List<string>
    An array of one or more data center locations where to run the this monitor.
    MaxResponseTime int
    The response time in milliseconds where the monitor should be considered failing. Possible values are between 0 and 5000. (Default 1000).
    Muted bool
    Determines if any notifications will be sent out when the monitor fails and/or recovers. (Default false).
    Name string
    The name of the monitor.
    RetryStrategy DnsMonitorRetryStrategy
    A strategy for retrying failed check/monitor runs.
    RunParallel bool
    Determines whether the monitor should run on all selected locations in parallel or round-robin. (Default false).
    Tags List<string>
    A list of tags for organizing and filtering checks and monitors.
    TriggerIncident DnsMonitorTriggerIncident
    Create and resolve an incident based on the alert configuration. Useful for status page automation.
    UseGlobalAlertSettings bool
    When true, the account level alert settings will be used, not the alert setting defined on this monitor. (Default true).
    Activated bool
    Determines whether the monitor will run periodically or not after being deployed.
    Frequency int
    How often the monitor should run in minutes. Possible values are 0, 1, 2, 5, 10, 15, 30, 60, 120, 180, 360, 720, and 1440.
    Request DnsMonitorRequestArgs
    The parameters of the HTTP request.
    AlertChannelSubscriptions []DnsMonitorAlertChannelSubscriptionArgs
    An array of channel IDs and whether they're activated or not. If you don't set at least one alert subscription for your monitor, we won't be able to alert you.
    AlertSettings DnsMonitorAlertSettingsArgs
    Determines the alert escalation policy for the monitor.
    DegradedResponseTime int
    The response time in milliseconds where the monitor should be considered degraded. Possible values are between 0 and 5000. (Default 500).
    FrequencyOffset int
    To create a high frequency monitor, set frequency to 0 and frequency_offset to 10, 20, or 30.
    GroupId int
    The ID of the check group that this monitor is part of.
    GroupOrder int
    The position of the monitor in the check group. It determines in what order checks and monitors are run when a group is triggered from the API or from CI/CD.
    Locations []string
    An array of one or more data center locations where to run the this monitor.
    MaxResponseTime int
    The response time in milliseconds where the monitor should be considered failing. Possible values are between 0 and 5000. (Default 1000).
    Muted bool
    Determines if any notifications will be sent out when the monitor fails and/or recovers. (Default false).
    Name string
    The name of the monitor.
    RetryStrategy DnsMonitorRetryStrategyArgs
    A strategy for retrying failed check/monitor runs.
    RunParallel bool
    Determines whether the monitor should run on all selected locations in parallel or round-robin. (Default false).
    Tags []string
    A list of tags for organizing and filtering checks and monitors.
    TriggerIncident DnsMonitorTriggerIncidentArgs
    Create and resolve an incident based on the alert configuration. Useful for status page automation.
    UseGlobalAlertSettings bool
    When true, the account level alert settings will be used, not the alert setting defined on this monitor. (Default true).
    activated Boolean
    Determines whether the monitor will run periodically or not after being deployed.
    frequency Integer
    How often the monitor should run in minutes. Possible values are 0, 1, 2, 5, 10, 15, 30, 60, 120, 180, 360, 720, and 1440.
    request DnsMonitorRequest
    The parameters of the HTTP request.
    alertChannelSubscriptions List<DnsMonitorAlertChannelSubscription>
    An array of channel IDs and whether they're activated or not. If you don't set at least one alert subscription for your monitor, we won't be able to alert you.
    alertSettings DnsMonitorAlertSettings
    Determines the alert escalation policy for the monitor.
    degradedResponseTime Integer
    The response time in milliseconds where the monitor should be considered degraded. Possible values are between 0 and 5000. (Default 500).
    frequencyOffset Integer
    To create a high frequency monitor, set frequency to 0 and frequency_offset to 10, 20, or 30.
    groupId Integer
    The ID of the check group that this monitor is part of.
    groupOrder Integer
    The position of the monitor in the check group. It determines in what order checks and monitors are run when a group is triggered from the API or from CI/CD.
    locations List<String>
    An array of one or more data center locations where to run the this monitor.
    maxResponseTime Integer
    The response time in milliseconds where the monitor should be considered failing. Possible values are between 0 and 5000. (Default 1000).
    muted Boolean
    Determines if any notifications will be sent out when the monitor fails and/or recovers. (Default false).
    name String
    The name of the monitor.
    retryStrategy DnsMonitorRetryStrategy
    A strategy for retrying failed check/monitor runs.
    runParallel Boolean
    Determines whether the monitor should run on all selected locations in parallel or round-robin. (Default false).
    tags List<String>
    A list of tags for organizing and filtering checks and monitors.
    triggerIncident DnsMonitorTriggerIncident
    Create and resolve an incident based on the alert configuration. Useful for status page automation.
    useGlobalAlertSettings Boolean
    When true, the account level alert settings will be used, not the alert setting defined on this monitor. (Default true).
    activated boolean
    Determines whether the monitor will run periodically or not after being deployed.
    frequency number
    How often the monitor should run in minutes. Possible values are 0, 1, 2, 5, 10, 15, 30, 60, 120, 180, 360, 720, and 1440.
    request DnsMonitorRequest
    The parameters of the HTTP request.
    alertChannelSubscriptions DnsMonitorAlertChannelSubscription[]
    An array of channel IDs and whether they're activated or not. If you don't set at least one alert subscription for your monitor, we won't be able to alert you.
    alertSettings DnsMonitorAlertSettings
    Determines the alert escalation policy for the monitor.
    degradedResponseTime number
    The response time in milliseconds where the monitor should be considered degraded. Possible values are between 0 and 5000. (Default 500).
    frequencyOffset number
    To create a high frequency monitor, set frequency to 0 and frequency_offset to 10, 20, or 30.
    groupId number
    The ID of the check group that this monitor is part of.
    groupOrder number
    The position of the monitor in the check group. It determines in what order checks and monitors are run when a group is triggered from the API or from CI/CD.
    locations string[]
    An array of one or more data center locations where to run the this monitor.
    maxResponseTime number
    The response time in milliseconds where the monitor should be considered failing. Possible values are between 0 and 5000. (Default 1000).
    muted boolean
    Determines if any notifications will be sent out when the monitor fails and/or recovers. (Default false).
    name string
    The name of the monitor.
    retryStrategy DnsMonitorRetryStrategy
    A strategy for retrying failed check/monitor runs.
    runParallel boolean
    Determines whether the monitor should run on all selected locations in parallel or round-robin. (Default false).
    tags string[]
    A list of tags for organizing and filtering checks and monitors.
    triggerIncident DnsMonitorTriggerIncident
    Create and resolve an incident based on the alert configuration. Useful for status page automation.
    useGlobalAlertSettings boolean
    When true, the account level alert settings will be used, not the alert setting defined on this monitor. (Default true).
    activated bool
    Determines whether the monitor will run periodically or not after being deployed.
    frequency int
    How often the monitor should run in minutes. Possible values are 0, 1, 2, 5, 10, 15, 30, 60, 120, 180, 360, 720, and 1440.
    request DnsMonitorRequestArgs
    The parameters of the HTTP request.
    alert_channel_subscriptions Sequence[DnsMonitorAlertChannelSubscriptionArgs]
    An array of channel IDs and whether they're activated or not. If you don't set at least one alert subscription for your monitor, we won't be able to alert you.
    alert_settings DnsMonitorAlertSettingsArgs
    Determines the alert escalation policy for the monitor.
    degraded_response_time int
    The response time in milliseconds where the monitor should be considered degraded. Possible values are between 0 and 5000. (Default 500).
    frequency_offset int
    To create a high frequency monitor, set frequency to 0 and frequency_offset to 10, 20, or 30.
    group_id int
    The ID of the check group that this monitor is part of.
    group_order int
    The position of the monitor in the check group. It determines in what order checks and monitors are run when a group is triggered from the API or from CI/CD.
    locations Sequence[str]
    An array of one or more data center locations where to run the this monitor.
    max_response_time int
    The response time in milliseconds where the monitor should be considered failing. Possible values are between 0 and 5000. (Default 1000).
    muted bool
    Determines if any notifications will be sent out when the monitor fails and/or recovers. (Default false).
    name str
    The name of the monitor.
    retry_strategy DnsMonitorRetryStrategyArgs
    A strategy for retrying failed check/monitor runs.
    run_parallel bool
    Determines whether the monitor should run on all selected locations in parallel or round-robin. (Default false).
    tags Sequence[str]
    A list of tags for organizing and filtering checks and monitors.
    trigger_incident DnsMonitorTriggerIncidentArgs
    Create and resolve an incident based on the alert configuration. Useful for status page automation.
    use_global_alert_settings bool
    When true, the account level alert settings will be used, not the alert setting defined on this monitor. (Default true).
    activated Boolean
    Determines whether the monitor will run periodically or not after being deployed.
    frequency Number
    How often the monitor should run in minutes. Possible values are 0, 1, 2, 5, 10, 15, 30, 60, 120, 180, 360, 720, and 1440.
    request Property Map
    The parameters of the HTTP request.
    alertChannelSubscriptions List<Property Map>
    An array of channel IDs and whether they're activated or not. If you don't set at least one alert subscription for your monitor, we won't be able to alert you.
    alertSettings Property Map
    Determines the alert escalation policy for the monitor.
    degradedResponseTime Number
    The response time in milliseconds where the monitor should be considered degraded. Possible values are between 0 and 5000. (Default 500).
    frequencyOffset Number
    To create a high frequency monitor, set frequency to 0 and frequency_offset to 10, 20, or 30.
    groupId Number
    The ID of the check group that this monitor is part of.
    groupOrder Number
    The position of the monitor in the check group. It determines in what order checks and monitors are run when a group is triggered from the API or from CI/CD.
    locations List<String>
    An array of one or more data center locations where to run the this monitor.
    maxResponseTime Number
    The response time in milliseconds where the monitor should be considered failing. Possible values are between 0 and 5000. (Default 1000).
    muted Boolean
    Determines if any notifications will be sent out when the monitor fails and/or recovers. (Default false).
    name String
    The name of the monitor.
    retryStrategy Property Map
    A strategy for retrying failed check/monitor runs.
    runParallel Boolean
    Determines whether the monitor should run on all selected locations in parallel or round-robin. (Default false).
    tags List<String>
    A list of tags for organizing and filtering checks and monitors.
    triggerIncident Property Map
    Create and resolve an incident based on the alert configuration. Useful for status page automation.
    useGlobalAlertSettings Boolean
    When true, the account level alert settings will be used, not the alert setting defined on this monitor. (Default true).

    Outputs

    All input properties are implicitly available as output properties. Additionally, the DnsMonitor resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing DnsMonitor Resource

    Get an existing DnsMonitor resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: DnsMonitorState, opts?: CustomResourceOptions): DnsMonitor
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        activated: Optional[bool] = None,
        alert_channel_subscriptions: Optional[Sequence[DnsMonitorAlertChannelSubscriptionArgs]] = None,
        alert_settings: Optional[DnsMonitorAlertSettingsArgs] = None,
        degraded_response_time: Optional[int] = None,
        frequency: Optional[int] = None,
        frequency_offset: Optional[int] = None,
        group_id: Optional[int] = None,
        group_order: Optional[int] = None,
        locations: Optional[Sequence[str]] = None,
        max_response_time: Optional[int] = None,
        muted: Optional[bool] = None,
        name: Optional[str] = None,
        request: Optional[DnsMonitorRequestArgs] = None,
        retry_strategy: Optional[DnsMonitorRetryStrategyArgs] = None,
        run_parallel: Optional[bool] = None,
        tags: Optional[Sequence[str]] = None,
        trigger_incident: Optional[DnsMonitorTriggerIncidentArgs] = None,
        use_global_alert_settings: Optional[bool] = None) -> DnsMonitor
    func GetDnsMonitor(ctx *Context, name string, id IDInput, state *DnsMonitorState, opts ...ResourceOption) (*DnsMonitor, error)
    public static DnsMonitor Get(string name, Input<string> id, DnsMonitorState? state, CustomResourceOptions? opts = null)
    public static DnsMonitor get(String name, Output<String> id, DnsMonitorState state, CustomResourceOptions options)
    resources:  _:    type: checkly:DnsMonitor    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Activated bool
    Determines whether the monitor will run periodically or not after being deployed.
    AlertChannelSubscriptions List<DnsMonitorAlertChannelSubscription>
    An array of channel IDs and whether they're activated or not. If you don't set at least one alert subscription for your monitor, we won't be able to alert you.
    AlertSettings DnsMonitorAlertSettings
    Determines the alert escalation policy for the monitor.
    DegradedResponseTime int
    The response time in milliseconds where the monitor should be considered degraded. Possible values are between 0 and 5000. (Default 500).
    Frequency int
    How often the monitor should run in minutes. Possible values are 0, 1, 2, 5, 10, 15, 30, 60, 120, 180, 360, 720, and 1440.
    FrequencyOffset int
    To create a high frequency monitor, set frequency to 0 and frequency_offset to 10, 20, or 30.
    GroupId int
    The ID of the check group that this monitor is part of.
    GroupOrder int
    The position of the monitor in the check group. It determines in what order checks and monitors are run when a group is triggered from the API or from CI/CD.
    Locations List<string>
    An array of one or more data center locations where to run the this monitor.
    MaxResponseTime int
    The response time in milliseconds where the monitor should be considered failing. Possible values are between 0 and 5000. (Default 1000).
    Muted bool
    Determines if any notifications will be sent out when the monitor fails and/or recovers. (Default false).
    Name string
    The name of the monitor.
    Request DnsMonitorRequest
    The parameters of the HTTP request.
    RetryStrategy DnsMonitorRetryStrategy
    A strategy for retrying failed check/monitor runs.
    RunParallel bool
    Determines whether the monitor should run on all selected locations in parallel or round-robin. (Default false).
    Tags List<string>
    A list of tags for organizing and filtering checks and monitors.
    TriggerIncident DnsMonitorTriggerIncident
    Create and resolve an incident based on the alert configuration. Useful for status page automation.
    UseGlobalAlertSettings bool
    When true, the account level alert settings will be used, not the alert setting defined on this monitor. (Default true).
    Activated bool
    Determines whether the monitor will run periodically or not after being deployed.
    AlertChannelSubscriptions []DnsMonitorAlertChannelSubscriptionArgs
    An array of channel IDs and whether they're activated or not. If you don't set at least one alert subscription for your monitor, we won't be able to alert you.
    AlertSettings DnsMonitorAlertSettingsArgs
    Determines the alert escalation policy for the monitor.
    DegradedResponseTime int
    The response time in milliseconds where the monitor should be considered degraded. Possible values are between 0 and 5000. (Default 500).
    Frequency int
    How often the monitor should run in minutes. Possible values are 0, 1, 2, 5, 10, 15, 30, 60, 120, 180, 360, 720, and 1440.
    FrequencyOffset int
    To create a high frequency monitor, set frequency to 0 and frequency_offset to 10, 20, or 30.
    GroupId int
    The ID of the check group that this monitor is part of.
    GroupOrder int
    The position of the monitor in the check group. It determines in what order checks and monitors are run when a group is triggered from the API or from CI/CD.
    Locations []string
    An array of one or more data center locations where to run the this monitor.
    MaxResponseTime int
    The response time in milliseconds where the monitor should be considered failing. Possible values are between 0 and 5000. (Default 1000).
    Muted bool
    Determines if any notifications will be sent out when the monitor fails and/or recovers. (Default false).
    Name string
    The name of the monitor.
    Request DnsMonitorRequestArgs
    The parameters of the HTTP request.
    RetryStrategy DnsMonitorRetryStrategyArgs
    A strategy for retrying failed check/monitor runs.
    RunParallel bool
    Determines whether the monitor should run on all selected locations in parallel or round-robin. (Default false).
    Tags []string
    A list of tags for organizing and filtering checks and monitors.
    TriggerIncident DnsMonitorTriggerIncidentArgs
    Create and resolve an incident based on the alert configuration. Useful for status page automation.
    UseGlobalAlertSettings bool
    When true, the account level alert settings will be used, not the alert setting defined on this monitor. (Default true).
    activated Boolean
    Determines whether the monitor will run periodically or not after being deployed.
    alertChannelSubscriptions List<DnsMonitorAlertChannelSubscription>
    An array of channel IDs and whether they're activated or not. If you don't set at least one alert subscription for your monitor, we won't be able to alert you.
    alertSettings DnsMonitorAlertSettings
    Determines the alert escalation policy for the monitor.
    degradedResponseTime Integer
    The response time in milliseconds where the monitor should be considered degraded. Possible values are between 0 and 5000. (Default 500).
    frequency Integer
    How often the monitor should run in minutes. Possible values are 0, 1, 2, 5, 10, 15, 30, 60, 120, 180, 360, 720, and 1440.
    frequencyOffset Integer
    To create a high frequency monitor, set frequency to 0 and frequency_offset to 10, 20, or 30.
    groupId Integer
    The ID of the check group that this monitor is part of.
    groupOrder Integer
    The position of the monitor in the check group. It determines in what order checks and monitors are run when a group is triggered from the API or from CI/CD.
    locations List<String>
    An array of one or more data center locations where to run the this monitor.
    maxResponseTime Integer
    The response time in milliseconds where the monitor should be considered failing. Possible values are between 0 and 5000. (Default 1000).
    muted Boolean
    Determines if any notifications will be sent out when the monitor fails and/or recovers. (Default false).
    name String
    The name of the monitor.
    request DnsMonitorRequest
    The parameters of the HTTP request.
    retryStrategy DnsMonitorRetryStrategy
    A strategy for retrying failed check/monitor runs.
    runParallel Boolean
    Determines whether the monitor should run on all selected locations in parallel or round-robin. (Default false).
    tags List<String>
    A list of tags for organizing and filtering checks and monitors.
    triggerIncident DnsMonitorTriggerIncident
    Create and resolve an incident based on the alert configuration. Useful for status page automation.
    useGlobalAlertSettings Boolean
    When true, the account level alert settings will be used, not the alert setting defined on this monitor. (Default true).
    activated boolean
    Determines whether the monitor will run periodically or not after being deployed.
    alertChannelSubscriptions DnsMonitorAlertChannelSubscription[]
    An array of channel IDs and whether they're activated or not. If you don't set at least one alert subscription for your monitor, we won't be able to alert you.
    alertSettings DnsMonitorAlertSettings
    Determines the alert escalation policy for the monitor.
    degradedResponseTime number
    The response time in milliseconds where the monitor should be considered degraded. Possible values are between 0 and 5000. (Default 500).
    frequency number
    How often the monitor should run in minutes. Possible values are 0, 1, 2, 5, 10, 15, 30, 60, 120, 180, 360, 720, and 1440.
    frequencyOffset number
    To create a high frequency monitor, set frequency to 0 and frequency_offset to 10, 20, or 30.
    groupId number
    The ID of the check group that this monitor is part of.
    groupOrder number
    The position of the monitor in the check group. It determines in what order checks and monitors are run when a group is triggered from the API or from CI/CD.
    locations string[]
    An array of one or more data center locations where to run the this monitor.
    maxResponseTime number
    The response time in milliseconds where the monitor should be considered failing. Possible values are between 0 and 5000. (Default 1000).
    muted boolean
    Determines if any notifications will be sent out when the monitor fails and/or recovers. (Default false).
    name string
    The name of the monitor.
    request DnsMonitorRequest
    The parameters of the HTTP request.
    retryStrategy DnsMonitorRetryStrategy
    A strategy for retrying failed check/monitor runs.
    runParallel boolean
    Determines whether the monitor should run on all selected locations in parallel or round-robin. (Default false).
    tags string[]
    A list of tags for organizing and filtering checks and monitors.
    triggerIncident DnsMonitorTriggerIncident
    Create and resolve an incident based on the alert configuration. Useful for status page automation.
    useGlobalAlertSettings boolean
    When true, the account level alert settings will be used, not the alert setting defined on this monitor. (Default true).
    activated bool
    Determines whether the monitor will run periodically or not after being deployed.
    alert_channel_subscriptions Sequence[DnsMonitorAlertChannelSubscriptionArgs]
    An array of channel IDs and whether they're activated or not. If you don't set at least one alert subscription for your monitor, we won't be able to alert you.
    alert_settings DnsMonitorAlertSettingsArgs
    Determines the alert escalation policy for the monitor.
    degraded_response_time int
    The response time in milliseconds where the monitor should be considered degraded. Possible values are between 0 and 5000. (Default 500).
    frequency int
    How often the monitor should run in minutes. Possible values are 0, 1, 2, 5, 10, 15, 30, 60, 120, 180, 360, 720, and 1440.
    frequency_offset int
    To create a high frequency monitor, set frequency to 0 and frequency_offset to 10, 20, or 30.
    group_id int
    The ID of the check group that this monitor is part of.
    group_order int
    The position of the monitor in the check group. It determines in what order checks and monitors are run when a group is triggered from the API or from CI/CD.
    locations Sequence[str]
    An array of one or more data center locations where to run the this monitor.
    max_response_time int
    The response time in milliseconds where the monitor should be considered failing. Possible values are between 0 and 5000. (Default 1000).
    muted bool
    Determines if any notifications will be sent out when the monitor fails and/or recovers. (Default false).
    name str
    The name of the monitor.
    request DnsMonitorRequestArgs
    The parameters of the HTTP request.
    retry_strategy DnsMonitorRetryStrategyArgs
    A strategy for retrying failed check/monitor runs.
    run_parallel bool
    Determines whether the monitor should run on all selected locations in parallel or round-robin. (Default false).
    tags Sequence[str]
    A list of tags for organizing and filtering checks and monitors.
    trigger_incident DnsMonitorTriggerIncidentArgs
    Create and resolve an incident based on the alert configuration. Useful for status page automation.
    use_global_alert_settings bool
    When true, the account level alert settings will be used, not the alert setting defined on this monitor. (Default true).
    activated Boolean
    Determines whether the monitor will run periodically or not after being deployed.
    alertChannelSubscriptions List<Property Map>
    An array of channel IDs and whether they're activated or not. If you don't set at least one alert subscription for your monitor, we won't be able to alert you.
    alertSettings Property Map
    Determines the alert escalation policy for the monitor.
    degradedResponseTime Number
    The response time in milliseconds where the monitor should be considered degraded. Possible values are between 0 and 5000. (Default 500).
    frequency Number
    How often the monitor should run in minutes. Possible values are 0, 1, 2, 5, 10, 15, 30, 60, 120, 180, 360, 720, and 1440.
    frequencyOffset Number
    To create a high frequency monitor, set frequency to 0 and frequency_offset to 10, 20, or 30.
    groupId Number
    The ID of the check group that this monitor is part of.
    groupOrder Number
    The position of the monitor in the check group. It determines in what order checks and monitors are run when a group is triggered from the API or from CI/CD.
    locations List<String>
    An array of one or more data center locations where to run the this monitor.
    maxResponseTime Number
    The response time in milliseconds where the monitor should be considered failing. Possible values are between 0 and 5000. (Default 1000).
    muted Boolean
    Determines if any notifications will be sent out when the monitor fails and/or recovers. (Default false).
    name String
    The name of the monitor.
    request Property Map
    The parameters of the HTTP request.
    retryStrategy Property Map
    A strategy for retrying failed check/monitor runs.
    runParallel Boolean
    Determines whether the monitor should run on all selected locations in parallel or round-robin. (Default false).
    tags List<String>
    A list of tags for organizing and filtering checks and monitors.
    triggerIncident Property Map
    Create and resolve an incident based on the alert configuration. Useful for status page automation.
    useGlobalAlertSettings Boolean
    When true, the account level alert settings will be used, not the alert setting defined on this monitor. (Default true).

    Supporting Types

    DnsMonitorAlertChannelSubscription, DnsMonitorAlertChannelSubscriptionArgs

    Activated bool
    Whether an alert should be sent to this channel.
    ChannelId int
    The ID of the alert channel.
    Activated bool
    Whether an alert should be sent to this channel.
    ChannelId int
    The ID of the alert channel.
    activated Boolean
    Whether an alert should be sent to this channel.
    channelId Integer
    The ID of the alert channel.
    activated boolean
    Whether an alert should be sent to this channel.
    channelId number
    The ID of the alert channel.
    activated bool
    Whether an alert should be sent to this channel.
    channel_id int
    The ID of the alert channel.
    activated Boolean
    Whether an alert should be sent to this channel.
    channelId Number
    The ID of the alert channel.

    DnsMonitorAlertSettings, DnsMonitorAlertSettingsArgs

    EscalationType string
    Determines the type of escalation to use. Possible values are RUN_BASED and TIME_BASED. (Default RUN_BASED).
    ParallelRunFailureThresholds List<DnsMonitorAlertSettingsParallelRunFailureThreshold>
    Configuration for parallel run failure threshold.
    Reminders List<DnsMonitorAlertSettingsReminder>
    Defines how often to send reminder notifications after initial alert.
    RunBasedEscalations List<DnsMonitorAlertSettingsRunBasedEscalation>
    Configuration for run-based escalation.
    TimeBasedEscalations List<DnsMonitorAlertSettingsTimeBasedEscalation>
    Configuration for time-based escalation.
    EscalationType string
    Determines the type of escalation to use. Possible values are RUN_BASED and TIME_BASED. (Default RUN_BASED).
    ParallelRunFailureThresholds []DnsMonitorAlertSettingsParallelRunFailureThreshold
    Configuration for parallel run failure threshold.
    Reminders []DnsMonitorAlertSettingsReminder
    Defines how often to send reminder notifications after initial alert.
    RunBasedEscalations []DnsMonitorAlertSettingsRunBasedEscalation
    Configuration for run-based escalation.
    TimeBasedEscalations []DnsMonitorAlertSettingsTimeBasedEscalation
    Configuration for time-based escalation.
    escalationType String
    Determines the type of escalation to use. Possible values are RUN_BASED and TIME_BASED. (Default RUN_BASED).
    parallelRunFailureThresholds List<DnsMonitorAlertSettingsParallelRunFailureThreshold>
    Configuration for parallel run failure threshold.
    reminders List<DnsMonitorAlertSettingsReminder>
    Defines how often to send reminder notifications after initial alert.
    runBasedEscalations List<DnsMonitorAlertSettingsRunBasedEscalation>
    Configuration for run-based escalation.
    timeBasedEscalations List<DnsMonitorAlertSettingsTimeBasedEscalation>
    Configuration for time-based escalation.
    escalationType string
    Determines the type of escalation to use. Possible values are RUN_BASED and TIME_BASED. (Default RUN_BASED).
    parallelRunFailureThresholds DnsMonitorAlertSettingsParallelRunFailureThreshold[]
    Configuration for parallel run failure threshold.
    reminders DnsMonitorAlertSettingsReminder[]
    Defines how often to send reminder notifications after initial alert.
    runBasedEscalations DnsMonitorAlertSettingsRunBasedEscalation[]
    Configuration for run-based escalation.
    timeBasedEscalations DnsMonitorAlertSettingsTimeBasedEscalation[]
    Configuration for time-based escalation.
    escalation_type str
    Determines the type of escalation to use. Possible values are RUN_BASED and TIME_BASED. (Default RUN_BASED).
    parallel_run_failure_thresholds Sequence[DnsMonitorAlertSettingsParallelRunFailureThreshold]
    Configuration for parallel run failure threshold.
    reminders Sequence[DnsMonitorAlertSettingsReminder]
    Defines how often to send reminder notifications after initial alert.
    run_based_escalations Sequence[DnsMonitorAlertSettingsRunBasedEscalation]
    Configuration for run-based escalation.
    time_based_escalations Sequence[DnsMonitorAlertSettingsTimeBasedEscalation]
    Configuration for time-based escalation.
    escalationType String
    Determines the type of escalation to use. Possible values are RUN_BASED and TIME_BASED. (Default RUN_BASED).
    parallelRunFailureThresholds List<Property Map>
    Configuration for parallel run failure threshold.
    reminders List<Property Map>
    Defines how often to send reminder notifications after initial alert.
    runBasedEscalations List<Property Map>
    Configuration for run-based escalation.
    timeBasedEscalations List<Property Map>
    Configuration for time-based escalation.

    DnsMonitorAlertSettingsParallelRunFailureThreshold, DnsMonitorAlertSettingsParallelRunFailureThresholdArgs

    Enabled bool
    Whether parallel run failure threshold is enabled. Only applies if the monitor is scheduled for multiple locations in parallel. (Default false).
    Percentage int
    Percentage of runs that must fail to trigger alert. Possible values are 10, 20, 30, 40, 50, 60, 70, 80, 90, and 100. (Default 10).
    Enabled bool
    Whether parallel run failure threshold is enabled. Only applies if the monitor is scheduled for multiple locations in parallel. (Default false).
    Percentage int
    Percentage of runs that must fail to trigger alert. Possible values are 10, 20, 30, 40, 50, 60, 70, 80, 90, and 100. (Default 10).
    enabled Boolean
    Whether parallel run failure threshold is enabled. Only applies if the monitor is scheduled for multiple locations in parallel. (Default false).
    percentage Integer
    Percentage of runs that must fail to trigger alert. Possible values are 10, 20, 30, 40, 50, 60, 70, 80, 90, and 100. (Default 10).
    enabled boolean
    Whether parallel run failure threshold is enabled. Only applies if the monitor is scheduled for multiple locations in parallel. (Default false).
    percentage number
    Percentage of runs that must fail to trigger alert. Possible values are 10, 20, 30, 40, 50, 60, 70, 80, 90, and 100. (Default 10).
    enabled bool
    Whether parallel run failure threshold is enabled. Only applies if the monitor is scheduled for multiple locations in parallel. (Default false).
    percentage int
    Percentage of runs that must fail to trigger alert. Possible values are 10, 20, 30, 40, 50, 60, 70, 80, 90, and 100. (Default 10).
    enabled Boolean
    Whether parallel run failure threshold is enabled. Only applies if the monitor is scheduled for multiple locations in parallel. (Default false).
    percentage Number
    Percentage of runs that must fail to trigger alert. Possible values are 10, 20, 30, 40, 50, 60, 70, 80, 90, and 100. (Default 10).

    DnsMonitorAlertSettingsReminder, DnsMonitorAlertSettingsReminderArgs

    Amount int
    Number of reminder notifications to send. Possible values are 0, 1, 2, 3, 4, 5, and 100000 (0 to disable, 100000 for unlimited). (Default 0).
    Interval int
    Interval between reminder notifications in minutes. Possible values are 5, 10, 15, and 30. (Default 5).
    Amount int
    Number of reminder notifications to send. Possible values are 0, 1, 2, 3, 4, 5, and 100000 (0 to disable, 100000 for unlimited). (Default 0).
    Interval int
    Interval between reminder notifications in minutes. Possible values are 5, 10, 15, and 30. (Default 5).
    amount Integer
    Number of reminder notifications to send. Possible values are 0, 1, 2, 3, 4, 5, and 100000 (0 to disable, 100000 for unlimited). (Default 0).
    interval Integer
    Interval between reminder notifications in minutes. Possible values are 5, 10, 15, and 30. (Default 5).
    amount number
    Number of reminder notifications to send. Possible values are 0, 1, 2, 3, 4, 5, and 100000 (0 to disable, 100000 for unlimited). (Default 0).
    interval number
    Interval between reminder notifications in minutes. Possible values are 5, 10, 15, and 30. (Default 5).
    amount int
    Number of reminder notifications to send. Possible values are 0, 1, 2, 3, 4, 5, and 100000 (0 to disable, 100000 for unlimited). (Default 0).
    interval int
    Interval between reminder notifications in minutes. Possible values are 5, 10, 15, and 30. (Default 5).
    amount Number
    Number of reminder notifications to send. Possible values are 0, 1, 2, 3, 4, 5, and 100000 (0 to disable, 100000 for unlimited). (Default 0).
    interval Number
    Interval between reminder notifications in minutes. Possible values are 5, 10, 15, and 30. (Default 5).

    DnsMonitorAlertSettingsRunBasedEscalation, DnsMonitorAlertSettingsRunBasedEscalationArgs

    FailedRunThreshold int
    Send an alert notification after the given number of consecutive monitor runs have failed. Possible values are between 1 and 5. (Default 1).
    FailedRunThreshold int
    Send an alert notification after the given number of consecutive monitor runs have failed. Possible values are between 1 and 5. (Default 1).
    failedRunThreshold Integer
    Send an alert notification after the given number of consecutive monitor runs have failed. Possible values are between 1 and 5. (Default 1).
    failedRunThreshold number
    Send an alert notification after the given number of consecutive monitor runs have failed. Possible values are between 1 and 5. (Default 1).
    failed_run_threshold int
    Send an alert notification after the given number of consecutive monitor runs have failed. Possible values are between 1 and 5. (Default 1).
    failedRunThreshold Number
    Send an alert notification after the given number of consecutive monitor runs have failed. Possible values are between 1 and 5. (Default 1).

    DnsMonitorAlertSettingsTimeBasedEscalation, DnsMonitorAlertSettingsTimeBasedEscalationArgs

    MinutesFailingThreshold int
    Send an alert notification after the monitor has been failing for the given amount of time (in minutes). Possible values are 5, 10, 15, and 30. (Default 5).
    MinutesFailingThreshold int
    Send an alert notification after the monitor has been failing for the given amount of time (in minutes). Possible values are 5, 10, 15, and 30. (Default 5).
    minutesFailingThreshold Integer
    Send an alert notification after the monitor has been failing for the given amount of time (in minutes). Possible values are 5, 10, 15, and 30. (Default 5).
    minutesFailingThreshold number
    Send an alert notification after the monitor has been failing for the given amount of time (in minutes). Possible values are 5, 10, 15, and 30. (Default 5).
    minutes_failing_threshold int
    Send an alert notification after the monitor has been failing for the given amount of time (in minutes). Possible values are 5, 10, 15, and 30. (Default 5).
    minutesFailingThreshold Number
    Send an alert notification after the monitor has been failing for the given amount of time (in minutes). Possible values are 5, 10, 15, and 30. (Default 5).

    DnsMonitorRequest, DnsMonitorRequestArgs

    Query string
    The DNS record to query.
    RecordType string
    The DNS record type. Possible values are A, AAAA, CNAME, MX, NS, TXT and SOA.
    Assertions List<DnsMonitorRequestAssertion>
    Assertions to validate the HTTP response. DNS monitors only support status code assertions.
    NameServer DnsMonitorRequestNameServer
    The name server to use.
    Protocol string
    The protocol used to communicate with the name server. Possible values are UDP and TCP. (Default UDP).
    Query string
    The DNS record to query.
    RecordType string
    The DNS record type. Possible values are A, AAAA, CNAME, MX, NS, TXT and SOA.
    Assertions []DnsMonitorRequestAssertion
    Assertions to validate the HTTP response. DNS monitors only support status code assertions.
    NameServer DnsMonitorRequestNameServer
    The name server to use.
    Protocol string
    The protocol used to communicate with the name server. Possible values are UDP and TCP. (Default UDP).
    query String
    The DNS record to query.
    recordType String
    The DNS record type. Possible values are A, AAAA, CNAME, MX, NS, TXT and SOA.
    assertions List<DnsMonitorRequestAssertion>
    Assertions to validate the HTTP response. DNS monitors only support status code assertions.
    nameServer DnsMonitorRequestNameServer
    The name server to use.
    protocol String
    The protocol used to communicate with the name server. Possible values are UDP and TCP. (Default UDP).
    query string
    The DNS record to query.
    recordType string
    The DNS record type. Possible values are A, AAAA, CNAME, MX, NS, TXT and SOA.
    assertions DnsMonitorRequestAssertion[]
    Assertions to validate the HTTP response. DNS monitors only support status code assertions.
    nameServer DnsMonitorRequestNameServer
    The name server to use.
    protocol string
    The protocol used to communicate with the name server. Possible values are UDP and TCP. (Default UDP).
    query str
    The DNS record to query.
    record_type str
    The DNS record type. Possible values are A, AAAA, CNAME, MX, NS, TXT and SOA.
    assertions Sequence[DnsMonitorRequestAssertion]
    Assertions to validate the HTTP response. DNS monitors only support status code assertions.
    name_server DnsMonitorRequestNameServer
    The name server to use.
    protocol str
    The protocol used to communicate with the name server. Possible values are UDP and TCP. (Default UDP).
    query String
    The DNS record to query.
    recordType String
    The DNS record type. Possible values are A, AAAA, CNAME, MX, NS, TXT and SOA.
    assertions List<Property Map>
    Assertions to validate the HTTP response. DNS monitors only support status code assertions.
    nameServer Property Map
    The name server to use.
    protocol String
    The protocol used to communicate with the name server. Possible values are UDP and TCP. (Default UDP).

    DnsMonitorRequestAssertion, DnsMonitorRequestAssertionArgs

    Comparison string
    The type of comparison to be executed between expected and actual value of the assertion. Possible values are EQUALS, NOT_EQUALS, GREATER_THAN and LESS_THAN.
    Source string
    The source of the asserted value. Possible values are RESPONSE_CODE, RESPONSE_TIME, TEXT_ANSWER and JSON_ANSWER.
    Target string
    The target value. Typically NOERROR when the source is RESPONSE_CODE.
    Property string
    Comparison string
    The type of comparison to be executed between expected and actual value of the assertion. Possible values are EQUALS, NOT_EQUALS, GREATER_THAN and LESS_THAN.
    Source string
    The source of the asserted value. Possible values are RESPONSE_CODE, RESPONSE_TIME, TEXT_ANSWER and JSON_ANSWER.
    Target string
    The target value. Typically NOERROR when the source is RESPONSE_CODE.
    Property string
    comparison String
    The type of comparison to be executed between expected and actual value of the assertion. Possible values are EQUALS, NOT_EQUALS, GREATER_THAN and LESS_THAN.
    source String
    The source of the asserted value. Possible values are RESPONSE_CODE, RESPONSE_TIME, TEXT_ANSWER and JSON_ANSWER.
    target String
    The target value. Typically NOERROR when the source is RESPONSE_CODE.
    property String
    comparison string
    The type of comparison to be executed between expected and actual value of the assertion. Possible values are EQUALS, NOT_EQUALS, GREATER_THAN and LESS_THAN.
    source string
    The source of the asserted value. Possible values are RESPONSE_CODE, RESPONSE_TIME, TEXT_ANSWER and JSON_ANSWER.
    target string
    The target value. Typically NOERROR when the source is RESPONSE_CODE.
    property string
    comparison str
    The type of comparison to be executed between expected and actual value of the assertion. Possible values are EQUALS, NOT_EQUALS, GREATER_THAN and LESS_THAN.
    source str
    The source of the asserted value. Possible values are RESPONSE_CODE, RESPONSE_TIME, TEXT_ANSWER and JSON_ANSWER.
    target str
    The target value. Typically NOERROR when the source is RESPONSE_CODE.
    property str
    comparison String
    The type of comparison to be executed between expected and actual value of the assertion. Possible values are EQUALS, NOT_EQUALS, GREATER_THAN and LESS_THAN.
    source String
    The source of the asserted value. Possible values are RESPONSE_CODE, RESPONSE_TIME, TEXT_ANSWER and JSON_ANSWER.
    target String
    The target value. Typically NOERROR when the source is RESPONSE_CODE.
    property String

    DnsMonitorRequestNameServer, DnsMonitorRequestNameServerArgs

    Host string
    The name server host.
    Port int
    The name server port.
    Host string
    The name server host.
    Port int
    The name server port.
    host String
    The name server host.
    port Integer
    The name server port.
    host string
    The name server host.
    port number
    The name server port.
    host str
    The name server host.
    port int
    The name server port.
    host String
    The name server host.
    port Number
    The name server port.

    DnsMonitorRetryStrategy, DnsMonitorRetryStrategyArgs

    Type string
    Determines which type of retry strategy to use. Possible values are FIXED, LINEAR, EXPONENTIAL, SINGLE_RETRY, and NO_RETRIES.
    BaseBackoffSeconds int
    The number of seconds to wait before the first retry attempt. (Default 60).
    MaxDurationSeconds int
    The total amount of time to continue retrying the check/monitor (maximum 600 seconds). Available when type is FIXED, LINEAR, or EXPONENTIAL. (Default 600).
    MaxRetries int
    The maximum number of times to retry the check/monitor. Value must be between 1 and 10. Available when type is FIXED, LINEAR, or EXPONENTIAL. (Default 2).
    OnlyOn DnsMonitorRetryStrategyOnlyOn
    Apply the retry strategy only if the defined conditions match.
    SameRegion bool
    Whether retries should be run in the same region as the initial check/monitor run. (Default true).
    Type string
    Determines which type of retry strategy to use. Possible values are FIXED, LINEAR, EXPONENTIAL, SINGLE_RETRY, and NO_RETRIES.
    BaseBackoffSeconds int
    The number of seconds to wait before the first retry attempt. (Default 60).
    MaxDurationSeconds int
    The total amount of time to continue retrying the check/monitor (maximum 600 seconds). Available when type is FIXED, LINEAR, or EXPONENTIAL. (Default 600).
    MaxRetries int
    The maximum number of times to retry the check/monitor. Value must be between 1 and 10. Available when type is FIXED, LINEAR, or EXPONENTIAL. (Default 2).
    OnlyOn DnsMonitorRetryStrategyOnlyOn
    Apply the retry strategy only if the defined conditions match.
    SameRegion bool
    Whether retries should be run in the same region as the initial check/monitor run. (Default true).
    type String
    Determines which type of retry strategy to use. Possible values are FIXED, LINEAR, EXPONENTIAL, SINGLE_RETRY, and NO_RETRIES.
    baseBackoffSeconds Integer
    The number of seconds to wait before the first retry attempt. (Default 60).
    maxDurationSeconds Integer
    The total amount of time to continue retrying the check/monitor (maximum 600 seconds). Available when type is FIXED, LINEAR, or EXPONENTIAL. (Default 600).
    maxRetries Integer
    The maximum number of times to retry the check/monitor. Value must be between 1 and 10. Available when type is FIXED, LINEAR, or EXPONENTIAL. (Default 2).
    onlyOn DnsMonitorRetryStrategyOnlyOn
    Apply the retry strategy only if the defined conditions match.
    sameRegion Boolean
    Whether retries should be run in the same region as the initial check/monitor run. (Default true).
    type string
    Determines which type of retry strategy to use. Possible values are FIXED, LINEAR, EXPONENTIAL, SINGLE_RETRY, and NO_RETRIES.
    baseBackoffSeconds number
    The number of seconds to wait before the first retry attempt. (Default 60).
    maxDurationSeconds number
    The total amount of time to continue retrying the check/monitor (maximum 600 seconds). Available when type is FIXED, LINEAR, or EXPONENTIAL. (Default 600).
    maxRetries number
    The maximum number of times to retry the check/monitor. Value must be between 1 and 10. Available when type is FIXED, LINEAR, or EXPONENTIAL. (Default 2).
    onlyOn DnsMonitorRetryStrategyOnlyOn
    Apply the retry strategy only if the defined conditions match.
    sameRegion boolean
    Whether retries should be run in the same region as the initial check/monitor run. (Default true).
    type str
    Determines which type of retry strategy to use. Possible values are FIXED, LINEAR, EXPONENTIAL, SINGLE_RETRY, and NO_RETRIES.
    base_backoff_seconds int
    The number of seconds to wait before the first retry attempt. (Default 60).
    max_duration_seconds int
    The total amount of time to continue retrying the check/monitor (maximum 600 seconds). Available when type is FIXED, LINEAR, or EXPONENTIAL. (Default 600).
    max_retries int
    The maximum number of times to retry the check/monitor. Value must be between 1 and 10. Available when type is FIXED, LINEAR, or EXPONENTIAL. (Default 2).
    only_on DnsMonitorRetryStrategyOnlyOn
    Apply the retry strategy only if the defined conditions match.
    same_region bool
    Whether retries should be run in the same region as the initial check/monitor run. (Default true).
    type String
    Determines which type of retry strategy to use. Possible values are FIXED, LINEAR, EXPONENTIAL, SINGLE_RETRY, and NO_RETRIES.
    baseBackoffSeconds Number
    The number of seconds to wait before the first retry attempt. (Default 60).
    maxDurationSeconds Number
    The total amount of time to continue retrying the check/monitor (maximum 600 seconds). Available when type is FIXED, LINEAR, or EXPONENTIAL. (Default 600).
    maxRetries Number
    The maximum number of times to retry the check/monitor. Value must be between 1 and 10. Available when type is FIXED, LINEAR, or EXPONENTIAL. (Default 2).
    onlyOn Property Map
    Apply the retry strategy only if the defined conditions match.
    sameRegion Boolean
    Whether retries should be run in the same region as the initial check/monitor run. (Default true).

    DnsMonitorRetryStrategyOnlyOn, DnsMonitorRetryStrategyOnlyOnArgs

    NetworkError bool
    When true, retry only if the cause of the failure is a network error. (Default false).
    NetworkError bool
    When true, retry only if the cause of the failure is a network error. (Default false).
    networkError Boolean
    When true, retry only if the cause of the failure is a network error. (Default false).
    networkError boolean
    When true, retry only if the cause of the failure is a network error. (Default false).
    network_error bool
    When true, retry only if the cause of the failure is a network error. (Default false).
    networkError Boolean
    When true, retry only if the cause of the failure is a network error. (Default false).

    DnsMonitorTriggerIncident, DnsMonitorTriggerIncidentArgs

    Description string
    A detailed description of the incident.
    Name string
    The name of the incident.
    NotifySubscribers bool
    Whether to notify subscribers when the incident is triggered.
    ServiceId string
    The status page service that this incident will be associated with.
    Severity string
    The severity level of the incident. Possible values are MINOR, MEDIUM, MAJOR, and CRITICAL.
    Description string
    A detailed description of the incident.
    Name string
    The name of the incident.
    NotifySubscribers bool
    Whether to notify subscribers when the incident is triggered.
    ServiceId string
    The status page service that this incident will be associated with.
    Severity string
    The severity level of the incident. Possible values are MINOR, MEDIUM, MAJOR, and CRITICAL.
    description String
    A detailed description of the incident.
    name String
    The name of the incident.
    notifySubscribers Boolean
    Whether to notify subscribers when the incident is triggered.
    serviceId String
    The status page service that this incident will be associated with.
    severity String
    The severity level of the incident. Possible values are MINOR, MEDIUM, MAJOR, and CRITICAL.
    description string
    A detailed description of the incident.
    name string
    The name of the incident.
    notifySubscribers boolean
    Whether to notify subscribers when the incident is triggered.
    serviceId string
    The status page service that this incident will be associated with.
    severity string
    The severity level of the incident. Possible values are MINOR, MEDIUM, MAJOR, and CRITICAL.
    description str
    A detailed description of the incident.
    name str
    The name of the incident.
    notify_subscribers bool
    Whether to notify subscribers when the incident is triggered.
    service_id str
    The status page service that this incident will be associated with.
    severity str
    The severity level of the incident. Possible values are MINOR, MEDIUM, MAJOR, and CRITICAL.
    description String
    A detailed description of the incident.
    name String
    The name of the incident.
    notifySubscribers Boolean
    Whether to notify subscribers when the incident is triggered.
    serviceId String
    The status page service that this incident will be associated with.
    severity String
    The severity level of the incident. Possible values are MINOR, MEDIUM, MAJOR, and CRITICAL.

    Package Details

    Repository
    checkly checkly/pulumi-checkly
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the checkly Terraform Provider.
    checkly logo
    Checkly v2.7.0 published on Tuesday, Nov 4, 2025 by Checkly
    checkly/pulumi-checkly
      Meet Neo: Your AI Platform Teammate