terraform/website/source/docs/providers/pagerduty/r/escalation_policy.html.mark...

2.2 KiB

layout page_title sidebar_current description
pagerduty PagerDuty: pagerduty_escalation_policy docs-pagerduty-resource-escalation_policy Creates and manages an escalation policy in PagerDuty.

pagerduty_escalation_policy

An escalation policy determines what user or schedule will be notified first, second, and so on when an incident is triggered. Escalation policies are used by one or more services.

Example Usage

resource "pagerduty_user" "example" {
    name  = "Earline Greenholt"
    email = "125.greenholt.earline@graham.name"
    teams = ["${pagerduty_team.example.id}"]
}

resource "pagerduty_escalation_policy" "example" {
  name             = "Engineering"
  description      = "Engineering Escalation Policy"
  num_loops        = 2
  escalation_rules = <<EOF
  [
      {
          "escalation_delay_in_minutes": 10,
          "targets": [
              {
                  "type": "user",
                  "id": "${pagerduty_user.example.id}"
              }
          ]
      }
  ]
EOF
}

Argument Reference

The following arguments are supported:

  • name - (Required) The name of the escalation policy.
  • description - (Optional) A human-friendly description of the escalation policy. If not set, a placeholder of "Managed by Terraform" will be set.
  • num_loops (Optional) The number of times the escalation policy will repeat after reaching the end of its escalation.
  • escalation_rules (Required) A JSON array containing escalation rules. Each rule must have escalation_delay_in_minutes defined as well as an array containing targets
    • escalation_delay_in_minutes (Required) The number of minutes before an unacknowledged incident escalates away from this rule.
    • targets (Required) The targets an incident should be assigned to upon reaching this rule.

Attributes Reference

The following attributes are exported:

  • id - The ID of the escalation policy.
  • name - The name of the escalation policy.
  • description - Escalation policy description.
  • num_loops - The number of times the escalation policy will repeat after reaching the end of its escalation.