yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
Files
d167e4cc29458fd80ea2e4d84d6df87e142bbfd1
doc-exports/docs/lts/api-ref/UpdateHostGroup.html
liusiying77 fdbbe7547a LTS API 20240130 version. 
Reviewed-by: Bobkova, Natalia <natalia.bobkova@t-systems.com>
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: liusiying77 <liusiying@huawei.com>
Co-committed-by: liusiying77 <liusiying@huawei.com>
2025-03-12 12:37:01 +00:00

385 lines
26 KiB
HTML
Raw Blame History

<a name="UpdateHostGroup"></a><a name="UpdateHostGroup"></a>
<h1 class="topictitle1">Modifying a Host Group</h1>
<div id="body1708331107508"><div class="section" id="UpdateHostGroup__section2586195514319"><h4 class="sectiontitle">Function</h4><p id="UpdateHostGroup__p5586155519311">Modify a host group.</p>
</div>
<div class="section" id="UpdateHostGroup__section165861755123115"><h4 class="sectiontitle">URI</h4><p id="UpdateHostGroup__p7586155573110">PUT /v3/{project_id}/lts/host-group</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateHostGroup__table135871255173114" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path Parameters</caption><thead align="left"><tr id="UpdateHostGroup__row85861255103110"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.1"><p id="UpdateHostGroup__p1958785543111">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.2"><p id="UpdateHostGroup__p12587175513112">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.3"><p id="UpdateHostGroup__p125874556317">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.2.3.2.5.1.4"><p id="UpdateHostGroup__p958775518319">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="UpdateHostGroup__row55861255153117"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="UpdateHostGroup__p458705553116">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="UpdateHostGroup__p75871955203116">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="UpdateHostGroup__p85871055203110">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="UpdateHostGroup__p14587145583115">Project ID. For details about how to obtain a project ID, see <a href="lts_api_0006.html">Obtaining the Project ID, Account ID, Log Group ID, and Log Stream ID</a>.</p>
<p id="UpdateHostGroup__p558725520311">Minimum: <strong id="UpdateHostGroup__b558745513318">1</strong></p>
<p id="UpdateHostGroup__p145876552311">Maximum: <strong id="UpdateHostGroup__b658715516315">64</strong></p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="UpdateHostGroup__section9587185553113"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateHostGroup__HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="UpdateHostGroup__row20587105510319"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="UpdateHostGroup__p1658785514313">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.2"><p id="UpdateHostGroup__p2588165523111">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.3"><p id="UpdateHostGroup__p7588155515318">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.2.5.1.4"><p id="UpdateHostGroup__p17588115513115">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="UpdateHostGroup__row13587165514319"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="UpdateHostGroup__p258845543113">X-Auth-Token</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="UpdateHostGroup__p16588655193114">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="UpdateHostGroup__p15882558319">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="UpdateHostGroup__p9588055103115">User token obtained from IAM. For details about how to obtain a user token, see <a href="lts_api_0004.html">Obtaining a User Token</a>.</p>
<p id="UpdateHostGroup__p3588185513313">Minimum: <strong id="UpdateHostGroup__b16588195512316">1</strong></p>
<p id="UpdateHostGroup__p1658835516319">Maximum: <strong id="UpdateHostGroup__b1958855523119">10000</strong></p>
</td>
</tr>
<tr id="UpdateHostGroup__row1558714551319"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="UpdateHostGroup__p17588175510316">Content-Type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="UpdateHostGroup__p4588175543116">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="UpdateHostGroup__p125881855143117">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="UpdateHostGroup__p85881655193114">Set this parameter to application/json;charset=UTF-8.</p>
<p id="UpdateHostGroup__p135881855183118">Minimum: <strong id="UpdateHostGroup__b358805593118">30</strong></p>
<p id="UpdateHostGroup__p145881559318">Maximum: <strong id="UpdateHostGroup__b1358815553111">30</strong></p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateHostGroup__request_UpdateHostGroupRequestBody" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Request body parameters</caption><thead align="left"><tr id="UpdateHostGroup__row13588455163114"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="UpdateHostGroup__p65891755123114">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="UpdateHostGroup__p1358919553311">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="UpdateHostGroup__p1589655123118">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="UpdateHostGroup__p458917552311">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="UpdateHostGroup__row165881555183114"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="UpdateHostGroup__p558965510310">host_group_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="UpdateHostGroup__p1458995553116">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="UpdateHostGroup__p958911553311">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="UpdateHostGroup__p8589115516315">Host group ID.</p>
<p id="UpdateHostGroup__p1258945511313">Minimum: <strong id="UpdateHostGroup__b13589255113115">36</strong></p>
<p id="UpdateHostGroup__p105895551316">Maximum: <strong id="UpdateHostGroup__b8589145513110">36</strong></p>
</td>
</tr>
<tr id="UpdateHostGroup__row1058865583114"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="UpdateHostGroup__p958913552315">host_group_name</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="UpdateHostGroup__p358905512318">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="UpdateHostGroup__p958905518312">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="UpdateHostGroup__p1058945516316">Host group name. Use only letters, digits, underscores (_), hyphens (-), and periods (.). Do not start with a period or underscore or end with a period.</p>
<p id="UpdateHostGroup__p13589175519316">Minimum: <strong id="UpdateHostGroup__b2589755113117">1</strong></p>
<p id="UpdateHostGroup__p8589155583119">Maximum: <strong id="UpdateHostGroup__b1558915563117">64</strong></p>
</td>
</tr>
<tr id="UpdateHostGroup__row4588155518315"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="UpdateHostGroup__p058917552312">host_id_list</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="UpdateHostGroup__p95891255163116">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="UpdateHostGroup__p135896556314">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="UpdateHostGroup__p1258985520313">Host ID list. The host type must be the same as the host group type.</p>
<p id="UpdateHostGroup__p1558915559313">Minimum: <strong id="UpdateHostGroup__b1658945573117">36</strong></p>
<p id="UpdateHostGroup__p55896555318">Maximum: <strong id="UpdateHostGroup__b1558935573119">36</strong></p>
</td>
</tr>
<tr id="UpdateHostGroup__row175881055163119"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="UpdateHostGroup__p13589195511315">host_group_tag</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="UpdateHostGroup__p13590355163110">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="UpdateHostGroup__p7590105511315">Array of <a href="#UpdateHostGroup__request_HostGroupTag">HostGroupTag</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="UpdateHostGroup__p185907558313">Host group tags. A key must be unique. Up to 20 keys are allowed.</p>
</td>
</tr>
<tr id="UpdateHostGroup__row18588185573115"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="UpdateHostGroup__p2059035518311">labels</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="UpdateHostGroup__p195901455193116">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="UpdateHostGroup__p11590115593119">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="UpdateHostGroup__p759055553116">Host group identifier. This parameter is mandatory when the host group type is <strong id="UpdateHostGroup__b12590115573111">LABEL</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="UpdateHostGroup__request_HostGroupTag"></a><a name="request_HostGroupTag"></a><table cellpadding="4" cellspacing="0" summary="" id="UpdateHostGroup__request_HostGroupTag" frame="border" border="1" rules="all"><caption><b>Table 4 </b>HostGroupTag</caption><thead align="left"><tr id="UpdateHostGroup__row18590195512313"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.1"><p id="UpdateHostGroup__p1059045511316">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.2"><p id="UpdateHostGroup__p1759055519318">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.3"><p id="UpdateHostGroup__p165901055143118">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.4.2.5.1.4"><p id="UpdateHostGroup__p1759095583115">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="UpdateHostGroup__row959085514314"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.1 "><p id="UpdateHostGroup__p17590195553113">key</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.2 "><p id="UpdateHostGroup__p25911455173116">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="UpdateHostGroup__p6591145593119">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.4.2.5.1.4 "><p id="UpdateHostGroup__p15591195553116">Tag key. Use only UTF-8 letters, digits, spaces, and the following characters: .:=+-@. Do not start with an underscore (). Max 128 characters are allowed.</p>
</td>
</tr>
<tr id="UpdateHostGroup__row259065512313"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.1 "><p id="UpdateHostGroup__p10591155514318">value</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.2 "><p id="UpdateHostGroup__p15591125593114">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="UpdateHostGroup__p35911155153117">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.4.2.5.1.4 "><p id="UpdateHostGroup__p1459125573110">Tag value. Use only UTF-8 letters, digits, spaces, and the following characters: _.:/=+-@. Max 255 characters are allowed.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="UpdateHostGroup__section1759105511315"><h4 class="sectiontitle">Response Parameters</h4><p id="UpdateHostGroup__p1459135519314"><strong id="UpdateHostGroup__b65914554317">Status code: 200</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateHostGroup__response_HostGroupResponBody200" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Response body parameters</caption><thead align="left"><tr id="UpdateHostGroup__row13591145563117"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.3.2.4.1.1"><p id="UpdateHostGroup__p2059195593113">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.3.2.4.1.2"><p id="UpdateHostGroup__p75928554319">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.3.2.4.1.3"><p id="UpdateHostGroup__p165922557314">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="UpdateHostGroup__row95911655183113"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpdateHostGroup__p5592115533119">host_group_id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpdateHostGroup__p1459214554318">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpdateHostGroup__p175921455183111">Host group ID.</p>
</td>
</tr>
<tr id="UpdateHostGroup__row559117556313"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpdateHostGroup__p9592185513115">host_group_name</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpdateHostGroup__p359225520316">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpdateHostGroup__p2592135510316">Host group name.</p>
</td>
</tr>
<tr id="UpdateHostGroup__row195911855123118"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpdateHostGroup__p1759235512319">host_group_type</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpdateHostGroup__p125921055193113">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpdateHostGroup__p17592125519318">Host group type.</p>
</td>
</tr>
<tr id="UpdateHostGroup__row19591135513119"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpdateHostGroup__p15921755113110">host_id_list</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpdateHostGroup__p11592355193118">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpdateHostGroup__p55924559318">Host ID list.</p>
</td>
</tr>
<tr id="UpdateHostGroup__row195916555312"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpdateHostGroup__p95921355153120">host_group_tag</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpdateHostGroup__p15592115533117">Array of <a href="#UpdateHostGroup__response_HostGroupTag">HostGroupTag</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpdateHostGroup__p1859212557314">Tag information.</p>
</td>
</tr>
<tr id="UpdateHostGroup__row11591955103116"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpdateHostGroup__p6592105510313">create_time</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpdateHostGroup__p15921855183120">Long</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpdateHostGroup__p759225513111">Creation time.</p>
</td>
</tr>
<tr id="UpdateHostGroup__row25911755143115"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpdateHostGroup__p2059213553313">update_time</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpdateHostGroup__p13592145513112">Long</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpdateHostGroup__p0593135513117">Update time.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="UpdateHostGroup__response_HostGroupTag"></a><a name="response_HostGroupTag"></a><table cellpadding="4" cellspacing="0" summary="" id="UpdateHostGroup__response_HostGroupTag" frame="border" border="1" rules="all"><caption><b>Table 6 </b>HostGroupTag</caption><thead align="left"><tr id="UpdateHostGroup__row55935556313"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.4.2.4.1.1"><p id="UpdateHostGroup__p759317551318">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.4.2.4.1.2"><p id="UpdateHostGroup__p1059355513314">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.4.2.4.1.3"><p id="UpdateHostGroup__p15593165516318">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="UpdateHostGroup__row9593155173119"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="UpdateHostGroup__p10593455183115">key</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.2 "><p id="UpdateHostGroup__p15593655173120">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.4.2.4.1.3 "><p id="UpdateHostGroup__p12593655123111">Tag key.</p>
</td>
</tr>
<tr id="UpdateHostGroup__row559385513112"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="UpdateHostGroup__p175931554312">value</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.2 "><p id="UpdateHostGroup__p1359315551314">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.4.2.4.1.3 "><p id="UpdateHostGroup__p15593205593118">Tag value.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="UpdateHostGroup__p165938556318"><strong id="UpdateHostGroup__b1659335519311">Status code: 400</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateHostGroup__response_ErrorResultInfo400" frame="border" border="1" rules="all"><caption><b>Table 7 </b>Response body parameters</caption><thead align="left"><tr id="UpdateHostGroup__row9593135512313"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.6.2.4.1.1"><p id="UpdateHostGroup__p1759445523112">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.6.2.4.1.2"><p id="UpdateHostGroup__p6594175573114">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.6.2.4.1.3"><p id="UpdateHostGroup__p185947559316">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="UpdateHostGroup__row4593175516313"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.6.2.4.1.1 "><p id="UpdateHostGroup__p1659445517311">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.6.2.4.1.2 "><p id="UpdateHostGroup__p2594195583118">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.6.2.4.1.3 "><p id="UpdateHostGroup__p165941855113120">Error code</p>
</td>
</tr>
<tr id="UpdateHostGroup__row959325583119"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.6.2.4.1.1 "><p id="UpdateHostGroup__p18594155512313">error_msg</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.6.2.4.1.2 "><p id="UpdateHostGroup__p85942554318">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.6.2.4.1.3 "><p id="UpdateHostGroup__p85943556314">Error description</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="UpdateHostGroup__p155941455163110"><strong id="UpdateHostGroup__b125941655183113">Status code: 500</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateHostGroup__table1859485593115" frame="border" border="1" rules="all"><caption><b>Table 8 </b>Response body parameters</caption><thead align="left"><tr id="UpdateHostGroup__row2594125573117"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.8.2.4.1.1"><p id="UpdateHostGroup__p859515551312">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.8.2.4.1.2"><p id="UpdateHostGroup__p2595195573116">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.8.2.4.1.3"><p id="UpdateHostGroup__p25951755123110">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="UpdateHostGroup__row7594205516317"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.8.2.4.1.1 "><p id="UpdateHostGroup__p9595185510310">error_code</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.8.2.4.1.2 "><p id="UpdateHostGroup__p19595175543116">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.8.2.4.1.3 "><p id="UpdateHostGroup__p13595135593119">Error code</p>
</td>
</tr>
<tr id="UpdateHostGroup__row20594175543119"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.8.2.4.1.1 "><p id="UpdateHostGroup__p20595125543111">error_msg</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.8.2.4.1.2 "><p id="UpdateHostGroup__p11595125573114">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.8.2.4.1.3 "><p id="UpdateHostGroup__p11595115511313">Error description</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="UpdateHostGroup__section659510553318"><h4 class="sectiontitle">Example Requests</h4><p id="UpdateHostGroup__p3595455153120">Update a host group. Parameter host_group_id is mandatory.</p>
<pre class="screen" id="UpdateHostGroup__screen1659585573115">PUT https://{endpoint}/v3/{project_id}/lts/host-group
{
"host_group_id" : "xxxxxx",
"host_group_name" : "qweqwe",
"host_id_list" : [ "host_id_1", "host_id_2" ],
"host_group_tag" : [ {
"key" : "xxx",
"value" : "xxx"
} ]
}</pre>
</div>
<div class="section" id="UpdateHostGroup__section1359515553114"><h4 class="sectiontitle">Example Responses</h4><p id="UpdateHostGroup__p13596175533116"><strong id="UpdateHostGroup__b65961455103112">Status code: 200</strong></p>
<p id="UpdateHostGroup__p1859605503117">The host group is modified.</p>
<pre class="screen" id="UpdateHostGroup__screen1259615553115">{
"host_group_id" : "xxxxxx",
"host_group_name" : "qweqwe",
"host_group_type" : "linux",
"host_id_list" : [ "host_id_1", "host_id_2" ],
"host_group_tag" : [ {
"key" : "xxx",
"value" : "xxx"
} ],
"create_time" : 16351494332,
"update_time" : 16351494332
}</pre>
<p id="UpdateHostGroup__p959618551311"><strong id="UpdateHostGroup__b1596055123118">Status code: 400</strong></p>
<p id="UpdateHostGroup__p35963557319">Invalid request. Modify the request based on the description in <strong id="UpdateHostGroup__b1359619555314">error_msg</strong> before a retry.</p>
<pre class="screen" id="UpdateHostGroup__screen2596205514317">{
"error_code" : "LTS.1807",
"error_msg" : "Invalid host group id"
}</pre>
<p id="UpdateHostGroup__p1159613559319"><strong id="UpdateHostGroup__b2596555143120">Status code: 500</strong></p>
<p id="UpdateHostGroup__p75968552313">The server has received the request but encountered an internal error.</p>
<pre class="screen" id="UpdateHostGroup__screen45968556312">{
"error_code" : "LTS.0010",
"error_msg" : "Internal Server Error"
}</pre>
</div>
<div class="section" id="UpdateHostGroup__section859685517311"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateHostGroup__status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="UpdateHostGroup__row19597055143116"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="UpdateHostGroup__p16597165533117">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.2.1.3.1.2"><p id="UpdateHostGroup__p16597155163113">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="UpdateHostGroup__row259715553110"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="UpdateHostGroup__p059745515312">200</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="UpdateHostGroup__p20597355123114">The host group is modified.</p>
</td>
</tr>
<tr id="UpdateHostGroup__row5597145593110"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="UpdateHostGroup__p20597195573120">400</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="UpdateHostGroup__p4597175512314">Invalid request. Modify the request based on the description in <strong id="UpdateHostGroup__b7597105510315">error_msg</strong> before a retry.</p>
</td>
</tr>
<tr id="UpdateHostGroup__row7597195513316"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="UpdateHostGroup__p3597165563119">500</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="UpdateHostGroup__p1459715523114">The server has received the request but encountered an internal error.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="UpdateHostGroup__section175978553316"><h4 class="sectiontitle">Error Codes</h4><p id="UpdateHostGroup__p115974557313">See <a href="ErrorCode.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="lts_api_1015.html">Host Group Management</a></div>
</div>
</div>
View Git Blame Copy Permalink