ACacronis

DELETE /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

  • Base URL
    https://dev-cloud.acronis.com/api/alert_manager/v1
  • Auth
    OAuth 2
    Authorization code: https://dev-cloud.acronis.com/api/2/idp/authorize
    Client credentials
    Password
    Token URL: https://dev-cloud.acronis.com/api/2/idp/token scopes: urn:acronis.com::alert_manager::admin

Query parameters

deleted_atstring

A filter by date when the alert was dismissed. Must be a Unix timestamp in nanoseconds.

Available operators:

  • eq - equals
  • lt - less than
  • gt - greater than
  • le - less than or equals
  • ge - greater than or equals
idUuid[]

Case-insensitive IDs of the alerts to return in the results.

[
  "c106fd7b-338b-4635-8e61-31f6255482d5",
  "f71fdcdb-fc43-4b2f-9830-c53fb213de7b"
]
querystring

A text to search for within planName or resourceName fields of the alerts. The search is case-insensitive.

severity'ok' | 'information' | 'warning' | 'error' | 'critical'

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)
show_deletedboolean

If true, dismissed alerts will be included in the response.

show_deleted_onlyboolean

If true, only dismissed alerts will be included in the response.

sourcestring

A filter by the alert producer.

source_time_stampstring

A filter by timestamp that was provided by an alert producer. The timestamp may be an arbitrary integer value.

Available operators:

  • eq - equals
  • lt - less than
  • gt - greater than
  • le - less than or equals
  • ge - greater than or equals
typestring[]

A filter by list of alert types. A list of registered types can be obtained by sending a GET request to the /types endpoint.

updated_atstring

A filter by date when the alert was created or dismissed. Must be a Unix timestamp in nanoseconds.

Available operators:

  • eq - equals
  • lt - less than
  • gt - greater than
  • le - less than or equals
  • ge - greater than or equals
created_atstring

A filter by date when the alert was created. Must be a Unix timestamp in nanoseconds.

Available operators:

  • eq - equals
  • lt - less than
  • gt - greater than
  • le - less than or equals
  • ge - greater than or equals
categorystring[]

A filter by list of alert categories. A list of registered categories can be obtained by sending a GET request to the /categories endpoint.

  • Example: category=Backup&category=Monitoring
planIdstring[]

Case-insensitive filter for alerts with the specified plan IDs.

The following rules are applied:

  • planId=BackupPlan01 - matches the exact BackupPlan01 string in the corresponding parameter
  • planId=or(BackupPlan01,BackupPlan02) - matches the exact BackupPlan01 or BackupPlan02 strings in the corresponding parameter

Examples: planId=A1111&planId=B2222 planId=or(A1111,B2222)

resourceIdstring[]

Case-insensitive filter for alerts with the specified resource IDs.

The following rules are applied:

  • resourceId=FileResource01 - matches the exact FileResource01 string in the corresponding parameter
  • resourceId=or(FileResource01,FileResource02) - matches the exact FileResource01 or FileResource02 strings in the corresponding parameter

Examples: resourceId=A1111&resourceId=B2222 resourceId=or(A1111,B2222)

planNamestring[]

Case-insensitive filter for alerts with the specified plan names.

The following rules are applied:

  • planName=Plan01 - matches the substring Plan01 in the corresponding parameter
  • planName=eq(BackupPlan01) - matches the exact BackupPlan01 string in the corresponding parameter
  • planName=or(BackupPlan01,BackupPlan02) - matches the exact BackupPlan01 or BackupPlan02 strings in the corresponding parameter

Examples: planName=Plan1&planName=eq(BackupPlan2) planName=Plan1&planName=or(BackupPlan2,BackupPlan3)

resourceNamestring[]

Case-insensitive filter for alerts with the specified resource names.

The following rules are applied:

  • resourceName=Resource01 - matches the substring Resource01 in the corresponding parameter
  • resourceName=eq(FileResource01) - matches the exact FileResource01 string in the corresponding parameter
  • resourceName=or(FileResource01,FileResource02) - matches the exact FileResource01 or FileResource02 strings in the corresponding parameter

Examples: resourceName=Resource1&resourceName=eq(FileResource2) resourceName=Resource1&resourceName=or(FileResource2,FileResource3)

Response

Alerts were successfully dismissed.

Changes

No recorded changes to this operation across all 1 revision of this API.