1. Packages
  2. AWS
  3. API Docs
  4. cloudwatch
  5. InternetMonitor
AWS v6.54.2 published on Wednesday, Oct 2, 2024 by Pulumi

aws.cloudwatch.InternetMonitor

Explore with Pulumi AI

aws logo
AWS v6.54.2 published on Wednesday, Oct 2, 2024 by Pulumi

    Provides a Internet Monitor Monitor resource.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const example = new aws.cloudwatch.InternetMonitor("example", {monitorName: "exmple"});
    
    import pulumi
    import pulumi_aws as aws
    
    example = aws.cloudwatch.InternetMonitor("example", monitor_name="exmple")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/cloudwatch"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := cloudwatch.NewInternetMonitor(ctx, "example", &cloudwatch.InternetMonitorArgs{
    			MonitorName: pulumi.String("exmple"),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var example = new Aws.CloudWatch.InternetMonitor("example", new()
        {
            MonitorName = "exmple",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.cloudwatch.InternetMonitor;
    import com.pulumi.aws.cloudwatch.InternetMonitorArgs;
    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 = new InternetMonitor("example", InternetMonitorArgs.builder()
                .monitorName("exmple")
                .build());
    
        }
    }
    
    resources:
      example:
        type: aws:cloudwatch:InternetMonitor
        properties:
          monitorName: exmple
    

    Create InternetMonitor Resource

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

    Constructor syntax

    new InternetMonitor(name: string, args: InternetMonitorArgs, opts?: CustomResourceOptions);
    @overload
    def InternetMonitor(resource_name: str,
                        args: InternetMonitorArgs,
                        opts: Optional[ResourceOptions] = None)
    
    @overload
    def InternetMonitor(resource_name: str,
                        opts: Optional[ResourceOptions] = None,
                        monitor_name: Optional[str] = None,
                        health_events_config: Optional[InternetMonitorHealthEventsConfigArgs] = None,
                        internet_measurements_log_delivery: Optional[InternetMonitorInternetMeasurementsLogDeliveryArgs] = None,
                        max_city_networks_to_monitor: Optional[int] = None,
                        resources: Optional[Sequence[str]] = None,
                        status: Optional[str] = None,
                        tags: Optional[Mapping[str, str]] = None,
                        traffic_percentage_to_monitor: Optional[int] = None)
    func NewInternetMonitor(ctx *Context, name string, args InternetMonitorArgs, opts ...ResourceOption) (*InternetMonitor, error)
    public InternetMonitor(string name, InternetMonitorArgs args, CustomResourceOptions? opts = null)
    public InternetMonitor(String name, InternetMonitorArgs args)
    public InternetMonitor(String name, InternetMonitorArgs args, CustomResourceOptions options)
    
    type: aws:cloudwatch:InternetMonitor
    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 InternetMonitorArgs
    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 InternetMonitorArgs
    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 InternetMonitorArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args InternetMonitorArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args InternetMonitorArgs
    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 internetMonitorResource = new Aws.CloudWatch.InternetMonitor("internetMonitorResource", new()
    {
        MonitorName = "string",
        HealthEventsConfig = new Aws.CloudWatch.Inputs.InternetMonitorHealthEventsConfigArgs
        {
            AvailabilityScoreThreshold = 0,
            PerformanceScoreThreshold = 0,
        },
        InternetMeasurementsLogDelivery = new Aws.CloudWatch.Inputs.InternetMonitorInternetMeasurementsLogDeliveryArgs
        {
            S3Config = new Aws.CloudWatch.Inputs.InternetMonitorInternetMeasurementsLogDeliveryS3ConfigArgs
            {
                BucketName = "string",
                BucketPrefix = "string",
                LogDeliveryStatus = "string",
            },
        },
        MaxCityNetworksToMonitor = 0,
        Resources = new[]
        {
            "string",
        },
        Status = "string",
        Tags = 
        {
            { "string", "string" },
        },
        TrafficPercentageToMonitor = 0,
    });
    
    example, err := cloudwatch.NewInternetMonitor(ctx, "internetMonitorResource", &cloudwatch.InternetMonitorArgs{
    	MonitorName: pulumi.String("string"),
    	HealthEventsConfig: &cloudwatch.InternetMonitorHealthEventsConfigArgs{
    		AvailabilityScoreThreshold: pulumi.Float64(0),
    		PerformanceScoreThreshold:  pulumi.Float64(0),
    	},
    	InternetMeasurementsLogDelivery: &cloudwatch.InternetMonitorInternetMeasurementsLogDeliveryArgs{
    		S3Config: &cloudwatch.InternetMonitorInternetMeasurementsLogDeliveryS3ConfigArgs{
    			BucketName:        pulumi.String("string"),
    			BucketPrefix:      pulumi.String("string"),
    			LogDeliveryStatus: pulumi.String("string"),
    		},
    	},
    	MaxCityNetworksToMonitor: pulumi.Int(0),
    	Resources: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	Status: pulumi.String("string"),
    	Tags: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	TrafficPercentageToMonitor: pulumi.Int(0),
    })
    
    var internetMonitorResource = new InternetMonitor("internetMonitorResource", InternetMonitorArgs.builder()
        .monitorName("string")
        .healthEventsConfig(InternetMonitorHealthEventsConfigArgs.builder()
            .availabilityScoreThreshold(0)
            .performanceScoreThreshold(0)
            .build())
        .internetMeasurementsLogDelivery(InternetMonitorInternetMeasurementsLogDeliveryArgs.builder()
            .s3Config(InternetMonitorInternetMeasurementsLogDeliveryS3ConfigArgs.builder()
                .bucketName("string")
                .bucketPrefix("string")
                .logDeliveryStatus("string")
                .build())
            .build())
        .maxCityNetworksToMonitor(0)
        .resources("string")
        .status("string")
        .tags(Map.of("string", "string"))
        .trafficPercentageToMonitor(0)
        .build());
    
    internet_monitor_resource = aws.cloudwatch.InternetMonitor("internetMonitorResource",
        monitor_name="string",
        health_events_config={
            "availabilityScoreThreshold": 0,
            "performanceScoreThreshold": 0,
        },
        internet_measurements_log_delivery={
            "s3Config": {
                "bucketName": "string",
                "bucketPrefix": "string",
                "logDeliveryStatus": "string",
            },
        },
        max_city_networks_to_monitor=0,
        resources=["string"],
        status="string",
        tags={
            "string": "string",
        },
        traffic_percentage_to_monitor=0)
    
    const internetMonitorResource = new aws.cloudwatch.InternetMonitor("internetMonitorResource", {
        monitorName: "string",
        healthEventsConfig: {
            availabilityScoreThreshold: 0,
            performanceScoreThreshold: 0,
        },
        internetMeasurementsLogDelivery: {
            s3Config: {
                bucketName: "string",
                bucketPrefix: "string",
                logDeliveryStatus: "string",
            },
        },
        maxCityNetworksToMonitor: 0,
        resources: ["string"],
        status: "string",
        tags: {
            string: "string",
        },
        trafficPercentageToMonitor: 0,
    });
    
    type: aws:cloudwatch:InternetMonitor
    properties:
        healthEventsConfig:
            availabilityScoreThreshold: 0
            performanceScoreThreshold: 0
        internetMeasurementsLogDelivery:
            s3Config:
                bucketName: string
                bucketPrefix: string
                logDeliveryStatus: string
        maxCityNetworksToMonitor: 0
        monitorName: string
        resources:
            - string
        status: string
        tags:
            string: string
        trafficPercentageToMonitor: 0
    

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

    MonitorName string

    The name of the monitor.

    The following arguments are optional:

    HealthEventsConfig InternetMonitorHealthEventsConfig
    Health event thresholds. A health event threshold percentage, for performance and availability, determines when Internet Monitor creates a health event when there's an internet issue that affects your application end users. See Health Events Config below.
    InternetMeasurementsLogDelivery InternetMonitorInternetMeasurementsLogDelivery
    Publish internet measurements for Internet Monitor to an Amazon S3 bucket in addition to CloudWatch Logs.
    MaxCityNetworksToMonitor int
    The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the network or ASN, such as an internet service provider (ISP), that clients access the resources through. This limit helps control billing costs.
    Resources List<string>
    The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs).
    Status string
    The status for a monitor. The accepted values for Status with the UpdateMonitor API call are the following: ACTIVE and INACTIVE.
    Tags Dictionary<string, string>
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TrafficPercentageToMonitor int
    The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.
    MonitorName string

    The name of the monitor.

    The following arguments are optional:

    HealthEventsConfig InternetMonitorHealthEventsConfigArgs
    Health event thresholds. A health event threshold percentage, for performance and availability, determines when Internet Monitor creates a health event when there's an internet issue that affects your application end users. See Health Events Config below.
    InternetMeasurementsLogDelivery InternetMonitorInternetMeasurementsLogDeliveryArgs
    Publish internet measurements for Internet Monitor to an Amazon S3 bucket in addition to CloudWatch Logs.
    MaxCityNetworksToMonitor int
    The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the network or ASN, such as an internet service provider (ISP), that clients access the resources through. This limit helps control billing costs.
    Resources []string
    The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs).
    Status string
    The status for a monitor. The accepted values for Status with the UpdateMonitor API call are the following: ACTIVE and INACTIVE.
    Tags map[string]string
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TrafficPercentageToMonitor int
    The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.
    monitorName String

    The name of the monitor.

    The following arguments are optional:

    healthEventsConfig InternetMonitorHealthEventsConfig
    Health event thresholds. A health event threshold percentage, for performance and availability, determines when Internet Monitor creates a health event when there's an internet issue that affects your application end users. See Health Events Config below.
    internetMeasurementsLogDelivery InternetMonitorInternetMeasurementsLogDelivery
    Publish internet measurements for Internet Monitor to an Amazon S3 bucket in addition to CloudWatch Logs.
    maxCityNetworksToMonitor Integer
    The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the network or ASN, such as an internet service provider (ISP), that clients access the resources through. This limit helps control billing costs.
    resources List<String>
    The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs).
    status String
    The status for a monitor. The accepted values for Status with the UpdateMonitor API call are the following: ACTIVE and INACTIVE.
    tags Map<String,String>
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    trafficPercentageToMonitor Integer
    The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.
    monitorName string

    The name of the monitor.

    The following arguments are optional:

    healthEventsConfig InternetMonitorHealthEventsConfig
    Health event thresholds. A health event threshold percentage, for performance and availability, determines when Internet Monitor creates a health event when there's an internet issue that affects your application end users. See Health Events Config below.
    internetMeasurementsLogDelivery InternetMonitorInternetMeasurementsLogDelivery
    Publish internet measurements for Internet Monitor to an Amazon S3 bucket in addition to CloudWatch Logs.
    maxCityNetworksToMonitor number
    The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the network or ASN, such as an internet service provider (ISP), that clients access the resources through. This limit helps control billing costs.
    resources string[]
    The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs).
    status string
    The status for a monitor. The accepted values for Status with the UpdateMonitor API call are the following: ACTIVE and INACTIVE.
    tags {[key: string]: string}
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    trafficPercentageToMonitor number
    The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.
    monitor_name str

    The name of the monitor.

    The following arguments are optional:

    health_events_config InternetMonitorHealthEventsConfigArgs
    Health event thresholds. A health event threshold percentage, for performance and availability, determines when Internet Monitor creates a health event when there's an internet issue that affects your application end users. See Health Events Config below.
    internet_measurements_log_delivery InternetMonitorInternetMeasurementsLogDeliveryArgs
    Publish internet measurements for Internet Monitor to an Amazon S3 bucket in addition to CloudWatch Logs.
    max_city_networks_to_monitor int
    The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the network or ASN, such as an internet service provider (ISP), that clients access the resources through. This limit helps control billing costs.
    resources Sequence[str]
    The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs).
    status str
    The status for a monitor. The accepted values for Status with the UpdateMonitor API call are the following: ACTIVE and INACTIVE.
    tags Mapping[str, str]
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    traffic_percentage_to_monitor int
    The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.
    monitorName String

    The name of the monitor.

    The following arguments are optional:

    healthEventsConfig Property Map
    Health event thresholds. A health event threshold percentage, for performance and availability, determines when Internet Monitor creates a health event when there's an internet issue that affects your application end users. See Health Events Config below.
    internetMeasurementsLogDelivery Property Map
    Publish internet measurements for Internet Monitor to an Amazon S3 bucket in addition to CloudWatch Logs.
    maxCityNetworksToMonitor Number
    The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the network or ASN, such as an internet service provider (ISP), that clients access the resources through. This limit helps control billing costs.
    resources List<String>
    The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs).
    status String
    The status for a monitor. The accepted values for Status with the UpdateMonitor API call are the following: ACTIVE and INACTIVE.
    tags Map<String>
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    trafficPercentageToMonitor Number
    The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.

    Outputs

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

    Arn string
    ARN of the Monitor.
    Id string
    The provider-assigned unique ID for this managed resource.
    TagsAll Dictionary<string, string>
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    Arn string
    ARN of the Monitor.
    Id string
    The provider-assigned unique ID for this managed resource.
    TagsAll map[string]string
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    arn String
    ARN of the Monitor.
    id String
    The provider-assigned unique ID for this managed resource.
    tagsAll Map<String,String>
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    arn string
    ARN of the Monitor.
    id string
    The provider-assigned unique ID for this managed resource.
    tagsAll {[key: string]: string}
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    arn str
    ARN of the Monitor.
    id str
    The provider-assigned unique ID for this managed resource.
    tags_all Mapping[str, str]
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    arn String
    ARN of the Monitor.
    id String
    The provider-assigned unique ID for this managed resource.
    tagsAll Map<String>
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    Look up Existing InternetMonitor Resource

    Get an existing InternetMonitor 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?: InternetMonitorState, opts?: CustomResourceOptions): InternetMonitor
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            arn: Optional[str] = None,
            health_events_config: Optional[InternetMonitorHealthEventsConfigArgs] = None,
            internet_measurements_log_delivery: Optional[InternetMonitorInternetMeasurementsLogDeliveryArgs] = None,
            max_city_networks_to_monitor: Optional[int] = None,
            monitor_name: Optional[str] = None,
            resources: Optional[Sequence[str]] = None,
            status: Optional[str] = None,
            tags: Optional[Mapping[str, str]] = None,
            tags_all: Optional[Mapping[str, str]] = None,
            traffic_percentage_to_monitor: Optional[int] = None) -> InternetMonitor
    func GetInternetMonitor(ctx *Context, name string, id IDInput, state *InternetMonitorState, opts ...ResourceOption) (*InternetMonitor, error)
    public static InternetMonitor Get(string name, Input<string> id, InternetMonitorState? state, CustomResourceOptions? opts = null)
    public static InternetMonitor get(String name, Output<String> id, InternetMonitorState 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:
    Arn string
    ARN of the Monitor.
    HealthEventsConfig InternetMonitorHealthEventsConfig
    Health event thresholds. A health event threshold percentage, for performance and availability, determines when Internet Monitor creates a health event when there's an internet issue that affects your application end users. See Health Events Config below.
    InternetMeasurementsLogDelivery InternetMonitorInternetMeasurementsLogDelivery
    Publish internet measurements for Internet Monitor to an Amazon S3 bucket in addition to CloudWatch Logs.
    MaxCityNetworksToMonitor int
    The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the network or ASN, such as an internet service provider (ISP), that clients access the resources through. This limit helps control billing costs.
    MonitorName string

    The name of the monitor.

    The following arguments are optional:

    Resources List<string>
    The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs).
    Status string
    The status for a monitor. The accepted values for Status with the UpdateMonitor API call are the following: ACTIVE and INACTIVE.
    Tags Dictionary<string, string>
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TagsAll Dictionary<string, string>
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    TrafficPercentageToMonitor int
    The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.
    Arn string
    ARN of the Monitor.
    HealthEventsConfig InternetMonitorHealthEventsConfigArgs
    Health event thresholds. A health event threshold percentage, for performance and availability, determines when Internet Monitor creates a health event when there's an internet issue that affects your application end users. See Health Events Config below.
    InternetMeasurementsLogDelivery InternetMonitorInternetMeasurementsLogDeliveryArgs
    Publish internet measurements for Internet Monitor to an Amazon S3 bucket in addition to CloudWatch Logs.
    MaxCityNetworksToMonitor int
    The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the network or ASN, such as an internet service provider (ISP), that clients access the resources through. This limit helps control billing costs.
    MonitorName string

    The name of the monitor.

    The following arguments are optional:

    Resources []string
    The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs).
    Status string
    The status for a monitor. The accepted values for Status with the UpdateMonitor API call are the following: ACTIVE and INACTIVE.
    Tags map[string]string
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TagsAll map[string]string
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    TrafficPercentageToMonitor int
    The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.
    arn String
    ARN of the Monitor.
    healthEventsConfig InternetMonitorHealthEventsConfig
    Health event thresholds. A health event threshold percentage, for performance and availability, determines when Internet Monitor creates a health event when there's an internet issue that affects your application end users. See Health Events Config below.
    internetMeasurementsLogDelivery InternetMonitorInternetMeasurementsLogDelivery
    Publish internet measurements for Internet Monitor to an Amazon S3 bucket in addition to CloudWatch Logs.
    maxCityNetworksToMonitor Integer
    The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the network or ASN, such as an internet service provider (ISP), that clients access the resources through. This limit helps control billing costs.
    monitorName String

    The name of the monitor.

    The following arguments are optional:

    resources List<String>
    The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs).
    status String
    The status for a monitor. The accepted values for Status with the UpdateMonitor API call are the following: ACTIVE and INACTIVE.
    tags Map<String,String>
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll Map<String,String>
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    trafficPercentageToMonitor Integer
    The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.
    arn string
    ARN of the Monitor.
    healthEventsConfig InternetMonitorHealthEventsConfig
    Health event thresholds. A health event threshold percentage, for performance and availability, determines when Internet Monitor creates a health event when there's an internet issue that affects your application end users. See Health Events Config below.
    internetMeasurementsLogDelivery InternetMonitorInternetMeasurementsLogDelivery
    Publish internet measurements for Internet Monitor to an Amazon S3 bucket in addition to CloudWatch Logs.
    maxCityNetworksToMonitor number
    The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the network or ASN, such as an internet service provider (ISP), that clients access the resources through. This limit helps control billing costs.
    monitorName string

    The name of the monitor.

    The following arguments are optional:

    resources string[]
    The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs).
    status string
    The status for a monitor. The accepted values for Status with the UpdateMonitor API call are the following: ACTIVE and INACTIVE.
    tags {[key: string]: string}
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll {[key: string]: string}
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    trafficPercentageToMonitor number
    The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.
    arn str
    ARN of the Monitor.
    health_events_config InternetMonitorHealthEventsConfigArgs
    Health event thresholds. A health event threshold percentage, for performance and availability, determines when Internet Monitor creates a health event when there's an internet issue that affects your application end users. See Health Events Config below.
    internet_measurements_log_delivery InternetMonitorInternetMeasurementsLogDeliveryArgs
    Publish internet measurements for Internet Monitor to an Amazon S3 bucket in addition to CloudWatch Logs.
    max_city_networks_to_monitor int
    The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the network or ASN, such as an internet service provider (ISP), that clients access the resources through. This limit helps control billing costs.
    monitor_name str

    The name of the monitor.

    The following arguments are optional:

    resources Sequence[str]
    The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs).
    status str
    The status for a monitor. The accepted values for Status with the UpdateMonitor API call are the following: ACTIVE and INACTIVE.
    tags Mapping[str, str]
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tags_all Mapping[str, str]
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    traffic_percentage_to_monitor int
    The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.
    arn String
    ARN of the Monitor.
    healthEventsConfig Property Map
    Health event thresholds. A health event threshold percentage, for performance and availability, determines when Internet Monitor creates a health event when there's an internet issue that affects your application end users. See Health Events Config below.
    internetMeasurementsLogDelivery Property Map
    Publish internet measurements for Internet Monitor to an Amazon S3 bucket in addition to CloudWatch Logs.
    maxCityNetworksToMonitor Number
    The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the network or ASN, such as an internet service provider (ISP), that clients access the resources through. This limit helps control billing costs.
    monitorName String

    The name of the monitor.

    The following arguments are optional:

    resources List<String>
    The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs).
    status String
    The status for a monitor. The accepted values for Status with the UpdateMonitor API call are the following: ACTIVE and INACTIVE.
    tags Map<String>
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll Map<String>
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    trafficPercentageToMonitor Number
    The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.

    Supporting Types

    InternetMonitorHealthEventsConfig, InternetMonitorHealthEventsConfigArgs

    AvailabilityScoreThreshold double
    The health event threshold percentage set for availability scores.
    PerformanceScoreThreshold double
    The health event threshold percentage set for performance scores.
    AvailabilityScoreThreshold float64
    The health event threshold percentage set for availability scores.
    PerformanceScoreThreshold float64
    The health event threshold percentage set for performance scores.
    availabilityScoreThreshold Double
    The health event threshold percentage set for availability scores.
    performanceScoreThreshold Double
    The health event threshold percentage set for performance scores.
    availabilityScoreThreshold number
    The health event threshold percentage set for availability scores.
    performanceScoreThreshold number
    The health event threshold percentage set for performance scores.
    availability_score_threshold float
    The health event threshold percentage set for availability scores.
    performance_score_threshold float
    The health event threshold percentage set for performance scores.
    availabilityScoreThreshold Number
    The health event threshold percentage set for availability scores.
    performanceScoreThreshold Number
    The health event threshold percentage set for performance scores.

    InternetMonitorInternetMeasurementsLogDelivery, InternetMonitorInternetMeasurementsLogDeliveryArgs

    InternetMonitorInternetMeasurementsLogDeliveryS3Config, InternetMonitorInternetMeasurementsLogDeliveryS3ConfigArgs

    Import

    Using pulumi import, import Internet Monitor Monitors using the monitor_name. For example:

    $ pulumi import aws:cloudwatch/internetMonitor:InternetMonitor some some-monitor
    

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

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo
    AWS v6.54.2 published on Wednesday, Oct 2, 2024 by Pulumi