63 lines
2.2 KiB
Markdown
63 lines
2.2 KiB
Markdown
|
---
|
||
|
|
layout: "pagerduty"
|
||
|
|
page_title: "PagerDuty: pagerduty_escalation_policy"
|
||
|
|
sidebar_current: "docs-pagerduty-resource-escalation_policy"
|
||
|
|
description: |-
|
||
|
|
Creates and manages an escalation policy in PagerDuty.
|
||
|
|
---
|
||
|
|
|
||
|
|
# pagerduty\_escalation_policy
|
||
|
|
|
||
|
|
An [escalation policy](https://v2.developer.pagerduty.com/v2/page/api-reference#!/Escalation_Policies/get_escalation_policies) 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.
|