# EscalationPolicy

An EscalationPolicy is a set of rules to deliver an alert to assigned members.

> **Package : spaceone.api.monitoring.v1**

\ <br>

## EscalationPolicy

**EscalationPolicy Methods:**

| Method                                                                                                                                   | Request                                                                                                                                                                 | Response                                                                                                                                                  |
| ---------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [**create**](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#create)            | [CreateEscalationPolicyRequest](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#createescalationpolicyrequest) | [EscalationPolicyInfo](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#escalationpolicyinfo)     |
| [**update**](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#update)            | [UpdateEscalationPolicyRequest](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#updateescalationpolicyrequest) | [EscalationPolicyInfo](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#escalationpolicyinfo)     |
| [**set\_default**](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#set_default) | [EscalationPolicyRequest](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#escalationpolicyrequest)             | [EscalationPolicyInfo](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#escalationpolicyinfo)     |
| [**delete**](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#delete)            | [EscalationPolicyRequest](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#escalationpolicyrequest)             | [Empty](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#empty)                                   |
| [**get**](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#get)                  | [EscalationPolicyRequest](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#escalationpolicyrequest)             | [EscalationPolicyInfo](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#escalationpolicyinfo)     |
| [**list**](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#list)                | [EscalationPolicyQuery](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#escalationpolicyquery)                 | [EscalationPoliciesInfo](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#escalationpoliciesinfo) |
| [**stat**](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#stat)                | [EscalationPolicyStatQuery](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#escalationpolicystatquery)         | [Struct](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#struct)                                 |

<br>

### create

Creates a new EscalationPolicy. When creating an EscalationPolicy, if the project\_id is assigned, the EscalationPolicy is applied to the Project with the same project\_id. If an EscalationPolicy is set as a global policy, all Projects in the same domain can apply the policy.

> **POST** /monitoring/v1/escalation-policy/create

{{< tabs " create " >}}

{{< tab "Request Example" >}}

[CreateEscalationPolicyRequest](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#createescalationpolicyrequest)

* **name** (string) `Required`
* **rules** (EscalationPolicyRule) `Repeated` `Required`
* **resource\_group** (ResourceGroup) `Required`
* **repeat\_count** (int32)
* **finish\_condition** (EscalationFinishCondition)
* **tags** (Struct)
* **project\_id** (string)

{{< highlight json >}} { "name": "es-test", "rules": \[{"notification\_level": "LV1", "escalate\_minutes": 30}, {"notification\_level": "LV2", "escalate\_minutes": 30}], "repeat\_count": 2, "finish\_condition": "ACKNOWLEDGED", "domain\_id": "domain-58010aa2e451" } {{< /highlight >}} {{< /tab >}}

{{< tab "Response Example" >}}

[EscalationPolicyInfo](#ESCALATIONPOLICYINFO)

* **escalation\_policy\_id** (string) `Required`
* **name** (string) `Required`
* **is\_default** (bool) `Required`
* **rules** (EscalationPolicyRule) `Repeated` `Required`
* **repeat\_count** (int32) `Required`
* **finish\_condition** (EscalationFinishCondition) `Required`
* **resource\_group** (ResourceGroup) `Required`
* **project\_id** (string) `Required`
* **tags** (Struct) `Required`
* **workspace\_id** (string) `Required`
* **domain\_id** (string) `Required`
* **created\_at** (string) `Required`

{{< highlight json >}} { "escalation\_policy\_id": "ep-526e536fdca9", "name": "es-test", "rules": \[ { "notification\_level": "LV1", "escalate\_minutes": 30 }, { "notification\_level": "LV2", "escalate\_minutes": 30 } ], "repeat\_count": 2, "finish\_condition": "ACKNOWLEDGED", "scope": "DOMAIN", "tags": {}, "domain\_id": "domain-58010aa2e451", "created\_at": "2022-06-21T09:22:45.340Z" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

<br>

### update

Updates a specific EscalationPolicy. You can make changes in EscalationPolicy settings, including the name, the escalation process, and the number of iterations.

> **POST** /monitoring/v1/escalation-policy/update

{{< tabs " update " >}}

{{< tab "Request Example" >}}

[UpdateEscalationPolicyRequest](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#updateescalationpolicyrequest)

* **escalation\_policy\_id** (string) `Required`
* **name** (string)
* **rules** (EscalationPolicyRule) `Repeated`
* **repeat\_count** (int32)
* **finish\_condition** (EscalationFinishCondition)
* **tags** (Struct)

{{< highlight json >}} { "escalation\_policy\_id": "ep-526e536fdca9", "name": "es-test2", "rules": \[{"notification\_level": "LV1", "escalate\_minutes": 15}, {"notification\_level": "LV2", "escalate\_minutes": 15}, {"notification\_level": "LV3", "escalate\_minutes": 15}], "repeat\_count": 1, "finish\_condition": "RESOLVED", "domain\_id": "domain-58010aa2e451" } {{< /highlight >}} {{< /tab >}}

{{< tab "Response Example" >}}

[EscalationPolicyInfo](#ESCALATIONPOLICYINFO)

* **escalation\_policy\_id** (string) `Required`
* **name** (string) `Required`
* **is\_default** (bool) `Required`
* **rules** (EscalationPolicyRule) `Repeated` `Required`
* **repeat\_count** (int32) `Required`
* **finish\_condition** (EscalationFinishCondition) `Required`
* **resource\_group** (ResourceGroup) `Required`
* **project\_id** (string) `Required`
* **tags** (Struct) `Required`
* **workspace\_id** (string) `Required`
* **domain\_id** (string) `Required`
* **created\_at** (string) `Required`

{{< highlight json >}} { "escalation\_policy\_id": "ep-526e536fdca9", "name": "es-test", "rules": \[ { "notification\_level": "LV1", "escalate\_minutes": 30 }, { "notification\_level": "LV2", "escalate\_minutes": 30 } ], "repeat\_count": 2, "finish\_condition": "ACKNOWLEDGED", "scope": "DOMAIN", "tags": {}, "domain\_id": "domain-58010aa2e451", "created\_at": "2022-06-21T09:22:45.340Z" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

<br>

### set\_default

Sets a specific EscalationPolicy as default. Only policies configured as global can be set as default. When a Project is created, even if you did not configure any policy to the Project, the default policy set by this api method is applied.

> **POST** /monitoring/v1/escalation-policy/set-default

{{< tabs " set\_default " >}}

{{< tab "Request Example" >}}

[EscalationPolicyRequest](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#escalationpolicyrequest)

* **escalation\_policy\_id** (string) `Required`

{{< highlight json >}} { "escalation\_policy\_id": "ep-526e536fdca9", "domain\_id": "domain-58010aa2e451" } {{< /highlight >}} {{< /tab >}}

{{< tab "Response Example" >}}

[EscalationPolicyInfo](#ESCALATIONPOLICYINFO)

* **escalation\_policy\_id** (string) `Required`
* **name** (string) `Required`
* **is\_default** (bool) `Required`
* **rules** (EscalationPolicyRule) `Repeated` `Required`
* **repeat\_count** (int32) `Required`
* **finish\_condition** (EscalationFinishCondition) `Required`
* **resource\_group** (ResourceGroup) `Required`
* **project\_id** (string) `Required`
* **tags** (Struct) `Required`
* **workspace\_id** (string) `Required`
* **domain\_id** (string) `Required`
* **created\_at** (string) `Required`

{{< highlight json >}} { "escalation\_policy\_id": "ep-526e536fdca9", "name": "es-test", "rules": \[ { "notification\_level": "LV1", "escalate\_minutes": 30 }, { "notification\_level": "LV2", "escalate\_minutes": 30 } ], "repeat\_count": 2, "finish\_condition": "ACKNOWLEDGED", "scope": "DOMAIN", "tags": {}, "domain\_id": "domain-58010aa2e451", "created\_at": "2022-06-21T09:22:45.340Z" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

<br>

### delete

Deletes a specific EscalationPolicy. Deletes the EscalationPolicy with the escalation\_policy\_id from the deletion request.

> **POST** /monitoring/v1/escalation-policy/delete

{{< tabs " delete " >}}

{{< tab "Request Example" >}}

[EscalationPolicyRequest](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#escalationpolicyrequest)

* **escalation\_policy\_id** (string) `Required`

{{< highlight json >}} { "escalation\_policy\_id": "ep-526e536fdca9", "domain\_id": "domain-58010aa2e451" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

<br>

### get

Gets a specific EscalationPolicy. Prints detailed information about the EscalationPolicy, including the name, rules, and termination conditions.

> **POST** /monitoring/v1/escalation-policy/get

{{< tabs " get " >}}

{{< tab "Request Example" >}}

[EscalationPolicyRequest](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#escalationpolicyrequest)

* **escalation\_policy\_id** (string) `Required`

{{< highlight json >}} { "escalation\_policy\_id": "ep-526e536fdca9", "domain\_id": "domain-58010aa2e451" } {{< /highlight >}} {{< /tab >}}

{{< tab "Response Example" >}}

[EscalationPolicyInfo](#ESCALATIONPOLICYINFO)

* **escalation\_policy\_id** (string) `Required`
* **name** (string) `Required`
* **is\_default** (bool) `Required`
* **rules** (EscalationPolicyRule) `Repeated` `Required`
* **repeat\_count** (int32) `Required`
* **finish\_condition** (EscalationFinishCondition) `Required`
* **resource\_group** (ResourceGroup) `Required`
* **project\_id** (string) `Required`
* **tags** (Struct) `Required`
* **workspace\_id** (string) `Required`
* **domain\_id** (string) `Required`
* **created\_at** (string) `Required`

{{< highlight json >}} { "escalation\_policy\_id": "ep-526e536fdca9", "name": "es-test", "rules": \[ { "notification\_level": "LV1", "escalate\_minutes": 30 }, { "notification\_level": "LV2", "escalate\_minutes": 30 } ], "repeat\_count": 2, "finish\_condition": "ACKNOWLEDGED", "scope": "DOMAIN", "tags": {}, "domain\_id": "domain-58010aa2e451", "created\_at": "2022-06-21T09:22:45.340Z" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

<br>

### list

Gets a list of all EscalationPolicies. You can use a query to get a filtered list of EscalationPolicies.

> **POST** /monitoring/v1/escalation-policy/list

{{< tabs " list " >}}

{{< tab "Request Example" >}}

[EscalationPolicyQuery](https://github.com/cloudforet-io/api-doc/blob/master/content/en/monitoring/v1/EscalationPolicy/README.md#escalationpolicyquery)

* **resource\_group** (ResourceGroup) `Required`
* **query** (Query)
* **escalation\_policy\_id** (string)
* **name** (string)
* **is\_default** (bool)
* **finish\_condition** (EscalationFinishCondition)
* **project\_id** (string)

{{< highlight json >}} { "query": {}, "domain\_id": "domain-58010aa2e451" } {{< /highlight >}} {{< /tab >}}

{{< tab "Response Example" >}}

[EscalationPoliciesInfo](#ESCALATIONPOLICIESINFO)

* **results** (EscalationPolicyInfo) `Repeated` `Required`
* **total\_count** (int32) `Required`

{{< highlight json >}} { "results": \[ { "escalation\_policy\_id": "ep-7c9745003372", "name": "0525-ms-test-1", "rules": \[ { "notification\_level": "LV1" } ], "finish\_condition": "ACKNOWLEDGED", "scope": "DOMAIN", "tags": {}, "domain\_id": "domain-58010aa2e451", "created\_at": "2022-05-25T09:31:15.150Z" }, { "escalation\_policy\_id": "ep-d75670166af4", "name": "0525-ms-test-2", "rules": \[ { "notification\_level": "LV2", "escalate\_minutes": 30 }, { "notification\_level": "LV2" } ], "finish\_condition": "ACKNOWLEDGED", "scope": "DOMAIN", "tags": {}, "domain\_id": "domain-58010aa2e451", "created\_at": "2022-05-25T09:31:38.573Z" } ], "total\_count": 2 } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

<br>

### stat

> **POST** /monitoring/v1/escalation-policy/stat

\ <br>

## Message

### CreateEscalationPolicyRequest

* **name** (string) `Required`
* **rules** (EscalationPolicyRule) `Repeated` `Required`
* **resource\_group** (ResourceGroup) `Required`
* **repeat\_count** (int32)
* **finish\_condition** (EscalationFinishCondition)
* **tags** (Struct)
* **project\_id** (string)

  <br>

### EscalationPoliciesInfo

* **results** (EscalationPolicyInfo) `Repeated` `Required`
* **total\_count** (int32) `Required`

  <br>

### EscalationPolicyInfo

* **escalation\_policy\_id** (string) `Required`
* **name** (string) `Required`
* **is\_default** (bool) `Required`
* **rules** (EscalationPolicyRule) `Repeated` `Required`
* **repeat\_count** (int32) `Required`
* **finish\_condition** (EscalationFinishCondition) `Required`
* **resource\_group** (ResourceGroup) `Required`
* **project\_id** (string) `Required`
* **tags** (Struct) `Required`
* **workspace\_id** (string) `Required`
* **domain\_id** (string) `Required`
* **created\_at** (string) `Required`

  <br>

### EscalationPolicyQuery

* **resource\_group** (ResourceGroup) `Required`
* **query** (Query)
* **escalation\_policy\_id** (string)
* **name** (string)
* **is\_default** (bool)
* **finish\_condition** (EscalationFinishCondition)
* **project\_id** (string)

  <br>

### EscalationPolicyRequest

* **escalation\_policy\_id** (string) `Required`

  <br>

### EscalationPolicyRule

* **notification\_level** (NotificationLevel) `Required`
* **escalate\_minutes** (int32) `Required`

  <br>

### EscalationPolicyStatQuery

* **query** (StatisticsQuery) `Required`

  <br>

### UpdateEscalationPolicyRequest

* **escalation\_policy\_id** (string) `Required`
* **name** (string)
* **rules** (EscalationPolicyRule) `Repeated`
* **repeat\_count** (int32)
* **finish\_condition** (EscalationFinishCondition)
* **tags** (Struct)

  <br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cloudforet.gitbook.io/cloudforet-apis/content/en/monitoring/v1/escalationpolicy.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.