Skip to main content

StatusPageResource

Resource StatusPageResource in pulumi-better-uptime.
10 min read

Resource StatusPageResource in pulumi-better-uptime.

Pulumi type: better-uptime:index/statusPageResource:StatusPageResource.

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
explanationstringnoA detailed text displayed as a help icon.
historybooleannoDo you want to display detailed historical status for this item? This field is deprecated, use widgetType instead.
markAsDegradedForstringnoHow to mark this resource as degraded. Can be one of noIncident, anyIncident, or incidentMatchingMetadata.
markAsDegradedMetadataRuleStatusPageResourceMarkAsDegradedMetadataRule (input)noMetadata rule for marking resource as degraded. Only applicable when markAsDegradedFor is 'incident_matching_metadata'.
markAsDownForstringnoHow to mark this resource as down. Can be one of noIncident, anyIncident, or incidentMatchingMetadata.
markAsDownMetadataRuleStatusPageResourceMarkAsDownMetadataRule (input)noMetadata rule for marking resource as down. Only applicable when markAsDownFor is 'incident_matching_metadata'.
positionnumbernoThe position of this resource on your status page, indexed from zero. If you don't specify a position, we add the resource to the end of the status page. When you specify a position of an existing resource, we add the resource to this position and shift resources below to accommodate.
publicNamestringyesThe resource name displayed publicly on your status page.
resourceIdnumbernoThe ID of the resource you are adding. Omit when resourceType is ManuallyTrackedItem.
resourceTypestringyesThe type of the resource you are adding. Available values: ManuallyTrackedItem, Monitor, MonitorGroup, Heartbeat, HeartbeatGroup, WebhookIntegration, EmailIntegration, IncomingWebhook, AmazonSnsIntegration, ResourceGroup, LogsChart, CatalogReference.
statusPageIdstringyesThe ID of the Status Page.
statusPageSectionIdnumbernoThe ID of the Status Page Section. If you don't specify a status_page_section_id, we add the resource to the first section. If there are no sections in the status page yet, one will be automatically created for you.
widgetTypestringnoWhat widget to display for this resource. Available values: plain - only display status, history - display historical status,intradayHistory- display detailed historical status,responseTimes- add a response times chart (only for Monitor resource type). This takes preference over history when both parameters are present.

Outputs#

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

PropertyTypeComputedDescription
availabilitynumberyesThe availability of this resource (from 0.0 to 1.0).
explanationstringnoA detailed text displayed as a help icon.
historybooleannoDo you want to display detailed historical status for this item? This field is deprecated, use widgetType instead.
markAsDegradedForstringnoHow to mark this resource as degraded. Can be one of noIncident, anyIncident, or incidentMatchingMetadata.
markAsDegradedMetadataRuleStatusPageResourceMarkAsDegradedMetadataRule (output)noMetadata rule for marking resource as degraded. Only applicable when markAsDegradedFor is 'incident_matching_metadata'.
markAsDownForstringnoHow to mark this resource as down. Can be one of noIncident, anyIncident, or incidentMatchingMetadata.
markAsDownMetadataRuleStatusPageResourceMarkAsDownMetadataRule (output)noMetadata rule for marking resource as down. Only applicable when markAsDownFor is 'incident_matching_metadata'.
positionnumbernoThe position of this resource on your status page, indexed from zero. If you don't specify a position, we add the resource to the end of the status page. When you specify a position of an existing resource, we add the resource to this position and shift resources below to accommodate.
publicNamestringnoThe resource name displayed publicly on your status page.
resourceIdnumbernoThe ID of the resource you are adding. Omit when resourceType is ManuallyTrackedItem.
resourceTypestringnoThe type of the resource you are adding. Available values: ManuallyTrackedItem, Monitor, MonitorGroup, Heartbeat, HeartbeatGroup, WebhookIntegration, EmailIntegration, IncomingWebhook, AmazonSnsIntegration, ResourceGroup, LogsChart, CatalogReference.
statusstringyesThe current status of the resource. Can be one of notMonitored (when the underlying monitor is paused), operational, maintenance, degraded, or downtime
statusHistoriesStatusPageResourceStatusHistory (output)[]yesHistory of a single status page resource history
statusPageIdstringnoThe ID of the Status Page.
statusPageSectionIdnumbernoThe ID of the Status Page Section. If you don't specify a status_page_section_id, we add the resource to the first section. If there are no sections in the status page yet, one will be automatically created for you.
widgetTypestringnoWhat widget to display for this resource. Available values: plain - only display status, history - display historical status,intradayHistory- display detailed historical status,responseTimes- add a response times chart (only for Monitor resource type). This takes preference over history when both parameters are present.

StatusPageResourceMarkAsDegradedMetadataRule (input)#

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

PropertyTypeRequiredDescription
keystringyesThe metadata key to match against.
metadataValuesStatusPageResourceMarkAsDegradedMetadataRuleMetadataValue (input)[]yesList of metadata values that should trigger the degraded status.

StatusPageResourceMarkAsDegradedMetadataRuleMetadataValue (input)#

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

