checkly.CheckGroup
Check groups allow you to group together a set of related checks, which can also share default settings for various attributes.
Example Usage
using Pulumi;
using Checkly = Pulumi.Checkly;
class MyStack : Stack
{
public MyStack()
{
var testGroup1CheckGroup = new Checkly.CheckGroup("testGroup1CheckGroup", new Checkly.CheckGroupArgs
{
Activated = true,
Muted = false,
Tags =
{
"auto",
},
Locations =
{
"eu-west-1",
},
Concurrency = 3,
ApiCheckDefaults = new Checkly.Inputs.CheckGroupApiCheckDefaultsArgs
{
Url = "http://example.com/",
Headers =
{
{ "X-Test", "foo" },
},
QueryParameters =
{
{ "query", "foo" },
},
Assertions =
{
new Checkly.Inputs.CheckGroupApiCheckDefaultsAssertionArgs
{
Source = "STATUS_CODE",
Property = "",
Comparison = "EQUALS",
Target = "200",
},
new Checkly.Inputs.CheckGroupApiCheckDefaultsAssertionArgs
{
Source = "TEXT_BODY",
Property = "",
Comparison = "CONTAINS",
Target = "welcome",
},
},
BasicAuth = new Checkly.Inputs.CheckGroupApiCheckDefaultsBasicAuthArgs
{
Username = "user",
Password = "pass",
},
},
EnvironmentVariables =
{
{ "ENVTEST", "Hello world" },
},
DoubleCheck = true,
UseGlobalAlertSettings = false,
AlertSettings = new Checkly.Inputs.CheckGroupAlertSettingsArgs
{
EscalationType = "RUN_BASED",
RunBasedEscalations =
{
new Checkly.Inputs.CheckGroupAlertSettingsRunBasedEscalationArgs
{
FailedRunThreshold = 1,
},
},
TimeBasedEscalations =
{
new Checkly.Inputs.CheckGroupAlertSettingsTimeBasedEscalationArgs
{
MinutesFailingThreshold = 5,
},
},
Reminders =
{
new Checkly.Inputs.CheckGroupAlertSettingsReminderArgs
{
Amount = 2,
Interval = 5,
},
},
},
LocalSetupScript = "setup-test",
LocalTeardownScript = "teardown-test",
});
// Add a check to a group
var testCheck1 = new Checkly.Check("testCheck1", new Checkly.CheckArgs
{
GroupId = testGroup1CheckGroup.Id,
GroupOrder = 1,
});
// Using with alert channels
var emailAc1 = new Checkly.AlertChannel("emailAc1", new Checkly.AlertChannelArgs
{
Email = new Checkly.Inputs.AlertChannelEmailArgs
{
Address = "info@example.com",
},
});
var emailAc2 = new Checkly.AlertChannel("emailAc2", new Checkly.AlertChannelArgs
{
Email = new Checkly.Inputs.AlertChannelEmailArgs
{
Address = "info2@example.com",
},
});
// Connect the check group to the alert channels
var testGroup1Index_checkGroupCheckGroup = new Checkly.CheckGroup("testGroup1Index/checkGroupCheckGroup", new Checkly.CheckGroupArgs
{
AlertChannelSubscriptions =
{
new Checkly.Inputs.CheckGroupAlertChannelSubscriptionArgs
{
ChannelId = emailAc1.Id,
Activated = true,
},
new Checkly.Inputs.CheckGroupAlertChannelSubscriptionArgs
{
ChannelId = emailAc2.Id,
Activated = true,
},
},
});
}
}
package main
import (
"github.com/checkly/pulumi-checkly/sdk/go/checkly"
"github.com/pulumi/pulumi-checkly/sdk/go/checkly"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
testGroup1CheckGroup, err := checkly.NewCheckGroup(ctx, "testGroup1CheckGroup", &checkly.CheckGroupArgs{
Activated: pulumi.Bool(true),
Muted: pulumi.Bool(false),
Tags: pulumi.StringArray{
pulumi.String("auto"),
},
Locations: pulumi.StringArray{
pulumi.String("eu-west-1"),
},
Concurrency: pulumi.Int(3),
ApiCheckDefaults: &CheckGroupApiCheckDefaultsArgs{
Url: pulumi.String("http://example.com/"),
Headers: pulumi.AnyMap{
"X-Test": pulumi.Any("foo"),
},
QueryParameters: pulumi.AnyMap{
"query": pulumi.Any("foo"),
},
Assertions: CheckGroupApiCheckDefaultsAssertionArray{
&CheckGroupApiCheckDefaultsAssertionArgs{
Source: pulumi.String("STATUS_CODE"),
Property: pulumi.String(""),
Comparison: pulumi.String("EQUALS"),
Target: pulumi.String("200"),
},
&CheckGroupApiCheckDefaultsAssertionArgs{
Source: pulumi.String("TEXT_BODY"),
Property: pulumi.String(""),
Comparison: pulumi.String("CONTAINS"),
Target: pulumi.String("welcome"),
},
},
BasicAuth: &CheckGroupApiCheckDefaultsBasicAuthArgs{
Username: pulumi.String("user"),
Password: pulumi.String("pass"),
},
},
EnvironmentVariables: pulumi.AnyMap{
"ENVTEST": pulumi.Any("Hello world"),
},
DoubleCheck: pulumi.Bool(true),
UseGlobalAlertSettings: pulumi.Bool(false),
AlertSettings: &CheckGroupAlertSettingsArgs{
EscalationType: pulumi.String("RUN_BASED"),
RunBasedEscalations: CheckGroupAlertSettingsRunBasedEscalationArray{
&CheckGroupAlertSettingsRunBasedEscalationArgs{
FailedRunThreshold: pulumi.Int(1),
},
},
TimeBasedEscalations: CheckGroupAlertSettingsTimeBasedEscalationArray{
&CheckGroupAlertSettingsTimeBasedEscalationArgs{
MinutesFailingThreshold: pulumi.Int(5),
},
},
Reminders: CheckGroupAlertSettingsReminderArray{
&CheckGroupAlertSettingsReminderArgs{
Amount: pulumi.Int(2),
Interval: pulumi.Int(5),
},
},
},
LocalSetupScript: pulumi.String("setup-test"),
LocalTeardownScript: pulumi.String("teardown-test"),
})
if err != nil {
return err
}
_, err = checkly.NewCheck(ctx, "testCheck1", &checkly.CheckArgs{
GroupId: testGroup1CheckGroup.ID(),
GroupOrder: pulumi.Int(1),
})
if err != nil {
return err
}
emailAc1, err := checkly.NewAlertChannel(ctx, "emailAc1", &checkly.AlertChannelArgs{
Email: &AlertChannelEmailArgs{
Address: pulumi.String("info@example.com"),
},
})
if err != nil {
return err
}
emailAc2, err := checkly.NewAlertChannel(ctx, "emailAc2", &checkly.AlertChannelArgs{
Email: &AlertChannelEmailArgs{
Address: pulumi.String("info2@example.com"),
},
})
if err != nil {
return err
}
_, err = checkly.NewCheckGroup(ctx, "testGroup1Index/checkGroupCheckGroup", &checkly.CheckGroupArgs{
AlertChannelSubscriptions: CheckGroupAlertChannelSubscriptionArray{
&CheckGroupAlertChannelSubscriptionArgs{
ChannelId: emailAc1.ID(),
Activated: pulumi.Bool(true),
},
&CheckGroupAlertChannelSubscriptionArgs{
ChannelId: emailAc2.ID(),
Activated: pulumi.Bool(true),
},
},
})
if err != nil {
return err
}
return nil
})
}
Coming soon!
import pulumi
import pulumi_checkly as checkly
test_group1_check_group = checkly.CheckGroup("testGroup1CheckGroup",
activated=True,
muted=False,
tags=["auto"],
locations=["eu-west-1"],
concurrency=3,
api_check_defaults=checkly.CheckGroupApiCheckDefaultsArgs(
url="http://example.com/",
headers={
"X-Test": "foo",
},
query_parameters={
"query": "foo",
},
assertions=[
checkly.CheckGroupApiCheckDefaultsAssertionArgs(
source="STATUS_CODE",
property="",
comparison="EQUALS",
target="200",
),
checkly.CheckGroupApiCheckDefaultsAssertionArgs(
source="TEXT_BODY",
property="",
comparison="CONTAINS",
target="welcome",
),
],
basic_auth=checkly.CheckGroupApiCheckDefaultsBasicAuthArgs(
username="user",
password="pass",
),
),
environment_variables={
"ENVTEST": "Hello world",
},
double_check=True,
use_global_alert_settings=False,
alert_settings=checkly.CheckGroupAlertSettingsArgs(
escalation_type="RUN_BASED",
run_based_escalations=[checkly.CheckGroupAlertSettingsRunBasedEscalationArgs(
failed_run_threshold=1,
)],
time_based_escalations=[checkly.CheckGroupAlertSettingsTimeBasedEscalationArgs(
minutes_failing_threshold=5,
)],
reminders=[checkly.CheckGroupAlertSettingsReminderArgs(
amount=2,
interval=5,
)],
),
local_setup_script="setup-test",
local_teardown_script="teardown-test")
# Add a check to a group
test_check1 = checkly.Check("testCheck1",
group_id=test_group1_check_group.id,
group_order=1)
# Using with alert channels
email_ac1 = checkly.AlertChannel("emailAc1", email=checkly.AlertChannelEmailArgs(
address="info@example.com",
))
email_ac2 = checkly.AlertChannel("emailAc2", email=checkly.AlertChannelEmailArgs(
address="info2@example.com",
))
# Connect the check group to the alert channels
test_group1_index_check_group_check_group = checkly.CheckGroup("testGroup1Index/checkGroupCheckGroup", alert_channel_subscriptions=[
checkly.CheckGroupAlertChannelSubscriptionArgs(
channel_id=email_ac1.id,
activated=True,
),
checkly.CheckGroupAlertChannelSubscriptionArgs(
channel_id=email_ac2.id,
activated=True,
),
])
import * as pulumi from "@pulumi/pulumi";
import * as pulumi from "@checkly/pulumi";
const testGroup1CheckGroup = new checkly.CheckGroup("testGroup1CheckGroup", {
activated: true,
muted: false,
tags: ["auto"],
locations: ["eu-west-1"],
concurrency: 3,
apiCheckDefaults: {
url: "http://example.com/",
headers: {
"X-Test": "foo",
},
queryParameters: {
query: "foo",
},
assertions: [
{
source: "STATUS_CODE",
property: "",
comparison: "EQUALS",
target: "200",
},
{
source: "TEXT_BODY",
property: "",
comparison: "CONTAINS",
target: "welcome",
},
],
basicAuth: {
username: "user",
password: "pass",
},
},
environmentVariables: {
ENVTEST: "Hello world",
},
doubleCheck: true,
useGlobalAlertSettings: false,
alertSettings: {
escalationType: "RUN_BASED",
runBasedEscalations: [{
failedRunThreshold: 1,
}],
timeBasedEscalations: [{
minutesFailingThreshold: 5,
}],
reminders: [{
amount: 2,
interval: 5,
}],
},
localSetupScript: "setup-test",
localTeardownScript: "teardown-test",
});
// Add a check to a group
const testCheck1 = new checkly.Check("testCheck1", {
groupId: testGroup1CheckGroup.id,
groupOrder: 1,
});
// Using with alert channels
const emailAc1 = new checkly.AlertChannel("emailAc1", {email: {
address: "info@example.com",
}});
const emailAc2 = new checkly.AlertChannel("emailAc2", {email: {
address: "info2@example.com",
}});
// Connect the check group to the alert channels
const testGroup1Index_checkGroupCheckGroup = new checkly.CheckGroup("testGroup1Index/checkGroupCheckGroup", {alertChannelSubscriptions: [
{
channelId: emailAc1.id,
activated: true,
},
{
channelId: emailAc2.id,
activated: true,
},
]});
Coming soon!
Create CheckGroup Resource
new CheckGroup(name: string, args: CheckGroupArgs, opts?: CustomResourceOptions);
@overload
def CheckGroup(resource_name: str,
opts: Optional[ResourceOptions] = None,
activated: Optional[bool] = None,
alert_channel_subscriptions: Optional[Sequence[CheckGroupAlertChannelSubscriptionArgs]] = None,
alert_settings: Optional[CheckGroupAlertSettingsArgs] = None,
api_check_defaults: Optional[CheckGroupApiCheckDefaultsArgs] = None,
concurrency: Optional[int] = None,
double_check: Optional[bool] = None,
environment_variables: Optional[Mapping[str, Any]] = None,
local_setup_script: Optional[str] = None,
local_teardown_script: Optional[str] = None,
locations: Optional[Sequence[str]] = None,
muted: Optional[bool] = None,
name: Optional[str] = None,
private_locations: Optional[Sequence[str]] = None,
runtime_id: Optional[str] = None,
setup_snippet_id: Optional[int] = None,
tags: Optional[Sequence[str]] = None,
teardown_snippet_id: Optional[int] = None,
use_global_alert_settings: Optional[bool] = None)
@overload
def CheckGroup(resource_name: str,
args: CheckGroupArgs,
opts: Optional[ResourceOptions] = None)
func NewCheckGroup(ctx *Context, name string, args CheckGroupArgs, opts ...ResourceOption) (*CheckGroup, error)
public CheckGroup(string name, CheckGroupArgs args, CustomResourceOptions? opts = null)
public CheckGroup(String name, CheckGroupArgs args)
public CheckGroup(String name, CheckGroupArgs args, CustomResourceOptions options)
type: checkly:CheckGroup
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args CheckGroupArgs
- 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 CheckGroupArgs
- 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 CheckGroupArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args CheckGroupArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args CheckGroupArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
CheckGroup 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 CheckGroup resource accepts the following input properties:
- Activated bool
Determines if the checks in the group are running or not.
- Concurrency int
Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- Alert
Channel List<CheckSubscriptions Group Alert Channel Subscription Args> - Alert
Settings CheckGroup Alert Settings Args - Api
Check CheckDefaults Group Api Check Defaults Args - Double
Check bool Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed.- Environment
Variables Dictionary<string, object> Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
The property
environment_variables
is deprecated and will be removed in a future version. Consider using the newenvironment_variable
list.- Local
Setup stringScript A valid piece of Node.js code to run in the setup phase of an API check in this group.
- Local
Teardown stringScript A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- Locations List<string>
An array of one or more data center locations where to run the checks.
- Muted bool
Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- Name string
The name of the check group.
- Private
Locations List<string> An array of one or more private locations slugs.
- Runtime
Id string The id of the runtime to use for this group.
- Setup
Snippet intId An ID reference to a snippet to use in the setup phase of an API check.
- List<string>
Tags for organizing and filtering checks.
- Teardown
Snippet intId An ID reference to a snippet to use in the teardown phase of an API check.
- Use
Global boolAlert Settings When true, the account level alert settings will be used, not the alert setting defined on this check group.
- Activated bool
Determines if the checks in the group are running or not.
- Concurrency int
Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- Alert
Channel []CheckSubscriptions Group Alert Channel Subscription Args - Alert
Settings CheckGroup Alert Settings Args - Api
Check CheckDefaults Group Api Check Defaults Args - Double
Check bool Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed.- Environment
Variables map[string]interface{} Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
The property
environment_variables
is deprecated and will be removed in a future version. Consider using the newenvironment_variable
list.- Local
Setup stringScript A valid piece of Node.js code to run in the setup phase of an API check in this group.
- Local
Teardown stringScript A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- Locations []string
An array of one or more data center locations where to run the checks.
- Muted bool
Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- Name string
The name of the check group.
- Private
Locations []string An array of one or more private locations slugs.
- Runtime
Id string The id of the runtime to use for this group.
- Setup
Snippet intId An ID reference to a snippet to use in the setup phase of an API check.
- []string
Tags for organizing and filtering checks.
- Teardown
Snippet intId An ID reference to a snippet to use in the teardown phase of an API check.
- Use
Global boolAlert Settings When true, the account level alert settings will be used, not the alert setting defined on this check group.
- activated Boolean
Determines if the checks in the group are running or not.
- concurrency Integer
Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- alert
Channel List<CheckSubscriptions Group Alert Channel Subscription Args> - alert
Settings CheckGroup Alert Settings Args - api
Check CheckDefaults Group Api Check Defaults Args - double
Check Boolean Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed.- environment
Variables Map<String,Object> Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
The property
environment_variables
is deprecated and will be removed in a future version. Consider using the newenvironment_variable
list.- local
Setup StringScript A valid piece of Node.js code to run in the setup phase of an API check in this group.
- local
Teardown StringScript A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- locations List<String>
An array of one or more data center locations where to run the checks.
- muted Boolean
Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- name String
The name of the check group.
- private
Locations List<String> An array of one or more private locations slugs.
- runtime
Id String The id of the runtime to use for this group.
- setup
Snippet IntegerId An ID reference to a snippet to use in the setup phase of an API check.
- List<String>
Tags for organizing and filtering checks.
- teardown
Snippet IntegerId An ID reference to a snippet to use in the teardown phase of an API check.
- use
Global BooleanAlert Settings When true, the account level alert settings will be used, not the alert setting defined on this check group.
- activated boolean
Determines if the checks in the group are running or not.
- concurrency number
Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- alert
Channel CheckSubscriptions Group Alert Channel Subscription Args[] - alert
Settings CheckGroup Alert Settings Args - api
Check CheckDefaults Group Api Check Defaults Args - double
Check boolean Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed.- environment
Variables {[key: string]: any} Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
The property
environment_variables
is deprecated and will be removed in a future version. Consider using the newenvironment_variable
list.- local
Setup stringScript A valid piece of Node.js code to run in the setup phase of an API check in this group.
- local
Teardown stringScript A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- locations string[]
An array of one or more data center locations where to run the checks.
- muted boolean
Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- name string
The name of the check group.
- private
Locations string[] An array of one or more private locations slugs.
- runtime
Id string The id of the runtime to use for this group.
- setup
Snippet numberId An ID reference to a snippet to use in the setup phase of an API check.
- string[]
Tags for organizing and filtering checks.
- teardown
Snippet numberId An ID reference to a snippet to use in the teardown phase of an API check.
- use
Global booleanAlert Settings When true, the account level alert settings will be used, not the alert setting defined on this check group.
- activated bool
Determines if the checks in the group are running or not.
- concurrency int
Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- alert_
channel_ Sequence[Checksubscriptions Group Alert Channel Subscription Args] - alert_
settings CheckGroup Alert Settings Args - api_
check_ Checkdefaults Group Api Check Defaults Args - double_
check bool Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed.- environment_
variables Mapping[str, Any] Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
The property
environment_variables
is deprecated and will be removed in a future version. Consider using the newenvironment_variable
list.- local_
setup_ strscript A valid piece of Node.js code to run in the setup phase of an API check in this group.
- local_
teardown_ strscript A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- locations Sequence[str]
An array of one or more data center locations where to run the checks.
- muted bool
Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- name str
The name of the check group.
- private_
locations Sequence[str] An array of one or more private locations slugs.
- runtime_
id str The id of the runtime to use for this group.
- setup_
snippet_ intid An ID reference to a snippet to use in the setup phase of an API check.
- Sequence[str]
Tags for organizing and filtering checks.
- teardown_
snippet_ intid An ID reference to a snippet to use in the teardown phase of an API check.
- use_
global_ boolalert_ settings When true, the account level alert settings will be used, not the alert setting defined on this check group.
- activated Boolean
Determines if the checks in the group are running or not.
- concurrency Number
Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- alert
Channel List<Property Map>Subscriptions - alert
Settings Property Map - api
Check Property MapDefaults - double
Check Boolean Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed.- environment
Variables Map<Any> Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
The property
environment_variables
is deprecated and will be removed in a future version. Consider using the newenvironment_variable
list.- local
Setup StringScript A valid piece of Node.js code to run in the setup phase of an API check in this group.
- local
Teardown StringScript A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- locations List<String>
An array of one or more data center locations where to run the checks.
- muted Boolean
Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- name String
The name of the check group.
- private
Locations List<String> An array of one or more private locations slugs.
- runtime
Id String The id of the runtime to use for this group.
- setup
Snippet NumberId An ID reference to a snippet to use in the setup phase of an API check.
- List<String>
Tags for organizing and filtering checks.
- teardown
Snippet NumberId An ID reference to a snippet to use in the teardown phase of an API check.
- use
Global BooleanAlert Settings When true, the account level alert settings will be used, not the alert setting defined on this check group.
Outputs
All input properties are implicitly available as output properties. Additionally, the CheckGroup 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 CheckGroup Resource
Get an existing CheckGroup 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?: CheckGroupState, opts?: CustomResourceOptions): CheckGroup
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
activated: Optional[bool] = None,
alert_channel_subscriptions: Optional[Sequence[CheckGroupAlertChannelSubscriptionArgs]] = None,
alert_settings: Optional[CheckGroupAlertSettingsArgs] = None,
api_check_defaults: Optional[CheckGroupApiCheckDefaultsArgs] = None,
concurrency: Optional[int] = None,
double_check: Optional[bool] = None,
environment_variables: Optional[Mapping[str, Any]] = None,
local_setup_script: Optional[str] = None,
local_teardown_script: Optional[str] = None,
locations: Optional[Sequence[str]] = None,
muted: Optional[bool] = None,
name: Optional[str] = None,
private_locations: Optional[Sequence[str]] = None,
runtime_id: Optional[str] = None,
setup_snippet_id: Optional[int] = None,
tags: Optional[Sequence[str]] = None,
teardown_snippet_id: Optional[int] = None,
use_global_alert_settings: Optional[bool] = None) -> CheckGroup
func GetCheckGroup(ctx *Context, name string, id IDInput, state *CheckGroupState, opts ...ResourceOption) (*CheckGroup, error)
public static CheckGroup Get(string name, Input<string> id, CheckGroupState? state, CustomResourceOptions? opts = null)
public static CheckGroup get(String name, Output<String> id, CheckGroupState 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.
- Activated bool
Determines if the checks in the group are running or not.
- Alert
Channel List<CheckSubscriptions Group Alert Channel Subscription Args> - Alert
Settings CheckGroup Alert Settings Args - Api
Check CheckDefaults Group Api Check Defaults Args - Concurrency int
Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- Double
Check bool Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed.- Environment
Variables Dictionary<string, object> Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
The property
environment_variables
is deprecated and will be removed in a future version. Consider using the newenvironment_variable
list.- Local
Setup stringScript A valid piece of Node.js code to run in the setup phase of an API check in this group.
- Local
Teardown stringScript A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- Locations List<string>
An array of one or more data center locations where to run the checks.
- Muted bool
Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- Name string
The name of the check group.
- Private
Locations List<string> An array of one or more private locations slugs.
- Runtime
Id string The id of the runtime to use for this group.
- Setup
Snippet intId An ID reference to a snippet to use in the setup phase of an API check.
- List<string>
Tags for organizing and filtering checks.
- Teardown
Snippet intId An ID reference to a snippet to use in the teardown phase of an API check.
- Use
Global boolAlert Settings When true, the account level alert settings will be used, not the alert setting defined on this check group.
- Activated bool
Determines if the checks in the group are running or not.
- Alert
Channel []CheckSubscriptions Group Alert Channel Subscription Args - Alert
Settings CheckGroup Alert Settings Args - Api
Check CheckDefaults Group Api Check Defaults Args - Concurrency int
Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- Double
Check bool Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed.- Environment
Variables map[string]interface{} Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
The property
environment_variables
is deprecated and will be removed in a future version. Consider using the newenvironment_variable
list.- Local
Setup stringScript A valid piece of Node.js code to run in the setup phase of an API check in this group.
- Local
Teardown stringScript A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- Locations []string
An array of one or more data center locations where to run the checks.
- Muted bool
Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- Name string
The name of the check group.
- Private
Locations []string An array of one or more private locations slugs.
- Runtime
Id string The id of the runtime to use for this group.
- Setup
Snippet intId An ID reference to a snippet to use in the setup phase of an API check.
- []string
Tags for organizing and filtering checks.
- Teardown
Snippet intId An ID reference to a snippet to use in the teardown phase of an API check.
- Use
Global boolAlert Settings When true, the account level alert settings will be used, not the alert setting defined on this check group.
- activated Boolean
Determines if the checks in the group are running or not.
- alert
Channel List<CheckSubscriptions Group Alert Channel Subscription Args> - alert
Settings CheckGroup Alert Settings Args - api
Check CheckDefaults Group Api Check Defaults Args - concurrency Integer
Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- double
Check Boolean Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed.- environment
Variables Map<String,Object> Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
The property
environment_variables
is deprecated and will be removed in a future version. Consider using the newenvironment_variable
list.- local
Setup StringScript A valid piece of Node.js code to run in the setup phase of an API check in this group.
- local
Teardown StringScript A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- locations List<String>
An array of one or more data center locations where to run the checks.
- muted Boolean
Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- name String
The name of the check group.
- private
Locations List<String> An array of one or more private locations slugs.
- runtime
Id String The id of the runtime to use for this group.
- setup
Snippet IntegerId An ID reference to a snippet to use in the setup phase of an API check.
- List<String>
Tags for organizing and filtering checks.
- teardown
Snippet IntegerId An ID reference to a snippet to use in the teardown phase of an API check.
- use
Global BooleanAlert Settings When true, the account level alert settings will be used, not the alert setting defined on this check group.
- activated boolean
Determines if the checks in the group are running or not.
- alert
Channel CheckSubscriptions Group Alert Channel Subscription Args[] - alert
Settings CheckGroup Alert Settings Args - api
Check CheckDefaults Group Api Check Defaults Args - concurrency number
Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- double
Check boolean Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed.- environment
Variables {[key: string]: any} Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
The property
environment_variables
is deprecated and will be removed in a future version. Consider using the newenvironment_variable
list.- local
Setup stringScript A valid piece of Node.js code to run in the setup phase of an API check in this group.
- local
Teardown stringScript A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- locations string[]
An array of one or more data center locations where to run the checks.
- muted boolean
Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- name string
The name of the check group.
- private
Locations string[] An array of one or more private locations slugs.
- runtime
Id string The id of the runtime to use for this group.
- setup
Snippet numberId An ID reference to a snippet to use in the setup phase of an API check.
- string[]
Tags for organizing and filtering checks.
- teardown
Snippet numberId An ID reference to a snippet to use in the teardown phase of an API check.
- use
Global booleanAlert Settings When true, the account level alert settings will be used, not the alert setting defined on this check group.
- activated bool
Determines if the checks in the group are running or not.
- alert_
channel_ Sequence[Checksubscriptions Group Alert Channel Subscription Args] - alert_
settings CheckGroup Alert Settings Args - api_
check_ Checkdefaults Group Api Check Defaults Args - concurrency int
Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- double_
check bool Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed.- environment_
variables Mapping[str, Any] Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
The property
environment_variables
is deprecated and will be removed in a future version. Consider using the newenvironment_variable
list.- local_
setup_ strscript A valid piece of Node.js code to run in the setup phase of an API check in this group.
- local_
teardown_ strscript A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- locations Sequence[str]
An array of one or more data center locations where to run the checks.
- muted bool
Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- name str
The name of the check group.
- private_
locations Sequence[str] An array of one or more private locations slugs.
- runtime_
id str The id of the runtime to use for this group.
- setup_
snippet_ intid An ID reference to a snippet to use in the setup phase of an API check.
- Sequence[str]
Tags for organizing and filtering checks.
- teardown_
snippet_ intid An ID reference to a snippet to use in the teardown phase of an API check.
- use_
global_ boolalert_ settings When true, the account level alert settings will be used, not the alert setting defined on this check group.
- activated Boolean
Determines if the checks in the group are running or not.
- alert
Channel List<Property Map>Subscriptions - alert
Settings Property Map - api
Check Property MapDefaults - concurrency Number
Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- double
Check Boolean Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed.- environment
Variables Map<Any> Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
The property
environment_variables
is deprecated and will be removed in a future version. Consider using the newenvironment_variable
list.- local
Setup StringScript A valid piece of Node.js code to run in the setup phase of an API check in this group.
- local
Teardown StringScript A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- locations List<String>
An array of one or more data center locations where to run the checks.
- muted Boolean
Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- name String
The name of the check group.
- private
Locations List<String> An array of one or more private locations slugs.
- runtime
Id String The id of the runtime to use for this group.
- setup
Snippet NumberId An ID reference to a snippet to use in the setup phase of an API check.
- List<String>
Tags for organizing and filtering checks.
- teardown
Snippet NumberId An ID reference to a snippet to use in the teardown phase of an API check.
- use
Global BooleanAlert Settings When true, the account level alert settings will be used, not the alert setting defined on this check group.
Supporting Types
CheckGroupAlertChannelSubscription
- activated bool
- channel_
id int
CheckGroupAlertSettings
- Escalation
Type string - Reminders
List<Check
Group Alert Settings Reminder> - Run
Based List<CheckEscalations Group Alert Settings Run Based Escalation> - Ssl
Certificates List<CheckGroup Alert Settings Ssl Certificate> This property is deprecated and it's ignored by the Checkly Public API. It will be removed in a future version.
- Time
Based List<CheckEscalations Group Alert Settings Time Based Escalation>
- Escalation
Type string - Reminders
[]Check
Group Alert Settings Reminder - Run
Based []CheckEscalations Group Alert Settings Run Based Escalation - Ssl
Certificates []CheckGroup Alert Settings Ssl Certificate This property is deprecated and it's ignored by the Checkly Public API. It will be removed in a future version.
- Time
Based []CheckEscalations Group Alert Settings Time Based Escalation
- escalation
Type String - reminders
List<Check
Group Alert Settings Reminder> - run
Based List<CheckEscalations Group Alert Settings Run Based Escalation> - ssl
Certificates List<CheckGroup Alert Settings Ssl Certificate> This property is deprecated and it's ignored by the Checkly Public API. It will be removed in a future version.
- time
Based List<CheckEscalations Group Alert Settings Time Based Escalation>
- escalation
Type string - reminders
Check
Group Alert Settings Reminder[] - run
Based CheckEscalations Group Alert Settings Run Based Escalation[] - ssl
Certificates CheckGroup Alert Settings Ssl Certificate[] This property is deprecated and it's ignored by the Checkly Public API. It will be removed in a future version.
- time
Based CheckEscalations Group Alert Settings Time Based Escalation[]
- escalation_
type str - reminders
Sequence[Check
Group Alert Settings Reminder] - run_
based_ Sequence[Checkescalations Group Alert Settings Run Based Escalation] - ssl_
certificates Sequence[CheckGroup Alert Settings Ssl Certificate] This property is deprecated and it's ignored by the Checkly Public API. It will be removed in a future version.
- time_
based_ Sequence[Checkescalations Group Alert Settings Time Based Escalation]
- escalation
Type String - reminders List<Property Map>
- run
Based List<Property Map>Escalations - ssl
Certificates List<Property Map> This property is deprecated and it's ignored by the Checkly Public API. It will be removed in a future version.
- time
Based List<Property Map>Escalations
CheckGroupAlertSettingsReminder
CheckGroupAlertSettingsRunBasedEscalation
- failed
Run IntegerThreshold
- failed
Run numberThreshold
- failed
Run NumberThreshold
CheckGroupAlertSettingsSslCertificate
- Alert
Threshold int - Enabled bool
- Alert
Threshold int - Enabled bool
- alert
Threshold Integer - enabled Boolean
- alert
Threshold number - enabled boolean
- alert_
threshold int - enabled bool
- alert
Threshold Number - enabled Boolean
CheckGroupAlertSettingsTimeBasedEscalation
- minutes
Failing IntegerThreshold
- minutes
Failing numberThreshold
- minutes
Failing NumberThreshold
CheckGroupApiCheckDefaults
- Assertions
List<Check
Group Api Check Defaults Assertion> - Basic
Auth CheckGroup Api Check Defaults Basic Auth - Headers Dictionary<string, object>
- Query
Parameters Dictionary<string, object> - Url string
- Assertions
[]Check
Group Api Check Defaults Assertion - Basic
Auth CheckGroup Api Check Defaults Basic Auth - Headers map[string]interface{}
- Query
Parameters map[string]interface{} - Url string
- assertions
List<Check
Group Api Check Defaults Assertion> - basic
Auth CheckGroup Api Check Defaults Basic Auth - headers Map<String,Object>
- query
Parameters Map<String,Object> - url String
- assertions
Check
Group Api Check Defaults Assertion[] - basic
Auth CheckGroup Api Check Defaults Basic Auth - headers {[key: string]: any}
- query
Parameters {[key: string]: any} - url string
- assertions
Sequence[Check
Group Api Check Defaults Assertion] - basic_
auth CheckGroup Api Check Defaults Basic Auth - headers Mapping[str, Any]
- query_
parameters Mapping[str, Any] - url str
- assertions List<Property Map>
- basic
Auth Property Map - headers Map<Any>
- query
Parameters Map<Any> - url String
CheckGroupApiCheckDefaultsAssertion
- Comparison string
- Source string
- Target string
- Property string
- Comparison string
- Source string
- Target string
- Property string
- comparison String
- source String
- target String
- property String
- comparison string
- source string
- target string
- property string
- comparison str
- source str
- target str
- property str
- comparison String
- source String
- target String
- property String
CheckGroupApiCheckDefaultsBasicAuth
Package Details
- Repository
- checkly checkly/pulumi-checkly
- License
- MIT
- Notes
This Pulumi package is based on the
checkly
Terraform Provider.