doc-exports/docs/css/api-ref/css_03_0133.html
Zheng, Xiu 99a2d77599 css api 23.5.1 20240520
Reviewed-by: Kacur, Michal <michal.kacur@t-systems.com>
Co-authored-by: Zheng, Xiu <zhengxiu@huawei.com>
Co-committed-by: Zheng, Xiu <zhengxiu@huawei.com>
2024-06-07 17:47:08 +00:00

197 lines
13 KiB
HTML

<a name="css_03_0133"></a><a name="css_03_0133"></a>
<h1 class="topictitle1">Creating a Cluster Detection Task</h1>
<div id="body0000001667757620"><div class="section" id="css_03_0133__section62941413105517"><h4 class="sectiontitle">Function</h4><p id="css_03_0133__p429591335510">This API is used to create a cluster detection task.</p>
</div>
<div class="section" id="css_03_0133__section829671313556"><h4 class="sectiontitle">URI</h4><p id="css_03_0133__p10296813155510">POST /v1.0/{project_id}/clusters/{cluster_id}/ai-ops</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_03_0133__table429841315520" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path parameters</caption><thead align="left"><tr id="css_03_0133__row829661345511"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.1"><p id="css_03_0133__p132983134558">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.2"><p id="css_03_0133__p192981113175512">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.3"><p id="css_03_0133__p1729931314558">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.2.3.2.5.1.4"><p id="css_03_0133__p14299101375518">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="css_03_0133__row329741395513"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="css_03_0133__p1429941315557">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="css_03_0133__p1329931314551">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="css_03_0133__p6300181311554">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="css_03_0133__p9300201313557">Project ID. For details about how to obtain a project ID, see <a href="css_03_0071.html">Obtaining a Project ID and Name</a>.</p>
</td>
</tr>
<tr id="css_03_0133__row12297313175520"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="css_03_0133__p18300713105511">cluster_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="css_03_0133__p6301181375516">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="css_03_0133__p10301111345515">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="css_03_0133__p03011713145516">ID of the target cluster</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="css_03_0133__section93011133555"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_03_0133__HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="css_03_0133__row15302111318559"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="css_03_0133__p17303713145517">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.2"><p id="css_03_0133__p1830381312554">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.3"><p id="css_03_0133__p1630361365513">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.2.5.1.4"><p id="css_03_0133__p4304191314557">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="css_03_0133__row17302101310555"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="css_03_0133__p15304013205511">X-Language</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="css_03_0133__p18304191316556">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="css_03_0133__p93044139558">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="css_03_0133__p1730515136554">Language</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_03_0133__request_CreateAiOpsRequestBody" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Request body parameter</caption><thead align="left"><tr id="css_03_0133__row18305013185518"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="css_03_0133__p1930621365519">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="css_03_0133__p173071613105513">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="css_03_0133__p2030751310552">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="css_03_0133__p15307101385516">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="css_03_0133__row1330571318552"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="css_03_0133__p12307141314551">name</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="css_03_0133__p83086135552">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="css_03_0133__p0308151335520">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="css_03_0133__p230811314551">Detection task name</p>
</td>
</tr>
<tr id="css_03_0133__row12306101325510"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="css_03_0133__p53084135551">description</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="css_03_0133__p18309151345510">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="css_03_0133__p18309101355512">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="css_03_0133__p19309713205513">Detection task description</p>
</td>
</tr>
<tr id="css_03_0133__row1830691355510"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="css_03_0133__p1830921318556">alarm</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="css_03_0133__p73109132556">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="css_03_0133__p153100137551"><a href="#css_03_0133__request_alarm">alarm</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="css_03_0133__p11310813205520">After the detection task is complete, an SMN alarm message is sent.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="css_03_0133__request_alarm"></a><a name="request_alarm"></a><table cellpadding="4" cellspacing="0" summary="" id="css_03_0133__request_alarm" frame="border" border="1" rules="all"><caption><b>Table 4 </b>alarm</caption><thead align="left"><tr id="css_03_0133__row2311101385510"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.1"><p id="css_03_0133__p20313213145518">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.2"><p id="css_03_0133__p193136133558">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.3"><p id="css_03_0133__p3313181335518">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.4.2.5.1.4"><p id="css_03_0133__p11314201335517">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="css_03_0133__row831216131553"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.1 "><p id="css_03_0133__p14314111312559">level</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.2 "><p id="css_03_0133__p123152137553">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="css_03_0133__p731581375512">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.4.2.5.1.4 "><p id="css_03_0133__p8315713145511">Sensitivity of an SMN alarm message.</p>
<ul id="css_03_0133__ul131511310552"><li id="css_03_0133__li13315121316552"><strong id="css_03_0133__b103731236913">high</strong></li><li id="css_03_0133__li13316151310551"><strong id="css_03_0133__b1293310395115">medium</strong></li><li id="css_03_0133__li12316161325517"><strong id="css_03_0133__b79739443118">suggestion</strong></li><li id="css_03_0133__li153161713145516"><strong id="css_03_0133__b042312507115">norisk</strong></li></ul>
</td>
</tr>
<tr id="css_03_0133__row1231241315552"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.1 "><p id="css_03_0133__p1631620134557">smn_topic</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.2 "><p id="css_03_0133__p15317913165519">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="css_03_0133__p731781395511">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.4.2.5.1.4 "><p id="css_03_0133__p4317151317555">SMN topic name</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="css_03_0133__section831811133551"><h4 class="sectiontitle">Response Parameters</h4><p id="css_03_0133__p231831319553">None</p>
</div>
<div class="section" id="css_03_0133__section331813136555"><h4 class="sectiontitle">Request Example</h4><p id="css_03_0133__p153181413105520">Create a cluster detection task.</p>
<pre class="screen" id="css_03_0133__screen53194136556">POST /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/ai-ops
{
"name": " aiops-test ",
"description": " Create a cluster checking task.
",
"alarm":{
"level":"high",
"smn_topic":"aiops-test"
}
}</pre>
</div>
<div class="section" id="css_03_0133__section11321713175515"><h4 class="sectiontitle">Response Example</h4><p id="css_03_0133__p1632118139553">None</p>
</div>
<div class="section" id="css_03_0133__section132115135552"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_03_0133__status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="css_03_0133__row7322171318553"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="css_03_0133__p43231213145512">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.2.1.3.1.2"><p id="css_03_0133__p1632319139552">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="css_03_0133__row1432231375515"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="css_03_0133__p1632341355516">200</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="css_03_0133__p13324313195512">The request is processed successfully.</p>
</td>
</tr>
<tr id="css_03_0133__row15322101313552"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="css_03_0133__p113240135558">400</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="css_03_0133__p12324101385517">Invalid request.</p>
<p id="css_03_0133__p5324113165515">Modify the request instead of retrying.</p>
</td>
</tr>
<tr id="css_03_0133__row12322113195514"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="css_03_0133__p13325013105520">409</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="css_03_0133__p13252013165518">The request cannot be processed due to a conflict.</p>
<p id="css_03_0133__p732521325517">This status code indicates that the resource that the client attempts to create already exists, or the request fails to be processed because of the update of the conflict request.</p>
</td>
</tr>
<tr id="css_03_0133__row132201385510"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="css_03_0133__p2325111385520">412</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="css_03_0133__p1932551325518">The server does not meet one of the requirements that the requester puts on the request.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="css_03_0133__section13326111365514"><h4 class="sectiontitle">Error Codes</h4><p id="css_03_0133__p16326141311559">For details, see <a href="css_03_0076.html">Error Code</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="css_03_0132.html">Intelligent O&amp;M</a></div>
</div>
</div>