PropertyTypeRequiredDescription
emailstringnoEmail of the referenced user when type is User.
itemIdstringnoID of the referenced item when type is different than String.
namestringnoName of the referenced item when type is different than String. Not available for Endpoint, SlackIntegration, and ZapierWebhook, which are referenced by itemId.
typestringnoValue types can be grouped into 2 main categories: - Scalar: String - Reference: User, Team, Policy, Schedule, Endpoint, Source, SlackIntegration, LinearIntegration, JiraIntegration, MicrosoftTeamsWebhook, ZapierWebhook, NativeWebhook, PagerDutyWebhook The value of a Scalar type is defined using the value field. The value of a Reference type is defined using one of the following fields: - itemId - great choice when you know the ID of the target item. - email - your go-to choice when you're referencing users. - name - can be used to reference other items like teams, policies, etc. Not available for Endpoint, SlackIntegration, and ZapierWebhook, which are referenced by itemId. The reference types require the presence of at least one of the three fields: itemId, name, email.
valuestringnoValue when type is String.

StatusPageResourceMarkAsDownMetadataRule (input)#

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

PropertyTypeRequiredDescription
keystringyesThe metadata key to match against.
metadataValuesStatusPageResourceMarkAsDownMetadataRuleMetadataValue (input)[]yesList of metadata values that should trigger the down status.

StatusPageResourceMarkAsDownMetadataRuleMetadataValue (input)#

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

PropertyTypeRequiredDescription
emailstringnoEmail of the referenced user when type is User.
itemIdstringnoID of the referenced item when type is different than String.
namestringnoName of the referenced item when type is different than String. Not available for Endpoint, SlackIntegration, and ZapierWebhook, which are referenced by itemId.
typestringnoValue types can be grouped into 2 main categories: - Scalar: String - Reference: User, Team, Policy, Schedule, Endpoint, Source, SlackIntegration, LinearIntegration, JiraIntegration, MicrosoftTeamsWebhook, ZapierWebhook, NativeWebhook, PagerDutyWebhook The value of a Scalar type is defined using the value field. The value of a Reference type is defined using one of the following fields: - itemId - great choice when you know the ID of the target item. - email - your go-to choice when you're referencing users. - name - can be used to reference other items like teams, policies, etc. Not available for Endpoint, SlackIntegration, and ZapierWebhook, which are referenced by itemId. The reference types require the presence of at least one of the three fields: itemId, name, email.
valuestringnoValue when type is String.

StatusPageResourceMarkAsDegradedMetadataRule (output)#

Output object StatusPageResourceMarkAsDegradedMetadataRule. Fields below belong to this object.

PropertyTypeAlways presentDescription
keystringyesThe metadata key to match against.
metadataValuesStatusPageResourceMarkAsDegradedMetadataRuleMetadataValue (output)[]yesList of metadata values that should trigger the degraded status.

StatusPageResourceMarkAsDegradedMetadataRuleMetadataValue (output)#

Output object StatusPageResourceMarkAsDegradedMetadataRuleMetadataValue. Fields below belong to this object.

PropertyTypeAlways presentDescription
emailstringnoEmail of the referenced user when type is User.
itemIdstringnoID of the referenced item when type is different than String.
namestringnoName of the referenced item when type is different than String. Not available for Endpoint, SlackIntegration, and ZapierWebhook, which are referenced by itemId.
typestringnoValue types can be grouped into 2 main categories: - Scalar: String - Reference: User, Team, Policy, Schedule, Endpoint, Source, SlackIntegration, LinearIntegration, JiraIntegration, MicrosoftTeamsWebhook, ZapierWebhook, NativeWebhook, PagerDutyWebhook The value of a Scalar type is defined using the value field. The value of a Reference type is defined using one of the following fields: - itemId - great choice when you know the ID of the target item. - email - your go-to choice when you're referencing users. - name - can be used to reference other items like teams, policies, etc. Not available for Endpoint, SlackIntegration, and ZapierWebhook, which are referenced by itemId. The reference types require the presence of at least one of the three fields: itemId, name, email.
valuestringnoValue when type is String.

StatusPageResourceMarkAsDownMetadataRule (output)#

Output object StatusPageResourceMarkAsDownMetadataRule. Fields below belong to this object.

PropertyTypeAlways presentDescription
keystringyesThe metadata key to match against.
metadataValuesStatusPageResourceMarkAsDownMetadataRuleMetadataValue (output)[]yesList of metadata values that should trigger the down status.

StatusPageResourceMarkAsDownMetadataRuleMetadataValue (output)#

Output object StatusPageResourceMarkAsDownMetadataRuleMetadataValue. Fields below belong to this object.

PropertyTypeAlways presentDescription
emailstringnoEmail of the referenced user when type is User.
itemIdstringnoID of the referenced item when type is different than String.
namestringnoName of the referenced item when type is different than String. Not available for Endpoint, SlackIntegration, and ZapierWebhook, which are referenced by itemId.
typestringnoValue types can be grouped into 2 main categories: - Scalar: String - Reference: User, Team, Policy, Schedule, Endpoint, Source, SlackIntegration, LinearIntegration, JiraIntegration, MicrosoftTeamsWebhook, ZapierWebhook, NativeWebhook, PagerDutyWebhook The value of a Scalar type is defined using the value field. The value of a Reference type is defined using one of the following fields: - itemId - great choice when you know the ID of the target item. - email - your go-to choice when you're referencing users. - name - can be used to reference other items like teams, policies, etc. Not available for Endpoint, SlackIntegration, and ZapierWebhook, which are referenced by itemId. The reference types require the presence of at least one of the three fields: itemId, name, email.
valuestringnoValue when type is String.

StatusPageResourceStatusHistory (output)#

Output object StatusPageResourceStatusHistory. Fields below belong to this object.

PropertyTypeAlways presentDescription
daystringno
downtimeDurationnumberno
maintenanceDurationnumberno
statusstringno