forked from docs/doc-exports
Hasko, Vladimir
255730fbf9
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>
123 lines
9.0 KiB
HTML
123 lines
9.0 KiB
HTML
<a name="lts_02_0003"></a><a name="lts_02_0003"></a>
|
|
|
|
<h1 class="topictitle1">Creating a Log Group</h1>
|
|
<div id="body47819686"><p class="msonormal" id="lts_02_0003__p15426562">This API is used to create a log group. All API URLs described in this section must be case-sensitive.</p>
|
|
<div class="section" id="lts_02_0003__section4621333"><h4 class="sectiontitle">Function</h4><p class="msonormal" id="lts_02_0003__p48189318">This function describes how to create a log group for log storage and query. You can create a maximum of 100 log groups.</p>
|
|
</div>
|
|
<div class="section" id="lts_02_0003__section41592000"><h4 class="sectiontitle">URI</h4><ul id="lts_02_0003__ul165395536212"><li id="lts_02_0003__li5269929173052">URI format<p class="msonormal" id="lts_02_0003__p63135782"><a name="lts_02_0003__li5269929173052"></a><a name="li5269929173052"></a>POST /v2.0/{project_id}/log-groups</p>
|
|
</li></ul>
|
|
<ul id="lts_02_0003__ul0109191102213"><li class="msonormal" id="lts_02_0003__li21091415229">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_02_0003__table48105459" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="lts_02_0003__row60866610"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.3.3.1.1.2.5.1.1"><p id="lts_02_0003__p31248367"><strong id="lts_02_0003__b1337963223918">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.3.3.1.1.2.5.1.2"><p id="lts_02_0003__p48089780"><strong id="lts_02_0003__b481373363911">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.3.3.1.1.2.5.1.3"><p id="lts_02_0003__p2958122"><strong id="lts_02_0003__b18346435193915">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.3.3.1.1.2.5.1.4"><p id="lts_02_0003__p38281336"><strong id="lts_02_0003__b2026411366395">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="lts_02_0003__row13780551"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.3.1.1.2.5.1.1 "><p id="lts_02_0003__p42482879">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.3.1.1.2.5.1.2 "><p id="lts_02_0003__p18561159">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.3.1.1.2.5.1.3 "><p id="lts_02_0003__p27058887">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.3.1.1.2.5.1.4 "><p id="lts_02_0003__p44286248">Project ID</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="lts_02_0003__section38783684"><h4 class="sectiontitle">Request</h4><ul id="lts_02_0003__ul30416337"><li id="lts_02_0003__li5311585">Request parameters
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_02_0003__table47804267" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description</caption><thead align="left"><tr id="lts_02_0003__row48525468"><th align="left" class="cellrowborder" valign="top" width="16%" id="mcps1.3.4.2.1.1.2.6.1.1"><p id="lts_02_0003__p38248803"><strong id="lts_02_0003__b1124318619407">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16%" id="mcps1.3.4.2.1.1.2.6.1.2"><p id="lts_02_0003__p11145359"><strong id="lts_02_0003__afd1c772bc0d34dd0954eb451c30339a1">Sub-Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16%" id="mcps1.3.4.2.1.1.2.6.1.3"><p id="lts_02_0003__p30358920"><strong id="lts_02_0003__b07871114164011">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="12%" id="mcps1.3.4.2.1.1.2.6.1.4"><p id="lts_02_0003__p43153461"><strong id="lts_02_0003__b24681157403">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.2.1.1.2.6.1.5"><p id="lts_02_0003__p5769471"><strong id="lts_02_0003__b05215168400">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="lts_02_0003__row64673997"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.1.2.6.1.1 "><p id="lts_02_0003__p4102408">log_group_name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.1.2.6.1.2 "><p id="lts_02_0003__p63859607">N/A</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.1.2.6.1.3 "><p id="lts_02_0003__p5245667">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.2.1.1.2.6.1.4 "><p id="lts_02_0003__p22245843">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.1.1.2.6.1.5 "><p id="lts_02_0003__p57082831">Log group name.</p>
|
|
<p id="lts_02_0003__a85abdc81ab8744b69765ad68746d242f">The configuration rules are as follows:</p>
|
|
<ul id="lts_02_0003__u171738f158ec47de86f1dcc16cd98255"><li id="lts_02_0003__li18572153114310">Must be a string of 1 to 64 characters.</li><li id="lts_02_0003__l08ec7850d87f46e6800de42bb4822bef">Only letters, digits, underscores (_), hyphens (-), and periods (.) are allowed. The name cannot start or end with a period.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="lts_02_0003__row43983438"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.1.2.6.1.1 "><p id="lts_02_0003__p5888712">ttl_in_days</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.1.2.6.1.2 "><p id="lts_02_0003__p7223683">N/A</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.1.2.6.1.3 "><p id="lts_02_0003__p48247463">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.4.2.1.1.2.6.1.4 "><p id="lts_02_0003__p15730394">Int</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.1.1.2.6.1.5 "><p id="lts_02_0003__p65581032161015">Log expiration time. The value is fixed to 7 days.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="lts_02_0003__ul58951042"><li id="lts_02_0003__li60797332">Example request<pre class="screen" id="lts_02_0003__screen10305078">POST /v2.0/{project_id}/log-groups
|
|
{
|
|
"log_group_name":"test01",
|
|
"ttl_in_days": 7
|
|
}</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="lts_02_0003__section13508843"><h4 class="sectiontitle">Response</h4><ul id="lts_02_0003__ul29404983"><li id="lts_02_0003__li63318255">Response parameters
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_02_0003__table32993388" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Parameter description</caption><thead align="left"><tr id="lts_02_0003__row9385709"><th align="left" class="cellrowborder" valign="top" width="25.742574257425744%" id="mcps1.3.5.2.1.1.2.5.1.1"><p id="lts_02_0003__p22044993"><strong id="lts_02_0003__b129413310598">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="22.772277227722775%" id="mcps1.3.5.2.1.1.2.5.1.2"><p id="lts_02_0003__p40814009"><strong id="lts_02_0003__b853626101">Sub-Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.792079207920793%" id="mcps1.3.5.2.1.1.2.5.1.3"><p id="lts_02_0003__p17600446"><strong id="lts_02_0003__b151384295920">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="30.693069306930692%" id="mcps1.3.5.2.1.1.2.5.1.4"><p id="lts_02_0003__p16350007"><strong id="lts_02_0003__b2021484365911">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="lts_02_0003__row49282189"><td class="cellrowborder" valign="top" width="25.742574257425744%" headers="mcps1.3.5.2.1.1.2.5.1.1 "><p id="lts_02_0003__p32434343">log_group_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="22.772277227722775%" headers="mcps1.3.5.2.1.1.2.5.1.2 "><p id="lts_02_0003__p9936109">N/A</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.792079207920793%" headers="mcps1.3.5.2.1.1.2.5.1.3 "><p id="lts_02_0003__p66627401">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="30.693069306930692%" headers="mcps1.3.5.2.1.1.2.5.1.4 "><p id="lts_02_0003__p28110368">Log group ID</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="lts_02_0003__ul51666726"><li id="lts_02_0003__li62347356">Example response<pre class="screen" id="lts_02_0003__screen24255300">{
|
|
"log_group_id":"56b4b31f-3024-11e9-9023-286ed488ce71"
|
|
} </pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="lts_02_0003__section54470724"><h4 class="sectiontitle">Returned Value</h4><ul id="lts_02_0003__ul18522258"><li id="lts_02_0003__li32482594">Normal<p id="lts_02_0003__p17682175254410"><a name="lts_02_0003__li32482594"></a><a name="li32482594"></a>201</p>
|
|
</li></ul>
|
|
<ul id="lts_02_0003__ul3583115"><li id="lts_02_0003__li44860134">Abnormal<p id="lts_02_0003__p8911139194318"><a name="lts_02_0003__li44860134"></a><a name="li44860134"></a>For details about status code, see <a href="lts_02_0020.html">Status Code</a>.</p>
|
|
</li></ul>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="lts_02_0002.html">Log Group Management (Old Version)</a></div>
|
|
</div>
|
|
</div>
|
|
|