Get Alert Definitions

Get Alert Definitions

If the search criteria is not satisfied, the API will return all Alert Definitions

Request
URI
GET
https://{api_host}/suite-api/api/alertdefinitions
COPY
Query Parameters
string
adapterKind
Optional

The Adapter Kind key of the Alert Definitions to search for

string
resourceKind
Optional

The Resource Kind key of the Alert Definitions to search for

string of array
id
Optional

The identifier(s) of the Alert Definitions to search for.
Do not specify adapterKind or resourceKind if searching by the identifier

integer
page
Optional
Constraints: default: 0

Page number from which data needs to be displayed (0-based)

integer
pageSize
Optional
Constraints: default: 1000

Expected number of entries per page


Authentication
This operation uses the following authentication methods.
Responses
200

The collection of Alert Definitions

Returns alert-definitions of type(s) application/json
"{\n  \"alertDefinitions\" : [ {\n    \"id\" : \"f080147f-c60d-4f08-8801-b602e2931b6f\",\n    \"name\" : \"High CPU/Memory Usage\",\n    \"description\" : \"CPU or MEM usage too High\",\n    \"adapterKindKey\" : \"VMWARE\",\n    \"resourceKindKey\" : \"HostSystem\",\n    \"waitCycles\" : 3,\n    \"cancelCycles\" : 2,\n    \"type\" : 0,\n    \"subType\" : 0,\n    \"states\" : [ {\n      \"severity\" : \"WARNING\",\n      \"base-symptom-set\" : {\n        \"type\" : \"SYMPTOM_SET_COMPOSITE\",\n        \"operator\" : \"AND\",\n        \"symptom-sets\" : [ {\n          \"type\" : \"SYMPTOM_SET\",\n          \"adapterKindKey\" : \"VMWARE\",\n          \"resourceKindKey\" : \"Datastore\",\n          \"relation\" : \"DESCENDANT\",\n          \"aggregation\" : \"ALL\",\n          \"symptomSetOperator\" : \"AND\",\n          \"symptomDefinitionIds\" : [ \"Symptom5\", \"!Symptom6\" ],\n          \"alertConditions\" : [ {\n            \"waitCycles\" : 5,\n            \"cancelCycles\" : 5,\n            \"severity\" : \"CRITICAL\",\n            \"condition\" : {\n              \"type\" : \"CONDITION_HT\",\n              \"key\" : \"cpu|demandmhz\",\n              \"operator\" : \"GT_EQ\",\n              \"valueType\" : \"NUMERIC\",\n              \"instanced\" : false,\n              \"targetKey\" : \"cpu|availablemhz\",\n              \"thresholdType\" : \"STATKEY\"\n            }\n          } ]\n        }, {\n          \"type\" : \"SYMPTOM_SET\",\n          \"relation\" : \"SELF\",\n          \"aggregation\" : \"ALL\",\n          \"symptomSetOperator\" : \"OR\",\n          \"symptomDefinitionIds\" : [ \"Symptom100\", \"Symptom101\" ]\n        } ]\n      },\n      \"impact\" : {\n        \"impactType\" : \"BADGE\",\n        \"detail\" : \"health\"\n      }\n    } ],\n    \"forVCDTenants\" : false\n  }, {\n    \"id\" : \"AlertDefinition-147ff080-8801-c60d-4f08-931b6fb602e2\",\n    \"name\" : \"MyAlertDefinition\",\n    \"description\" : \"An Alert Definition associated with ESX host\",\n    \"adapterKindKey\" : \"VMWARE\",\n    \"resourceKindKey\" : \"HostSystem\",\n    \"waitCycles\" : 3,\n    \"cancelCycles\" : 2,\n    \"type\" : 0,\n    \"subType\" : 0,\n    \"states\" : [ {\n      \"severity\" : \"CRITICAL\",\n      \"base-symptom-set\" : {\n        \"type\" : \"SYMPTOM_SET\",\n        \"relation\" : \"SELF\",\n        \"aggregation\" : \"ALL\",\n        \"symptomDefinitionIds\" : [ \"SymptomDefinition-5\" ]\n      },\n      \"impact\" : {\n        \"impactType\" : \"BADGE\",\n        \"detail\" : \"Health\"\n      }\n    } ],\n    \"forVCDTenants\" : false\n  } ]\n}"
object
pageInfo
Optional

Represents page information for a paged result

array of object
links
Optional

Collection of links

array of object
alertDefinitions
Optional

Collection of Problem Definitions


Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/suite-api/api/alertdefinitions