Dismiss the alerts by filter
DELETE {{base_url}}/api/alert_manager/v1/alerts
Dismisses the alerts by optional filtering parameters. Alerts will be dismissed even if they have the orphaned
flag.
Note that if no filter is provided all alerts within the tenant scope will be dismissed.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
id | string | (Optional) Case-insensitive IDs of the alerts to return in the results. |
Type: Array of String
Array type description:
Type: String
Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
| query
| null | | (Optional) A text to search for within planName
or resourceName
fields of the alerts. The search is case-insensitive.
Type: String |
| severity
| null | | (Optional) A filter by the alert severity.
Available operators:
eq
- equals to the specified value: eq(warning)or
- equals to one of the specified values: or(warning,critical)lt
- less than the specified value: lt(warning)gt
- greater than the specified value: gt(warning)le
- less than or equals to the specified value: le(warning)ge
- greater than or equals to the specified value: ge(warning)
Type: String |
| show_deleted
| boolean | | (Optional) If true, dismissed alerts will be included in the response.
Type: Boolean
Default: false |
| show_deleted_only
| boolean | | (Optional) If true, only dismissed alerts will be included in the response.
Type: Boolean
Default: false |
| source
| null | | (Optional) A filter by the alert producer.
Type: String |
| source_time_stamp
| string | | (Optional) A filter by timestamp that was provided by an alert producer.
Type: String
Pattern: ^([0-9]+)|(eq([0-9]+))$|(le([0-9]+))|(lt([0-9]+))|(gt([0-9]+))|(ge([0-9]+))$ |
| type
| string | | (Optional) A filter by list of alert types. A list of registered types can be obtained by sending a GET request to the /types
endpoint.
Type: Array of Union Array type description: Type: Union May be any of:
- ID used in Cyber Application to uniquely identify an entity either type or instance.
Generic format - cti.<ctx>[~<ctx>]*[~(<ctx>|<uuid>)]
<ctx>
-<vendor>.<application>.<name>.v<major>.<minor>
<vendor>
- vendor's short code (max 50 characters)<application>
- application's short code (max 50 characters)<name>
- entity's name (max 128 characters), may include.
and_
to be used for structuringv<major>.<minor>
- entity's version
Better regex pattern (for advanced regex processors)
^cti\.(?'ctx'[a-z][a-z0-9_]{0,49}\.[a-z][a-z0-9_]{0,49}\.[a-z][a-z0-9_.]{1,127}\.v[\d]+\.[\d]+)(~(?&ctx))*(~[0-9a-f]{8}\b-[0-9a-f]{4}\b-[0-9a-f]{4}\b-[0-9a-f]{4}\b-[0-9a-f]{12})?$
Type: String Max length: 1024 Pattern: ^cti.([a-z][a-z0-9_].[a-z][a-z0-9_].[a-z_][a-z0-9_.].v[\d]+.[\d]+)(~([a-z][a-z0-9_].[a-z][a-z0-9_].[a-z_][a-z0-9_.].v[\d]+.[\d]+))*(~[0-9a-f]{8}\b-[0-9a-f]{4}\b-[0-9a-f]{4}\b-[0-9a-f]{4}\b-[0-9a-f]{12})?$
- Type: String |
|
category
| string | | (Optional) A filter by list of alert categories. A list of registered categories can be obtained by sending a GET request to the/categories
endpoint.
Type: Array of Union Array type description: Type: Union May be any of:
- ID used in Cyber Application to uniquely identify an entity either type or instance.
Generic format - cti.<ctx>[~<ctx>]*[~(<ctx>|<uuid>)]
<ctx>
-<vendor>.<application>.<name>.v<major>.<minor>
<vendor>
- vendor's short code (max 50 characters)<application>
- application's short code (max 50 characters)<name>
- entity's name (max 128 characters), may include.
and_
to be used for structuringv<major>.<minor>
- entity's version
Better regex pattern (for advanced regex processors)
^cti\.(?'ctx'[a-z][a-z0-9_]{0,49}\.[a-z][a-z0-9_]{0,49}\.[a-z][a-z0-9_.]{1,127}\.v[\d]+\.[\d]+)(~(?&ctx))*(~[0-9a-f]{8}\b-[0-9a-f]{4}\b-[0-9a-f]{4}\b-[0-9a-f]{4}\b-[0-9a-f]{12})?$
Type: String Max length: 1024 Pattern: ^cti.([a-z][a-z0-9_].[a-z][a-z0-9_].[a-z_][a-z0-9_.].v[\d]+.[\d]+)(~([a-z][a-z0-9_].[a-z][a-z0-9_].[a-z_][a-z0-9_.].v[\d]+.[\d]+))*(~[0-9a-f]{8}\b-[0-9a-f]{4}\b-[0-9a-f]{4}\b-[0-9a-f]{4}\b-[0-9a-f]{12})?$
- Type: String |
|
updated_at
| string | | (Optional) A filter by date when the alert was created or dismissed.
Type: String
Pattern: ^([0-9]+)|(eq([0-9]+))$|(le([0-9]+))|(lt([0-9]+))|(gt([0-9]+))|(ge([0-9]+))$ |
| created_at
| string | | (Optional) A filter by date when the alert was created.
Type: String
Pattern: ^([0-9]+)|(eq([0-9]+))$|(le([0-9]+))|(lt([0-9]+))|(gt([0-9]+))|(ge([0-9]+))$ |
| deleted_at
| string | | (Optional) A filter by date when the alert was dismissed.
Type: String
Pattern: ^([0-9]+)|(eq([0-9]+))$|(le([0-9]+))|(lt([0-9]+))|(gt([0-9]+))|(ge([0-9]+))$ |
| planId
| string | | (Optional) A filter for alerts with the specified plan IDs.
Type: Array of String
Array type description:
Type: String |
| resourceId
| string | | (Optional) A filter for alerts with the specified resource IDs.
Type: Array of String
Array type description:
Type: String |
| planName
| string | | (Optional) A filter for alerts with the specified plan names.
Type: Array of String
Array type description:
Type: String |
| resourceName
| string | | (Optional) A filter for alerts with the specified resource names.
Type: Array of String Array type description: Type: String |