1. Packages
  2. NS1
  3. API Docs
  4. MonitoringJob
NS1 v3.1.5 published on Friday, Jan 19, 2024 by Pulumi

ns1.MonitoringJob

Explore with Pulumi AI

ns1 logo
NS1 v3.1.5 published on Friday, Jan 19, 2024 by Pulumi

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

    NS1 Documentation

    MonitoringJob Api Doc

    Example Usage

    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Ns1 = Pulumi.Ns1;
    
    return await Deployment.RunAsync(() => 
    {
        var uswestMonitor = new Ns1.MonitoringJob("uswestMonitor", new()
        {
            Active = true,
            Config = 
            {
                { "host", "example-elb-uswest.aws.amazon.com" },
                { "port", 443 },
                { "send", "HEAD / HTTP/1.0\\r\\n\\r\\n" },
                { "ssl", 1 },
            },
            Frequency = 60,
            JobType = "tcp",
            Mute = true,
            Policy = "quorum",
            RapidRecheck = true,
            Regions = new[]
            {
                "lga",
                "sjc",
                "sin",
            },
            Rules = new[]
            {
                new Ns1.Inputs.MonitoringJobRuleArgs
                {
                    Comparison = "contains",
                    Key = "output",
                    Value = "200 OK",
                },
            },
        });
    
    });
    
    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, "uswestMonitor", &ns1.MonitoringJobArgs{
    			Active: pulumi.Bool(true),
    			Config: pulumi.Map{
    				"host": pulumi.Any("example-elb-uswest.aws.amazon.com"),
    				"port": pulumi.Any(443),
    				"send": pulumi.Any("HEAD / HTTP/1.0\\r\\n\\r\\n"),
    				"ssl":  pulumi.Any(1),
    			},
    			Frequency:    pulumi.Int(60),
    			JobType:      pulumi.String("tcp"),
    			Mute:         pulumi.Bool(true),
    			Policy:       pulumi.String("quorum"),
    			RapidRecheck: pulumi.Bool(true),
    			Regions: pulumi.StringArray{
    				pulumi.String("lga"),
    				pulumi.String("sjc"),
    				pulumi.String("sin"),
    			},
    			Rules: ns1.MonitoringJobRuleArray{
    				&ns1.MonitoringJobRuleArgs{
    					Comparison: pulumi.String("contains"),
    					Key:        pulumi.String("output"),
    					Value:      pulumi.String("200 OK"),
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    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()        
                .active(true)
                .config(Map.ofEntries(
                    Map.entry("host", "example-elb-uswest.aws.amazon.com"),
                    Map.entry("port", 443),
                    Map.entry("send", "HEAD / HTTP/1.0\\r\\n\\r\\n"),
                    Map.entry("ssl", 1)
                ))
                .frequency(60)
                .jobType("tcp")
                .mute(true)
                .policy("quorum")
                .rapidRecheck(true)
                .regions(            
                    "lga",
                    "sjc",
                    "sin")
                .rules(MonitoringJobRuleArgs.builder()
                    .comparison("contains")
                    .key("output")
                    .value("200 OK")
                    .build())
                .build());
    
        }
    }
    
    import pulumi
    import pulumi_ns1 as ns1
    
    uswest_monitor = ns1.MonitoringJob("uswestMonitor",
        active=True,
        config={
            "host": "example-elb-uswest.aws.amazon.com",
            "port": 443,
            "send": "HEAD / HTTP/1.0\\r\\n\\r\\n",
            "ssl": 1,
        },
        frequency=60,
        job_type="tcp",
        mute=True,
        policy="quorum",
        rapid_recheck=True,
        regions=[
            "lga",
            "sjc",
            "sin",
        ],
        rules=[ns1.MonitoringJobRuleArgs(
            comparison="contains",
            key="output",
            value="200 OK",
        )])
    
    import * as pulumi from "@pulumi/pulumi";
    import * as ns1 from "@pulumi/ns1";
    
    const uswestMonitor = new ns1.MonitoringJob("uswestMonitor", {
        active: true,
        config: {
            host: "example-elb-uswest.aws.amazon.com",
            port: 443,
            send: "HEAD / HTTP/1.0\\r\\n\\r\\n",
            ssl: 1,
        },
        frequency: 60,
        jobType: "tcp",
        mute: true,
        policy: "quorum",
        rapidRecheck: true,
        regions: [
            "lga",
            "sjc",
            "sin",
        ],
        rules: [{
            comparison: "contains",
            key: "output",
            value: "200 OK",
        }],
    });
    
    resources:
      uswestMonitor:
        type: ns1:MonitoringJob
        properties:
          active: true
          config:
            host: example-elb-uswest.aws.amazon.com
            port: 443
            send: HEAD / HTTP/1.0\r\n\r\n
            ssl: 1
          frequency: 60
          jobType: tcp
          mute: true
          policy: quorum
          rapidRecheck: true
          regions:
            - lga
            - sjc
            - sin
          rules:
            - comparison: contains
              key: output
              value: 200 OK
    

    Create MonitoringJob Resource

    new MonitoringJob(name: string, args: MonitoringJobArgs, opts?: CustomResourceOptions);
    @overload
    def MonitoringJob(resource_name: str,
                      opts: Optional[ResourceOptions] = None,
                      active: Optional[bool] = None,
                      config: Optional[Mapping[str, Any]] = 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)
    @overload
    def MonitoringJob(resource_name: str,
                      args: MonitoringJobArgs,
                      opts: Optional[ResourceOptions] = 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.
    
    
    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.

    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

    The MonitoringJob resource accepts the following input properties:

    Config Dictionary<string, object>
    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]interface{}
    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,Object>
    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]: any}
    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, Any]
    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<Any>
    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, Any]] = 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)
    Resource lookup is not supported in YAML
    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, object>
    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]interface{}
    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,Object>
    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]: any}
    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, Any]
    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<Any>
    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>`
    

    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.1.5 published on Friday, Jan 19, 2024 by Pulumi