published on Monday, Nov 9, 2026 by pulumiverse
Grafanapublished on Monday, Nov 9, 2026 by pulumiverse
Manages a Grafana Incident severity, which expresses the impact of an incident.
The Incident API enforces a few rules that affect Terraform:
- Severities can be created at levels
1to5, and labels and levels must be unique within the organization, including archived severities. Besides Pending, an organization can therefore hold at most 5 severities, archived or not. A new organization starts with Pending, Critical, Major and Minor, which leaves two levels free. When a new severity’s level or label is already taken, the error names the severity that holds it. - An archived severity keeps its label and level, so neither can be reused until it is deleted. Archiving a severity does not free its level for another one.
- The level cannot be changed after the severity is created, so changing
levelreplaces the severity. The plan is refused when another severity, archived or not, already holds the new level or label, since the replacement would otherwise delete the severity and then fail to create it.createBeforeDestroycannot be used, because the new severity would conflict with the old one’s level or label. - A severity that any incident uses, open or closed, cannot be deleted, and that includes the delete a replacement makes. Set
archived = trueto retire it instead, which keeps the incident history intact. To stop managing it without deleting it, use aremovedblock withlifecycle { destroy = false }.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as grafana from "@pulumiverse/grafana";
const informational = new grafana.incident.Severity("informational", {
label: "Informational",
level: 4,
description: "No customer impact, tracked for awareness.",
icon: "angle-double-down",
darkColor: "rgba(110, 159, 255, 1)",
lightColor: "rgba(31, 98, 224, 1)",
});
import pulumi
import pulumiverse_grafana as grafana
informational = grafana.incident.Severity("informational",
label="Informational",
level=4,
description="No customer impact, tracked for awareness.",
icon="angle-double-down",
dark_color="rgba(110, 159, 255, 1)",
light_color="rgba(31, 98, 224, 1)")
package main
import (
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/pulumiverse/pulumi-grafana/sdk/v2/go/grafana/incident"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := incident.NewSeverity(ctx, "informational", &incident.SeverityArgs{
Label: pulumi.String("Informational"),
Level: pulumi.Int(4),
Description: pulumi.String("No customer impact, tracked for awareness."),
Icon: pulumi.String("angle-double-down"),
DarkColor: pulumi.String("rgba(110, 159, 255, 1)"),
LightColor: pulumi.String("rgba(31, 98, 224, 1)"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Grafana = Pulumiverse.Grafana;
return await Deployment.RunAsync(() =>
{
var informational = new Grafana.Incident.Severity("informational", new()
{
Label = "Informational",
Level = 4,
Description = "No customer impact, tracked for awareness.",
Icon = "angle-double-down",
DarkColor = "rgba(110, 159, 255, 1)",
LightColor = "rgba(31, 98, 224, 1)",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.grafana.incident.Severity;
import com.pulumi.grafana.incident.SeverityArgs;
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) {
var informational = new Severity("informational", SeverityArgs.builder()
.label("Informational")
.level(4)
.description("No customer impact, tracked for awareness.")
.icon("angle-double-down")
.darkColor("rgba(110, 159, 255, 1)")
.lightColor("rgba(31, 98, 224, 1)")
.build());
}
}
resources:
informational:
type: grafana:incident:Severity
properties:
label: Informational
level: 4
description: No customer impact, tracked for awareness.
icon: angle-double-down
darkColor: rgba(110, 159, 255, 1)
lightColor: rgba(31, 98, 224, 1)
Example coming soon!
Create Severity Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Severity(name: string, args: SeverityArgs, opts?: CustomResourceOptions);@overload
def Severity(resource_name: str,
args: SeverityArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Severity(resource_name: str,
opts: Optional[ResourceOptions] = None,
label: Optional[str] = None,
level: Optional[int] = None,
archived: Optional[bool] = None,
dark_color: Optional[str] = None,
description: Optional[str] = None,
icon: Optional[str] = None,
light_color: Optional[str] = None)func NewSeverity(ctx *Context, name string, args SeverityArgs, opts ...ResourceOption) (*Severity, error)public Severity(string name, SeverityArgs args, CustomResourceOptions? opts = null)
public Severity(String name, SeverityArgs args)
public Severity(String name, SeverityArgs args, CustomResourceOptions options)
type: grafana:incident:Severity
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "grafana_incident_severity" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args SeverityArgs
- 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 SeverityArgs
- 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 SeverityArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args SeverityArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args SeverityArgs
- 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 severityResource = new Grafana.Incident.Severity("severityResource", new()
{
Label = "string",
Level = 0,
Archived = false,
DarkColor = "string",
Description = "string",
Icon = "string",
LightColor = "string",
});
example, err := incident.NewSeverity(ctx, "severityResource", &incident.SeverityArgs{
Label: pulumi.String("string"),
Level: pulumi.Int(0),
Archived: pulumi.Bool(false),
DarkColor: pulumi.String("string"),
Description: pulumi.String("string"),
Icon: pulumi.String("string"),
LightColor: pulumi.String("string"),
})
resource "grafana_incident_severity" "severityResource" {
lifecycle {
create_before_destroy = true
}
label = "string"
level = 0
archived = false
dark_color = "string"
description = "string"
icon = "string"
light_color = "string"
}
var severityResource = new Severity("severityResource", SeverityArgs.builder()
.label("string")
.level(0)
.archived(false)
.darkColor("string")
.description("string")
.icon("string")
.lightColor("string")
.build());
severity_resource = grafana.incident.Severity("severityResource",
label="string",
level=0,
archived=False,
dark_color="string",
description="string",
icon="string",
light_color="string")
const severityResource = new grafana.incident.Severity("severityResource", {
label: "string",
level: 0,
archived: false,
darkColor: "string",
description: "string",
icon: "string",
lightColor: "string",
});
type: grafana:incident:Severity
properties:
archived: false
darkColor: string
description: string
icon: string
label: string
level: 0
lightColor: string
Severity 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 Severity resource accepts the following input properties:
- Label string
- The display label of the severity, for example
Critical. Incidents reference the severity by this label. It must be unique within the organization, including archived severities. - Level int
- The level of the severity, from
1to5; lower is more severe. It must be unique within the organization, including archived severities. Level-1belongs to the system-managed Pending severity, which can be imported but not created. Changing it forces a new severity to be created. - Archived bool
- Whether the severity is archived. Archived severities cannot be assigned to new incidents, but remain on historical ones. The Pending severity cannot be archived. Defaults to
false. - Dark
Color string - The color of the severity in dark mode, as a CSS color such as
#FF5286orrgb(255, 82, 134). - Description string
- A description of when the severity applies.
- Icon string
- The name of the icon shown for the severity in the UI and in Slack. One of
angle-double-down,angle-double-up,bolt,bug,exclamation,exclamation-triangle,fire,question-circleorshield. - Light
Color string - The color of the severity in light mode, as a CSS color such as
#FF5286orrgb(255, 82, 134).
- Label string
- The display label of the severity, for example
Critical. Incidents reference the severity by this label. It must be unique within the organization, including archived severities. - Level int
- The level of the severity, from
1to5; lower is more severe. It must be unique within the organization, including archived severities. Level-1belongs to the system-managed Pending severity, which can be imported but not created. Changing it forces a new severity to be created. - Archived bool
- Whether the severity is archived. Archived severities cannot be assigned to new incidents, but remain on historical ones. The Pending severity cannot be archived. Defaults to
false. - Dark
Color string - The color of the severity in dark mode, as a CSS color such as
#FF5286orrgb(255, 82, 134). - Description string
- A description of when the severity applies.
- Icon string
- The name of the icon shown for the severity in the UI and in Slack. One of
angle-double-down,angle-double-up,bolt,bug,exclamation,exclamation-triangle,fire,question-circleorshield. - Light
Color string - The color of the severity in light mode, as a CSS color such as
#FF5286orrgb(255, 82, 134).
- label string
- The display label of the severity, for example
Critical. Incidents reference the severity by this label. It must be unique within the organization, including archived severities. - level number
- The level of the severity, from
1to5; lower is more severe. It must be unique within the organization, including archived severities. Level-1belongs to the system-managed Pending severity, which can be imported but not created. Changing it forces a new severity to be created. - archived bool
- Whether the severity is archived. Archived severities cannot be assigned to new incidents, but remain on historical ones. The Pending severity cannot be archived. Defaults to
false. - dark_
color string - The color of the severity in dark mode, as a CSS color such as
#FF5286orrgb(255, 82, 134). - description string
- A description of when the severity applies.
- icon string
- The name of the icon shown for the severity in the UI and in Slack. One of
angle-double-down,angle-double-up,bolt,bug,exclamation,exclamation-triangle,fire,question-circleorshield. - light_
color string - The color of the severity in light mode, as a CSS color such as
#FF5286orrgb(255, 82, 134).
- label String
- The display label of the severity, for example
Critical. Incidents reference the severity by this label. It must be unique within the organization, including archived severities. - level Integer
- The level of the severity, from
1to5; lower is more severe. It must be unique within the organization, including archived severities. Level-1belongs to the system-managed Pending severity, which can be imported but not created. Changing it forces a new severity to be created. - archived Boolean
- Whether the severity is archived. Archived severities cannot be assigned to new incidents, but remain on historical ones. The Pending severity cannot be archived. Defaults to
false. - dark
Color String - The color of the severity in dark mode, as a CSS color such as
#FF5286orrgb(255, 82, 134). - description String
- A description of when the severity applies.
- icon String
- The name of the icon shown for the severity in the UI and in Slack. One of
angle-double-down,angle-double-up,bolt,bug,exclamation,exclamation-triangle,fire,question-circleorshield. - light
Color String - The color of the severity in light mode, as a CSS color such as
#FF5286orrgb(255, 82, 134).
- label string
- The display label of the severity, for example
Critical. Incidents reference the severity by this label. It must be unique within the organization, including archived severities. - level number
- The level of the severity, from
1to5; lower is more severe. It must be unique within the organization, including archived severities. Level-1belongs to the system-managed Pending severity, which can be imported but not created. Changing it forces a new severity to be created. - archived boolean
- Whether the severity is archived. Archived severities cannot be assigned to new incidents, but remain on historical ones. The Pending severity cannot be archived. Defaults to
false. - dark
Color string - The color of the severity in dark mode, as a CSS color such as
#FF5286orrgb(255, 82, 134). - description string
- A description of when the severity applies.
- icon string
- The name of the icon shown for the severity in the UI and in Slack. One of
angle-double-down,angle-double-up,bolt,bug,exclamation,exclamation-triangle,fire,question-circleorshield. - light
Color string - The color of the severity in light mode, as a CSS color such as
#FF5286orrgb(255, 82, 134).
- label str
- The display label of the severity, for example
Critical. Incidents reference the severity by this label. It must be unique within the organization, including archived severities. - level int
- The level of the severity, from
1to5; lower is more severe. It must be unique within the organization, including archived severities. Level-1belongs to the system-managed Pending severity, which can be imported but not created. Changing it forces a new severity to be created. - archived bool
- Whether the severity is archived. Archived severities cannot be assigned to new incidents, but remain on historical ones. The Pending severity cannot be archived. Defaults to
false. - dark_
color str - The color of the severity in dark mode, as a CSS color such as
#FF5286orrgb(255, 82, 134). - description str
- A description of when the severity applies.
- icon str
- The name of the icon shown for the severity in the UI and in Slack. One of
angle-double-down,angle-double-up,bolt,bug,exclamation,exclamation-triangle,fire,question-circleorshield. - light_
color str - The color of the severity in light mode, as a CSS color such as
#FF5286orrgb(255, 82, 134).
- label String
- The display label of the severity, for example
Critical. Incidents reference the severity by this label. It must be unique within the organization, including archived severities. - level Number
- The level of the severity, from
1to5; lower is more severe. It must be unique within the organization, including archived severities. Level-1belongs to the system-managed Pending severity, which can be imported but not created. Changing it forces a new severity to be created. - archived Boolean
- Whether the severity is archived. Archived severities cannot be assigned to new incidents, but remain on historical ones. The Pending severity cannot be archived. Defaults to
false. - dark
Color String - The color of the severity in dark mode, as a CSS color such as
#FF5286orrgb(255, 82, 134). - description String
- A description of when the severity applies.
- icon String
- The name of the icon shown for the severity in the UI and in Slack. One of
angle-double-down,angle-double-up,bolt,bug,exclamation,exclamation-triangle,fire,question-circleorshield. - light
Color String - The color of the severity in light mode, as a CSS color such as
#FF5286orrgb(255, 82, 134).
Outputs
All input properties are implicitly available as output properties. Additionally, the Severity 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 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 Severity Resource
Get an existing Severity 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?: SeverityState, opts?: CustomResourceOptions): Severity@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
archived: Optional[bool] = None,
dark_color: Optional[str] = None,
description: Optional[str] = None,
icon: Optional[str] = None,
label: Optional[str] = None,
level: Optional[int] = None,
light_color: Optional[str] = None) -> Severityfunc GetSeverity(ctx *Context, name string, id IDInput, state *SeverityState, opts ...ResourceOption) (*Severity, error)public static Severity Get(string name, Input<string> id, SeverityState? state, CustomResourceOptions? opts = null)public static Severity get(String name, Output<String> id, SeverityState state, CustomResourceOptions options)resources: _: type: grafana:incident:Severity get: id: ${id}import {
to = grafana_incident_severity.example
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.
- Archived bool
- Whether the severity is archived. Archived severities cannot be assigned to new incidents, but remain on historical ones. The Pending severity cannot be archived. Defaults to
false. - Dark
Color string - The color of the severity in dark mode, as a CSS color such as
#FF5286orrgb(255, 82, 134). - Description string
- A description of when the severity applies.
- Icon string
- The name of the icon shown for the severity in the UI and in Slack. One of
angle-double-down,angle-double-up,bolt,bug,exclamation,exclamation-triangle,fire,question-circleorshield. - Label string
- The display label of the severity, for example
Critical. Incidents reference the severity by this label. It must be unique within the organization, including archived severities. - Level int
- The level of the severity, from
1to5; lower is more severe. It must be unique within the organization, including archived severities. Level-1belongs to the system-managed Pending severity, which can be imported but not created. Changing it forces a new severity to be created. - Light
Color string - The color of the severity in light mode, as a CSS color such as
#FF5286orrgb(255, 82, 134).
- Archived bool
- Whether the severity is archived. Archived severities cannot be assigned to new incidents, but remain on historical ones. The Pending severity cannot be archived. Defaults to
false. - Dark
Color string - The color of the severity in dark mode, as a CSS color such as
#FF5286orrgb(255, 82, 134). - Description string
- A description of when the severity applies.
- Icon string
- The name of the icon shown for the severity in the UI and in Slack. One of
angle-double-down,angle-double-up,bolt,bug,exclamation,exclamation-triangle,fire,question-circleorshield. - Label string
- The display label of the severity, for example
Critical. Incidents reference the severity by this label. It must be unique within the organization, including archived severities. - Level int
- The level of the severity, from
1to5; lower is more severe. It must be unique within the organization, including archived severities. Level-1belongs to the system-managed Pending severity, which can be imported but not created. Changing it forces a new severity to be created. - Light
Color string - The color of the severity in light mode, as a CSS color such as
#FF5286orrgb(255, 82, 134).
- archived bool
- Whether the severity is archived. Archived severities cannot be assigned to new incidents, but remain on historical ones. The Pending severity cannot be archived. Defaults to
false. - dark_
color string - The color of the severity in dark mode, as a CSS color such as
#FF5286orrgb(255, 82, 134). - description string
- A description of when the severity applies.
- icon string
- The name of the icon shown for the severity in the UI and in Slack. One of
angle-double-down,angle-double-up,bolt,bug,exclamation,exclamation-triangle,fire,question-circleorshield. - label string
- The display label of the severity, for example
Critical. Incidents reference the severity by this label. It must be unique within the organization, including archived severities. - level number
- The level of the severity, from
1to5; lower is more severe. It must be unique within the organization, including archived severities. Level-1belongs to the system-managed Pending severity, which can be imported but not created. Changing it forces a new severity to be created. - light_
color string - The color of the severity in light mode, as a CSS color such as
#FF5286orrgb(255, 82, 134).
- archived Boolean
- Whether the severity is archived. Archived severities cannot be assigned to new incidents, but remain on historical ones. The Pending severity cannot be archived. Defaults to
false. - dark
Color String - The color of the severity in dark mode, as a CSS color such as
#FF5286orrgb(255, 82, 134). - description String
- A description of when the severity applies.
- icon String
- The name of the icon shown for the severity in the UI and in Slack. One of
angle-double-down,angle-double-up,bolt,bug,exclamation,exclamation-triangle,fire,question-circleorshield. - label String
- The display label of the severity, for example
Critical. Incidents reference the severity by this label. It must be unique within the organization, including archived severities. - level Integer
- The level of the severity, from
1to5; lower is more severe. It must be unique within the organization, including archived severities. Level-1belongs to the system-managed Pending severity, which can be imported but not created. Changing it forces a new severity to be created. - light
Color String - The color of the severity in light mode, as a CSS color such as
#FF5286orrgb(255, 82, 134).
- archived boolean
- Whether the severity is archived. Archived severities cannot be assigned to new incidents, but remain on historical ones. The Pending severity cannot be archived. Defaults to
false. - dark
Color string - The color of the severity in dark mode, as a CSS color such as
#FF5286orrgb(255, 82, 134). - description string
- A description of when the severity applies.
- icon string
- The name of the icon shown for the severity in the UI and in Slack. One of
angle-double-down,angle-double-up,bolt,bug,exclamation,exclamation-triangle,fire,question-circleorshield. - label string
- The display label of the severity, for example
Critical. Incidents reference the severity by this label. It must be unique within the organization, including archived severities. - level number
- The level of the severity, from
1to5; lower is more severe. It must be unique within the organization, including archived severities. Level-1belongs to the system-managed Pending severity, which can be imported but not created. Changing it forces a new severity to be created. - light
Color string - The color of the severity in light mode, as a CSS color such as
#FF5286orrgb(255, 82, 134).
- archived bool
- Whether the severity is archived. Archived severities cannot be assigned to new incidents, but remain on historical ones. The Pending severity cannot be archived. Defaults to
false. - dark_
color str - The color of the severity in dark mode, as a CSS color such as
#FF5286orrgb(255, 82, 134). - description str
- A description of when the severity applies.
- icon str
- The name of the icon shown for the severity in the UI and in Slack. One of
angle-double-down,angle-double-up,bolt,bug,exclamation,exclamation-triangle,fire,question-circleorshield. - label str
- The display label of the severity, for example
Critical. Incidents reference the severity by this label. It must be unique within the organization, including archived severities. - level int
- The level of the severity, from
1to5; lower is more severe. It must be unique within the organization, including archived severities. Level-1belongs to the system-managed Pending severity, which can be imported but not created. Changing it forces a new severity to be created. - light_
color str - The color of the severity in light mode, as a CSS color such as
#FF5286orrgb(255, 82, 134).
- archived Boolean
- Whether the severity is archived. Archived severities cannot be assigned to new incidents, but remain on historical ones. The Pending severity cannot be archived. Defaults to
false. - dark
Color String - The color of the severity in dark mode, as a CSS color such as
#FF5286orrgb(255, 82, 134). - description String
- A description of when the severity applies.
- icon String
- The name of the icon shown for the severity in the UI and in Slack. One of
angle-double-down,angle-double-up,bolt,bug,exclamation,exclamation-triangle,fire,question-circleorshield. - label String
- The display label of the severity, for example
Critical. Incidents reference the severity by this label. It must be unique within the organization, including archived severities. - level Number
- The level of the severity, from
1to5; lower is more severe. It must be unique within the organization, including archived severities. Level-1belongs to the system-managed Pending severity, which can be imported but not created. Changing it forces a new severity to be created. - light
Color String - The color of the severity in light mode, as a CSS color such as
#FF5286orrgb(255, 82, 134).
Import
terraform import grafana_incident_severity.name "{{ id }}"
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- grafana pulumiverse/pulumi-grafana
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
grafanaTerraform Provider.
Grafanapublished on Monday, Nov 9, 2026 by pulumiverse