Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Ns1 Provider
  3. API Docs
  4. MonitoringJob
NS1 v3.6.2 published on Wednesday, Apr 9, 2025 by Pulumi
pulumi/pulumi-ns1

ns1.MonitoringJob

Explore with Pulumi AI

ns1 logo
NS1 v3.6.2 published on Wednesday, Apr 9, 2025 by Pulumi
pulumi/pulumi-ns1

    Provides a NS1 Monitoring Job resource. This can be used to create, modify, and delete monitoring jobs.

    Example Usage

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

const uswestMonitor = new ns1.MonitoringJob("uswest_monitor", {
    name: "uswest",
    active: true,
    regions: [
        "lga",
        "sjc",
        "sin",
    ],
    jobType: "tcp",
    frequency: 60,
    rapidRecheck: true,
    policy: "quorum",
    mute: true,
    config: {
        ssl: "1",
        send: "HEAD / HTTP/1.0\\r\\n\\r\\n",
        port: "443",
        host: "example-elb-uswest.aws.amazon.com",
    },
    rules: [{
        value: "200 OK",
        comparison: "contains",
        key: "output",
    }],
});

    import pulumi
import pulumi_ns1 as ns1

uswest_monitor = ns1.MonitoringJob("uswest_monitor",
    name="uswest",
    active=True,
    regions=[
        "lga",
        "sjc",
        "sin",
    ],
    job_type="tcp",
    frequency=60,
    rapid_recheck=True,
    policy="quorum",
    mute=True,
    config={
        "ssl": "1",
        "send": "HEAD / HTTP/1.0\\r\\n\\r\\n",
        "port": "443",
        "host": "example-elb-uswest.aws.amazon.com",
    },
    rules=[{
        "value": "200 OK",
        "comparison": "contains",
        "key": "output",
    }])

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ns1.NewMonitoringJob(ctx, "uswest_monitor", &ns1.MonitoringJobArgs{
			Name:   pulumi.String("uswest"),
			Active: pulumi.Bool(true),
			Regions: pulumi.StringArray{
				pulumi.String("lga"),
				pulumi.String("sjc"),
				pulumi.String("sin"),
			},
			JobType:      pulumi.String("tcp"),
			Frequency:    pulumi.Int(60),
			RapidRecheck: pulumi.Bool(true),
			Policy:       pulumi.String("quorum"),
			Mute:         pulumi.Bool(true),
			Config: pulumi.StringMap{
				"ssl":  pulumi.String("1"),
				"send": pulumi.String("HEAD / HTTP/1.0\\r\\n\\r\\n"),
				"port": pulumi.String("443"),
				"host": pulumi.String("example-elb-uswest.aws.amazon.com"),
			},
			Rules: ns1.MonitoringJobRuleArray{
				&ns1.MonitoringJobRuleArgs{
					Value:      pulumi.String("200 OK"),
					Comparison: pulumi.String("contains"),
					Key:        pulumi.String("output"),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var uswestMonitor = new Ns1.MonitoringJob("uswest_monitor", new()
    {
        Name = "uswest",
        Active = true,
        Regions = new[]
        {
            "lga",
            "sjc",
            "sin",
        },
        JobType = "tcp",
        Frequency = 60,
        RapidRecheck = true,
        Policy = "quorum",
        Mute = true,
        Config = 
        {
            { "ssl", "1" },
            { "send", "HEAD / HTTP/1.0\\r\\n\\r\\n" },
            { "port", "443" },
            { "host", "example-elb-uswest.aws.amazon.com" },
        },
        Rules = new[]
        {
            new Ns1.Inputs.MonitoringJobRuleArgs
            {
                Value = "200 OK",
                Comparison = "contains",
                Key = "output",
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ns1.MonitoringJob;
import com.pulumi.ns1.MonitoringJobArgs;
import com.pulumi.ns1.inputs.MonitoringJobRuleArgs;
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 uswestMonitor = new MonitoringJob("uswestMonitor", MonitoringJobArgs.builder()
            .name("uswest")
            .active(true)
            .regions(            
                "lga",
                "sjc",
                "sin")
            .jobType("tcp")
            .frequency(60)
            .rapidRecheck(true)
            .policy("quorum")
            .mute(true)
            .config(Map.ofEntries(
                Map.entry("ssl", 1),
                Map.entry("send", "HEAD / HTTP/1.0\\r\\n\\r\\n"),
                Map.entry("port", 443),
                Map.entry("host", "example-elb-uswest.aws.amazon.com")
            ))
            .rules(MonitoringJobRuleArgs.builder()
                .value("200 OK")
                .comparison("contains")
                .key("output")
                .build())
            .build());

    }
}

    resources:
  uswestMonitor:
    type: ns1:MonitoringJob
    name: uswest_monitor
    properties:
      name: uswest
      active: true
      regions:
        - lga
        - sjc
        - sin
      jobType: tcp
      frequency: 60
      rapidRecheck: true
      policy: quorum
      mute: true
      config:
        ssl: 1
        send: HEAD / HTTP/1.0\r\n\r\n
        port: 443
        host: example-elb-uswest.aws.amazon.com
      rules:
        - value: 200 OK
          comparison: contains
          key: output

    NS1 Documentation

    MonitoringJob Api Doc

    Create MonitoringJob Resource

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

    Constructor syntax

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

@overload
def MonitoringJob(resource_name: str,
                  opts: Optional[ResourceOptions] = None,
                  regions: Optional[Sequence[str]] = None,
                  config: Optional[Mapping[str, str]] = None,
                  frequency: Optional[int] = None,
                  job_type: Optional[str] = None,
                  notify_failback: Optional[bool] = None,
                  name: Optional[str] = None,
                  notes: Optional[str] = None,
                  notify_delay: Optional[int] = None,
                  active: Optional[bool] = None,
                  notify_list: Optional[str] = None,
                  notify_regional: Optional[bool] = None,
                  notify_repeat: Optional[int] = None,
                  policy: Optional[str] = None,
                  rapid_recheck: Optional[bool] = None,
                  mute: Optional[bool] = None,
                  rules: Optional[Sequence[MonitoringJobRuleArgs]] = None)
    func NewMonitoringJob(ctx *Context, name string, args MonitoringJobArgs, opts ...ResourceOption) (*MonitoringJob, error)
    public MonitoringJob(string name, MonitoringJobArgs args, CustomResourceOptions? opts = null)
    public MonitoringJob(String name, MonitoringJobArgs args)
public MonitoringJob(String name, MonitoringJobArgs args, CustomResourceOptions options)

    type: ns1:MonitoringJob
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 MonitoringJobArgs
    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 MonitoringJobArgs
    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 MonitoringJobArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args MonitoringJobArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args MonitoringJobArgs
    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 monitoringJobResource = new Ns1.MonitoringJob("monitoringJobResource", new()
{
    Regions = new[]
    {
        "string",
    },
    Config = 
    {
        { "string", "string" },
    },
    Frequency = 0,
    JobType = "string",
    NotifyFailback = false,
    Name = "string",
    Notes = "string",
    NotifyDelay = 0,
    Active = false,
    NotifyList = "string",
    NotifyRegional = false,
    NotifyRepeat = 0,
    Policy = "string",
    RapidRecheck = false,
    Mute = false,
    Rules = new[]
    {
        new Ns1.Inputs.MonitoringJobRuleArgs
        {
            Comparison = "string",
            Key = "string",
            Value = "string",
        },
    },
});

    example, err := ns1.NewMonitoringJob(ctx, "monitoringJobResource", &ns1.MonitoringJobArgs{
	Regions: pulumi.StringArray{
		pulumi.String("string"),
	},
	Config: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	Frequency:      pulumi.Int(0),
	JobType:        pulumi.String("string"),
	NotifyFailback: pulumi.Bool(false),
	Name:           pulumi.String("string"),
	Notes:          pulumi.String("string"),
	NotifyDelay:    pulumi.Int(0),
	Active:         pulumi.Bool(false),
	NotifyList:     pulumi.String("string"),
	NotifyRegional: pulumi.Bool(false),
	NotifyRepeat:   pulumi.Int(0),
	Policy:         pulumi.String("string"),
	RapidRecheck:   pulumi.Bool(false),
	Mute:           pulumi.Bool(false),
	Rules: ns1.MonitoringJobRuleArray{
		&ns1.MonitoringJobRuleArgs{
			Comparison: pulumi.String("string"),
			Key:        pulumi.String("string"),
			Value:      pulumi.String("string"),
		},
	},
})

    var monitoringJobResource = new MonitoringJob("monitoringJobResource", MonitoringJobArgs.builder()
    .regions("string")
    .config(Map.of("string", "string"))
    .frequency(0)
    .jobType("string")
    .notifyFailback(false)
    .name("string")
    .notes("string")
    .notifyDelay(0)
    .active(false)
    .notifyList("string")
    .notifyRegional(false)
    .notifyRepeat(0)
    .policy("string")
    .rapidRecheck(false)
    .mute(false)
    .rules(MonitoringJobRuleArgs.builder()
        .comparison("string")
        .key("string")
        .value("string")
        .build())
    .build());

    monitoring_job_resource = ns1.MonitoringJob("monitoringJobResource",
    regions=["string"],
    config={
        "string": "string",
    },
    frequency=0,
    job_type="string",
    notify_failback=False,
    name="string",
    notes="string",
    notify_delay=0,
    active=False,
    notify_list="string",
    notify_regional=False,
    notify_repeat=0,
    policy="string",
    rapid_recheck=False,
    mute=False,
    rules=[{
        "comparison": "string",
        "key": "string",
        "value": "string",
    }])

    const monitoringJobResource = new ns1.MonitoringJob("monitoringJobResource", {
    regions: ["string"],
    config: {
        string: "string",
    },
    frequency: 0,
    jobType: "string",
    notifyFailback: false,
    name: "string",
    notes: "string",
    notifyDelay: 0,
    active: false,
    notifyList: "string",
    notifyRegional: false,
    notifyRepeat: 0,
    policy: "string",
    rapidRecheck: false,
    mute: false,
    rules: [{
        comparison: "string",
        key: "string",
        value: "string",
    }],
});

    type: ns1:MonitoringJob
properties:
    active: false
    config:
        string: string
    frequency: 0
    jobType: string
    mute: false
    name: string
    notes: string
    notifyDelay: 0
    notifyFailback: false
    notifyList: string
    notifyRegional: false
    notifyRepeat: 0
    policy: string
    rapidRecheck: false
    regions:
        - string
    rules:
        - comparison: string
          key: string
          value: string

    MonitoringJob 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 MonitoringJob resource accepts the following input properties:

    Config Dictionary<string, string>
    A configuration dictionary with keys and values depending on the job_type. Configuration details for each job_type are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    Frequency int
    The frequency, in seconds, at which to run the monitoring job in each region.
    JobType string
    The type of monitoring job to be run. Refer to the NS1 API documentation (https://ns1.com/api#monitoring-jobs) for supported values which include ping, tcp, dns, http.
    Regions List<string>
    The list of region codes in which to run the monitoring job. See NS1 API docs for supported values.
    Active bool
    Indicates if the job is active or temporarily disabled.
    Mute bool
    turn off the notifications for the monitoring job.
    Name string
    The free-form display name for the monitoring job.
    Notes string
    Freeform notes to be included in any notifications about this job.
    NotifyDelay int
    The time in seconds after a failure to wait before sending a notification.
    NotifyFailback bool
    If true, a notification is sent when a job returns to an "up" state.
    NotifyList string
    NotifyRegional bool
    If true, notifications are sent for any regional failure (and failback if desired), in addition to global state notifications.
    NotifyRepeat int
    The time in seconds between repeat notifications of a failed job.
    Policy string
    The policy for determining the monitor's global status based on the status of the job in all regions. See NS1 API docs for supported values.
    RapidRecheck bool
    If true, on any apparent state change, the job is quickly re-run after one second to confirm the state change before notification.
    Rules List<MonitoringJobRule>
    A list of rules for determining failure conditions. Each rule acts on one of the outputs from the monitoring job. You must specify key (the output key); comparison (a comparison to perform on the the output); and value (the value to compare to). For example, {"key":"rtt", "comparison":"<", "value":100} is a rule requiring the rtt from a job to be under 100ms, or the job will be marked failed. Available output keys, comparators, and value types are are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    Config map[string]string
    A configuration dictionary with keys and values depending on the job_type. Configuration details for each job_type are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    Frequency int
    The frequency, in seconds, at which to run the monitoring job in each region.
    JobType string
    The type of monitoring job to be run. Refer to the NS1 API documentation (https://ns1.com/api#monitoring-jobs) for supported values which include ping, tcp, dns, http.
    Regions []string
    The list of region codes in which to run the monitoring job. See NS1 API docs for supported values.
    Active bool
    Indicates if the job is active or temporarily disabled.
    Mute bool
    turn off the notifications for the monitoring job.
    Name string
    The free-form display name for the monitoring job.
    Notes string
    Freeform notes to be included in any notifications about this job.
    NotifyDelay int
    The time in seconds after a failure to wait before sending a notification.
    NotifyFailback bool
    If true, a notification is sent when a job returns to an "up" state.
    NotifyList string
    NotifyRegional bool
    If true, notifications are sent for any regional failure (and failback if desired), in addition to global state notifications.
    NotifyRepeat int
    The time in seconds between repeat notifications of a failed job.
    Policy string
    The policy for determining the monitor's global status based on the status of the job in all regions. See NS1 API docs for supported values.
    RapidRecheck bool
    If true, on any apparent state change, the job is quickly re-run after one second to confirm the state change before notification.
    Rules []MonitoringJobRuleArgs
    A list of rules for determining failure conditions. Each rule acts on one of the outputs from the monitoring job. You must specify key (the output key); comparison (a comparison to perform on the the output); and value (the value to compare to). For example, {"key":"rtt", "comparison":"<", "value":100} is a rule requiring the rtt from a job to be under 100ms, or the job will be marked failed. Available output keys, comparators, and value types are are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    config Map<String,String>
    A configuration dictionary with keys and values depending on the job_type. Configuration details for each job_type are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    frequency Integer
    The frequency, in seconds, at which to run the monitoring job in each region.
    jobType String
    The type of monitoring job to be run. Refer to the NS1 API documentation (https://ns1.com/api#monitoring-jobs) for supported values which include ping, tcp, dns, http.
    regions List<String>
    The list of region codes in which to run the monitoring job. See NS1 API docs for supported values.
    active Boolean
    Indicates if the job is active or temporarily disabled.
    mute Boolean
    turn off the notifications for the monitoring job.
    name String
    The free-form display name for the monitoring job.
    notes String
    Freeform notes to be included in any notifications about this job.
    notifyDelay Integer
    The time in seconds after a failure to wait before sending a notification.
    notifyFailback Boolean
    If true, a notification is sent when a job returns to an "up" state.
    notifyList String
    notifyRegional Boolean
    If true, notifications are sent for any regional failure (and failback if desired), in addition to global state notifications.
    notifyRepeat Integer
    The time in seconds between repeat notifications of a failed job.
    policy String
    The policy for determining the monitor's global status based on the status of the job in all regions. See NS1 API docs for supported values.
    rapidRecheck Boolean
    If true, on any apparent state change, the job is quickly re-run after one second to confirm the state change before notification.
    rules List<MonitoringJobRule>
    A list of rules for determining failure conditions. Each rule acts on one of the outputs from the monitoring job. You must specify key (the output key); comparison (a comparison to perform on the the output); and value (the value to compare to). For example, {"key":"rtt", "comparison":"<", "value":100} is a rule requiring the rtt from a job to be under 100ms, or the job will be marked failed. Available output keys, comparators, and value types are are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    config {[key: string]: string}
    A configuration dictionary with keys and values depending on the job_type. Configuration details for each job_type are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    frequency number
    The frequency, in seconds, at which to run the monitoring job in each region.
    jobType string
    The type of monitoring job to be run. Refer to the NS1 API documentation (https://ns1.com/api#monitoring-jobs) for supported values which include ping, tcp, dns, http.
    regions string[]
    The list of region codes in which to run the monitoring job. See NS1 API docs for supported values.
    active boolean
    Indicates if the job is active or temporarily disabled.
    mute boolean
    turn off the notifications for the monitoring job.
    name string
    The free-form display name for the monitoring job.
    notes string
    Freeform notes to be included in any notifications about this job.
    notifyDelay number
    The time in seconds after a failure to wait before sending a notification.
    notifyFailback boolean
    If true, a notification is sent when a job returns to an "up" state.
    notifyList string
    notifyRegional boolean
    If true, notifications are sent for any regional failure (and failback if desired), in addition to global state notifications.
    notifyRepeat number
    The time in seconds between repeat notifications of a failed job.
    policy string
    The policy for determining the monitor's global status based on the status of the job in all regions. See NS1 API docs for supported values.
    rapidRecheck boolean
    If true, on any apparent state change, the job is quickly re-run after one second to confirm the state change before notification.
    rules MonitoringJobRule[]
    A list of rules for determining failure conditions. Each rule acts on one of the outputs from the monitoring job. You must specify key (the output key); comparison (a comparison to perform on the the output); and value (the value to compare to). For example, {"key":"rtt", "comparison":"<", "value":100} is a rule requiring the rtt from a job to be under 100ms, or the job will be marked failed. Available output keys, comparators, and value types are are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    config Mapping[str, str]
    A configuration dictionary with keys and values depending on the job_type. Configuration details for each job_type are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    frequency int
    The frequency, in seconds, at which to run the monitoring job in each region.
    job_type str
    The type of monitoring job to be run. Refer to the NS1 API documentation (https://ns1.com/api#monitoring-jobs) for supported values which include ping, tcp, dns, http.
    regions Sequence[str]
    The list of region codes in which to run the monitoring job. See NS1 API docs for supported values.
    active bool
    Indicates if the job is active or temporarily disabled.
    mute bool
    turn off the notifications for the monitoring job.
    name str
    The free-form display name for the monitoring job.
    notes str
    Freeform notes to be included in any notifications about this job.
    notify_delay int
    The time in seconds after a failure to wait before sending a notification.
    notify_failback bool
    If true, a notification is sent when a job returns to an "up" state.
    notify_list str
    notify_regional bool
    If true, notifications are sent for any regional failure (and failback if desired), in addition to global state notifications.
    notify_repeat int
    The time in seconds between repeat notifications of a failed job.
    policy str
    The policy for determining the monitor's global status based on the status of the job in all regions. See NS1 API docs for supported values.
    rapid_recheck bool
    If true, on any apparent state change, the job is quickly re-run after one second to confirm the state change before notification.
    rules Sequence[MonitoringJobRuleArgs]
    A list of rules for determining failure conditions. Each rule acts on one of the outputs from the monitoring job. You must specify key (the output key); comparison (a comparison to perform on the the output); and value (the value to compare to). For example, {"key":"rtt", "comparison":"<", "value":100} is a rule requiring the rtt from a job to be under 100ms, or the job will be marked failed. Available output keys, comparators, and value types are are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    config Map<String>
    A configuration dictionary with keys and values depending on the job_type. Configuration details for each job_type are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    frequency Number
    The frequency, in seconds, at which to run the monitoring job in each region.
    jobType String
    The type of monitoring job to be run. Refer to the NS1 API documentation (https://ns1.com/api#monitoring-jobs) for supported values which include ping, tcp, dns, http.
    regions List<String>
    The list of region codes in which to run the monitoring job. See NS1 API docs for supported values.
    active Boolean
    Indicates if the job is active or temporarily disabled.
    mute Boolean
    turn off the notifications for the monitoring job.
    name String
    The free-form display name for the monitoring job.
    notes String
    Freeform notes to be included in any notifications about this job.
    notifyDelay Number
    The time in seconds after a failure to wait before sending a notification.
    notifyFailback Boolean
    If true, a notification is sent when a job returns to an "up" state.
    notifyList String
    notifyRegional Boolean
    If true, notifications are sent for any regional failure (and failback if desired), in addition to global state notifications.
    notifyRepeat Number
    The time in seconds between repeat notifications of a failed job.
    policy String
    The policy for determining the monitor's global status based on the status of the job in all regions. See NS1 API docs for supported values.
    rapidRecheck Boolean
    If true, on any apparent state change, the job is quickly re-run after one second to confirm the state change before notification.
    rules List<Property Map>
    A list of rules for determining failure conditions. Each rule acts on one of the outputs from the monitoring job. You must specify key (the output key); comparison (a comparison to perform on the the output); and value (the value to compare to). For example, {"key":"rtt", "comparison":"<", "value":100} is a rule requiring the rtt from a job to be under 100ms, or the job will be marked failed. Available output keys, comparators, and value types are are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the MonitoringJob 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 MonitoringJob Resource

    Get an existing MonitoringJob 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?: MonitoringJobState, opts?: CustomResourceOptions): MonitoringJob
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        active: Optional[bool] = None,
        config: Optional[Mapping[str, str]] = None,
        frequency: Optional[int] = None,
        job_type: Optional[str] = None,
        mute: Optional[bool] = None,
        name: Optional[str] = None,
        notes: Optional[str] = None,
        notify_delay: Optional[int] = None,
        notify_failback: Optional[bool] = None,
        notify_list: Optional[str] = None,
        notify_regional: Optional[bool] = None,
        notify_repeat: Optional[int] = None,
        policy: Optional[str] = None,
        rapid_recheck: Optional[bool] = None,
        regions: Optional[Sequence[str]] = None,
        rules: Optional[Sequence[MonitoringJobRuleArgs]] = None) -> MonitoringJob
    func GetMonitoringJob(ctx *Context, name string, id IDInput, state *MonitoringJobState, opts ...ResourceOption) (*MonitoringJob, error)
    public static MonitoringJob Get(string name, Input<string> id, MonitoringJobState? state, CustomResourceOptions? opts = null)
    public static MonitoringJob get(String name, Output<String> id, MonitoringJobState state, CustomResourceOptions options)
    resources:  _:    type: ns1:MonitoringJob    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:
    Active bool
    Indicates if the job is active or temporarily disabled.
    Config Dictionary<string, string>
    A configuration dictionary with keys and values depending on the job_type. Configuration details for each job_type are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    Frequency int
    The frequency, in seconds, at which to run the monitoring job in each region.
    JobType string
    The type of monitoring job to be run. Refer to the NS1 API documentation (https://ns1.com/api#monitoring-jobs) for supported values which include ping, tcp, dns, http.
    Mute bool
    turn off the notifications for the monitoring job.
    Name string
    The free-form display name for the monitoring job.
    Notes string
    Freeform notes to be included in any notifications about this job.
    NotifyDelay int
    The time in seconds after a failure to wait before sending a notification.
    NotifyFailback bool
    If true, a notification is sent when a job returns to an "up" state.
    NotifyList string
    NotifyRegional bool
    If true, notifications are sent for any regional failure (and failback if desired), in addition to global state notifications.
    NotifyRepeat int
    The time in seconds between repeat notifications of a failed job.
    Policy string
    The policy for determining the monitor's global status based on the status of the job in all regions. See NS1 API docs for supported values.
    RapidRecheck bool
    If true, on any apparent state change, the job is quickly re-run after one second to confirm the state change before notification.
    Regions List<string>
    The list of region codes in which to run the monitoring job. See NS1 API docs for supported values.
    Rules List<MonitoringJobRule>
    A list of rules for determining failure conditions. Each rule acts on one of the outputs from the monitoring job. You must specify key (the output key); comparison (a comparison to perform on the the output); and value (the value to compare to). For example, {"key":"rtt", "comparison":"<", "value":100} is a rule requiring the rtt from a job to be under 100ms, or the job will be marked failed. Available output keys, comparators, and value types are are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    Active bool
    Indicates if the job is active or temporarily disabled.
    Config map[string]string
    A configuration dictionary with keys and values depending on the job_type. Configuration details for each job_type are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    Frequency int
    The frequency, in seconds, at which to run the monitoring job in each region.
    JobType string
    The type of monitoring job to be run. Refer to the NS1 API documentation (https://ns1.com/api#monitoring-jobs) for supported values which include ping, tcp, dns, http.
    Mute bool
    turn off the notifications for the monitoring job.
    Name string
    The free-form display name for the monitoring job.
    Notes string
    Freeform notes to be included in any notifications about this job.
    NotifyDelay int
    The time in seconds after a failure to wait before sending a notification.
    NotifyFailback bool
    If true, a notification is sent when a job returns to an "up" state.
    NotifyList string
    NotifyRegional bool
    If true, notifications are sent for any regional failure (and failback if desired), in addition to global state notifications.
    NotifyRepeat int
    The time in seconds between repeat notifications of a failed job.
    Policy string
    The policy for determining the monitor's global status based on the status of the job in all regions. See NS1 API docs for supported values.
    RapidRecheck bool
    If true, on any apparent state change, the job is quickly re-run after one second to confirm the state change before notification.
    Regions []string
    The list of region codes in which to run the monitoring job. See NS1 API docs for supported values.
    Rules []MonitoringJobRuleArgs
    A list of rules for determining failure conditions. Each rule acts on one of the outputs from the monitoring job. You must specify key (the output key); comparison (a comparison to perform on the the output); and value (the value to compare to). For example, {"key":"rtt", "comparison":"<", "value":100} is a rule requiring the rtt from a job to be under 100ms, or the job will be marked failed. Available output keys, comparators, and value types are are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    active Boolean
    Indicates if the job is active or temporarily disabled.
    config Map<String,String>
    A configuration dictionary with keys and values depending on the job_type. Configuration details for each job_type are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    frequency Integer
    The frequency, in seconds, at which to run the monitoring job in each region.
    jobType String
    The type of monitoring job to be run. Refer to the NS1 API documentation (https://ns1.com/api#monitoring-jobs) for supported values which include ping, tcp, dns, http.
    mute Boolean
    turn off the notifications for the monitoring job.
    name String
    The free-form display name for the monitoring job.
    notes String
    Freeform notes to be included in any notifications about this job.
    notifyDelay Integer
    The time in seconds after a failure to wait before sending a notification.
    notifyFailback Boolean
    If true, a notification is sent when a job returns to an "up" state.
    notifyList String
    notifyRegional Boolean
    If true, notifications are sent for any regional failure (and failback if desired), in addition to global state notifications.
    notifyRepeat Integer
    The time in seconds between repeat notifications of a failed job.
    policy String
    The policy for determining the monitor's global status based on the status of the job in all regions. See NS1 API docs for supported values.
    rapidRecheck Boolean
    If true, on any apparent state change, the job is quickly re-run after one second to confirm the state change before notification.
    regions List<String>
    The list of region codes in which to run the monitoring job. See NS1 API docs for supported values.
    rules List<MonitoringJobRule>
    A list of rules for determining failure conditions. Each rule acts on one of the outputs from the monitoring job. You must specify key (the output key); comparison (a comparison to perform on the the output); and value (the value to compare to). For example, {"key":"rtt", "comparison":"<", "value":100} is a rule requiring the rtt from a job to be under 100ms, or the job will be marked failed. Available output keys, comparators, and value types are are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    active boolean
    Indicates if the job is active or temporarily disabled.
    config {[key: string]: string}
    A configuration dictionary with keys and values depending on the job_type. Configuration details for each job_type are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    frequency number
    The frequency, in seconds, at which to run the monitoring job in each region.
    jobType string
    The type of monitoring job to be run. Refer to the NS1 API documentation (https://ns1.com/api#monitoring-jobs) for supported values which include ping, tcp, dns, http.
    mute boolean
    turn off the notifications for the monitoring job.
    name string
    The free-form display name for the monitoring job.
    notes string
    Freeform notes to be included in any notifications about this job.
    notifyDelay number
    The time in seconds after a failure to wait before sending a notification.
    notifyFailback boolean
    If true, a notification is sent when a job returns to an "up" state.
    notifyList string
    notifyRegional boolean
    If true, notifications are sent for any regional failure (and failback if desired), in addition to global state notifications.
    notifyRepeat number
    The time in seconds between repeat notifications of a failed job.
    policy string
    The policy for determining the monitor's global status based on the status of the job in all regions. See NS1 API docs for supported values.
    rapidRecheck boolean
    If true, on any apparent state change, the job is quickly re-run after one second to confirm the state change before notification.
    regions string[]
    The list of region codes in which to run the monitoring job. See NS1 API docs for supported values.
    rules MonitoringJobRule[]
    A list of rules for determining failure conditions. Each rule acts on one of the outputs from the monitoring job. You must specify key (the output key); comparison (a comparison to perform on the the output); and value (the value to compare to). For example, {"key":"rtt", "comparison":"<", "value":100} is a rule requiring the rtt from a job to be under 100ms, or the job will be marked failed. Available output keys, comparators, and value types are are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    active bool
    Indicates if the job is active or temporarily disabled.
    config Mapping[str, str]
    A configuration dictionary with keys and values depending on the job_type. Configuration details for each job_type are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    frequency int
    The frequency, in seconds, at which to run the monitoring job in each region.
    job_type str
    The type of monitoring job to be run. Refer to the NS1 API documentation (https://ns1.com/api#monitoring-jobs) for supported values which include ping, tcp, dns, http.
    mute bool
    turn off the notifications for the monitoring job.
    name str
    The free-form display name for the monitoring job.
    notes str
    Freeform notes to be included in any notifications about this job.
    notify_delay int
    The time in seconds after a failure to wait before sending a notification.
    notify_failback bool
    If true, a notification is sent when a job returns to an "up" state.
    notify_list str
    notify_regional bool
    If true, notifications are sent for any regional failure (and failback if desired), in addition to global state notifications.
    notify_repeat int
    The time in seconds between repeat notifications of a failed job.
    policy str
    The policy for determining the monitor's global status based on the status of the job in all regions. See NS1 API docs for supported values.
    rapid_recheck bool
    If true, on any apparent state change, the job is quickly re-run after one second to confirm the state change before notification.
    regions Sequence[str]
    The list of region codes in which to run the monitoring job. See NS1 API docs for supported values.
    rules Sequence[MonitoringJobRuleArgs]
    A list of rules for determining failure conditions. Each rule acts on one of the outputs from the monitoring job. You must specify key (the output key); comparison (a comparison to perform on the the output); and value (the value to compare to). For example, {"key":"rtt", "comparison":"<", "value":100} is a rule requiring the rtt from a job to be under 100ms, or the job will be marked failed. Available output keys, comparators, and value types are are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    active Boolean
    Indicates if the job is active or temporarily disabled.
    config Map<String>
    A configuration dictionary with keys and values depending on the job_type. Configuration details for each job_type are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.
    frequency Number
    The frequency, in seconds, at which to run the monitoring job in each region.
    jobType String
    The type of monitoring job to be run. Refer to the NS1 API documentation (https://ns1.com/api#monitoring-jobs) for supported values which include ping, tcp, dns, http.
    mute Boolean
    turn off the notifications for the monitoring job.
    name String
    The free-form display name for the monitoring job.
    notes String
    Freeform notes to be included in any notifications about this job.
    notifyDelay Number
    The time in seconds after a failure to wait before sending a notification.
    notifyFailback Boolean
    If true, a notification is sent when a job returns to an "up" state.
    notifyList String
    notifyRegional Boolean
    If true, notifications are sent for any regional failure (and failback if desired), in addition to global state notifications.
    notifyRepeat Number
    The time in seconds between repeat notifications of a failed job.
    policy String
    The policy for determining the monitor's global status based on the status of the job in all regions. See NS1 API docs for supported values.
    rapidRecheck Boolean
    If true, on any apparent state change, the job is quickly re-run after one second to confirm the state change before notification.
    regions List<String>
    The list of region codes in which to run the monitoring job. See NS1 API docs for supported values.
    rules List<Property Map>
    A list of rules for determining failure conditions. Each rule acts on one of the outputs from the monitoring job. You must specify key (the output key); comparison (a comparison to perform on the the output); and value (the value to compare to). For example, {"key":"rtt", "comparison":"<", "value":100} is a rule requiring the rtt from a job to be under 100ms, or the job will be marked failed. Available output keys, comparators, and value types are are found by submitting a GET request to https://api.nsone.net/v1/monitoring/jobtypes.

    Supporting Types

    MonitoringJobRule, MonitoringJobRuleArgs

    Comparison string
    Key string
    Value string
    Comparison string
    Key string
    Value string
    comparison String
    key String
    value String
    comparison string
    key string
    value string
    comparison str
    key str
    value str
    comparison String
    key String
    value String

    Import

    $ pulumi import ns1:index/monitoringJob:MonitoringJob <name> <monitoringjob_id>`

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    NS1 pulumi/pulumi-ns1
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the ns1 Terraform Provider.
    ns1 logo
    NS1 v3.6.2 published on Wednesday, Apr 9, 2025 by Pulumi
    pulumi/pulumi-ns1