vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/lts/api-ref/lts_api_0012.html
Hasko, Vladimir 255730fbf9 lts_api (recreate of #279) 
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-12-02 09:17:17 +00:00

371 lines
30 KiB
HTML
Raw Permalink Blame History

<a name="lts_api_0012"></a><a name="lts_api_0012"></a>
<h1 class="topictitle1">Creating a Log Group</h1>
<div id="body32001227"><div class="section" id="lts_api_0012__en-us_topic_0160681583_section4621333"><h4 class="sectiontitle">Function</h4><p class="msonormal" id="lts_api_0012__en-us_topic_0160681583_p48189318">This API is used to create a log group for log retention and query. You can create a maximum of 100 log groups.</p>
</div>
<div class="section" id="lts_api_0012__en-us_topic_0160681583_section41592000"><h4 class="sectiontitle">URI</h4><div class="msonormal" id="lts_api_0012__en-us_topic_0160681583_p63135782">POST /v2/{project_id}/groups
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0012__en-us_topic_0160681583_table48105459" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameter</caption><thead align="left"><tr id="lts_api_0012__en-us_topic_0160681583_row60866610"><th align="left" class="cellrowborder" valign="top" width="20.31%" id="mcps1.3.2.2.1.2.5.1.1"><p id="lts_api_0012__en-us_topic_0160681583_p31248367">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="9.790000000000001%" id="mcps1.3.2.2.1.2.5.1.2"><p id="lts_api_0012__en-us_topic_0160681583_p48089780">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.85%" id="mcps1.3.2.2.1.2.5.1.3"><p id="lts_api_0012__en-us_topic_0160681583_p2958122">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.05%" id="mcps1.3.2.2.1.2.5.1.4"><p id="lts_api_0012__en-us_topic_0160681583_p38281336">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="lts_api_0012__en-us_topic_0160681583_row13780551"><td class="cellrowborder" valign="top" width="20.31%" headers="mcps1.3.2.2.1.2.5.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p42482879">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="9.790000000000001%" headers="mcps1.3.2.2.1.2.5.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p18561159">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="18.85%" headers="mcps1.3.2.2.1.2.5.1.3 "><p id="lts_api_0012__en-us_topic_0160681583_p27058887">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.05%" headers="mcps1.3.2.2.1.2.5.1.4 "><p id="lts_api_0012__en-us_topic_0160681583_p978513322285">Project ID. For details about how to obtain the ID, see <a href="lts_api_0006.html#lts_api_0006">Obtaining the AccountID, Project ID, Log Group ID, and Log Stream ID</a>.</p>
<p id="lts_api_0012__en-us_topic_0160681583_p978533220283">Default value: None</p>
<p id="lts_api_0012__en-us_topic_0160681583_p97851232182819">Value length: 32 characters</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="section" id="lts_api_0012__en-us_topic_0160681583_section38783684"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0012__en-us_topic_0160681583_HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="lts_api_0012__en-us_topic_0160681583_row127861032112814"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="lts_api_0012__en-us_topic_0160681583_p11786113211288">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="10%" id="mcps1.3.3.2.2.5.1.2"><p id="lts_api_0012__en-us_topic_0160681583_p6786153292814">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.3"><p id="lts_api_0012__en-us_topic_0160681583_p3786133232810">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.3.2.2.5.1.4"><p id="lts_api_0012__en-us_topic_0160681583_p778713329287">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="lts_api_0012__en-us_topic_0160681583_row127861432112819"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p16787932112810">X-Auth-Token</p>
</td>
<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.3.2.2.5.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p1778793215287">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="lts_api_0012__en-us_topic_0160681583_p57871432122811">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.2.5.1.4 "><p id="lts_api_0012__en-us_topic_0160681583_p778753211281">User token obtained from IAM.</p>
<p id="lts_api_0012__en-us_topic_0160681583_p1578716321285">Default value: None</p>
<p id="lts_api_0012__en-us_topic_0160681583_p87871032152811">Minimum length: 1000 characters</p>
<p id="lts_api_0012__en-us_topic_0160681583_p1578853211286">Maximum length: 2000 characters</p>
</td>
</tr>
<tr id="lts_api_0012__en-us_topic_0160681583_row10786163218287"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p9788143211288">Content-Type</p>
</td>
<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.3.2.2.5.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p12788113211286">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="lts_api_0012__en-us_topic_0160681583_p167881232132820">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.2.5.1.4 "><p id="lts_api_0012__en-us_topic_0160681583_p9788183218282">Set this parameter to <strong id="lts_api_0012__en-us_topic_0160681583_b582361811514">application/json;charset=UTF-8</strong>.</p>
<p id="lts_api_0012__en-us_topic_0160681583_p1078803220288">Default value: None</p>
<p id="lts_api_0012__en-us_topic_0160681583_p57889324284">Length: 30 characters</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0012__en-us_topic_0160681583_requestParameter" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Request body parameters</caption><thead align="left"><tr id="lts_api_0012__en-us_topic_0160681583_row147891332152810"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="lts_api_0012__en-us_topic_0160681583_p6789203220287">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="10%" id="mcps1.3.3.3.2.5.1.2"><p id="lts_api_0012__en-us_topic_0160681583_p19789123213280">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="lts_api_0012__en-us_topic_0160681583_p9789103272811">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.3.3.2.5.1.4"><p id="lts_api_0012__en-us_topic_0160681583_p14790173232813">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="lts_api_0012__en-us_topic_0160681583_row1778933212816"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p279012325289">log_group_name</p>
</td>
<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.3.3.2.5.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p1790163213281">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="lts_api_0012__en-us_topic_0160681583_p18790232112814">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.3.2.5.1.4 "><p id="lts_api_0012__en-us_topic_0160681583_p0790332102810">Name of the log group to be created.</p>
<p id="lts_api_0012__en-us_topic_0160681583_p1970845032315">Minimum length: 1 character</p>
<p id="lts_api_0012__en-us_topic_0160681583_p15708450142315">Maximum length: 64 characters</p>
<p id="lts_api_0012__en-us_topic_0160681583_p1379023213284">Enumerated value:</p>
<ul id="lts_api_0012__en-us_topic_0160681583_ul13790113202814"><li id="lts_api_0012__en-us_topic_0160681583_li5790123282816"><strong id="lts_api_0012__en-us_topic_0160681583_b13524340174812">lts-group-01nh</strong></li></ul>
</td>
</tr>
<tr id="lts_api_0012__en-us_topic_0160681583_row1978953219281"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p87911532202819">ttl_in_days</p>
</td>
<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.3.3.2.5.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p12791103216287">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="lts_api_0012__en-us_topic_0160681583_p5791113212282">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.3.2.5.1.4 "><p id="lts_api_0012__en-us_topic_0160681583_p8791032192817">Log retention duration, in days (fixed to 7 days).</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="lts_api_0012__en-us_topic_0160681583_section13508843"><h4 class="sectiontitle">Response Parameters</h4><p id="lts_api_0012__en-us_topic_0160681583_p5892432157"><strong id="lts_api_0012__en-us_topic_0160681583_b9487131711393">Status code: 201</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0012__en-us_topic_0160681583_responseParameter" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response body parameter</caption><thead align="left"><tr id="lts_api_0012__en-us_topic_0160681583_row107921832122819"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.4.1.1"><p id="lts_api_0012__en-us_topic_0160681583_p1792432182810">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.4.1.2"><p id="lts_api_0012__en-us_topic_0160681583_p579312324285">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.3.2.4.1.3"><p id="lts_api_0012__en-us_topic_0160681583_p177931432172811">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="lts_api_0012__en-us_topic_0160681583_row13792032142816"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p117933326280">log_group_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p1679383219286">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.3.2.4.1.3 "><p id="lts_api_0012__en-us_topic_0160681583_p379353210286">ID of the created log group.</p>
<p id="lts_api_0012__en-us_topic_0160681583_p6793193215288">Value length: 36 characters</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="lts_api_0012__en-us_topic_0160681583_p1879333272816"><strong id="lts_api_0012__en-us_topic_0160681583_b9974640143913">Status code: 400</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0012__en-us_topic_0160681583_table1279333215288" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Response body parameters</caption><thead align="left"><tr id="lts_api_0012__en-us_topic_0160681583_row1779411322283"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.5.2.4.1.1"><p id="lts_api_0012__en-us_topic_0160681583_p197949326284">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.5.2.4.1.2"><p id="lts_api_0012__en-us_topic_0160681583_p17946326289">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.5.2.4.1.3"><p id="lts_api_0012__en-us_topic_0160681583_p10794173213287">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="lts_api_0012__en-us_topic_0160681583_row19794173212281"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.4.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p14795103219288">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.4.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p107951432172814">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.5.2.4.1.3 "><p id="lts_api_0012__en-us_topic_0160681583_p979583262810">Error code.</p>
<p id="lts_api_0012__en-us_topic_0160681583_p20795133222811">Enumerated value:</p>
<ul id="lts_api_0012__en-us_topic_0160681583_ul1979503213286"><li id="lts_api_0012__en-us_topic_0160681583_li67952032122810"><strong id="lts_api_0012__en-us_topic_0160681583_b129810577480">LTS.0403</strong></li></ul>
</td>
</tr>
<tr id="lts_api_0012__en-us_topic_0160681583_row279416329283"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.4.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p5795032142810">error_msg</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.4.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p16795832102815">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.5.2.4.1.3 "><p id="lts_api_0012__en-us_topic_0160681583_p7795732102820">Error message.</p>
<p id="lts_api_0012__en-us_topic_0160681583_p157967322288">Enumerated value:</p>
<ul id="lts_api_0012__en-us_topic_0160681583_ul127961032152817"><li id="lts_api_0012__en-us_topic_0160681583_li57964326283"><strong id="lts_api_0012__en-us_topic_0160681583_b1182631104918">Invalid projectId</strong></li></ul>
</td>
</tr>
</tbody>
</table>
</div>
<p id="lts_api_0012__en-us_topic_0160681583_p6796153217282"><strong id="lts_api_0012__en-us_topic_0160681583_b5721847163920">Status code: 401</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0012__en-us_topic_0160681583_table87968325284" frame="border" border="1" rules="all"><caption><b>Table 6 </b>Response body parameters</caption><thead align="left"><tr id="lts_api_0012__en-us_topic_0160681583_row157961932122816"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.7.2.4.1.1"><p id="lts_api_0012__en-us_topic_0160681583_p8796143252812">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.7.2.4.1.2"><p id="lts_api_0012__en-us_topic_0160681583_p10797732152815">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.7.2.4.1.3"><p id="lts_api_0012__en-us_topic_0160681583_p167971532182813">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="lts_api_0012__en-us_topic_0160681583_row1796932192818"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.4.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p10797932122811">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.4.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p779793222816">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.7.2.4.1.3 "><p id="lts_api_0012__en-us_topic_0160681583_p57972328289">Error code.</p>
<p id="lts_api_0012__en-us_topic_0160681583_p47971032102818">Enumerated value:</p>
<ul id="lts_api_0012__en-us_topic_0160681583_ul1679710321289"><li id="lts_api_0012__en-us_topic_0160681583_li13797113272813"><strong id="lts_api_0012__en-us_topic_0160681583_b1133049114911">LTS.0403</strong></li></ul>
</td>
</tr>
<tr id="lts_api_0012__en-us_topic_0160681583_row6796203252813"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.4.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p17981432112820">error_msg</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.4.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p12798163216281">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.7.2.4.1.3 "><p id="lts_api_0012__en-us_topic_0160681583_p1879817328286">Error message.</p>
<p id="lts_api_0012__en-us_topic_0160681583_p6798163212281">Enumerated value:</p>
<ul id="lts_api_0012__en-us_topic_0160681583_ul779818326288"><li id="lts_api_0012__en-us_topic_0160681583_li2079819327282"><strong id="lts_api_0012__en-us_topic_0160681583_b1520241511492">Invalid projectId</strong></li></ul>
</td>
</tr>
</tbody>
</table>
</div>
<p id="lts_api_0012__en-us_topic_0160681583_p15798232132812"><strong id="lts_api_0012__en-us_topic_0160681583_b1590316514394">Status code: 403</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0012__en-us_topic_0160681583_table57981432122813" frame="border" border="1" rules="all"><caption><b>Table 7 </b>Response body parameters</caption><thead align="left"><tr id="lts_api_0012__en-us_topic_0160681583_row107991332122814"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.9.2.4.1.1"><p id="lts_api_0012__en-us_topic_0160681583_p15799183218282">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.9.2.4.1.2"><p id="lts_api_0012__en-us_topic_0160681583_p17991032132820">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.9.2.4.1.3"><p id="lts_api_0012__en-us_topic_0160681583_p079910323286">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="lts_api_0012__en-us_topic_0160681583_row779973232814"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.4.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p147995324281">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.4.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p280053213285">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.9.2.4.1.3 "><p id="lts_api_0012__en-us_topic_0160681583_p18001032182813">Error code.</p>
<p id="lts_api_0012__en-us_topic_0160681583_p158001532102813">Enumerated value:</p>
<ul id="lts_api_0012__en-us_topic_0160681583_ul9800103262820"><li id="lts_api_0012__en-us_topic_0160681583_li1680053282818"><strong id="lts_api_0012__en-us_topic_0160681583_b639362410492">LTS.0403</strong></li></ul>
</td>
</tr>
<tr id="lts_api_0012__en-us_topic_0160681583_row7799163210282"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.4.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p68008321288">error_msg</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.4.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p480033213286">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.9.2.4.1.3 "><p id="lts_api_0012__en-us_topic_0160681583_p19800032142810">Error message.</p>
<p id="lts_api_0012__en-us_topic_0160681583_p16800432142819">Enumerated value:</p>
<ul id="lts_api_0012__en-us_topic_0160681583_ul20800332132815"><li id="lts_api_0012__en-us_topic_0160681583_li4801203211282"><strong id="lts_api_0012__en-us_topic_0160681583_b9593132810491">Invalid projectId</strong></li></ul>
</td>
</tr>
</tbody>
</table>
</div>
<p id="lts_api_0012__en-us_topic_0160681583_p4801232192816"><strong id="lts_api_0012__en-us_topic_0160681583_b17558105814399">Status code: 500</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0012__en-us_topic_0160681583_table158011326281" frame="border" border="1" rules="all"><caption><b>Table 8 </b>Response body parameters</caption><thead align="left"><tr id="lts_api_0012__en-us_topic_0160681583_row15801832152817"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.11.2.4.1.1"><p id="lts_api_0012__en-us_topic_0160681583_p38011032162818">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.11.2.4.1.2"><p id="lts_api_0012__en-us_topic_0160681583_p7801113214284">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.11.2.4.1.3"><p id="lts_api_0012__en-us_topic_0160681583_p16802332142819">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="lts_api_0012__en-us_topic_0160681583_row1780153272817"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.11.2.4.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p18802113217289">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.11.2.4.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p280215323284">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.11.2.4.1.3 "><p id="lts_api_0012__en-us_topic_0160681583_p080233212820">Error code.</p>
<p id="lts_api_0012__en-us_topic_0160681583_p178026322289">Enumerated value:</p>
<ul id="lts_api_0012__en-us_topic_0160681583_ul1280253292819"><li id="lts_api_0012__en-us_topic_0160681583_li16802113282811"><strong id="lts_api_0012__en-us_topic_0160681583_b1178703418496">LTS.0403</strong></li></ul>
</td>
</tr>
<tr id="lts_api_0012__en-us_topic_0160681583_row980113232814"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.11.2.4.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p168022326284">error_msg</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.11.2.4.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p78031326289">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.11.2.4.1.3 "><p id="lts_api_0012__en-us_topic_0160681583_p880353212815">Error message.</p>
<p id="lts_api_0012__en-us_topic_0160681583_p11803532152818">Enumerated value:</p>
<ul id="lts_api_0012__en-us_topic_0160681583_ul680323202812"><li id="lts_api_0012__en-us_topic_0160681583_li9803113252815"><strong id="lts_api_0012__en-us_topic_0160681583_b1516219389493">Invalid projectId</strong></li></ul>
</td>
</tr>
</tbody>
</table>
</div>
<p id="lts_api_0012__en-us_topic_0160681583_p1480393262811"><strong id="lts_api_0012__en-us_topic_0160681583_b261415218401">Status code: 503</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0012__en-us_topic_0160681583_table5803183214283" frame="border" border="1" rules="all"><caption><b>Table 9 </b>Response body parameters</caption><thead align="left"><tr id="lts_api_0012__en-us_topic_0160681583_row68031632202810"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.13.2.4.1.1"><p id="lts_api_0012__en-us_topic_0160681583_p11804173220280">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.13.2.4.1.2"><p id="lts_api_0012__en-us_topic_0160681583_p680433232820">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.13.2.4.1.3"><p id="lts_api_0012__en-us_topic_0160681583_p158041132102812">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="lts_api_0012__en-us_topic_0160681583_row1880343282812"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.13.2.4.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p13480112914516">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.13.2.4.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p194811291455">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.13.2.4.1.3 "><p id="lts_api_0012__en-us_topic_0160681583_p18481182934517">Error code.</p>
<p id="lts_api_0012__en-us_topic_0160681583_p1848132984517">Enumerated value:</p>
<ul id="lts_api_0012__en-us_topic_0160681583_ul8481142954514"><li id="lts_api_0012__en-us_topic_0160681583_li1048118298454"><strong id="lts_api_0012__en-us_topic_0160681583_b1862694344910">LTS.0403</strong></li></ul>
</td>
</tr>
<tr id="lts_api_0012__en-us_topic_0160681583_row349942710451"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.13.2.4.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p9481229104517">error_msg</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.13.2.4.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p10481182911457">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.13.2.4.1.3 "><p id="lts_api_0012__en-us_topic_0160681583_p19481529154514">Error message.</p>
<p id="lts_api_0012__en-us_topic_0160681583_p204818293454">Enumerated value:</p>
<ul id="lts_api_0012__en-us_topic_0160681583_ul448132911456"><li id="lts_api_0012__en-us_topic_0160681583_li1248182916454"><strong id="lts_api_0012__en-us_topic_0160681583_b864264604914">Invalid projectId</strong></li></ul>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="lts_api_0012__en-us_topic_0160681583_section98051132152819"><h4 class="sectiontitle">Example Request</h4><pre class="screen" id="lts_api_0012__en-us_topic_0160681583_screen7805032192810">POST https://{endpoint}/v2/{project_id}/groups
/v2/{project_id}/groups
{
"log_group_name": "lts-group-01nh",
"ttl_in_days": 7
}</pre>
</div>
<div class="section" id="lts_api_0012__en-us_topic_0160681583_section9806133242811"><h4 class="sectiontitle">Example Response</h4><p id="lts_api_0012__en-us_topic_0160681583_p5806173211285"><strong id="lts_api_0012__en-us_topic_0160681583_b143416130401">Status code: 201</strong></p>
<pre class="screen" id="lts_api_0012__en-us_topic_0160681583_screen7806163218288">{
"log_group_id":"b6b9332b-091f-4b22-b810-264318d2d664"
}</pre>
<p id="lts_api_0012__en-us_topic_0160681583_p17806932162819"><strong id="lts_api_0012__en-us_topic_0160681583_b5495515144012">Status code: 400</strong></p>
<p id="lts_api_0012__en-us_topic_0160681583_p5806932192820">The request is invalid. Modify the request based on the description in <strong id="lts_api_0012__en-us_topic_0160681583_b1620365422813">error_msg</strong> before a retry.</p>
<pre class="screen" id="lts_api_0012__en-us_topic_0160681583_screen48064326286">{
"error_code" : "LTS.0009",
"error_msg" : "Failed to validate the request body"
}</pre>
<p id="lts_api_0012__en-us_topic_0160681583_p14807183212810"><strong id="lts_api_0012__en-us_topic_0160681583_b12216121954015">Status code: 401</strong></p>
<p id="lts_api_0012__en-us_topic_0160681583_p178071632102820">Authentication failed. Check the token and try again.</p>
<pre class="screen" id="lts_api_0012__en-us_topic_0160681583_screen15807232192816">{
"error_code" : "LTS.0003",
"error_msg" : "Invalid token"
}</pre>
<p id="lts_api_0012__en-us_topic_0160681583_p180773213281"><strong id="lts_api_0012__en-us_topic_0160681583_b638916220404">Status code: 403</strong></p>
<p id="lts_api_0012__en-us_topic_0160681583_p68079328289">The server understood the request but refused to authorize it. The client should not repeat the request without modifications.</p>
<pre class="screen" id="lts_api_0012__en-us_topic_0160681583_screen480853252812">{
"error_code" : "LTS.0001",
"error_msg" : "Invalid projectId"
}</pre>
<p id="lts_api_0012__en-us_topic_0160681583_p4808332142810"><strong id="lts_api_0012__en-us_topic_0160681583_b2062332554019">Status code: 500</strong></p>
<p id="lts_api_0012__en-us_topic_0160681583_p1980812325284">The server has received the request but encountered an internal error.</p>
<pre class="screen" id="lts_api_0012__en-us_topic_0160681583_screen580823282811">{
"error_code" : "LTS.0102",
"error_msg" : "Failed to create log group"
}</pre>
</div>
<div class="section" id="lts_api_0012__en-us_topic_0160681583_section15808183292814"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0012__en-us_topic_0160681583_table5770" frame="border" border="1" rules="all"><thead align="left"><tr id="lts_api_0012__en-us_topic_0160681583_row180911325281"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="lts_api_0012__en-us_topic_0160681583_p980923232818">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.2.1.3.1.2"><p id="lts_api_0012__en-us_topic_0160681583_p1880903216284">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="lts_api_0012__en-us_topic_0160681583_row13809332132810"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p1080912326282">201</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p88102324284">The request has succeeded and the log group has been created.</p>
</td>
</tr>
<tr id="lts_api_0012__en-us_topic_0160681583_row118091032192819"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p19810432132811">400</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p1681083222819">The request is invalid. Modify the request based on the description in <strong id="lts_api_0012__en-us_topic_0160681583_b2107174912287">error_msg</strong> before a retry.</p>
</td>
</tr>
<tr id="lts_api_0012__en-us_topic_0160681583_row19809103211282"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p19810143232813">401</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p10810332102819">Authentication failed. Check the token and try again.</p>
</td>
</tr>
<tr id="lts_api_0012__en-us_topic_0160681583_row178093325288"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p7811113215285">403</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p19811632192818">The server understood the request but refused to authorize it. The client should not repeat the request without modifications.</p>
</td>
</tr>
<tr id="lts_api_0012__en-us_topic_0160681583_row0809932152815"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p17811113222813">500</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p5812133210284">The server has received the request but encountered an internal error.</p>
</td>
</tr>
<tr id="lts_api_0012__en-us_topic_0160681583_row3809173242815"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="lts_api_0012__en-us_topic_0160681583_p158126325281">503</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="lts_api_0012__en-us_topic_0160681583_p08121232152818">The requested service is unavailable.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="lts_api_0012__en-us_topic_0160681583_section295512324283"><h4 class="sectiontitle">Error Codes</h4><p id="lts_api_0012__en-us_topic_0160681583_p59562325281">For details, see <a href="lts_02_0021.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="lts_api_0011.html">Log Group Management (New Version)</a></div>
</div>
</div>
View Git Blame Copy Permalink