forked from docs/doc-exports
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>
359 lines
29 KiB
HTML
359 lines
29 KiB
HTML
<a name="lts_api_0024"></a><a name="lts_api_0024"></a>
|
|
|
|
<h1 class="topictitle1">Modifying a Log Group</h1>
|
|
<div id="body32001227"><div class="section" id="lts_api_0024__en-us_topic_0258246476_section13053314289"><h4 class="sectiontitle">Function</h4><p id="lts_api_0024__en-us_topic_0258246476_p40173362817">This API is used to modify the log retention duration of a specified log group.</p>
|
|
</div>
|
|
<div class="section" id="lts_api_0024__en-us_topic_0258246476_section20123382819"><h4 class="sectiontitle">URI</h4><p id="lts_api_0024__en-us_topic_0258246476_p160133112810">POST /v2/{project_id}/groups/{log_group_id}</p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0024__en-us_topic_0258246476_table71733172817" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameters</caption><thead align="left"><tr id="lts_api_0024__en-us_topic_0258246476_row1113332814"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.1"><p id="lts_api_0024__en-us_topic_0258246476_p91113318287">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="10%" id="mcps1.3.2.3.2.5.1.2"><p id="lts_api_0024__en-us_topic_0258246476_p0183316285">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.3"><p id="lts_api_0024__en-us_topic_0258246476_p181933102815">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.2.3.2.5.1.4"><p id="lts_api_0024__en-us_topic_0258246476_p13216330289">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="lts_api_0024__en-us_topic_0258246476_row2143362813"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p82103392814">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.2.3.2.5.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p142133382814">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="lts_api_0024__en-us_topic_0258246476_p1021433102818">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.2.3.2.5.1.4 "><p id="lts_api_0024__en-us_topic_0258246476_p1623332286">Project ID. For details about how to obtain a project 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_0024__en-us_topic_0258246476_p42113320288">Default value: None</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p1121833142818">Value length: 36 characters</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="lts_api_0024__en-us_topic_0258246476_row81533142814"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p821433102818">log_group_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.2.3.2.5.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p123173312289">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="lts_api_0024__en-us_topic_0258246476_p1632336285">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.2.3.2.5.1.4 "><p id="lts_api_0024__en-us_topic_0258246476_p17312335289">Log group ID. For details about how to obtain a log group 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_0024__en-us_topic_0258246476_p9393319286">Default value: None</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p8373312820">Value length: 36 characters</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="lts_api_0024__en-us_topic_0258246476_section10393392817"><h4 class="sectiontitle">Request Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0024__en-us_topic_0258246476_HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="lts_api_0024__en-us_topic_0258246476_row7418336287"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="lts_api_0024__en-us_topic_0258246476_p19413313286">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_0024__en-us_topic_0258246476_p134633132815">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_0024__en-us_topic_0258246476_p195123322817">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_0024__en-us_topic_0258246476_p351433102810">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="lts_api_0024__en-us_topic_0258246476_row1346339285"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p135143317287">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_0024__en-us_topic_0258246476_p15510337284">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="lts_api_0024__en-us_topic_0258246476_p65193392810">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.2.5.1.4 "><p id="lts_api_0024__en-us_topic_0258246476_p10503315285">User token obtained from IAM.</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p06133152819">Default value: None</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p186193322814">Minimum length: 1000 characters</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p206533182818">Maximum length: 2000 characters</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="lts_api_0024__en-us_topic_0258246476_row74333202810"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p186103352817">Content-Type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.3.2.2.5.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p106433142814">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="lts_api_0024__en-us_topic_0258246476_p96733182813">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.2.5.1.4 "><p id="lts_api_0024__en-us_topic_0258246476_p9788183218282">Set this parameter to <strong id="lts_api_0024__en-us_topic_0258246476_b1559115694614">application/json;charset=UTF-8</strong>.</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p1078803220288">Default value: None</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p57889324284">Minimum length: 30 characters</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p87881032112819">Maximum length: 30 characters</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0024__en-us_topic_0258246476_requestParameter" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Request body parameter</caption><thead align="left"><tr id="lts_api_0024__en-us_topic_0258246476_row3715339280"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="lts_api_0024__en-us_topic_0258246476_p108153322810">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_0024__en-us_topic_0258246476_p17812331285">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_0024__en-us_topic_0258246476_p128133392812">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_0024__en-us_topic_0258246476_p9816332280">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="lts_api_0024__en-us_topic_0258246476_row97113352816"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p12863310284">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_0024__en-us_topic_0258246476_p2081833112814">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="lts_api_0024__en-us_topic_0258246476_p89193312819">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.3.2.5.1.4 "><p id="lts_api_0024__en-us_topic_0258246476_p89633182814">Log retention duration, in days (fixed to 7 days). </p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="lts_api_0024__en-us_topic_0258246476_section795330283"><h4 class="sectiontitle">Response Parameters</h4><p id="lts_api_0024__en-us_topic_0258246476_p20914332280"><strong id="lts_api_0024__en-us_topic_0258246476_b5909161374314">Status code: 200</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0024__en-us_topic_0258246476_responseParameter" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response body parameters</caption><thead align="left"><tr id="lts_api_0024__en-us_topic_0258246476_row410183372813"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.4.1.1"><p id="lts_api_0024__en-us_topic_0258246476_p141063317281">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_0024__en-us_topic_0258246476_p01111331285">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_0024__en-us_topic_0258246476_p012733122814">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="lts_api_0024__en-us_topic_0258246476_row31053315283"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p912113314287">creation_time</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p1014217301547">long</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.3.2.4.1.3 "><p id="lts_api_0024__en-us_topic_0258246476_p201253302815">Time when a log group was created.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="lts_api_0024__en-us_topic_0258246476_row2010163392814"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p10121433172811">log_group_name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p2012163316283">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.3.2.4.1.3 "><p id="lts_api_0024__en-us_topic_0258246476_p13138333287">Log group name.</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p18210186195113">Minimum length: 1 character</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p162103675116">Maximum length: 64 characters</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="lts_api_0024__en-us_topic_0258246476_row151063312812"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p121343318288">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_0024__en-us_topic_0258246476_p1513163302819">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.3.2.4.1.3 "><p id="lts_api_0024__en-us_topic_0258246476_p1913123317282">Log group ID.</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p1813833142819">Value length: 36 characters</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="lts_api_0024__en-us_topic_0258246476_row181019339288"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p11141333112816">ttl_in_days</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p1137973863213">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.3.2.4.1.3 "><p id="lts_api_0024__en-us_topic_0258246476_p19663163851416">Log retention duration, in days (fixed to 7 days). </p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p151411335280"><strong id="lts_api_0024__en-us_topic_0258246476_b359001924317">Status code: 400</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0024__en-us_topic_0258246476_table91463313284" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Response body parameters</caption><thead align="left"><tr id="lts_api_0024__en-us_topic_0258246476_row101483352820"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.5.2.4.1.1"><p id="lts_api_0024__en-us_topic_0258246476_p1515123316283">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_0024__en-us_topic_0258246476_p191512331281">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_0024__en-us_topic_0258246476_p17151233162811">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="lts_api_0024__en-us_topic_0258246476_row9141733192813"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.4.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p715333132812">error_code</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.4.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p9151933172810">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.5.2.4.1.3 "><p id="lts_api_0024__en-us_topic_0258246476_p216133202812">Error code.</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p816143302810">Example value:</p>
|
|
<ul id="lts_api_0024__en-us_topic_0258246476_ul1016163319281"><li id="lts_api_0024__en-us_topic_0258246476_li41616333281">LTS.0403</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="lts_api_0024__en-us_topic_0258246476_row10145336287"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.4.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p1216333202813">error_msg</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.4.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p151623313289">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.5.2.4.1.3 "><p id="lts_api_0024__en-us_topic_0258246476_p116033102813">Error message.</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p81633382818">Example value:</p>
|
|
<ul id="lts_api_0024__en-us_topic_0258246476_ul2016143372819"><li id="lts_api_0024__en-us_topic_0258246476_li3171433172814">Invalid projectId</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p61714331282"><strong id="lts_api_0024__en-us_topic_0258246476_b1188712218432">Status code: 401</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0024__en-us_topic_0258246476_table11717337282" frame="border" border="1" rules="all"><caption><b>Table 6 </b>Response body parameters</caption><thead align="left"><tr id="lts_api_0024__en-us_topic_0258246476_row517933112812"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.7.2.4.1.1"><p id="lts_api_0024__en-us_topic_0258246476_p131753317283">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_0024__en-us_topic_0258246476_p51812331280">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_0024__en-us_topic_0258246476_p161853372814">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="lts_api_0024__en-us_topic_0258246476_row1417103352814"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.4.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p181817335282">error_code</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.4.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p1318433122811">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.7.2.4.1.3 "><p id="lts_api_0024__en-us_topic_0258246476_p17181233122814">Error code.</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p4181133142811">Example value:</p>
|
|
<ul id="lts_api_0024__en-us_topic_0258246476_ul4186339284"><li id="lts_api_0024__en-us_topic_0258246476_li1118203372816">LTS.0403</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="lts_api_0024__en-us_topic_0258246476_row1217133352810"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.4.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p1619143316289">error_msg</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.4.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p1219183316284">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.7.2.4.1.3 "><p id="lts_api_0024__en-us_topic_0258246476_p1419433202811">Error message.</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p119633152816">Example value:</p>
|
|
<ul id="lts_api_0024__en-us_topic_0258246476_ul71963372810"><li id="lts_api_0024__en-us_topic_0258246476_li151917336282">Invalid projectId</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p619133382810"><strong id="lts_api_0024__en-us_topic_0258246476_b16478102624316">Status code: 403</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0024__en-us_topic_0258246476_table419133122811" frame="border" border="1" rules="all"><caption><b>Table 7 </b>Response body parameters</caption><thead align="left"><tr id="lts_api_0024__en-us_topic_0258246476_row11923315289"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.9.2.4.1.1"><p id="lts_api_0024__en-us_topic_0258246476_p82063311284">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_0024__en-us_topic_0258246476_p5201933132818">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_0024__en-us_topic_0258246476_p32073362817">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="lts_api_0024__en-us_topic_0258246476_row1719203312819"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.4.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p4211933112819">error_code</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.4.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p10212333283">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.9.2.4.1.3 "><p id="lts_api_0024__en-us_topic_0258246476_p1921333182817">Error code.</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p921933162817">Example value:</p>
|
|
<ul id="lts_api_0024__en-us_topic_0258246476_ul221533202810"><li id="lts_api_0024__en-us_topic_0258246476_li52173313286">LTS.0403</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="lts_api_0024__en-us_topic_0258246476_row7201833152814"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.4.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p102243315284">error_msg</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.4.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p182263313289">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.9.2.4.1.3 "><p id="lts_api_0024__en-us_topic_0258246476_p19224338284">Error message.</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p18221833192817">Example value:</p>
|
|
<ul id="lts_api_0024__en-us_topic_0258246476_ul822233112814"><li id="lts_api_0024__en-us_topic_0258246476_li1522183392818">Invalid projectId</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p11223335286"><strong id="lts_api_0024__en-us_topic_0258246476_b172511230154315">Status code: 500</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0024__en-us_topic_0258246476_table1722433182813" frame="border" border="1" rules="all"><caption><b>Table 8 </b>Response body parameters</caption><thead align="left"><tr id="lts_api_0024__en-us_topic_0258246476_row1122933132815"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.11.2.4.1.1"><p id="lts_api_0024__en-us_topic_0258246476_p172311338286">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_0024__en-us_topic_0258246476_p8231733122813">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_0024__en-us_topic_0258246476_p19231337288">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="lts_api_0024__en-us_topic_0258246476_row2023933192812"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.11.2.4.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p32383312288">error_code</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.11.2.4.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p1124113314288">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.11.2.4.1.3 "><p id="lts_api_0024__en-us_topic_0258246476_p224113314284">Error code.</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p724833122811">Example value:</p>
|
|
<ul id="lts_api_0024__en-us_topic_0258246476_ul192413310288"><li id="lts_api_0024__en-us_topic_0258246476_li10241233172820">LTS.0403</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="lts_api_0024__en-us_topic_0258246476_row92343318283"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.11.2.4.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p112513332283">error_msg</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.11.2.4.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p152503313289">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.11.2.4.1.3 "><p id="lts_api_0024__en-us_topic_0258246476_p625133322810">Error message.</p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p7251533142820">Example value:</p>
|
|
<ul id="lts_api_0024__en-us_topic_0258246476_ul125153311286"><li id="lts_api_0024__en-us_topic_0258246476_li182518336281">Invalid projectId</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="lts_api_0024__en-us_topic_0258246476_section227113312810"><h4 class="sectiontitle">Example Request</h4><pre class="screen" id="lts_api_0024__en-us_topic_0258246476_screen42763322814">POST https://{endpoint}/v2/{project_id}/groups/{log_group_id}
|
|
|
|
/v2/{project_id}/groups/{log_group_id}
|
|
{
|
|
"ttl_in_days": 8
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="lts_api_0024__en-us_topic_0258246476_section1928433122810"><h4 class="sectiontitle">Example Response</h4><p id="lts_api_0024__en-us_topic_0258246476_p1328133382814"><strong id="lts_api_0024__en-us_topic_0258246476_b16235193510438">Status code: 200</strong></p>
|
|
<pre class="screen" id="lts_api_0024__en-us_topic_0258246476_screen12286334287">{"creation_time" : "number","log_group_name" : "string","log_group_id" : "string","ttl_in_days" : 8}</pre>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p102893316284"><strong id="lts_api_0024__en-us_topic_0258246476_b241463734313">Status code: 400</strong></p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p9281133192815">The request is invalid. Modify the request based on the description in <strong id="lts_api_0024__en-us_topic_0258246476_b1777803802812">error_msg</strong> before a retry.</p>
|
|
<pre class="screen" id="lts_api_0024__en-us_topic_0258246476_screen42818333282">{
|
|
"error_code" : "LTS.0009",
|
|
"error_msg" : "Failed to validate the request body"
|
|
}</pre>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p1829533162814"><strong id="lts_api_0024__en-us_topic_0258246476_b1287883984313">Status code: 401</strong></p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p1129103314284">Authentication failed. Check the token and try again.</p>
|
|
<pre class="screen" id="lts_api_0024__en-us_topic_0258246476_screen162917339283">{
|
|
"error_code" : "LTS.0414",
|
|
"error_msg" : "Invalid token"
|
|
}</pre>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p7297331287"><strong id="lts_api_0024__en-us_topic_0258246476_b205581042164318">Status code: 403</strong></p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p14291433172810">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_0024__en-us_topic_0258246476_screen1029533142813">{
|
|
"error_code" : "LTS.0001",
|
|
"error_msg" : "Invalid projectId"
|
|
}</pre>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p203012339289"><strong id="lts_api_0024__en-us_topic_0258246476_b5278194624319">Status code: 500</strong></p>
|
|
<p id="lts_api_0024__en-us_topic_0258246476_p173013319283">The server has received the request but encountered an internal error.</p>
|
|
<pre class="screen" id="lts_api_0024__en-us_topic_0258246476_screen5301233162811">{
|
|
"error_code" : "LTS.0102",
|
|
"error_msg" : "Failed to update log group"
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="lts_api_0024__en-us_topic_0258246476_section133023312285"><h4 class="sectiontitle">Status Codes</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="lts_api_0024__en-us_topic_0258246476_table5773" frame="border" border="1" rules="all"><thead align="left"><tr id="lts_api_0024__en-us_topic_0258246476_row19311433192816"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="lts_api_0024__en-us_topic_0258246476_p53112331283">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_0024__en-us_topic_0258246476_p103183314280">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="lts_api_0024__en-us_topic_0258246476_row1531533192812"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p33163318284">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p161331933152816">The request has succeeded and the log group has been modified.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="lts_api_0024__en-us_topic_0258246476_row1231183362810"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p1813323382810">400</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p111331933182810">The request is invalid. Modify the request based on the description in <strong id="lts_api_0024__en-us_topic_0258246476_b6203133142812">error_msg</strong> before a retry.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="lts_api_0024__en-us_topic_0258246476_row183123332816"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p15133633132812">401</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p01331933112814">Authentication failed. Check the token and try again.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="lts_api_0024__en-us_topic_0258246476_row17311033152815"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p913363322820">403</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p1213343318282">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_0024__en-us_topic_0258246476_row1231113316288"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p51331339285">500</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p151331433172814">The server has received the request but encountered an internal error.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="lts_api_0024__en-us_topic_0258246476_row7313334284"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="lts_api_0024__en-us_topic_0258246476_p8133163342816">503</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="lts_api_0024__en-us_topic_0258246476_p01331233202816">The requested service is unavailable.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="lts_api_0024__en-us_topic_0258246476_section0133183318280"><h4 class="sectiontitle">Error Codes</h4><p id="lts_api_0024__en-us_topic_0258246476_p2133113342817">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>
|
|
|