published on Friday, Sep 11, 2026 by incident-io
published on Friday, Sep 11, 2026 by incident-io
Manage incident severities.
Each incident has a severity, picked from one of the severities configured in your organisations settings.
Severities help categorise incidents, and communicate urgency/impact. You can use severities when filtering incidents in the dashboard, and in workflows and announcement rules.
Use this data source to look up an existing incident severity, either by id or by name.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as incident from "@pulumi/incident";
// Look up an existing incident severity by name.
const minor = incident.getSeverity({
name: "Minor",
});
// Create an incident severity.
const criticalSeverity = new incident.Severity("critical", {
name: "Critical",
description: "A critical incident that requires an immediate response.",
});
// Reference the incident severity by its ID.
const critical = incident.getSeverityOutput({
id: criticalSeverity.id,
});
import pulumi
import pulumi_incident as incident
# Look up an existing incident severity by name.
minor = incident.get_severity(name="Minor")
# Create an incident severity.
critical_severity = incident.Severity("critical",
name="Critical",
description="A critical incident that requires an immediate response.")
# Reference the incident severity by its ID.
critical = incident.get_severity_output(id=critical_severity.id)
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/incident/v7/incident"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
// Look up an existing incident severity by name.
_, err := incident.LookupSeverity(ctx, &incident.LookupSeverityArgs{
Name: pulumi.StringRef("Minor"),
}, nil)
if err != nil {
return err
}
// Create an incident severity.
criticalSeverity, err := incident.NewSeverity(ctx, "critical", &incident.SeverityArgs{
Name: pulumi.String("Critical"),
Description: pulumi.String("A critical incident that requires an immediate response."),
})
if err != nil {
return err
}
// Reference the incident severity by its ID.
_ = incident.LookupSeverityOutput(ctx, incident.GetSeverityOutputArgs{
Id: criticalSeverity.ID(),
}, nil)
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Incident = Pulumi.Incident;
return await Deployment.RunAsync(() =>
{
// Look up an existing incident severity by name.
var minor = Incident.GetSeverity.Invoke(new()
{
Name = "Minor",
});
// Create an incident severity.
var criticalSeverity = new Incident.Severity("critical", new()
{
Name = "Critical",
Description = "A critical incident that requires an immediate response.",
});
// Reference the incident severity by its ID.
var critical = Incident.GetSeverity.Invoke(new()
{
Id = criticalSeverity.Id,
});
});
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.GetSeverityArgs;
import com.pulumi.incident.Severity;
import com.pulumi.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) {
// Look up an existing incident severity by name.
final var minor = IncidentFunctions.getSeverity(GetSeverityArgs.builder()
.name("Minor")
.build());
// Create an incident severity.
var criticalSeverity = new Severity("criticalSeverity", SeverityArgs.builder()
.name("Critical")
.description("A critical incident that requires an immediate response.")
.build());
// Reference the incident severity by its ID.
final var critical = IncidentFunctions.getSeverity(GetSeverityArgs.builder()
.id(criticalSeverity.id())
.build());
}
}
resources:
# Create an incident severity.
criticalSeverity:
type: incident:Severity
name: critical
properties:
name: Critical
description: A critical incident that requires an immediate response.
variables:
# Look up an existing incident severity by name.
minor:
fn::invoke:
function: incident:getSeverity
arguments:
name: Minor
# Reference the incident severity by its ID.
critical:
fn::invoke:
function: incident:getSeverity
arguments:
id: ${criticalSeverity.id}
Example coming soon!
Using getSeverity
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getSeverity(args: GetSeverityArgs, opts?: InvokeOptions): Promise<GetSeverityResult>
function getSeverityOutput(args: GetSeverityOutputArgs, opts?: InvokeOutputOptions): Output<GetSeverityResult>def get_severity(id: Optional[str] = None,
name: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetSeverityResult
def get_severity_output(id: pulumi.Input[Optional[str]] = None,
name: pulumi.Input[Optional[str]] = None,
opts: Optional[InvokeOutputOptions] = None) -> Output[GetSeverityResult]func LookupSeverity(ctx *Context, args *LookupSeverityArgs, opts ...InvokeOption) (*LookupSeverityResult, error)
func LookupSeverityOutput(ctx *Context, args *LookupSeverityOutputArgs, opts ...InvokeOption) LookupSeverityResultOutput> Note: This function is named LookupSeverity in the Go SDK.
public static class GetSeverity
{
public static Task<GetSeverityResult> InvokeAsync(GetSeverityArgs args, InvokeOptions? opts = null)
public static Output<GetSeverityResult> Invoke(GetSeverityInvokeArgs args, InvokeOptions? opts = null)
public static Output<GetSeverityResult> Invoke(GetSeverityInvokeArgs args, InvokeOutputOptions opts)
}public static CompletableFuture<GetSeverityResult> getSeverity(GetSeverityArgs args, InvokeOptions options)
public static Output<GetSeverityResult> getSeverity(GetSeverityArgs args, InvokeOptions options)
public static Output<GetSeverityResult> getSeverity(GetSeverityArgs args, InvokeOutputOptions options)
fn::invoke:
function: incident:index/getSeverity:getSeverity
arguments:
# arguments dictionarydata "incident_get_severity" "name" {
# arguments
}The following arguments are supported:
getSeverity Result
The following output properties are available:
- Description string
- Description of the severity
- Id string
- Unique identifier of the severity
- Name string
- Human readable name of the severity
- Rank double
- Rank to help sort severities (lower numbers are less severe)
- Description string
- Description of the severity
- Id string
- Unique identifier of the severity
- Name string
- Human readable name of the severity
- Rank float64
- Rank to help sort severities (lower numbers are less severe)
- description string
- Description of the severity
- id string
- Unique identifier of the severity
- name string
- Human readable name of the severity
- rank number
- Rank to help sort severities (lower numbers are less severe)
- description String
- Description of the severity
- id String
- Unique identifier of the severity
- name String
- Human readable name of the severity
- rank Double
- Rank to help sort severities (lower numbers are less severe)
- description string
- Description of the severity
- id string
- Unique identifier of the severity
- name string
- Human readable name of the severity
- rank number
- Rank to help sort severities (lower numbers are less severe)
- description str
- Description of the severity
- id str
- Unique identifier of the severity
- name str
- Human readable name of the severity
- rank float
- Rank to help sort severities (lower numbers are less severe)
- description String
- Description of the severity
- id String
- Unique identifier of the severity
- name String
- Human readable name of the severity
- rank Number
- Rank to help sort severities (lower numbers are less severe)
Package Details
- Repository
- incident incident-io/terraform-provider-incident
- License
- Notes
- This Pulumi package is based on the
incidentTerraform Provider.
published on Friday, Sep 11, 2026 by incident-io