published on Tuesday, Mar 24, 2026 by incident-io
published on Tuesday, Mar 24, 2026 by incident-io
Manage maintenance windows for temporarily overriding alert routing during planned maintenance.
Maintenance windows allow you to suppress or redirect alerts during scheduled maintenance periods, preventing unnecessary escalations and noise.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as incident from "@pulumi/incident";
const opsLead = incident.getUser({
email: "ops-lead@example.com",
});
const example = new incident.MaintenanceWindow("example", {
name: "Scheduled Database Migration",
startAt: "2026-04-01T02:00:00Z",
endAt: "2026-04-01T06:00:00Z",
leadId: opsLead.then(opsLead => opsLead.id),
showInSidebar: true,
resolveOnEnd: true,
rerouteOnEnd: false,
alertConditionGroups: [{
conditions: [{
subject: "alert.title",
operation: "contains",
paramBindings: [{
value: {
literal: "database",
},
}],
}],
}],
});
import pulumi
import pulumi_incident as incident
ops_lead = incident.get_user(email="ops-lead@example.com")
example = incident.MaintenanceWindow("example",
name="Scheduled Database Migration",
start_at="2026-04-01T02:00:00Z",
end_at="2026-04-01T06:00:00Z",
lead_id=ops_lead.id,
show_in_sidebar=True,
resolve_on_end=True,
reroute_on_end=False,
alert_condition_groups=[{
"conditions": [{
"subject": "alert.title",
"operation": "contains",
"param_bindings": [{
"value": {
"literal": "database",
},
}],
}],
}])
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/incident/v5/incident"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
opsLead, err := incident.GetUser(ctx, &incident.GetUserArgs{
Email: pulumi.StringRef("ops-lead@example.com"),
}, nil)
if err != nil {
return err
}
_, err = incident.NewMaintenanceWindow(ctx, "example", &incident.MaintenanceWindowArgs{
Name: pulumi.String("Scheduled Database Migration"),
StartAt: pulumi.String("2026-04-01T02:00:00Z"),
EndAt: pulumi.String("2026-04-01T06:00:00Z"),
LeadId: pulumi.String(opsLead.Id),
ShowInSidebar: pulumi.Bool(true),
ResolveOnEnd: pulumi.Bool(true),
RerouteOnEnd: pulumi.Bool(false),
AlertConditionGroups: incident.MaintenanceWindowAlertConditionGroupArray{
&incident.MaintenanceWindowAlertConditionGroupArgs{
Conditions: incident.MaintenanceWindowAlertConditionGroupConditionArray{
&incident.MaintenanceWindowAlertConditionGroupConditionArgs{
Subject: pulumi.String("alert.title"),
Operation: pulumi.String("contains"),
ParamBindings: incident.MaintenanceWindowAlertConditionGroupConditionParamBindingArray{
&incident.MaintenanceWindowAlertConditionGroupConditionParamBindingArgs{
Value: &incident.MaintenanceWindowAlertConditionGroupConditionParamBindingValueArgs{
Literal: pulumi.String("database"),
},
},
},
},
},
},
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Incident = Pulumi.Incident;
return await Deployment.RunAsync(() =>
{
var opsLead = Incident.GetUser.Invoke(new()
{
Email = "ops-lead@example.com",
});
var example = new Incident.MaintenanceWindow("example", new()
{
Name = "Scheduled Database Migration",
StartAt = "2026-04-01T02:00:00Z",
EndAt = "2026-04-01T06:00:00Z",
LeadId = opsLead.Apply(getUserResult => getUserResult.Id),
ShowInSidebar = true,
ResolveOnEnd = true,
RerouteOnEnd = false,
AlertConditionGroups = new[]
{
new Incident.Inputs.MaintenanceWindowAlertConditionGroupArgs
{
Conditions = new[]
{
new Incident.Inputs.MaintenanceWindowAlertConditionGroupConditionArgs
{
Subject = "alert.title",
Operation = "contains",
ParamBindings = new[]
{
new Incident.Inputs.MaintenanceWindowAlertConditionGroupConditionParamBindingArgs
{
Value = new Incident.Inputs.MaintenanceWindowAlertConditionGroupConditionParamBindingValueArgs
{
Literal = "database",
},
},
},
},
},
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.incident.IncidentFunctions;
import com.pulumi.incident.inputs.GetUserArgs;
import com.pulumi.incident.MaintenanceWindow;
import com.pulumi.incident.MaintenanceWindowArgs;
import com.pulumi.incident.inputs.MaintenanceWindowAlertConditionGroupArgs;
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 opsLead = IncidentFunctions.getUser(GetUserArgs.builder()
.email("ops-lead@example.com")
.build());
var example = new MaintenanceWindow("example", MaintenanceWindowArgs.builder()
.name("Scheduled Database Migration")
.startAt("2026-04-01T02:00:00Z")
.endAt("2026-04-01T06:00:00Z")
.leadId(opsLead.id())
.showInSidebar(true)
.resolveOnEnd(true)
.rerouteOnEnd(false)
.alertConditionGroups(MaintenanceWindowAlertConditionGroupArgs.builder()
.conditions(MaintenanceWindowAlertConditionGroupConditionArgs.builder()
.subject("alert.title")
.operation("contains")
.paramBindings(MaintenanceWindowAlertConditionGroupConditionParamBindingArgs.builder()
.value(MaintenanceWindowAlertConditionGroupConditionParamBindingValueArgs.builder()
.literal("database")
.build())
.build())
.build())
.build())
.build());
}
}
resources:
example:
type: incident:MaintenanceWindow
properties:
name: Scheduled Database Migration
startAt: 2026-04-01T02:00:00Z
endAt: 2026-04-01T06:00:00Z
leadId: ${opsLead.id}
showInSidebar: true
resolveOnEnd: true
rerouteOnEnd: false
alertConditionGroups:
- conditions:
- subject: alert.title
operation: contains
paramBindings:
- value:
literal: database
variables:
opsLead:
fn::invoke:
function: incident:getUser
arguments:
email: ops-lead@example.com
Create MaintenanceWindow Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new MaintenanceWindow(name: string, args: MaintenanceWindowArgs, opts?: CustomResourceOptions);@overload
def MaintenanceWindow(resource_name: str,
args: MaintenanceWindowArgs,
opts: Optional[ResourceOptions] = None)
@overload
def MaintenanceWindow(resource_name: str,
opts: Optional[ResourceOptions] = None,
lead_id: Optional[str] = None,
end_at: Optional[str] = None,
start_at: Optional[str] = None,
alert_condition_groups: Optional[Sequence[MaintenanceWindowAlertConditionGroupArgs]] = None,
notification_message: Optional[str] = None,
name: Optional[str] = None,
incident_id: Optional[str] = None,
notify_channels: Optional[Sequence[MaintenanceWindowNotifyChannelArgs]] = None,
notify_end_minutes_before: Optional[float] = None,
notify_start_minutes_before: Optional[float] = None,
reroute_on_end: Optional[bool] = None,
resolve_on_end: Optional[bool] = None,
show_in_sidebar: Optional[bool] = None,
escalation_targets: Optional[Sequence[MaintenanceWindowEscalationTargetArgs]] = None)func NewMaintenanceWindow(ctx *Context, name string, args MaintenanceWindowArgs, opts ...ResourceOption) (*MaintenanceWindow, error)public MaintenanceWindow(string name, MaintenanceWindowArgs args, CustomResourceOptions? opts = null)
public MaintenanceWindow(String name, MaintenanceWindowArgs args)
public MaintenanceWindow(String name, MaintenanceWindowArgs args, CustomResourceOptions options)
type: incident:MaintenanceWindow
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 MaintenanceWindowArgs
- 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 MaintenanceWindowArgs
- 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 MaintenanceWindowArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args MaintenanceWindowArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args MaintenanceWindowArgs
- 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 maintenanceWindowResource = new Incident.Index.MaintenanceWindow("maintenanceWindowResource", new()
{
LeadId = "string",
EndAt = "string",
StartAt = "string",
AlertConditionGroups = new[]
{
new Incident.Inputs.MaintenanceWindowAlertConditionGroupArgs
{
Conditions = new[]
{
new Incident.Inputs.MaintenanceWindowAlertConditionGroupConditionArgs
{
Operation = "string",
ParamBindings = new[]
{
new Incident.Inputs.MaintenanceWindowAlertConditionGroupConditionParamBindingArgs
{
ArrayValues = new[]
{
new Incident.Inputs.MaintenanceWindowAlertConditionGroupConditionParamBindingArrayValueArgs
{
Literal = "string",
Reference = "string",
},
},
Value = new Incident.Inputs.MaintenanceWindowAlertConditionGroupConditionParamBindingValueArgs
{
Literal = "string",
Reference = "string",
},
},
},
Subject = "string",
},
},
},
},
NotificationMessage = "string",
Name = "string",
IncidentId = "string",
NotifyChannels = new[]
{
new Incident.Inputs.MaintenanceWindowNotifyChannelArgs
{
ChannelId = "string",
ChannelType = "string",
ChannelName = "string",
},
},
NotifyEndMinutesBefore = 0,
NotifyStartMinutesBefore = 0,
RerouteOnEnd = false,
ResolveOnEnd = false,
ShowInSidebar = false,
EscalationTargets = new[]
{
new Incident.Inputs.MaintenanceWindowEscalationTargetArgs
{
EscalationPaths = new Incident.Inputs.MaintenanceWindowEscalationTargetEscalationPathsArgs
{
ArrayValues = new[]
{
new Incident.Inputs.MaintenanceWindowEscalationTargetEscalationPathsArrayValueArgs
{
Literal = "string",
Reference = "string",
},
},
Value = new Incident.Inputs.MaintenanceWindowEscalationTargetEscalationPathsValueArgs
{
Literal = "string",
Reference = "string",
},
},
Users = new Incident.Inputs.MaintenanceWindowEscalationTargetUsersArgs
{
ArrayValues = new[]
{
new Incident.Inputs.MaintenanceWindowEscalationTargetUsersArrayValueArgs
{
Literal = "string",
Reference = "string",
},
},
Value = new Incident.Inputs.MaintenanceWindowEscalationTargetUsersValueArgs
{
Literal = "string",
Reference = "string",
},
},
},
},
});
example, err := incident.NewMaintenanceWindow(ctx, "maintenanceWindowResource", &incident.MaintenanceWindowArgs{
LeadId: pulumi.String("string"),
EndAt: pulumi.String("string"),
StartAt: pulumi.String("string"),
AlertConditionGroups: incident.MaintenanceWindowAlertConditionGroupArray{
&incident.MaintenanceWindowAlertConditionGroupArgs{
Conditions: incident.MaintenanceWindowAlertConditionGroupConditionArray{
&incident.MaintenanceWindowAlertConditionGroupConditionArgs{
Operation: pulumi.String("string"),
ParamBindings: incident.MaintenanceWindowAlertConditionGroupConditionParamBindingArray{
&incident.MaintenanceWindowAlertConditionGroupConditionParamBindingArgs{
ArrayValues: incident.MaintenanceWindowAlertConditionGroupConditionParamBindingArrayValueArray{
&incident.MaintenanceWindowAlertConditionGroupConditionParamBindingArrayValueArgs{
Literal: pulumi.String("string"),
Reference: pulumi.String("string"),
},
},
Value: &incident.MaintenanceWindowAlertConditionGroupConditionParamBindingValueArgs{
Literal: pulumi.String("string"),
Reference: pulumi.String("string"),
},
},
},
Subject: pulumi.String("string"),
},
},
},
},
NotificationMessage: pulumi.String("string"),
Name: pulumi.String("string"),
IncidentId: pulumi.String("string"),
NotifyChannels: incident.MaintenanceWindowNotifyChannelArray{
&incident.MaintenanceWindowNotifyChannelArgs{
ChannelId: pulumi.String("string"),
ChannelType: pulumi.String("string"),
ChannelName: pulumi.String("string"),
},
},
NotifyEndMinutesBefore: pulumi.Float64(0),
NotifyStartMinutesBefore: pulumi.Float64(0),
RerouteOnEnd: pulumi.Bool(false),
ResolveOnEnd: pulumi.Bool(false),
ShowInSidebar: pulumi.Bool(false),
EscalationTargets: incident.MaintenanceWindowEscalationTargetArray{
&incident.MaintenanceWindowEscalationTargetArgs{
EscalationPaths: &incident.MaintenanceWindowEscalationTargetEscalationPathsArgs{
ArrayValues: incident.MaintenanceWindowEscalationTargetEscalationPathsArrayValueArray{
&incident.MaintenanceWindowEscalationTargetEscalationPathsArrayValueArgs{
Literal: pulumi.String("string"),
Reference: pulumi.String("string"),
},
},
Value: &incident.MaintenanceWindowEscalationTargetEscalationPathsValueArgs{
Literal: pulumi.String("string"),
Reference: pulumi.String("string"),
},
},
Users: &incident.MaintenanceWindowEscalationTargetUsersArgs{
ArrayValues: incident.MaintenanceWindowEscalationTargetUsersArrayValueArray{
&incident.MaintenanceWindowEscalationTargetUsersArrayValueArgs{
Literal: pulumi.String("string"),
Reference: pulumi.String("string"),
},
},
Value: &incident.MaintenanceWindowEscalationTargetUsersValueArgs{
Literal: pulumi.String("string"),
Reference: pulumi.String("string"),
},
},
},
},
})
var maintenanceWindowResource = new MaintenanceWindow("maintenanceWindowResource", MaintenanceWindowArgs.builder()
.leadId("string")
.endAt("string")
.startAt("string")
.alertConditionGroups(MaintenanceWindowAlertConditionGroupArgs.builder()
.conditions(MaintenanceWindowAlertConditionGroupConditionArgs.builder()
.operation("string")
.paramBindings(MaintenanceWindowAlertConditionGroupConditionParamBindingArgs.builder()
.arrayValues(MaintenanceWindowAlertConditionGroupConditionParamBindingArrayValueArgs.builder()
.literal("string")
.reference("string")
.build())
.value(MaintenanceWindowAlertConditionGroupConditionParamBindingValueArgs.builder()
.literal("string")
.reference("string")
.build())
.build())
.subject("string")
.build())
.build())
.notificationMessage("string")
.name("string")
.incidentId("string")
.notifyChannels(MaintenanceWindowNotifyChannelArgs.builder()
.channelId("string")
.channelType("string")
.channelName("string")
.build())
.notifyEndMinutesBefore(0.0)
.notifyStartMinutesBefore(0.0)
.rerouteOnEnd(false)
.resolveOnEnd(false)
.showInSidebar(false)
.escalationTargets(MaintenanceWindowEscalationTargetArgs.builder()
.escalationPaths(MaintenanceWindowEscalationTargetEscalationPathsArgs.builder()
.arrayValues(MaintenanceWindowEscalationTargetEscalationPathsArrayValueArgs.builder()
.literal("string")
.reference("string")
.build())
.value(MaintenanceWindowEscalationTargetEscalationPathsValueArgs.builder()
.literal("string")
.reference("string")
.build())
.build())
.users(MaintenanceWindowEscalationTargetUsersArgs.builder()
.arrayValues(MaintenanceWindowEscalationTargetUsersArrayValueArgs.builder()
.literal("string")
.reference("string")
.build())
.value(MaintenanceWindowEscalationTargetUsersValueArgs.builder()
.literal("string")
.reference("string")
.build())
.build())
.build())
.build());
maintenance_window_resource = incident.MaintenanceWindow("maintenanceWindowResource",
lead_id="string",
end_at="string",
start_at="string",
alert_condition_groups=[{
"conditions": [{
"operation": "string",
"param_bindings": [{
"array_values": [{
"literal": "string",
"reference": "string",
}],
"value": {
"literal": "string",
"reference": "string",
},
}],
"subject": "string",
}],
}],
notification_message="string",
name="string",
incident_id="string",
notify_channels=[{
"channel_id": "string",
"channel_type": "string",
"channel_name": "string",
}],
notify_end_minutes_before=0,
notify_start_minutes_before=0,
reroute_on_end=False,
resolve_on_end=False,
show_in_sidebar=False,
escalation_targets=[{
"escalation_paths": {
"array_values": [{
"literal": "string",
"reference": "string",
}],
"value": {
"literal": "string",
"reference": "string",
},
},
"users": {
"array_values": [{
"literal": "string",
"reference": "string",
}],
"value": {
"literal": "string",
"reference": "string",
},
},
}])
const maintenanceWindowResource = new incident.MaintenanceWindow("maintenanceWindowResource", {
leadId: "string",
endAt: "string",
startAt: "string",
alertConditionGroups: [{
conditions: [{
operation: "string",
paramBindings: [{
arrayValues: [{
literal: "string",
reference: "string",
}],
value: {
literal: "string",
reference: "string",
},
}],
subject: "string",
}],
}],
notificationMessage: "string",
name: "string",
incidentId: "string",
notifyChannels: [{
channelId: "string",
channelType: "string",
channelName: "string",
}],
notifyEndMinutesBefore: 0,
notifyStartMinutesBefore: 0,
rerouteOnEnd: false,
resolveOnEnd: false,
showInSidebar: false,
escalationTargets: [{
escalationPaths: {
arrayValues: [{
literal: "string",
reference: "string",
}],
value: {
literal: "string",
reference: "string",
},
},
users: {
arrayValues: [{
literal: "string",
reference: "string",
}],
value: {
literal: "string",
reference: "string",
},
},
}],
});
type: incident:MaintenanceWindow
properties:
alertConditionGroups:
- conditions:
- operation: string
paramBindings:
- arrayValues:
- literal: string
reference: string
value:
literal: string
reference: string
subject: string
endAt: string
escalationTargets:
- escalationPaths:
arrayValues:
- literal: string
reference: string
value:
literal: string
reference: string
users:
arrayValues:
- literal: string
reference: string
value:
literal: string
reference: string
incidentId: string
leadId: string
name: string
notificationMessage: string
notifyChannels:
- channelId: string
channelName: string
channelType: string
notifyEndMinutesBefore: 0
notifyStartMinutesBefore: 0
rerouteOnEnd: false
resolveOnEnd: false
showInSidebar: false
startAt: string
MaintenanceWindow Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The MaintenanceWindow resource accepts the following input properties:
- Alert
Condition List<MaintenanceGroups Window Alert Condition Group> - Groups of prerequisite conditions. All conditions in at least one group must be satisfied
- End
At string - When the maintenance window ends
- Lead
Id string - The incident.io user ID of the lead for this maintenance window
- Start
At string - When the maintenance window starts
- Escalation
Targets List<MaintenanceWindow Escalation Target> - If set, alerts matching this window will be escalated to these targets
- Incident
Id string - If set, alerts matching this window will be automatically attached to this incident
- Name string
- Human readable name for the maintenance window
- Notification
Message string - Custom message included in notifications about this maintenance window
- Notify
Channels List<MaintenanceWindow Notify Channel> - Channels to notify about the maintenance window starting and ending
- Notify
End doubleMinutes Before - Minutes before the end to send a notification to the configured channels
- Notify
Start doubleMinutes Before - Minutes before the start to send a notification to the configured channels
- Reroute
On boolEnd - Whether to retrigger firing alerts through alert routing when the window ends
- Resolve
On boolEnd - Whether to automatically resolve all firing alerts that matched this window when it ends
- bool
- Whether to show this maintenance window in the dashboard sidebar when active
- Alert
Condition []MaintenanceGroups Window Alert Condition Group Args - Groups of prerequisite conditions. All conditions in at least one group must be satisfied
- End
At string - When the maintenance window ends
- Lead
Id string - The incident.io user ID of the lead for this maintenance window
- Start
At string - When the maintenance window starts
- Escalation
Targets []MaintenanceWindow Escalation Target Args - If set, alerts matching this window will be escalated to these targets
- Incident
Id string - If set, alerts matching this window will be automatically attached to this incident
- Name string
- Human readable name for the maintenance window
- Notification
Message string - Custom message included in notifications about this maintenance window
- Notify
Channels []MaintenanceWindow Notify Channel Args - Channels to notify about the maintenance window starting and ending
- Notify
End float64Minutes Before - Minutes before the end to send a notification to the configured channels
- Notify
Start float64Minutes Before - Minutes before the start to send a notification to the configured channels
- Reroute
On boolEnd - Whether to retrigger firing alerts through alert routing when the window ends
- Resolve
On boolEnd - Whether to automatically resolve all firing alerts that matched this window when it ends
- bool
- Whether to show this maintenance window in the dashboard sidebar when active
- alert
Condition List<MaintenanceGroups Window Alert Condition Group> - Groups of prerequisite conditions. All conditions in at least one group must be satisfied
- end
At String - When the maintenance window ends
- lead
Id String - The incident.io user ID of the lead for this maintenance window
- start
At String - When the maintenance window starts
- escalation
Targets List<MaintenanceWindow Escalation Target> - If set, alerts matching this window will be escalated to these targets
- incident
Id String - If set, alerts matching this window will be automatically attached to this incident
- name String
- Human readable name for the maintenance window
- notification
Message String - Custom message included in notifications about this maintenance window
- notify
Channels List<MaintenanceWindow Notify Channel> - Channels to notify about the maintenance window starting and ending
- notify
End DoubleMinutes Before - Minutes before the end to send a notification to the configured channels
- notify
Start DoubleMinutes Before - Minutes before the start to send a notification to the configured channels
- reroute
On BooleanEnd - Whether to retrigger firing alerts through alert routing when the window ends
- resolve
On BooleanEnd - Whether to automatically resolve all firing alerts that matched this window when it ends
- Boolean
- Whether to show this maintenance window in the dashboard sidebar when active
- alert
Condition MaintenanceGroups Window Alert Condition Group[] - Groups of prerequisite conditions. All conditions in at least one group must be satisfied
- end
At string - When the maintenance window ends
- lead
Id string - The incident.io user ID of the lead for this maintenance window
- start
At string - When the maintenance window starts
- escalation
Targets MaintenanceWindow Escalation Target[] - If set, alerts matching this window will be escalated to these targets
- incident
Id string - If set, alerts matching this window will be automatically attached to this incident
- name string
- Human readable name for the maintenance window
- notification
Message string - Custom message included in notifications about this maintenance window
- notify
Channels MaintenanceWindow Notify Channel[] - Channels to notify about the maintenance window starting and ending
- notify
End numberMinutes Before - Minutes before the end to send a notification to the configured channels
- notify
Start numberMinutes Before - Minutes before the start to send a notification to the configured channels
- reroute
On booleanEnd - Whether to retrigger firing alerts through alert routing when the window ends
- resolve
On booleanEnd - Whether to automatically resolve all firing alerts that matched this window when it ends
- boolean
- Whether to show this maintenance window in the dashboard sidebar when active
- alert_
condition_ Sequence[Maintenancegroups Window Alert Condition Group Args] - Groups of prerequisite conditions. All conditions in at least one group must be satisfied
- end_
at str - When the maintenance window ends
- lead_
id str - The incident.io user ID of the lead for this maintenance window
- start_
at str - When the maintenance window starts
- escalation_
targets Sequence[MaintenanceWindow Escalation Target Args] - If set, alerts matching this window will be escalated to these targets
- incident_
id str - If set, alerts matching this window will be automatically attached to this incident
- name str
- Human readable name for the maintenance window
- notification_
message str - Custom message included in notifications about this maintenance window
- notify_
channels Sequence[MaintenanceWindow Notify Channel Args] - Channels to notify about the maintenance window starting and ending
- notify_
end_ floatminutes_ before - Minutes before the end to send a notification to the configured channels
- notify_
start_ floatminutes_ before - Minutes before the start to send a notification to the configured channels
- reroute_
on_ boolend - Whether to retrigger firing alerts through alert routing when the window ends
- resolve_
on_ boolend - Whether to automatically resolve all firing alerts that matched this window when it ends
- bool
- Whether to show this maintenance window in the dashboard sidebar when active
- alert
Condition List<Property Map>Groups - Groups of prerequisite conditions. All conditions in at least one group must be satisfied
- end
At String - When the maintenance window ends
- lead
Id String - The incident.io user ID of the lead for this maintenance window
- start
At String - When the maintenance window starts
- escalation
Targets List<Property Map> - If set, alerts matching this window will be escalated to these targets
- incident
Id String - If set, alerts matching this window will be automatically attached to this incident
- name String
- Human readable name for the maintenance window
- notification
Message String - Custom message included in notifications about this maintenance window
- notify
Channels List<Property Map> - Channels to notify about the maintenance window starting and ending
- notify
End NumberMinutes Before - Minutes before the end to send a notification to the configured channels
- notify
Start NumberMinutes Before - Minutes before the start to send a notification to the configured channels
- reroute
On BooleanEnd - Whether to retrigger firing alerts through alert routing when the window ends
- resolve
On BooleanEnd - Whether to automatically resolve all firing alerts that matched this window when it ends
- Boolean
- Whether to show this maintenance window in the dashboard sidebar when active
Outputs
All input properties are implicitly available as output properties. Additionally, the MaintenanceWindow 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 MaintenanceWindow Resource
Get an existing MaintenanceWindow 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?: MaintenanceWindowState, opts?: CustomResourceOptions): MaintenanceWindow@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
alert_condition_groups: Optional[Sequence[MaintenanceWindowAlertConditionGroupArgs]] = None,
end_at: Optional[str] = None,
escalation_targets: Optional[Sequence[MaintenanceWindowEscalationTargetArgs]] = None,
incident_id: Optional[str] = None,
lead_id: Optional[str] = None,
name: Optional[str] = None,
notification_message: Optional[str] = None,
notify_channels: Optional[Sequence[MaintenanceWindowNotifyChannelArgs]] = None,
notify_end_minutes_before: Optional[float] = None,
notify_start_minutes_before: Optional[float] = None,
reroute_on_end: Optional[bool] = None,
resolve_on_end: Optional[bool] = None,
show_in_sidebar: Optional[bool] = None,
start_at: Optional[str] = None) -> MaintenanceWindowfunc GetMaintenanceWindow(ctx *Context, name string, id IDInput, state *MaintenanceWindowState, opts ...ResourceOption) (*MaintenanceWindow, error)public static MaintenanceWindow Get(string name, Input<string> id, MaintenanceWindowState? state, CustomResourceOptions? opts = null)public static MaintenanceWindow get(String name, Output<String> id, MaintenanceWindowState state, CustomResourceOptions options)resources: _: type: incident:MaintenanceWindow get: id: ${id}- 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.
- Alert
Condition List<MaintenanceGroups Window Alert Condition Group> - Groups of prerequisite conditions. All conditions in at least one group must be satisfied
- End
At string - When the maintenance window ends
- Escalation
Targets List<MaintenanceWindow Escalation Target> - If set, alerts matching this window will be escalated to these targets
- Incident
Id string - If set, alerts matching this window will be automatically attached to this incident
- Lead
Id string - The incident.io user ID of the lead for this maintenance window
- Name string
- Human readable name for the maintenance window
- Notification
Message string - Custom message included in notifications about this maintenance window
- Notify
Channels List<MaintenanceWindow Notify Channel> - Channels to notify about the maintenance window starting and ending
- Notify
End doubleMinutes Before - Minutes before the end to send a notification to the configured channels
- Notify
Start doubleMinutes Before - Minutes before the start to send a notification to the configured channels
- Reroute
On boolEnd - Whether to retrigger firing alerts through alert routing when the window ends
- Resolve
On boolEnd - Whether to automatically resolve all firing alerts that matched this window when it ends
- bool
- Whether to show this maintenance window in the dashboard sidebar when active
- Start
At string - When the maintenance window starts
- Alert
Condition []MaintenanceGroups Window Alert Condition Group Args - Groups of prerequisite conditions. All conditions in at least one group must be satisfied
- End
At string - When the maintenance window ends
- Escalation
Targets []MaintenanceWindow Escalation Target Args - If set, alerts matching this window will be escalated to these targets
- Incident
Id string - If set, alerts matching this window will be automatically attached to this incident
- Lead
Id string - The incident.io user ID of the lead for this maintenance window
- Name string
- Human readable name for the maintenance window
- Notification
Message string - Custom message included in notifications about this maintenance window
- Notify
Channels []MaintenanceWindow Notify Channel Args - Channels to notify about the maintenance window starting and ending
- Notify
End float64Minutes Before - Minutes before the end to send a notification to the configured channels
- Notify
Start float64Minutes Before - Minutes before the start to send a notification to the configured channels
- Reroute
On boolEnd - Whether to retrigger firing alerts through alert routing when the window ends
- Resolve
On boolEnd - Whether to automatically resolve all firing alerts that matched this window when it ends
- bool
- Whether to show this maintenance window in the dashboard sidebar when active
- Start
At string - When the maintenance window starts
- alert
Condition List<MaintenanceGroups Window Alert Condition Group> - Groups of prerequisite conditions. All conditions in at least one group must be satisfied
- end
At String - When the maintenance window ends
- escalation
Targets List<MaintenanceWindow Escalation Target> - If set, alerts matching this window will be escalated to these targets
- incident
Id String - If set, alerts matching this window will be automatically attached to this incident
- lead
Id String - The incident.io user ID of the lead for this maintenance window
- name String
- Human readable name for the maintenance window
- notification
Message String - Custom message included in notifications about this maintenance window
- notify
Channels List<MaintenanceWindow Notify Channel> - Channels to notify about the maintenance window starting and ending
- notify
End DoubleMinutes Before - Minutes before the end to send a notification to the configured channels
- notify
Start DoubleMinutes Before - Minutes before the start to send a notification to the configured channels
- reroute
On BooleanEnd - Whether to retrigger firing alerts through alert routing when the window ends
- resolve
On BooleanEnd - Whether to automatically resolve all firing alerts that matched this window when it ends
- Boolean
- Whether to show this maintenance window in the dashboard sidebar when active
- start
At String - When the maintenance window starts
- alert
Condition MaintenanceGroups Window Alert Condition Group[] - Groups of prerequisite conditions. All conditions in at least one group must be satisfied
- end
At string - When the maintenance window ends
- escalation
Targets MaintenanceWindow Escalation Target[] - If set, alerts matching this window will be escalated to these targets
- incident
Id string - If set, alerts matching this window will be automatically attached to this incident
- lead
Id string - The incident.io user ID of the lead for this maintenance window
- name string
- Human readable name for the maintenance window
- notification
Message string - Custom message included in notifications about this maintenance window
- notify
Channels MaintenanceWindow Notify Channel[] - Channels to notify about the maintenance window starting and ending
- notify
End numberMinutes Before - Minutes before the end to send a notification to the configured channels
- notify
Start numberMinutes Before - Minutes before the start to send a notification to the configured channels
- reroute
On booleanEnd - Whether to retrigger firing alerts through alert routing when the window ends
- resolve
On booleanEnd - Whether to automatically resolve all firing alerts that matched this window when it ends
- boolean
- Whether to show this maintenance window in the dashboard sidebar when active
- start
At string - When the maintenance window starts
- alert_
condition_ Sequence[Maintenancegroups Window Alert Condition Group Args] - Groups of prerequisite conditions. All conditions in at least one group must be satisfied
- end_
at str - When the maintenance window ends
- escalation_
targets Sequence[MaintenanceWindow Escalation Target Args] - If set, alerts matching this window will be escalated to these targets
- incident_
id str - If set, alerts matching this window will be automatically attached to this incident
- lead_
id str - The incident.io user ID of the lead for this maintenance window
- name str
- Human readable name for the maintenance window
- notification_
message str - Custom message included in notifications about this maintenance window
- notify_
channels Sequence[MaintenanceWindow Notify Channel Args] - Channels to notify about the maintenance window starting and ending
- notify_
end_ floatminutes_ before - Minutes before the end to send a notification to the configured channels
- notify_
start_ floatminutes_ before - Minutes before the start to send a notification to the configured channels
- reroute_
on_ boolend - Whether to retrigger firing alerts through alert routing when the window ends
- resolve_
on_ boolend - Whether to automatically resolve all firing alerts that matched this window when it ends
- bool
- Whether to show this maintenance window in the dashboard sidebar when active
- start_
at str - When the maintenance window starts
- alert
Condition List<Property Map>Groups - Groups of prerequisite conditions. All conditions in at least one group must be satisfied
- end
At String - When the maintenance window ends
- escalation
Targets List<Property Map> - If set, alerts matching this window will be escalated to these targets
- incident
Id String - If set, alerts matching this window will be automatically attached to this incident
- lead
Id String - The incident.io user ID of the lead for this maintenance window
- name String
- Human readable name for the maintenance window
- notification
Message String - Custom message included in notifications about this maintenance window
- notify
Channels List<Property Map> - Channels to notify about the maintenance window starting and ending
- notify
End NumberMinutes Before - Minutes before the end to send a notification to the configured channels
- notify
Start NumberMinutes Before - Minutes before the start to send a notification to the configured channels
- reroute
On BooleanEnd - Whether to retrigger firing alerts through alert routing when the window ends
- resolve
On BooleanEnd - Whether to automatically resolve all firing alerts that matched this window when it ends
- Boolean
- Whether to show this maintenance window in the dashboard sidebar when active
- start
At String - When the maintenance window starts
Supporting Types
MaintenanceWindowAlertConditionGroup, MaintenanceWindowAlertConditionGroupArgs
- Conditions
List<Maintenance
Window Alert Condition Group Condition> - The prerequisite conditions that must all be satisfied
- Conditions
[]Maintenance
Window Alert Condition Group Condition - The prerequisite conditions that must all be satisfied
- conditions
List<Maintenance
Window Alert Condition Group Condition> - The prerequisite conditions that must all be satisfied
- conditions
Maintenance
Window Alert Condition Group Condition[] - The prerequisite conditions that must all be satisfied
- conditions
Sequence[Maintenance
Window Alert Condition Group Condition] - The prerequisite conditions that must all be satisfied
- conditions List<Property Map>
- The prerequisite conditions that must all be satisfied
MaintenanceWindowAlertConditionGroupCondition, MaintenanceWindowAlertConditionGroupConditionArgs
- Operation string
- The logical operation to be applied
- Param
Bindings List<MaintenanceWindow Alert Condition Group Condition Param Binding> - Bindings for the operation parameters
- Subject string
- The subject of the condition, on which the operation is applied
- Operation string
- The logical operation to be applied
- Param
Bindings []MaintenanceWindow Alert Condition Group Condition Param Binding - Bindings for the operation parameters
- Subject string
- The subject of the condition, on which the operation is applied
- operation String
- The logical operation to be applied
- param
Bindings List<MaintenanceWindow Alert Condition Group Condition Param Binding> - Bindings for the operation parameters
- subject String
- The subject of the condition, on which the operation is applied
- operation string
- The logical operation to be applied
- param
Bindings MaintenanceWindow Alert Condition Group Condition Param Binding[] - Bindings for the operation parameters
- subject string
- The subject of the condition, on which the operation is applied
- operation str
- The logical operation to be applied
- param_
bindings Sequence[MaintenanceWindow Alert Condition Group Condition Param Binding] - Bindings for the operation parameters
- subject str
- The subject of the condition, on which the operation is applied
- operation String
- The logical operation to be applied
- param
Bindings List<Property Map> - Bindings for the operation parameters
- subject String
- The subject of the condition, on which the operation is applied
MaintenanceWindowAlertConditionGroupConditionParamBinding, MaintenanceWindowAlertConditionGroupConditionParamBindingArgs
- Array
Values List<MaintenanceWindow Alert Condition Group Condition Param Binding Array Value> - The array of literal or reference parameter values
- Value
Maintenance
Window Alert Condition Group Condition Param Binding Value - The literal or reference parameter value
- Array
Values []MaintenanceWindow Alert Condition Group Condition Param Binding Array Value - The array of literal or reference parameter values
- Value
Maintenance
Window Alert Condition Group Condition Param Binding Value - The literal or reference parameter value
- array
Values List<MaintenanceWindow Alert Condition Group Condition Param Binding Array Value> - The array of literal or reference parameter values
- value
Maintenance
Window Alert Condition Group Condition Param Binding Value - The literal or reference parameter value
- array
Values MaintenanceWindow Alert Condition Group Condition Param Binding Array Value[] - The array of literal or reference parameter values
- value
Maintenance
Window Alert Condition Group Condition Param Binding Value - The literal or reference parameter value
- array_
values Sequence[MaintenanceWindow Alert Condition Group Condition Param Binding Array Value] - The array of literal or reference parameter values
- value
Maintenance
Window Alert Condition Group Condition Param Binding Value - The literal or reference parameter value
- array
Values List<Property Map> - The array of literal or reference parameter values
- value Property Map
- The literal or reference parameter value
MaintenanceWindowAlertConditionGroupConditionParamBindingArrayValue, MaintenanceWindowAlertConditionGroupConditionParamBindingArrayValueArgs
MaintenanceWindowAlertConditionGroupConditionParamBindingValue, MaintenanceWindowAlertConditionGroupConditionParamBindingValueArgs
MaintenanceWindowEscalationTarget, MaintenanceWindowEscalationTargetArgs
- Escalation
Paths MaintenanceWindow Escalation Target Escalation Paths - Escalation paths to route alerts to
- Users
Maintenance
Window Escalation Target Users - Users to notify directly
- Escalation
Paths MaintenanceWindow Escalation Target Escalation Paths - Escalation paths to route alerts to
- Users
Maintenance
Window Escalation Target Users - Users to notify directly
- escalation
Paths MaintenanceWindow Escalation Target Escalation Paths - Escalation paths to route alerts to
- users
Maintenance
Window Escalation Target Users - Users to notify directly
- escalation
Paths MaintenanceWindow Escalation Target Escalation Paths - Escalation paths to route alerts to
- users
Maintenance
Window Escalation Target Users - Users to notify directly
- escalation_
paths MaintenanceWindow Escalation Target Escalation Paths - Escalation paths to route alerts to
- users
Maintenance
Window Escalation Target Users - Users to notify directly
- escalation
Paths Property Map - Escalation paths to route alerts to
- users Property Map
- Users to notify directly
MaintenanceWindowEscalationTargetEscalationPaths, MaintenanceWindowEscalationTargetEscalationPathsArgs
- Array
Values List<MaintenanceWindow Escalation Target Escalation Paths Array Value> - The array of literal or reference parameter values
- Value
Maintenance
Window Escalation Target Escalation Paths Value - The literal or reference parameter value
- Array
Values []MaintenanceWindow Escalation Target Escalation Paths Array Value - The array of literal or reference parameter values
- Value
Maintenance
Window Escalation Target Escalation Paths Value - The literal or reference parameter value
- array
Values List<MaintenanceWindow Escalation Target Escalation Paths Array Value> - The array of literal or reference parameter values
- value
Maintenance
Window Escalation Target Escalation Paths Value - The literal or reference parameter value
- array
Values MaintenanceWindow Escalation Target Escalation Paths Array Value[] - The array of literal or reference parameter values
- value
Maintenance
Window Escalation Target Escalation Paths Value - The literal or reference parameter value
- array_
values Sequence[MaintenanceWindow Escalation Target Escalation Paths Array Value] - The array of literal or reference parameter values
- value
Maintenance
Window Escalation Target Escalation Paths Value - The literal or reference parameter value
- array
Values List<Property Map> - The array of literal or reference parameter values
- value Property Map
- The literal or reference parameter value
MaintenanceWindowEscalationTargetEscalationPathsArrayValue, MaintenanceWindowEscalationTargetEscalationPathsArrayValueArgs
MaintenanceWindowEscalationTargetEscalationPathsValue, MaintenanceWindowEscalationTargetEscalationPathsValueArgs
MaintenanceWindowEscalationTargetUsers, MaintenanceWindowEscalationTargetUsersArgs
- Array
Values List<MaintenanceWindow Escalation Target Users Array Value> - The array of literal or reference parameter values
- Value
Maintenance
Window Escalation Target Users Value - The literal or reference parameter value
- Array
Values []MaintenanceWindow Escalation Target Users Array Value - The array of literal or reference parameter values
- Value
Maintenance
Window Escalation Target Users Value - The literal or reference parameter value
- array
Values List<MaintenanceWindow Escalation Target Users Array Value> - The array of literal or reference parameter values
- value
Maintenance
Window Escalation Target Users Value - The literal or reference parameter value
- array
Values MaintenanceWindow Escalation Target Users Array Value[] - The array of literal or reference parameter values
- value
Maintenance
Window Escalation Target Users Value - The literal or reference parameter value
- array_
values Sequence[MaintenanceWindow Escalation Target Users Array Value] - The array of literal or reference parameter values
- value
Maintenance
Window Escalation Target Users Value - The literal or reference parameter value
- array
Values List<Property Map> - The array of literal or reference parameter values
- value Property Map
- The literal or reference parameter value
MaintenanceWindowEscalationTargetUsersArrayValue, MaintenanceWindowEscalationTargetUsersArrayValueArgs
MaintenanceWindowEscalationTargetUsersValue, MaintenanceWindowEscalationTargetUsersValueArgs
MaintenanceWindowNotifyChannel, MaintenanceWindowNotifyChannelArgs
- Channel
Id string - The external provider channel ID (e.g. Slack channel ID)
- Channel
Type string - The type of channel (e.g. public, private)
- Channel
Name string - Human readable name of the channel
- Channel
Id string - The external provider channel ID (e.g. Slack channel ID)
- Channel
Type string - The type of channel (e.g. public, private)
- Channel
Name string - Human readable name of the channel
- channel
Id String - The external provider channel ID (e.g. Slack channel ID)
- channel
Type String - The type of channel (e.g. public, private)
- channel
Name String - Human readable name of the channel
- channel
Id string - The external provider channel ID (e.g. Slack channel ID)
- channel
Type string - The type of channel (e.g. public, private)
- channel
Name string - Human readable name of the channel
- channel_
id str - The external provider channel ID (e.g. Slack channel ID)
- channel_
type str - The type of channel (e.g. public, private)
- channel_
name str - Human readable name of the channel
- channel
Id String - The external provider channel ID (e.g. Slack channel ID)
- channel
Type String - The type of channel (e.g. public, private)
- channel
Name String - Human readable name of the channel
Import
The pulumi import command can be used, for example:
#!/bin/bash
Import a maintenance window using its ID
Replace the ID with a real ID from your incident.io organization
$ pulumi import incident:index/maintenanceWindow:MaintenanceWindow example 01ABC123DEF456GHI789JKL
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- incident incident-io/terraform-provider-incident
- License
- Notes
- This Pulumi package is based on the
incidentTerraform Provider.
published on Tuesday, Mar 24, 2026 by incident-io
