forked from docs/doc-exports
Su, Xiaomeng
57a0d535be
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com> Co-authored-by: Su, Xiaomeng <suxiaomeng1@huawei.com> Co-committed-by: Su, Xiaomeng <suxiaomeng1@huawei.com>
179 lines
13 KiB
HTML
179 lines
13 KiB
HTML
<a name="dli_02_0200"></a><a name="dli_02_0200"></a>
|
|
|
|
<h1 class="topictitle1">Modifying the Host Information</h1>
|
|
<div id="body1568259345388"><div class="section" id="dli_02_0200__section13287428103611"><h4 class="sectiontitle">Function</h4><p id="dli_02_0200__p6109426103819">This API is used to modify the host information of a connected datasource. Only full overwriting is supported.</p>
|
|
</div>
|
|
<div class="section" id="dli_02_0200__section52924285361"><h4 class="sectiontitle">URI</h4><ul id="dli_02_0200__ul1547562815364"><li id="dli_02_0200__li1847520284363">URI format<p id="dli_02_0200__p8475152813362"><a name="dli_02_0200__li1847520284363"></a><a name="li1847520284363"></a>PUT /v2.0/{project_id}/datasource/enhanced-connections/{connection_id}</p>
|
|
</li><li id="dli_02_0200__li1047502816366">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0200__table18299172853614" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameters</caption><thead align="left"><tr id="dli_02_0200__row947592853614"><th align="left" class="cellrowborder" valign="top" width="17.89178917891789%" id="mcps1.3.2.2.2.1.2.5.1.1"><p id="dli_02_0200__p1347513282368">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.77137713771377%" id="mcps1.3.2.2.2.1.2.5.1.2"><p id="dli_02_0200__p74757287366">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="12.73127312731273%" id="mcps1.3.2.2.2.1.2.5.1.3"><p id="dli_02_0200__p17794421546">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="55.60556055605561%" id="mcps1.3.2.2.2.1.2.5.1.4"><p id="dli_02_0200__p1475182833610">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_02_0200__row16475152833619"><td class="cellrowborder" valign="top" width="17.89178917891789%" headers="mcps1.3.2.2.2.1.2.5.1.1 "><p id="dli_02_0200__p1547552803615">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.77137713771377%" headers="mcps1.3.2.2.2.1.2.5.1.2 "><p id="dli_02_0200__p19475828123613">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.73127312731273%" headers="mcps1.3.2.2.2.1.2.5.1.3 "><p id="dli_02_0200__p1794527548">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.60556055605561%" headers="mcps1.3.2.2.2.1.2.5.1.4 "><p id="dli_02_0200__p1310472724012">Project ID, which is used for resource isolation. For details about how to obtain its value, see <a href="dli_02_0183.html">Obtaining a Project ID</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_02_0200__row1758412516020"><td class="cellrowborder" valign="top" width="17.89178917891789%" headers="mcps1.3.2.2.2.1.2.5.1.1 "><p id="dli_02_0200__p84192317188">connection_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.77137713771377%" headers="mcps1.3.2.2.2.1.2.5.1.2 "><p id="dli_02_0200__p1941914313180">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.73127312731273%" headers="mcps1.3.2.2.2.1.2.5.1.3 "><p id="dli_02_0200__p197941218546">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.60556055605561%" headers="mcps1.3.2.2.2.1.2.5.1.4 "><p id="dli_02_0200__p94197315183">Connection ID. Identifies the UUID of a datasource connection.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_02_0200__section1831452873613"><h4 class="sectiontitle">Request</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0200__table965315377819" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request parameters</caption><thead align="left"><tr id="dli_02_0200__row3654123717814"><th align="left" class="cellrowborder" valign="top" width="17.89178917891789%" id="mcps1.3.3.2.2.5.1.1"><p id="dli_02_0200__p1265453712813">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.77137713771377%" id="mcps1.3.3.2.2.5.1.2"><p id="dli_02_0200__p9654237585">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="12.49124912491249%" id="mcps1.3.3.2.2.5.1.3"><p id="dli_02_0200__p19937461398">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="55.84558455845584%" id="mcps1.3.3.2.2.5.1.4"><p id="dli_02_0200__p265416379818">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_02_0200__row7654203716810"><td class="cellrowborder" valign="top" width="17.89178917891789%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_02_0200__p15107358183">hosts</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.77137713771377%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_02_0200__p8107558589">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12.49124912491249%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_02_0200__p1828271516112">Array of objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.84558455845584%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_02_0200__p1228216154115">The user-defined host information. A maximum of 20,000 records are supported. For details, see <a href="#dli_02_0200__table6991727151310">hosts request parameters</a>. If this parameter is left blank, all configured host information will be deleted.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="dli_02_0200__table6991727151310"></a><a name="table6991727151310"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0200__table6991727151310" frame="border" border="1" rules="all"><caption><b>Table 3 </b>hosts request parameters</caption><thead align="left"><tr id="dli_02_0200__row159942715132"><th align="left" class="cellrowborder" valign="top" width="16.07%" id="mcps1.3.3.3.2.5.1.1"><p id="dli_02_0200__p1999162711134">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="9.55%" id="mcps1.3.3.3.2.5.1.2"><p id="dli_02_0200__p1610014271138">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16.61%" id="mcps1.3.3.3.2.5.1.3"><p id="dli_02_0200__p101006279131">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.769999999999996%" id="mcps1.3.3.3.2.5.1.4"><p id="dli_02_0200__p1210019278137">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_02_0200__row9100162701310"><td class="cellrowborder" valign="top" width="16.07%" headers="mcps1.3.3.3.2.5.1.1 "><p id="dli_02_0200__p31002272131">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.55%" headers="mcps1.3.3.3.2.5.1.2 "><p id="dli_02_0200__p4100142771318">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.3.3.3.2.5.1.3 "><p id="dli_02_0200__p91001127191314">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.769999999999996%" headers="mcps1.3.3.3.2.5.1.4 "><p id="dli_02_0200__p7100427171315">The user-defined host name. The value can consist of 128 characters, including digits, letters, underscores (_), hyphens (-), and periods (.). It must start with a letter.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_02_0200__row17100192717138"><td class="cellrowborder" valign="top" width="16.07%" headers="mcps1.3.3.3.2.5.1.1 "><p id="dli_02_0200__p19100182711311">ip</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.55%" headers="mcps1.3.3.3.2.5.1.2 "><p id="dli_02_0200__p3100327101315">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.3.3.3.2.5.1.3 "><p id="dli_02_0200__p10100227101313">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.769999999999996%" headers="mcps1.3.3.3.2.5.1.4 "><p id="dli_02_0200__p181004273132">The IPv4 address of the host.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dli_02_0200__section134515287360"><h4 class="sectiontitle">Response</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0200__table8348112818368" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response parameters</caption><thead align="left"><tr id="dli_02_0200__row11478132863610"><th align="left" class="cellrowborder" valign="top" width="15.628437156284372%" id="mcps1.3.4.2.2.4.1.1"><p id="dli_02_0200__p04782028173616">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.5981401859814%" id="mcps1.3.4.2.2.4.1.2"><p id="dli_02_0200__p34781128193612">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="65.77342265773424%" id="mcps1.3.4.2.2.4.1.3"><p id="dli_02_0200__p1347917286364">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_02_0200__row18479182813362"><td class="cellrowborder" valign="top" width="15.628437156284372%" headers="mcps1.3.4.2.2.4.1.1 "><p id="dli_02_0200__p392161273513">is_success</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.5981401859814%" headers="mcps1.3.4.2.2.4.1.2 "><p id="dli_02_0200__p18921161219357">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="65.77342265773424%" headers="mcps1.3.4.2.2.4.1.3 "><p id="dli_02_0200__p12921712163514">Indicates whether the request is successfully executed. Value <strong id="dli_02_0200__b12228112420286">true</strong> indicates that the request is successfully executed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_02_0200__row14946145019340"><td class="cellrowborder" valign="top" width="15.628437156284372%" headers="mcps1.3.4.2.2.4.1.1 "><p id="dli_02_0200__p692141213515">message</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.5981401859814%" headers="mcps1.3.4.2.2.4.1.2 "><p id="dli_02_0200__p6921012133518">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="65.77342265773424%" headers="mcps1.3.4.2.2.4.1.3 "><p id="dli_02_0200__p1921161214351">System prompt. If execution succeeds, the message may be left blank.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dli_02_0200__section1217010661112"><h4 class="sectiontitle">Example Request</h4><p id="dli_02_0200__p18496164910544">Modify the host information of an enhanced datasource connection.</p>
|
|
<pre class="screen" id="dli_02_0200__screen165944614370">{
|
|
"hosts": [
|
|
{
|
|
"ip":"192.168.0.1",
|
|
"name":"ecs-97f8-0001"
|
|
},
|
|
{
|
|
"ip":"192.168.0.2",
|
|
"name":"ecs-97f8-0002"
|
|
}
|
|
]
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="dli_02_0200__section910624615450"><h4 class="sectiontitle">Example Response</h4><pre class="screen" id="dli_02_0200__screen587751511378">{
|
|
"is_success": true,
|
|
"message": ""
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="dli_02_0200__sf39cfd445ad24e9e82754fcb0027179d"><h4 class="sectiontitle">Status Codes</h4><p id="dli_02_0200__a04144ca3a08e4576b386c6a98f43a2ae"><a href="#dli_02_0200__tb12870f1c5f24b27abd55ca24264af36">Table 5</a> describes the status code.</p>
|
|
|
|
<div class="tablenoborder"><a name="dli_02_0200__tb12870f1c5f24b27abd55ca24264af36"></a><a name="tb12870f1c5f24b27abd55ca24264af36"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_02_0200__tb12870f1c5f24b27abd55ca24264af36" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Status codes</caption><thead align="left"><tr id="dli_02_0200__r8d54231f95b14c01a5e55e95f3b2e838"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.7.3.2.3.1.1"><p id="dli_02_0200__ab49d21f312644072a331f43e92baf853">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="70%" id="mcps1.3.7.3.2.3.1.2"><p id="dli_02_0200__aea1d3bd107bb4c499da79a88832d256c">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_02_0200__r211ad4eb571d4d938e5579998723174e"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.2.3.1.1 "><p id="dli_02_0200__a3153e07b3a9749adba92599fe6628fbf">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.7.3.2.3.1.2 "><p id="dli_02_0200__p104431642124811">The modification operations are successful.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_02_0200__row44937531727"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.2.3.1.1 "><p id="dli_02_0200__p184941532219">400</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.7.3.2.3.1.2 "><p id="dli_02_0200__p2049413539219">Request error.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_02_0200__row65331212142411"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.7.3.2.3.1.1 "><p id="dli_02_0200__p5537171216249">500</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.7.3.2.3.1.2 "><p id="dli_02_0200__p953813124249">Internal service error.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dli_02_0200__section13596141025715"><h4 class="sectiontitle">Error Codes</h4><p id="dli_02_0200__p420584425712">If an error occurs when this API is invoked, the system does not return the result similar to the preceding example, but returns the error code and error information. For details, see <a href="dli_02_0056.html">Error Codes</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dli_02_0186.html">APIs Related to Enhanced Datasource Connections</a></div>
|
|
</div>
|
|
</div>
|
|
|