oci_health_checks_http_monitor
This resource provides the Http Monitor resource in Oracle Cloud Infrastructure Health Checks service.
Creates an HTTP monitor. Vantage points will be automatically selected if not specified,
and probes will be initiated from each vantage point to each of the targets at the frequency
specified by intervalInSeconds
.
Example Usage
resource "oci_health_checks_http_monitor" "test_http_monitor" {
#Required
compartment_id = var.compartment_id
display_name = var.http_monitor_display_name
interval_in_seconds = var.http_monitor_interval_in_seconds
protocol = var.http_monitor_protocol
targets = var.http_monitor_targets
#Optional
defined_tags = {"Operations.CostCenter"= "42"}
freeform_tags = {"Department"= "Finance"}
headers = var.http_monitor_headers
is_enabled = var.http_monitor_is_enabled
method = var.http_monitor_method
path = var.http_monitor_path
port = var.http_monitor_port
timeout_in_seconds = var.http_monitor_timeout_in_seconds
vantage_point_names = var.http_monitor_vantage_point_names
}
Argument Reference
The following arguments are supported:
compartment_id
- (Required) (Updatable) The OCID of the compartment.defined_tags
- (Optional) (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:{"Operations.CostCenter": "42"}
display_name
- (Required) (Updatable) A user-friendly and mutable name suitable for display in a user interface.freeform_tags
- (Optional) (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:{"Department": "Finance"}
headers
- (Optional) (Updatable) A dictionary of HTTP request headers.Note: Monitors and probes do not support the use of the
Authorization
HTTP header.interval_in_seconds
- (Required) (Updatable) The monitor interval in seconds. Valid values: 10, 30, and 60.is_enabled
- (Optional) (Updatable) Enables or disables the monitor. Set to ‘true’ to launch monitoring.method
- (Optional) (Updatable) The supported HTTP methods available for probes.path
- (Optional) (Updatable) The optional URL path to probe, including query parameters.port
- (Optional) (Updatable) The port on which to probe endpoints. If unspecified, probes will use the default port of their protocol.protocol
- (Required) (Updatable) The supported protocols available for HTTP probes.targets
- (Required) (Updatable) A list of targets (hostnames or IP addresses) of the probe.timeout_in_seconds
- (Optional) (Updatable) The probe timeout in seconds. Valid values: 10, 20, 30, and 60. The probe timeout must be less than or equal tointervalInSeconds
for monitors.vantage_point_names
- (Optional) (Updatable) A list of names of vantage points from which to execute the probe.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
Attributes Reference
The following attributes are exported:
compartment_id
- The OCID of the compartment.defined_tags
- Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:{"Operations.CostCenter": "42"}
display_name
- A user-friendly and mutable name suitable for display in a user interface.freeform_tags
- Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:{"Department": "Finance"}
headers
- A dictionary of HTTP request headers.Note: Monitors and probes do not support the use of the
Authorization
HTTP header.home_region
- The region where updates must be made and where results must be fetched from.id
- The OCID of the resource.interval_in_seconds
- The monitor interval in seconds. Valid values: 10, 30, and 60.is_enabled
- Enables or disables the monitor. Set to ‘true’ to launch monitoring.method
- The supported HTTP methods available for probes.path
- The optional URL path to probe, including query parameters.port
- The port on which to probe endpoints. If unspecified, probes will use the default port of their protocol.protocol
- The supported protocols available for HTTP probes.results_url
- A URL for fetching the probe results.targets
- A list of targets (hostnames or IP addresses) of the probe.time_created
- The RFC 3339-formatted creation date and time of the probe.timeout_in_seconds
- The probe timeout in seconds. Valid values: 10, 20, 30, and 60. The probe timeout must be less than or equal tointervalInSeconds
for monitors.vantage_point_names
- A list of names of vantage points from which to execute the probe.
Timeouts
The timeouts
block allows you to specify timeouts for certain operations:
* create
- (Defaults to 20 minutes), when creating the Http Monitor
* update
- (Defaults to 20 minutes), when updating the Http Monitor
* delete
- (Defaults to 20 minutes), when destroying the Http Monitor
Import
HttpMonitors can be imported using the id
, e.g.
$ terraform import oci_health_checks_http_monitor.test_http_monitor "id"