Fetch alerts grouped per customer
GET {{base_url}}/api/alert_manager/v1/customer_alerts?customer_id=14
Fetches alerts of the specified customers. This API uses extended barrier mode by default.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
customer_id | number | (Required) IDs of the customers whose alerts must be returned. |
Type: Array of String
Array type description:
Type: String |
| 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/categoriesendpoint.
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 |
RESPONSES
status: OK
{"items":[{"customer_id":"14","alerts":[{"_source":"6852F263-2B5E-48BF-B78B-486182D9BDBE","updatedAt":"2021-04-05T20:41:42.352636392Z","tenant":{"id":"56","uuid":"53a17005-b4be-4c5c-8186-758349e343cd","locator":"/1/50/53/56/"},"_sourceTimeStamp":3246,"id":"01C2D69A-112B-4DE1-98AE-8688223C5F4B","createdAt":"2021-04-05T20:41:41Z","details":{"activity":{"id":"D028B06E-36D6-43FF-9242-35E8A9917E3A"},"activityId":"D028B06E-36D6-43FF-9242-35E8A9917E3A"},"category":"cti.a.p.am.category.v1.0~a.p.backup.v1.0","receivedAt":"2021-04-01T22:16:19.71025511Z","severity":"critical","type":"cti.a.p.am.alert.v1.0~a.p.backup.failed.v1.0"}]},{"customer_id":"22","alerts":[{"updatedAt":"2021-04-05T23:41:55.089638934Z","tenant":{"id":"88","uuid":"459ef6ff-86b0-4caa-b677-9f1994d65fe4","locator":"/1/3/22/88"},"id":"BACA9625-A993-4722-B03F-F2807C85E76F","createdAt":"2021-04-05T23:41:55.089638934Z","details":{},"category":"cti.a.p.am.category.v1.0~a.p.dr.v1.0","receivedAt":"2021-04-05T23:41:55.089638324Z","severity":"warning","type":"cti.a.p.am.alert.v1.0~a.dr.internet_traffic.unblocked.v1.0"}]}]}