Skip to main content

OnCallCalendar

Resource OnCallCalendar in pulumi-better-uptime.
5 min read

Resource OnCallCalendar in pulumi-better-uptime.

Pulumi type: better-uptime:index/onCallCalendar:OnCallCalendar.

name is the Pulumi resource name. Nested object fields are documented under that object. They are not arguments of this resource.

Example#

Only required arguments are set. A string in angle brackets stands in for that argument. Any other value is an option or example written in the SDK description.

Arguments#

PropertyTypeRequiredDescription
namestringnoName of the on-call calendar.
onCallRotationOnCallCalendarOnCallRotation (input)noConfiguration block for the on-call rotation schedule. Ignored when omitted - on-call can be controlled in Better Stack.
teamNamestringnoUsed to specify the team the resource should be created in when using global tokens. You can't update this value later.

Outputs#

Computed outputs are produced by the provider. They are not constructor arguments.

PropertyTypeComputedDescription
defaultCalendarbooleanyesWhether the on-call calendar is the default on-call calendar.
namestringnoName of the on-call calendar.
onCallRotationOnCallCalendarOnCallRotation (output)noConfiguration block for the on-call rotation schedule. Ignored when omitted - on-call can be controlled in Better Stack.
onCallUsersOnCallCalendarOnCallUser (output)[]yesArray of on-call persons.
teamNamestringnoUsed to specify the team the resource should be created in when using global tokens. You can't update this value later.

OnCallCalendarOnCallRotation (input)#

Input object OnCallCalendarOnCallRotation. Fields below belong to this object, not to the parent.

PropertyTypeRequiredDescription
endRotationsAtstringyesEnd time of the rotation in RFC 3339 format (e.g. 2026-01-01T00:00:00Z)
rotationIntervalstringyesThe interval unit for rotation_length. Must be one of: hour, day, week.
rotationLengthnumberyesThe length of each rotation shift. See rotationInterval for units.
startRotationsAtstringyesStart time of the rotation in RFC 3339 format (e.g. 2026-01-01T00:00:00Z)
timezonestringnoTime zone the rotation's working hours are written in and its handovers follow across daylight-saving changes, an IANA name such as Europe/Prague. The offset in startRotationsAt still fixes the instant of the first shift, so write it in this time zone's offset. Omit to keep the time zone the rotation already has; a new rotation with working hours and no time zone uses UTC.
usersstring[]yesList of email addresses for users participating in the rotation.
workingHoursOnCallCalendarOnCallRotationWorkingHour (input)[]noWindows during which the rotation pages anyone, one block per day and window. Omit for a rotation that is active around the clock; omitting it on an existing rotation removes its working hours. A window whose endTime is not after startTime runs overnight.

OnCallCalendarOnCallRotationWorkingHour (input)#

Input object OnCallCalendarOnCallRotationWorkingHour. Fields below belong to this object, not to the parent.

PropertyTypeRequiredDescription
daystringyesDay of the week. Must be one of: sunday, monday, tuesday, wednesday, thursday, friday, saturday.
endTimestringnoEnd of the window as HH:MM on a 24-hour clock (e.g. 17:00). Ends at midnight when omitted, so a block with both times omitted covers the whole day.
startTimestringnoStart of the window as HH:MM on a 24-hour clock (e.g. 09:00). Starts at midnight when omitted.

OnCallCalendarOnCallRotation (output)#

Output object OnCallCalendarOnCallRotation. Fields below belong to this object.

PropertyTypeAlways presentDescription
endRotationsAtstringyesEnd time of the rotation in RFC 3339 format (e.g. 2026-01-01T00:00:00Z)
rotationIntervalstringyesThe interval unit for rotation_length. Must be one of: hour, day, week.
rotationLengthnumberyesThe length of each rotation shift. See rotationInterval for units.
startRotationsAtstringyesStart time of the rotation in RFC 3339 format (e.g. 2026-01-01T00:00:00Z)
timezonestringyesTime zone the rotation's working hours are written in and its handovers follow across daylight-saving changes, an IANA name such as Europe/Prague. The offset in startRotationsAt still fixes the instant of the first shift, so write it in this time zone's offset. Omit to keep the time zone the rotation already has; a new rotation with working hours and no time zone uses UTC.
usersstring[]yesList of email addresses for users participating in the rotation.
workingHoursOnCallCalendarOnCallRotationWorkingHour (output)[]noWindows during which the rotation pages anyone, one block per day and window. Omit for a rotation that is active around the clock; omitting it on an existing rotation removes its working hours. A window whose endTime is not after startTime runs overnight.

OnCallCalendarOnCallRotationWorkingHour (output)#

Output object OnCallCalendarOnCallRotationWorkingHour. Fields below belong to this object.

PropertyTypeAlways presentDescription
daystringyesDay of the week. Must be one of: sunday, monday, tuesday, wednesday, thursday, friday, saturday.
endTimestringnoEnd of the window as HH:MM on a 24-hour clock (e.g. 17:00). Ends at midnight when omitted, so a block with both times omitted covers the whole day.
startTimestringnoStart of the window as HH:MM on a 24-hour clock (e.g. 09:00). Starts at midnight when omitted.

OnCallCalendarOnCallUser (output)#

Output object OnCallCalendarOnCallUser. Fields below belong to this object.

PropertyTypeAlways presentDescription
emailstringno
firstNamestringno
idstringno
lastNamestringno
phoneNumbersstring[]no