Query Alert Definitions

Query collection of alert definitions matching the search criteria specified

Request

URI

POST

https://{api_host}/suite-api/api/alertdefinitions/query

COPY

Query Parameters

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

Request Body

The alert definition query

alert-definition-query of type(s) application/json

Optional

"{\n  \"ids\" : [ ],\n  \"adapterKinds\" : [ \"adapterKind\" ],\n  \"resourceKinds\" : [ \"resourceKind\" ]\n}"

array of string

adapterKinds

Optional

List of adapter kind keys. Can only be used when adapterKind is empty

array of string

ids

Optional

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

array of string

resourceKinds

Optional

List of resource kind keys. Can only be used when resourceKind is empty

Authentication

This operation uses the following authentication methods.

Token-based-authorization

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}"

array of object

alertDefinitions

Optional

Collection of Problem Definitions

array of object

links

Optional

Collection of links

object

pageInfo

Optional

Represents page information for a paged result

Code Samples

COPY

                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{}' https://{api_host}/suite-api/api/alertdefinitions/query

On This Page

Description

Request

Query Parameters

Request Body

Authentication

Response

200 Response Body

Alerts Operations

GET

Get Alert Definitions

POST