Oracle Cloud Infrastructure v2.11.0 published on Thursday, Sep 19, 2024 by Pulumi
oci.HealthChecks.getPingMonitors
Explore with Pulumi AI
This data source provides the list of Ping Monitors in Oracle Cloud Infrastructure Health Checks service.
Gets a list of configured ping monitors.
Results are paginated based on page
and limit
. The opc-next-page
header provides
a URL for fetching the next page.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";
const testPingMonitors = oci.HealthChecks.getPingMonitors({
compartmentId: compartmentId,
displayName: pingMonitorDisplayName,
homeRegion: pingMonitorHomeRegion,
});
import pulumi
import pulumi_oci as oci
test_ping_monitors = oci.HealthChecks.get_ping_monitors(compartment_id=compartment_id,
display_name=ping_monitor_display_name,
home_region=ping_monitor_home_region)
package main
import (
"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/HealthChecks"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := HealthChecks.GetPingMonitors(ctx, &healthchecks.GetPingMonitorsArgs{
CompartmentId: compartmentId,
DisplayName: pulumi.StringRef(pingMonitorDisplayName),
HomeRegion: pulumi.StringRef(pingMonitorHomeRegion),
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;
return await Deployment.RunAsync(() =>
{
var testPingMonitors = Oci.HealthChecks.GetPingMonitors.Invoke(new()
{
CompartmentId = compartmentId,
DisplayName = pingMonitorDisplayName,
HomeRegion = pingMonitorHomeRegion,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.HealthChecks.HealthChecksFunctions;
import com.pulumi.oci.HealthChecks.inputs.GetPingMonitorsArgs;
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) {
final var testPingMonitors = HealthChecksFunctions.getPingMonitors(GetPingMonitorsArgs.builder()
.compartmentId(compartmentId)
.displayName(pingMonitorDisplayName)
.homeRegion(pingMonitorHomeRegion)
.build());
}
}
variables:
testPingMonitors:
fn::invoke:
Function: oci:HealthChecks:getPingMonitors
Arguments:
compartmentId: ${compartmentId}
displayName: ${pingMonitorDisplayName}
homeRegion: ${pingMonitorHomeRegion}
Using getPingMonitors
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getPingMonitors(args: GetPingMonitorsArgs, opts?: InvokeOptions): Promise<GetPingMonitorsResult>
function getPingMonitorsOutput(args: GetPingMonitorsOutputArgs, opts?: InvokeOptions): Output<GetPingMonitorsResult>
def get_ping_monitors(compartment_id: Optional[str] = None,
display_name: Optional[str] = None,
filters: Optional[Sequence[_healthchecks.GetPingMonitorsFilter]] = None,
home_region: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetPingMonitorsResult
def get_ping_monitors_output(compartment_id: Optional[pulumi.Input[str]] = None,
display_name: Optional[pulumi.Input[str]] = None,
filters: Optional[pulumi.Input[Sequence[pulumi.Input[_healthchecks.GetPingMonitorsFilterArgs]]]] = None,
home_region: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetPingMonitorsResult]
func GetPingMonitors(ctx *Context, args *GetPingMonitorsArgs, opts ...InvokeOption) (*GetPingMonitorsResult, error)
func GetPingMonitorsOutput(ctx *Context, args *GetPingMonitorsOutputArgs, opts ...InvokeOption) GetPingMonitorsResultOutput
> Note: This function is named GetPingMonitors
in the Go SDK.
public static class GetPingMonitors
{
public static Task<GetPingMonitorsResult> InvokeAsync(GetPingMonitorsArgs args, InvokeOptions? opts = null)
public static Output<GetPingMonitorsResult> Invoke(GetPingMonitorsInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetPingMonitorsResult> getPingMonitors(GetPingMonitorsArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: oci:HealthChecks/getPingMonitors:getPingMonitors
arguments:
# arguments dictionary
The following arguments are supported:
- Compartment
Id string - Filters results by compartment.
- Display
Name string - Filters results that exactly match the
displayName
field. - Filters
List<Get
Ping Monitors Filter> - Home
Region string - Filters results that match the
homeRegion
.
- Compartment
Id string - Filters results by compartment.
- Display
Name string - Filters results that exactly match the
displayName
field. - Filters
[]Get
Ping Monitors Filter - Home
Region string - Filters results that match the
homeRegion
.
- compartment
Id String - Filters results by compartment.
- display
Name String - Filters results that exactly match the
displayName
field. - filters
List<Get
Ping Monitors Filter> - home
Region String - Filters results that match the
homeRegion
.
- compartment
Id string - Filters results by compartment.
- display
Name string - Filters results that exactly match the
displayName
field. - filters
Get
Ping Monitors Filter[] - home
Region string - Filters results that match the
homeRegion
.
- compartment_
id str - Filters results by compartment.
- display_
name str - Filters results that exactly match the
displayName
field. - filters
Sequence[healthchecks.
Get Ping Monitors Filter] - home_
region str - Filters results that match the
homeRegion
.
- compartment
Id String - Filters results by compartment.
- display
Name String - Filters results that exactly match the
displayName
field. - filters List<Property Map>
- home
Region String - Filters results that match the
homeRegion
.
getPingMonitors Result
The following output properties are available:
- Compartment
Id string - The OCID of the compartment.
- Id string
- The provider-assigned unique ID for this managed resource.
- Ping
Monitors List<GetPing Monitors Ping Monitor> - The list of ping_monitors.
- Display
Name string - A user-friendly and mutable name suitable for display in a user interface.
- Filters
List<Get
Ping Monitors Filter> - Home
Region string - The region where updates must be made and where results must be fetched from.
- Compartment
Id string - The OCID of the compartment.
- Id string
- The provider-assigned unique ID for this managed resource.
- Ping
Monitors []GetPing Monitors Ping Monitor - The list of ping_monitors.
- Display
Name string - A user-friendly and mutable name suitable for display in a user interface.
- Filters
[]Get
Ping Monitors Filter - Home
Region string - The region where updates must be made and where results must be fetched from.
- compartment
Id String - The OCID of the compartment.
- id String
- The provider-assigned unique ID for this managed resource.
- ping
Monitors List<GetPing Monitors Ping Monitor> - The list of ping_monitors.
- display
Name String - A user-friendly and mutable name suitable for display in a user interface.
- filters
List<Get
Ping Monitors Filter> - home
Region String - The region where updates must be made and where results must be fetched from.
- compartment
Id string - The OCID of the compartment.
- id string
- The provider-assigned unique ID for this managed resource.
- ping
Monitors GetPing Monitors Ping Monitor[] - The list of ping_monitors.
- display
Name string - A user-friendly and mutable name suitable for display in a user interface.
- filters
Get
Ping Monitors Filter[] - home
Region string - The region where updates must be made and where results must be fetched from.
- compartment_
id str - The OCID of the compartment.
- id str
- The provider-assigned unique ID for this managed resource.
- ping_
monitors Sequence[healthchecks.Get Ping Monitors Ping Monitor] - The list of ping_monitors.
- display_
name str - A user-friendly and mutable name suitable for display in a user interface.
- filters
Sequence[healthchecks.
Get Ping Monitors Filter] - home_
region str - The region where updates must be made and where results must be fetched from.
- compartment
Id String - The OCID of the compartment.
- id String
- The provider-assigned unique ID for this managed resource.
- ping
Monitors List<Property Map> - The list of ping_monitors.
- display
Name String - A user-friendly and mutable name suitable for display in a user interface.
- filters List<Property Map>
- home
Region String - The region where updates must be made and where results must be fetched from.
Supporting Types
GetPingMonitorsFilter
GetPingMonitorsPingMonitor
- Compartment
Id string - Filters results by compartment.
- Dictionary<string, string>
- 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 string - Filters results that exactly match the
displayName
field. - Dictionary<string, string>
- 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"}
- Home
Region string - Filters results that match the
homeRegion
. - Id string
- The OCID of the resource.
- Interval
In intSeconds - The monitor interval in seconds. Valid values: 10, 30, and 60.
- Is
Enabled bool - Enables or disables the monitor. Set to 'true' to launch monitoring.
- Port int
- The port on which to probe endpoints. If unspecified, probes will use the default port of their protocol.
- Protocol string
- The protocols for ping probes.
- Results
Url string - A URL for fetching the probe results.
- Targets List<string>
- A list of targets (hostnames or IP addresses) of the probe.
- Time
Created string - The RFC 3339-formatted creation date and time of the probe.
- Timeout
In intSeconds - The probe timeout in seconds. Valid values: 10, 20, 30, and 60. The probe timeout must be less than or equal to
intervalInSeconds
for monitors. - Vantage
Point List<string>Names - A list of names of vantage points from which to execute the probe.
- Compartment
Id string - Filters results by compartment.
- map[string]string
- 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 string - Filters results that exactly match the
displayName
field. - map[string]string
- 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"}
- Home
Region string - Filters results that match the
homeRegion
. - Id string
- The OCID of the resource.
- Interval
In intSeconds - The monitor interval in seconds. Valid values: 10, 30, and 60.
- Is
Enabled bool - Enables or disables the monitor. Set to 'true' to launch monitoring.
- Port int
- The port on which to probe endpoints. If unspecified, probes will use the default port of their protocol.
- Protocol string
- The protocols for ping probes.
- Results
Url string - A URL for fetching the probe results.
- Targets []string
- A list of targets (hostnames or IP addresses) of the probe.
- Time
Created string - The RFC 3339-formatted creation date and time of the probe.
- Timeout
In intSeconds - The probe timeout in seconds. Valid values: 10, 20, 30, and 60. The probe timeout must be less than or equal to
intervalInSeconds
for monitors. - Vantage
Point []stringNames - A list of names of vantage points from which to execute the probe.
- compartment
Id String - Filters results by compartment.
- Map<String,String>
- 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 String - Filters results that exactly match the
displayName
field. - Map<String,String>
- 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"}
- home
Region String - Filters results that match the
homeRegion
. - id String
- The OCID of the resource.
- interval
In IntegerSeconds - The monitor interval in seconds. Valid values: 10, 30, and 60.
- is
Enabled Boolean - Enables or disables the monitor. Set to 'true' to launch monitoring.
- port Integer
- The port on which to probe endpoints. If unspecified, probes will use the default port of their protocol.
- protocol String
- The protocols for ping probes.
- results
Url String - A URL for fetching the probe results.
- targets List<String>
- A list of targets (hostnames or IP addresses) of the probe.
- time
Created String - The RFC 3339-formatted creation date and time of the probe.
- timeout
In IntegerSeconds - The probe timeout in seconds. Valid values: 10, 20, 30, and 60. The probe timeout must be less than or equal to
intervalInSeconds
for monitors. - vantage
Point List<String>Names - A list of names of vantage points from which to execute the probe.
- compartment
Id string - Filters results by compartment.
- {[key: string]: string}
- 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 string - Filters results that exactly match the
displayName
field. - {[key: string]: string}
- 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"}
- home
Region string - Filters results that match the
homeRegion
. - id string
- The OCID of the resource.
- interval
In numberSeconds - The monitor interval in seconds. Valid values: 10, 30, and 60.
- is
Enabled boolean - Enables or disables the monitor. Set to 'true' to launch monitoring.
- port number
- The port on which to probe endpoints. If unspecified, probes will use the default port of their protocol.
- protocol string
- The protocols for ping probes.
- results
Url string - A URL for fetching the probe results.
- targets string[]
- A list of targets (hostnames or IP addresses) of the probe.
- time
Created string - The RFC 3339-formatted creation date and time of the probe.
- timeout
In numberSeconds - The probe timeout in seconds. Valid values: 10, 20, 30, and 60. The probe timeout must be less than or equal to
intervalInSeconds
for monitors. - vantage
Point string[]Names - A list of names of vantage points from which to execute the probe.
- compartment_
id str - Filters results by compartment.
- Mapping[str, str]
- 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 str - Filters results that exactly match the
displayName
field. - Mapping[str, str]
- 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"}
- home_
region str - Filters results that match the
homeRegion
. - id str
- The OCID of the resource.
- interval_
in_ intseconds - The monitor interval in seconds. Valid values: 10, 30, and 60.
- is_
enabled bool - Enables or disables the monitor. Set to 'true' to launch monitoring.
- port int
- The port on which to probe endpoints. If unspecified, probes will use the default port of their protocol.
- protocol str
- The protocols for ping probes.
- results_
url str - A URL for fetching the probe results.
- targets Sequence[str]
- A list of targets (hostnames or IP addresses) of the probe.
- time_
created str - The RFC 3339-formatted creation date and time of the probe.
- timeout_
in_ intseconds - The probe timeout in seconds. Valid values: 10, 20, 30, and 60. The probe timeout must be less than or equal to
intervalInSeconds
for monitors. - vantage_
point_ Sequence[str]names - A list of names of vantage points from which to execute the probe.
- compartment
Id String - Filters results by compartment.
- Map<String>
- 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 String - Filters results that exactly match the
displayName
field. - Map<String>
- 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"}
- home
Region String - Filters results that match the
homeRegion
. - id String
- The OCID of the resource.
- interval
In NumberSeconds - The monitor interval in seconds. Valid values: 10, 30, and 60.
- is
Enabled Boolean - Enables or disables the monitor. Set to 'true' to launch monitoring.
- port Number
- The port on which to probe endpoints. If unspecified, probes will use the default port of their protocol.
- protocol String
- The protocols for ping probes.
- results
Url String - A URL for fetching the probe results.
- targets List<String>
- A list of targets (hostnames or IP addresses) of the probe.
- time
Created String - The RFC 3339-formatted creation date and time of the probe.
- timeout
In NumberSeconds - The probe timeout in seconds. Valid values: 10, 20, 30, and 60. The probe timeout must be less than or equal to
intervalInSeconds
for monitors. - vantage
Point List<String>Names - A list of names of vantage points from which to execute the probe.
Package Details
- Repository
- oci pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
oci
Terraform Provider.