yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
Files
03e77f3e5b0080047fdcb72efdfd3333dd3bcf92
doc-exports/docs/bms/api-ref/en-us_topic_0000002340222804.html
wanghuijuan738 69783f9e3e bms api 20241225 version 
Reviewed-by: Pristromskaia, Margarita <margarita.pristromskaia@t-systems.com>
Co-authored-by: wanghuijuan738 <wanghuijuan738@huawei.com>
Co-committed-by: wanghuijuan738 <wanghuijuan738@huawei.com>
2025-07-16 09:58:55 +00:00

144 lines
16 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000002340222804"></a><a name="EN-US_TOPIC_0000002340222804"></a>
<h1 class="topictitle1">Querying the Specified IP Address of a <span id="en-us_topic_0053158662_text68606276113">BMS</span><span id="en-us_topic_0053158662_text1633718395557"></span><span id="en-us_topic_0053158662_text13715133210508"></span></h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_section53922917165259"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p5680132165259">This API is used to query the specified IP address of a <span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_text1240114985511">BMS</span><span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_text444753132119"></span><span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_text12158144143813"></span> based on the network name.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_section51121191165259"><h4 class="sectiontitle">URI</h4><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p63141473165259">GET /v2.1/{project_id}/servers/{server_id}/ips/{vpc_id}</p>
<p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p17943142984017"><a href="#EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_table6532183934016">Table 1</a> lists the parameters.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_table6532183934016"></a><a name="en-us_topic_0053158662_table6532183934016"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_table6532183934016" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_row1753243915409"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.4.2.4.1.1"><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p58268319165259">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.4.2.4.1.2"><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p22113407165259">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.4.2.4.1.3"><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p46355523165259">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_row253363924014"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.4.2.4.1.1 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p1217433165259">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.4.2.4.1.2 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p31503226165259">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.4.2.4.1.3 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p1624545165259">Specifies the project ID.</p>
<p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p9141450142010">For how to obtain the project ID, see <a href="https://docs.otc.t-systems.com/en-us/api/apiug/apig-en-api-180328009.html" target="_blank" rel="noopener noreferrer">Obtaining Required Information</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_row45331439194017"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.4.2.4.1.1 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p43442641165259">server_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.4.2.4.1.2 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p29193009165259">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.4.2.4.1.3 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p15823538165259">Specifies the <span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_text5570105012265">BMS</span><span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_text1257155072616"></span><span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_text155711950202613"></span> ID.</p>
<p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p29791113277">You can obtain the BMS ID from the <span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_en-us_topic_0113746489_text895314101319">BMS</span><span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_en-us_topic_0113746489_text1695320481317"></span> console or by calling the API <a href="en-us_topic_0000002340063012.html">Querying BMSs</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_row853312391409"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.4.2.4.1.1 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p39194593144447">vpc_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.4.2.4.1.2 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p20645494144447">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.4.2.4.1.3 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p37275314377">Specifies the ID of the VPC where the <span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_text61205995512">BMS</span><span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_text71859185516"></span><span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_text19650311391"></span> is located.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_section8194118165259"><h4 class="sectiontitle">Request Parameters</h4><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p35936184516">None</p>
</div>
<div class="section" id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_section634619153714"><h4 class="sectiontitle">Example Request</h4><div class="p" id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p3701615185814">Querying the IP address of a <span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_text266731472811">BMS</span><span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_text7802430369"></span><span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_text549771912419"></span> (ID: 95bf2490-5428-432c-ad9b-5e3406f869dd) in a specified VPC<div class="codecoloring" codetype="Java" id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_screen196411597164"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="n">GET</span><span class="w"> </span><span class="n">https</span><span class="p">:</span><span class="c1">//{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/ips/{vpc_id}</span>
</pre></div></td></tr></table></div>
</div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_section58140617165259"><h4 class="sectiontitle">Response Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_table56891490143956" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_row33903869143956"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.5.2.1.4.1.1"><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p59978491115233">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="23.369999999999997%" id="mcps1.3.5.2.1.4.1.2"><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p26419641115233">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.629999999999995%" id="mcps1.3.5.2.1.4.1.3"><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p64181866115233">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_row178261036111713"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.2.1.4.1.1 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p198876476174">Vpc_id</p>
</td>
<td class="cellrowborder" valign="top" width="23.369999999999997%" headers="mcps1.3.5.2.1.4.1.2 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p188714714172">Array of <a href="#EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_table22651992144025">address</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="51.629999999999995%" headers="mcps1.3.5.2.1.4.1.3 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p520445315187">Specifies the VPC used by the <span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_text1246211519504">BMS</span><span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_text1740611559503"></span>.</p>
<p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p139131765312"><strong id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_b1067184102718">Vpc_id</strong> indicates the ID of the VPC used by the <span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_text867124132712">BMS</span><span id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_text136754192711"></span>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_table22651992144025"></a><a name="en-us_topic_0053158662_table22651992144025"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_table22651992144025" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Network parameter structure description</caption><thead align="left"><tr id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_row15576094144025"><th align="left" class="cellrowborder" valign="top" width="25.040000000000003%" id="mcps1.3.5.3.2.4.1.1"><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p18294205151113">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="22.96%" id="mcps1.3.5.3.2.4.1.2"><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p52953511116">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="52%" id="mcps1.3.5.3.2.4.1.3"><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p1329719531112">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_row1498246144025"><td class="cellrowborder" valign="top" width="25.040000000000003%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p54249095144025">version</p>
</td>
<td class="cellrowborder" valign="top" width="22.96%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p32100540144025">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="52%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p16571197144025">Specifies the IP address version. The value can be:</p>
<ul id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_ul95681331131713"><li id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_en-us_topic_0053158696_li15758161811618"><strong id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_en-us_topic_0053158696_b9297191175814">4</strong>: IPv4 address</li><li id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_en-us_topic_0053158696_li20821181331619"><strong id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_en-us_topic_0053158696_b17364111518584">6</strong>: IPv6 address</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_row14923052144025"><td class="cellrowborder" valign="top" width="25.040000000000003%" headers="mcps1.3.5.3.2.4.1.1 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p807709144025">addr</p>
</td>
<td class="cellrowborder" valign="top" width="22.96%" headers="mcps1.3.5.3.2.4.1.2 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p65424470144025">String</p>
</td>
<td class="cellrowborder" valign="top" width="52%" headers="mcps1.3.5.3.2.4.1.3 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_p39086769144025">Specifies the IP address.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_section1105112513714"><h4 class="sectiontitle">Example Response</h4><div class="codecoloring" codetype="Java" id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_screen14793741143113"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span>
<span class="normal">6</span>
<span class="normal">7</span>
<span class="normal">8</span></pre></div></td><td class="code"><div><pre><span></span><span class="p">{</span>
<span class="w"> </span><span class="s">&quot;5849fdf1-9d79-4589-80c2-fe557990c417&quot;</span><span class="p">:</span><span class="w"> </span><span class="o">[</span>
<span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="s">&quot;version&quot;</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span>
<span class="w"> </span><span class="s">&quot;addr&quot;</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;192.168.1.159&quot;</span>
<span class="w"> </span><span class="p">}</span>
<span class="w"> </span><span class="o">]</span>
<span class="p">}</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_section7610951"><h4 class="sectiontitle">Returned Values</h4><div class="p" id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_en-us_topic_0106040941_p193201622141412">Normal values
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_en-us_topic_0106040941_table753804619176" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_en-us_topic_0106040941_row10735134615172"><th align="left" class="cellrowborder" valign="top" width="42.42%" id="mcps1.3.7.2.1.1.3.1.1"><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_en-us_topic_0106040941_p19735204616177">Returned Values</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="57.58%" id="mcps1.3.7.2.1.1.3.1.2"><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_en-us_topic_0106040941_p207355465176">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_en-us_topic_0106040941_row1473514621713"><td class="cellrowborder" valign="top" width="42.42%" headers="mcps1.3.7.2.1.1.3.1.1 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_en-us_topic_0106040941_p13735144611178">200</p>
</td>
<td class="cellrowborder" valign="top" width="57.58%" headers="mcps1.3.7.2.1.1.3.1.2 "><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_en-us_topic_0106040941_p207351246161711">The request has been successfully processed.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_en-us_topic_0106040941_p47633965">For details about other returned values, see <a href="en-us_topic_0053158690.html">Status Codes</a>.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_section14752650154917"><h4 class="sectiontitle">Error Codes</h4><p id="EN-US_TOPIC_0000002340222804__en-us_topic_0053158662_en-us_topic_0106040941_p10243161417491">See <a href="en-us_topic_0107541808.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0000002374101025.html">BMS IP Address Query (OpenStack Nova APIs)</a></div>
</div>
</div>
View Git Blame Copy Permalink