doc-exports/docs/aom/api-ref/aom_04_1014.html
Hasko, Vladimir bbf8757cdf AOM API 0929 (recreate of #275)
Reviewed-by: gtema <artem.goncharov@gmail.com>
Reviewed-by: Kucerak, Kristian <kristian.kucerak@t-systems.com>
Co-authored-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-committed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
2022-11-29 12:44:31 +00:00

519 lines
35 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<a name="aom_04_1014"></a><a name="aom_04_1014"></a>
<h1 class="topictitle1">Adding a Threshold Rule</h1>
<div id="body1606983050276"><div class="section" id="aom_04_1014__section57022943"><h4 class="sectiontitle">Function</h4><p class="msonormal" id="aom_04_1014__p41898900">This API is used to add a threshold rule.</p>
</div>
<div class="section" id="aom_04_1014__section43444447"><h4 class="sectiontitle">URI</h4><p class="msonormal" id="aom_04_1014__p38367706">POST /v2/{project_id}/ams/alarms</p>
</div>
<div class="section" id="aom_04_1014__section55455707"><h4 class="sectiontitle">Request</h4><p class="msonormal" id="aom_04_1014__p20776481"><strong id="aom_04_1014__b52770604">Request parameters</strong></p>
<p class="msonormal" id="aom_04_1014__p5173392"><a href="#aom_04_1014__table4524101420262">Table 1</a> describes the request parameters.</p>
<div class="tablenoborder"><a name="aom_04_1014__table4524101420262"></a><a name="table4524101420262"></a><table cellpadding="4" cellspacing="0" summary="" id="aom_04_1014__table4524101420262" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="aom_04_1014__row2977343"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.6.1.1"><p id="aom_04_1014__p39838269">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13%" id="mcps1.3.3.4.2.6.1.2"><p id="aom_04_1014__p5674367">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18%" id="mcps1.3.3.4.2.6.1.3"><p id="aom_04_1014__p56970606">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="26%" id="mcps1.3.3.4.2.6.1.4"><p id="aom_04_1014__p51216369">Value Range</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="23%" id="mcps1.3.3.4.2.6.1.5"><p id="aom_04_1014__p54885233">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="aom_04_1014__row16518869"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p62960006">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p66595691">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p25541868">String</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p55625459">Non-null.</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p9368293">Project ID obtained from IAM. Generally, a project ID contains 32 characters.</p>
</td>
</tr>
<tr id="aom_04_1014__row17205779"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p51490835">statistic</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p10008116">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p5351069">String</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p30783479">maximum, minimum, average, sum, or sampleCount.</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p10433898">Statistic.</p>
</td>
</tr>
<tr id="aom_04_1014__row26796220"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p23010182">namespace</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p51885436">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p41970824">String</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p289834132515">1255 characters. Colons (:) are not allowed.</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p22907899">Namespace.</p>
</td>
</tr>
<tr id="aom_04_1014__row4844507"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p56860761">metricName</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p42318895">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p5278470">String</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p24902917">1255 characters.</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p3870421">Metric name.</p>
</td>
</tr>
<tr id="aom_04_1014__row34833795"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p2965135">period</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p38849343">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p59789051">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p634134382512">20000, 60000, 300000, 900000, 1800000, 3600000, 14400000, or 86400000</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p24658874">Statistical period.</p>
</td>
</tr>
<tr id="aom_04_1014__row20603279"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p58252915">alarmLevel</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p20865638">No</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p12395155">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p1723611583257">4, 3, 2, or 1</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p55780021">Alarm severity.</p>
</td>
</tr>
<tr id="aom_04_1014__row32258147"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p62773080">evaluationPeriods</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p51454697">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p7080960">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p2323101417263">4, 3, or 2</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p18844889">Number of consecutive periods.</p>
</td>
</tr>
<tr id="aom_04_1014__row35386280"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p47716441">comparisonOperator</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p39826514">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p4722236">String</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p1380653082615">&gt;, &gt;=, &lt;, or &lt;=</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p45409538">Comparison operator.</p>
</td>
</tr>
<tr id="aom_04_1014__row6032659"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p18883353">threshold</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p53156661">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p10722252">String</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p1360915613268">Non-null value that can be converted to a value of the <strong id="aom_04_1014__b1120560699105412">double</strong> type. Once converted, the value cannot be null, or be a positive or negative infinity.</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p18610833">Threshold.</p>
</td>
</tr>
<tr id="aom_04_1014__row33279774"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p11307140">alarmName</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p43463147">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p30854010">String</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p521141918274">1255 characters. Special characters are not allowed.</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p32831027">Threshold name.</p>
</td>
</tr>
<tr id="aom_04_1014__row27043788"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p43063180">dimensions</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p65565528">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p11220154218275">List</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p465213520278">Non-null; number of dimensions &lt; 100</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p12941465">Metric dimension.</p>
</td>
</tr>
<tr id="aom_04_1014__row49364328"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p39087595">unit</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p11978664">No</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p30747717">String</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p14123151972813">Number of characters &lt; 32</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p6527808">Metric unit.</p>
</td>
</tr>
<tr id="aom_04_1014__row58750277"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p61151974">actionEnabled</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p54362893">No</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p41318175">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p58437894">-</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p35849002">Whether to enable the alarm function.</p>
</td>
</tr>
<tr id="aom_04_1014__row54205566"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p28574727">alarmActions</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p32851585">No</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p43732756">Array</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p1046919345281">Size ≤ 5</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p40220066">Alarm action.</p>
</td>
</tr>
<tr id="aom_04_1014__row26436278"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p60963810">alarmAdvice</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p39121545">No</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p14728597">String</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p5811849152813">Number of characters &lt; 255</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p64675579">Suggestion.</p>
</td>
</tr>
<tr id="aom_04_1014__row45209305"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p38075088">alarmDescription</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p64183279">No</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p31463135">String</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p92014291">Number of characters &lt; 255</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p2767697">Threshold rule description.</p>
</td>
</tr>
<tr id="aom_04_1014__row24909273"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p4385205">insufficientDataActions</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p19657350">No</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p48741556">Array</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p1088417622912">Size ≤ 5</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p19616069">Action to be taken when data is insufficient.</p>
</td>
</tr>
<tr id="aom_04_1014__row42326896"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.6.1.1 "><p id="aom_04_1014__p5926589">okActions</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.4.2.6.1.2 "><p id="aom_04_1014__p10291690">No</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.4.2.6.1.3 "><p id="aom_04_1014__p28320543">Array</p>
</td>
<td class="cellrowborder" valign="top" width="26%" headers="mcps1.3.3.4.2.6.1.4 "><p id="aom_04_1014__p16899661297">Size ≤ 5</p>
</td>
<td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.3.4.2.6.1.5 "><p id="aom_04_1014__p53751491">Recovery action.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="aom_04_1014__p13501584343"><strong id="aom_04_1014__b1024195414120">Request headers</strong></p>
<p class="msonormal" id="aom_04_1014__p19248500157"><a href="#aom_04_1014__table17428844137">Table 2</a> describes the request headers.</p>
<div class="tablenoborder"><a name="aom_04_1014__table17428844137"></a><a name="table17428844137"></a><table cellpadding="4" cellspacing="0" summary="" id="aom_04_1014__table17428844137" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request headers</caption><thead align="left"><tr id="aom_04_1014__row1542824171318"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.7.2.4.1.1"><p id="aom_04_1014__p18428241134">Name</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.7.2.4.1.2"><p id="aom_04_1014__p1142819412139">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.3.7.2.4.1.3"><p id="aom_04_1014__p1742816441311">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="aom_04_1014__row1942834191319"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.7.2.4.1.1 "><p id="aom_04_1014__p166451516193818">X-Auth-Token</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.7.2.4.1.2 "><p id="aom_04_1014__p464591643812">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.3.7.2.4.1.3 "><p id="aom_04_1014__p156451416173813">User token obtained from IAM.</p>
</td>
</tr>
<tr id="aom_04_1014__row2428124181313"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.7.2.4.1.1 "><p id="aom_04_1014__p464641619384">Content-Type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.7.2.4.1.2 "><p id="aom_04_1014__p464631663813">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.3.7.2.4.1.3 "><p id="aom_04_1014__p1464691683810">Content type, which is <strong id="aom_04_1014__b112522433105412">application/json</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p class="msonormal" id="aom_04_1014__p14001379"><strong id="aom_04_1014__b58903554">Example request</strong></p>
<pre class="screen" id="aom_04_1014__screen163011626173">{
"actionEnabled": false,
"alarmActions": [],
"alarmAdvice": "",
"alarmDescription": "",
"alarmLevel": 3,
"alarmName": "aaaaaaaa",
"comparisonOperator": "&gt;=",
"dimensions": [
{
"name": "appName",
"value": "rhm-broker"
}
],
"evaluationPeriods": 1,
"insufficientDataActions": [],
"metricName": "cpuCoreLimit",
"namespace": "PAAS.CONTAINER",
"okActions": [],
"period": 60000,
"statistic": "average",
"threshold": 0,
"unit": "Core"
}</pre>
</div>
<div class="section" id="aom_04_1014__section29339315"><h4 class="sectiontitle">Response</h4><p class="msonormal" id="aom_04_1014__p62778490"><strong id="aom_04_1014__b28135499">Response parameters</strong></p>
<p class="msonormal" id="aom_04_1014__p51892904"><a href="#aom_04_1014__table5592922105719">Table 3</a> describes the response parameters.</p>
<div class="tablenoborder"><a name="aom_04_1014__table5592922105719"></a><a name="table5592922105719"></a><table cellpadding="4" cellspacing="0" summary="" id="aom_04_1014__table5592922105719" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Response parameters</caption><thead align="left"><tr id="aom_04_1014__row51223818"><th align="left" class="cellrowborder" valign="top" width="29.592959295929592%" id="mcps1.3.4.4.2.4.1.1"><p id="aom_04_1014__p55488582">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="36.733673367336735%" id="mcps1.3.4.4.2.4.1.2"><p id="aom_04_1014__p65390118">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.673367336733676%" id="mcps1.3.4.4.2.4.1.3"><p id="aom_04_1014__p62108178">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="aom_04_1014__row64706547"><td class="cellrowborder" valign="top" width="29.592959295929592%" headers="mcps1.3.4.4.2.4.1.1 "><p id="aom_04_1014__p6738993">errorCode</p>
</td>
<td class="cellrowborder" valign="top" width="36.733673367336735%" headers="mcps1.3.4.4.2.4.1.2 "><p id="aom_04_1014__p8987571">String</p>
</td>
<td class="cellrowborder" valign="top" width="33.673367336733676%" headers="mcps1.3.4.4.2.4.1.3 "><p id="aom_04_1014__p56904674">Response code.</p>
</td>
</tr>
<tr id="aom_04_1014__row42380021"><td class="cellrowborder" valign="top" width="29.592959295929592%" headers="mcps1.3.4.4.2.4.1.1 "><p id="aom_04_1014__p10229714">errorMessage</p>
</td>
<td class="cellrowborder" valign="top" width="36.733673367336735%" headers="mcps1.3.4.4.2.4.1.2 "><p id="aom_04_1014__p23300495">String</p>
</td>
<td class="cellrowborder" valign="top" width="33.673367336733676%" headers="mcps1.3.4.4.2.4.1.3 "><p id="aom_04_1014__p8291924">Response message.</p>
</td>
</tr>
<tr id="aom_04_1014__row7518458"><td class="cellrowborder" valign="top" width="29.592959295929592%" headers="mcps1.3.4.4.2.4.1.1 "><p id="aom_04_1014__p5015327">alarmId</p>
</td>
<td class="cellrowborder" valign="top" width="36.733673367336735%" headers="mcps1.3.4.4.2.4.1.2 "><p id="aom_04_1014__p3588320">Long</p>
</td>
<td class="cellrowborder" valign="top" width="33.673367336733676%" headers="mcps1.3.4.4.2.4.1.3 "><p id="aom_04_1014__p22218535">Threshold rule code.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p class="msonormal" id="aom_04_1014__p65749087"><strong id="aom_04_1014__b54870873">Example response</strong></p>
<pre class="screen" id="aom_04_1014__screen95842490713">{
"errorCode": "AOM.0200",
"errorMessage": "success",
"alarmId": 12345678
}</pre>
</div>
<div class="section" id="aom_04_1014__section62727250"><h4 class="sectiontitle">Status Code</h4><ul id="aom_04_1014__ul33515889"><li id="aom_04_1014__li33207553">Success response<p id="aom_04_1014__p30432523"><a name="aom_04_1014__li33207553"></a><a name="li33207553"></a><a href="#aom_04_1014__table86491459125016">Table 4</a> describes the status code.</p>
<div class="tablenoborder"><a name="aom_04_1014__table86491459125016"></a><a name="table86491459125016"></a><table cellpadding="4" cellspacing="0" summary="" id="aom_04_1014__table86491459125016" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Status code</caption><thead align="left"><tr id="aom_04_1014__row58979846"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.5.2.1.2.2.4.1.1"><p id="aom_04_1014__p12638194">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.5.2.1.2.2.4.1.2"><p id="aom_04_1014__p18261589486">Message</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="70%" id="mcps1.3.5.2.1.2.2.4.1.3"><p id="aom_04_1014__p17060819">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="aom_04_1014__row39749137"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.5.2.1.2.2.4.1.1 "><p id="aom_04_1014__p65563539">200</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.5.2.1.2.2.4.1.2 "><p id="aom_04_1014__p115208125323">OK</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.2.1.2.2.4.1.3 "><p id="aom_04_1014__p19579466497">The request has succeeded.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<ul id="aom_04_1014__ul57132447"><li id="aom_04_1014__li44429978">Error response<p id="aom_04_1014__p64325485"><a name="aom_04_1014__li44429978"></a><a name="li44429978"></a><a href="#aom_04_1014__table939134985614">Table 5</a> describes the status codes. For more information, see <a href="aom_04_0018.html">Status Codes</a>.</p>
<div class="tablenoborder"><a name="aom_04_1014__table939134985614"></a><a name="table939134985614"></a><table cellpadding="4" cellspacing="0" summary="" id="aom_04_1014__table939134985614" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Status codes</caption><thead align="left"><tr id="aom_04_1014__row44141239"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.5.3.1.2.2.4.1.1"><p id="aom_04_1014__p18670586">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.5.3.1.2.2.4.1.2"><p id="aom_04_1014__p47075245288">Message</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="70%" id="mcps1.3.5.3.1.2.2.4.1.3"><p id="aom_04_1014__p35922469">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="aom_04_1014__row24038881"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.5.3.1.2.2.4.1.1 "><p id="aom_04_1014__p992341">400</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.5.3.1.2.2.4.1.2 "><p id="aom_04_1014__p126271018112520">Bad Request</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.1.2.2.4.1.3 "><p id="aom_04_1014__p2431727192515">The request is invalid. </p>
<p id="aom_04_1014__p34352717254">The client should not repeat the request without modifications.</p>
</td>
</tr>
<tr id="aom_04_1014__row52328576"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.5.3.1.2.2.4.1.1 "><p id="aom_04_1014__p10756297">401</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.5.3.1.2.2.4.1.2 "><p id="aom_04_1014__p195759466253">Unauthorized</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.1.2.2.4.1.3 "><p id="aom_04_1014__p1371123810254">The authorization information provided by the client is incorrect or invalid.</p>
</td>
</tr>
<tr id="aom_04_1014__row56712700"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.5.3.1.2.2.4.1.1 "><p id="aom_04_1014__p30325987">403</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.5.3.1.2.2.4.1.2 "><p id="aom_04_1014__p15185125614254">Forbidden</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.1.2.2.4.1.3 "><p id="aom_04_1014__p10447844263">The request is rejected.</p>
<p id="aom_04_1014__p20447941267">The server has received the request and understood it, but the server is refusing to respond to it. The client should not repeat the request without modifications. </p>
</td>
</tr>
<tr id="aom_04_1014__row28828553"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.5.3.1.2.2.4.1.1 "><p id="aom_04_1014__p53411432">500</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.5.3.1.2.2.4.1.2 "><p id="aom_04_1014__p2945812153211">Internal Server Error</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.1.2.2.4.1.3 "><p id="aom_04_1014__p1815584516269">The server is able to receive the request but unable to understand the request.</p>
</td>
</tr>
<tr id="aom_04_1014__row13793060"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.5.3.1.2.2.4.1.1 "><p id="aom_04_1014__p43496037">503</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.5.3.1.2.2.4.1.2 "><p id="aom_04_1014__p205675500263">Service Unavailable</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.1.2.2.4.1.3 "><p id="aom_04_1014__p4668115672614">The requested service is invalid. </p>
<p id="aom_04_1014__p14669256182611">The client should not repeat the request without modifications.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="aom_04_1014__section180881121217"><h4 class="sectiontitle">Error Code</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="aom_04_1014__table4880211161220" frame="border" border="1" rules="all"><caption><b>Table 6 </b>Error codes</caption><thead align="left"><tr id="aom_04_1014__row58767117124"><th align="left" class="cellrowborder" valign="top" width="33.333333333333336%" id="mcps1.3.6.2.2.4.1.1"><p id="aom_04_1014__p1287611131219">Error Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.333333333333336%" id="mcps1.3.6.2.2.4.1.2"><p id="aom_04_1014__p14876141115124">Message</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.333333333333336%" id="mcps1.3.6.2.2.4.1.3"><p id="aom_04_1014__p1687631110123">Solution</p>
</th>
</tr>
</thead>
<tbody><tr id="aom_04_1014__row128792110126"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.1 "><p id="aom_04_1014__p133916367131">AOM.0101</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.2 "><p id="aom_04_1014__p9294813204117">Invalid alarm name.</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.3 "><p id="aom_04_1014__p1039336141314">Check whether the parameter meets requirements.</p>
</td>
</tr>
<tr id="aom_04_1014__row887931191214"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.1 "><p id="aom_04_1014__p1439193618136">AOM.0102</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.2 "><p id="aom_04_1014__p9294113164118">The threshold rule name already exists.</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.3 "><p id="aom_04_1014__p19391136141312">Use another name.</p>
</td>
</tr>
<tr id="aom_04_1014__row1687961171220"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.1 "><p id="aom_04_1014__p53943613137">AOM.0103</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.2 "><p id="aom_04_1014__p12294913174111">Invalid alarm description.</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.3 "><p id="aom_04_1014__p1439173621312">Check whether the parameter meets requirements.</p>
</td>
</tr>
<tr id="aom_04_1014__row16880411161212"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.1 "><p id="aom_04_1014__p93943611311">AOM.0104</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.2 "><p id="aom_04_1014__p1129451364113">Invalid alarm threshold.</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.3 "><p id="aom_04_1014__p1139193618139">Check whether the parameter meets requirements.</p>
</td>
</tr>
<tr id="aom_04_1014__row199791311201315"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.1 "><p id="aom_04_1014__p1739143671313">AOM.0105</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.2 "><p id="aom_04_1014__p12294201315415">Invalid alarm period.</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.3 "><p id="aom_04_1014__p1739103615134">Check whether the parameter meets requirements.</p>
</td>
</tr>
<tr id="aom_04_1014__row19979911201318"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.1 "><p id="aom_04_1014__p441123621317">AOM.0106</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.2 "><p id="aom_04_1014__p5295131364116">Invalid email list.</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.3 "><p id="aom_04_1014__p1241143691311">Check whether the parameter meets requirements.</p>
</td>
</tr>
<tr id="aom_04_1014__row13979131151313"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.1 "><p id="aom_04_1014__p144153616134">AOM.0107</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.2 "><p id="aom_04_1014__p42951213174118">The maximum number of threshold rules has been reached.</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.3 "><p id="aom_04_1014__p1411736151317">Contact technical support to expand the capacity.</p>
</td>
</tr>
<tr id="aom_04_1014__row99791811111318"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.1 "><p id="aom_04_1014__p14411236151312">AOM.0108</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.2 "><p id="aom_04_1014__p929511139417">Invalid time range for alarm queries.</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.3 "><p id="aom_04_1014__p8411636191317">Check whether the parameter meets requirements.</p>
</td>
</tr>
<tr id="aom_04_1014__row1097901151318"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.1 "><p id="aom_04_1014__p13411936171311">AOM.0109</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.2 "><p id="aom_04_1014__p0295171315417">Invalid project ID.</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.3 "><p id="aom_04_1014__p7411236161319">Check whether the parameter meets requirements.</p>
</td>
</tr>
<tr id="aom_04_1014__row19977181191319"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.1 "><p id="aom_04_1014__p113717367137">AOM.0115</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.2 "><p id="aom_04_1014__p229517134415">Invalid request parameter.</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.3 "><p id="aom_04_1014__p153713361132">Check whether the parameter meets requirements.</p>
</td>
</tr>
<tr id="aom_04_1014__row11947161411313"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.1 "><p id="aom_04_1014__p6381636181319">AOM.0118</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.2 "><p id="aom_04_1014__p102961513124117">Invalid number of consecutive periods.</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.3 "><p id="aom_04_1014__p183819360138">Check whether the parameter meets requirements.</p>
</td>
</tr>
<tr id="aom_04_1014__row594741413133"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.1 "><p id="aom_04_1014__p1338173671318">AOM.0119</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.2 "><p id="aom_04_1014__p17296171384119">Invalid alarm statistic.</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.3 "><p id="aom_04_1014__p238123614130">Check whether the parameter meets requirements.</p>
</td>
</tr>
<tr id="aom_04_1014__row149478147137"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.1 "><p id="aom_04_1014__p338736151318">AOM.0120</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.2 "><p id="aom_04_1014__p16296313194113">Invalid alarm comparison operator.</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.3 "><p id="aom_04_1014__p1738163611137">Check whether the parameter meets requirements.</p>
</td>
</tr>
<tr id="aom_04_1014__row1794711148130"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.1 "><p id="aom_04_1014__p438133618136">AOM.0121</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.2 "><p id="aom_04_1014__p16296101314115">The alarm does not exist.</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.3 "><p id="aom_04_1014__p73918360139">Check whether the threshold rule exists.</p>
</td>
</tr>
<tr id="aom_04_1014__row17946121431313"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.1 "><p id="aom_04_1014__p15375363133">AOM.0500</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.2 "><p id="aom_04_1014__p1029661311419">Internal server error.</p>
</td>
<td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.6.2.2.4.1.3 "><p id="aom_04_1014__p537536201315">Contact technical support.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="aom_04_1045.html">Monitoring APIs</a></div>
</div>
</div>