forked from docs/doc-exports
Reviewed-by: Pristromskaia, Margarita <margarita.pristromskaia@t-systems.com> Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com> Co-authored-by: Zaoxu, Li <lizaoxu@huawei.com> Co-committed-by: Zaoxu, Li <lizaoxu@huawei.com>
350 lines
27 KiB
HTML
350 lines
27 KiB
HTML
<a name="deh_02_0022"></a><a name="deh_02_0022"></a>
|
|
|
|
<h1 class="topictitle1">Querying ECSs on a DeH</h1>
|
|
<div id="body1512563929533"><div class="section" id="deh_02_0022__section34213098"><h4 class="sectiontitle">Function</h4><p id="deh_02_0022__p30516772">This API is used to query information about deployed ECSs on a DeH.</p>
|
|
</div>
|
|
<div class="section" id="deh_02_0022__section39482434"><h4 class="sectiontitle">URI</h4><p id="deh_02_0022__p59525213239">GET /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id}/servers</p>
|
|
<p id="deh_02_0022__p04449354231"><a href="#deh_02_0022__table572214121015">Table 1</a> describes the parameters.</p>
|
|
|
|
<div class="tablenoborder"><a name="deh_02_0022__table572214121015"></a><a name="table572214121015"></a><table cellpadding="4" cellspacing="0" summary="" id="deh_02_0022__table572214121015" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters description</caption><thead align="left"><tr id="deh_02_0022__row572516410109"><th align="left" class="cellrowborder" valign="top" width="21.23787621237876%" id="mcps1.3.2.4.2.5.1.1"><p id="deh_02_0022__p107252049107"><strong id="deh_02_0022__b1384105117371">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="23.44765523447655%" id="mcps1.3.2.4.2.5.1.2"><p id="deh_02_0022__p726975522919"><strong id="deh_02_0022__b45169521371">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="24.48755124487551%" id="mcps1.3.2.4.2.5.1.3"><p id="deh_02_0022__p072564201017"><strong id="deh_02_0022__b19376153153714">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="30.826917308269174%" id="mcps1.3.2.4.2.5.1.4"><p id="deh_02_0022__p47253421017"><strong id="deh_02_0022__b1465915423717">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="deh_02_0022__row107256481017"><td class="cellrowborder" valign="top" width="21.23787621237876%" headers="mcps1.3.2.4.2.5.1.1 "><p id="deh_02_0022__p1872514451016">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="23.44765523447655%" headers="mcps1.3.2.4.2.5.1.2 "><p id="deh_02_0022__p12269175511291">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="24.48755124487551%" headers="mcps1.3.2.4.2.5.1.3 "><p id="deh_02_0022__p147251646108">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="30.826917308269174%" headers="mcps1.3.2.4.2.5.1.4 "><p id="deh_02_0022__p6725747104">Specifies the project ID.</p>
|
|
<p id="deh_02_0022__p7376194915119">For details about 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="deh_02_0022__row184436404555"><td class="cellrowborder" valign="top" width="21.23787621237876%" headers="mcps1.3.2.4.2.5.1.1 "><p id="deh_02_0022__p164455404556">dedicated_host_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="23.44765523447655%" headers="mcps1.3.2.4.2.5.1.2 "><p id="deh_02_0022__p29241051175512">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="24.48755124487551%" headers="mcps1.3.2.4.2.5.1.3 "><p id="deh_02_0022__p1592535185519">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="30.826917308269174%" headers="mcps1.3.2.4.2.5.1.4 "><p id="deh_02_0022__p1544524011550">Specifies the DeH ID.</p>
|
|
<p id="deh_02_0022__p858154817367">You can obtain the value from the DeH console or using the API in <a href="deh_02_0020.html">Querying DeHs</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="deh_02_0022__section60100823"><h4 class="sectiontitle">Request</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="deh_02_0022__table18900131133217" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request parameters</caption><thead align="left"><tr id="deh_02_0022__row1490010111322"><th align="left" class="cellrowborder" valign="top" width="16.89%" id="mcps1.3.3.2.2.6.1.1"><p id="deh_02_0022__p19198201311324"><strong id="deh_02_0022__b10668203213382">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15.629999999999999%" id="mcps1.3.3.2.2.6.1.2"><p id="deh_02_0022__p1198181311323"><strong id="deh_02_0022__b14694733183813">In</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15.27%" id="mcps1.3.3.2.2.6.1.3"><p id="deh_02_0022__p719881343216"><strong id="deh_02_0022__b775353410384">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.84%" id="mcps1.3.3.2.2.6.1.4"><p id="deh_02_0022__p51981138327"><strong id="deh_02_0022__b1160996956">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="38.37%" id="mcps1.3.3.2.2.6.1.5"><p id="deh_02_0022__p819916134329"><strong id="deh_02_0022__b19418183673813">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="deh_02_0022__row109009111326"><td class="cellrowborder" valign="top" width="16.89%" headers="mcps1.3.3.2.2.6.1.1 "><p id="deh_02_0022__p171997138323">limit</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.629999999999999%" headers="mcps1.3.3.2.2.6.1.2 "><p id="deh_02_0022__p11199121343220">query</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.27%" headers="mcps1.3.3.2.2.6.1.3 "><p id="deh_02_0022__p7199313113219">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.84%" headers="mcps1.3.3.2.2.6.1.4 "><p id="deh_02_0022__p9199181373213">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="38.37%" headers="mcps1.3.3.2.2.6.1.5 "><p id="deh_02_0022__p1199913183220">Specifies the number of records displayed per page.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_02_0022__row490114117328"><td class="cellrowborder" valign="top" width="16.89%" headers="mcps1.3.3.2.2.6.1.1 "><p id="deh_02_0022__p191991113123218">marker</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.629999999999999%" headers="mcps1.3.3.2.2.6.1.2 "><p id="deh_02_0022__p219981383214">query</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.27%" headers="mcps1.3.3.2.2.6.1.3 "><p id="deh_02_0022__p11199111311326">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.84%" headers="mcps1.3.3.2.2.6.1.4 "><p id="deh_02_0022__p101998131326">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="38.37%" headers="mcps1.3.3.2.2.6.1.5 "><p id="deh_02_0022__p91997135323">Specifies the ID of the last record on the previous page. If the <strong id="deh_02_0022__b5191173710123">marker</strong> value is invalid, status code 400 is returned.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="deh_02_0022__section4036497"><h4 class="sectiontitle">Response</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="deh_02_0022__table159571291711" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Response parameters</caption><thead align="left"><tr id="deh_02_0022__row59571329172"><th align="left" class="cellrowborder" valign="top" width="20.04%" id="mcps1.3.4.2.2.5.1.1"><p id="deh_02_0022__p995612241712"><strong id="deh_02_0022__b1893867141310">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.02%" id="mcps1.3.4.2.2.5.1.2"><p id="deh_02_0022__p209578217179"><strong id="deh_02_0022__b52413901320">In</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.11%" id="mcps1.3.4.2.2.5.1.3"><p id="deh_02_0022__p795711231719"><strong id="deh_02_0022__b5621110101318">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="37.830000000000005%" id="mcps1.3.4.2.2.5.1.4"><p id="deh_02_0022__p1295722191715"><strong id="deh_02_0022__b446881121312">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="deh_02_0022__row1957622174"><td class="cellrowborder" valign="top" width="20.04%" headers="mcps1.3.4.2.2.5.1.1 "><p id="deh_02_0022__p129575231710">servers</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.02%" headers="mcps1.3.4.2.2.5.1.2 "><p id="deh_02_0022__p29571623177">body</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.11%" headers="mcps1.3.4.2.2.5.1.3 "><p id="deh_02_0022__p1295718215176">Array of objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="37.830000000000005%" headers="mcps1.3.4.2.2.5.1.4 "><p id="deh_02_0022__p695714210177">Specifies the server object. For details, see <a href="#deh_02_0022__table1296218281715">Table 4</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="deh_02_0022__table1296218281715"></a><a name="table1296218281715"></a><table cellpadding="4" cellspacing="0" summary="" id="deh_02_0022__table1296218281715" frame="border" border="1" rules="all"><caption><b>Table 4 </b><strong id="deh_02_0022__b97621859113720">servers</strong> field description</caption><thead align="left"><tr id="deh_02_0022__row159588215173"><th align="left" class="cellrowborder" valign="top" width="17.97179717971797%" id="mcps1.3.4.3.2.4.1.1"><p id="deh_02_0022__p8957132101711"><strong id="deh_02_0022__b179991859123815">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.83218321832183%" id="mcps1.3.4.3.2.4.1.2"><p id="deh_02_0022__p19571624175"><strong id="deh_02_0022__b1498116513018">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="60.196019601960195%" id="mcps1.3.4.3.2.4.1.3"><p id="deh_02_0022__p995719251717"><strong id="deh_02_0022__b236410713016">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="deh_02_0022__row2095816210178"><td class="cellrowborder" valign="top" width="17.97179717971797%" headers="mcps1.3.4.3.2.4.1.1 "><p id="deh_02_0022__p195817281712">addresses</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.83218321832183%" headers="mcps1.3.4.3.2.4.1.2 "><p id="deh_02_0022__p295872101719">Map<String, Object></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60.196019601960195%" headers="mcps1.3.4.3.2.4.1.3 "><p id="deh_02_0022__p1126864317535">Specifies the network addresses of an ECS.</p>
|
|
<p id="deh_02_0022__p13268843195316">The structure is Map<String, Object>.</p>
|
|
<ul id="deh_02_0022__ul134676182517"><li id="deh_02_0022__li194671618195115">The key indicates the VPC subnet ID.</li><li id="deh_02_0022__li17467918195110">The value indicates the network attributes specified in <a href="#deh_02_0022__table08001321809">Table 5</a>.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_02_0022__row3960182161716"><td class="cellrowborder" valign="top" width="17.97179717971797%" headers="mcps1.3.4.3.2.4.1.1 "><p id="deh_02_0022__p1495982101710">created</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.83218321832183%" headers="mcps1.3.4.3.2.4.1.2 "><p id="deh_02_0022__p29607210176">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60.196019601960195%" headers="mcps1.3.4.3.2.4.1.3 "><p id="deh_02_0022__p196018214172">Specifies the time when the ECS was created.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_02_0022__row149601122172"><td class="cellrowborder" valign="top" width="17.97179717971797%" headers="mcps1.3.4.3.2.4.1.1 "><p id="deh_02_0022__p2096017241710">flavor</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.83218321832183%" headers="mcps1.3.4.3.2.4.1.2 "><p id="deh_02_0022__p12960182121716">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60.196019601960195%" headers="mcps1.3.4.3.2.4.1.3 "><p id="deh_02_0022__p19606231716">Specifies the ECS flavor. For details, see <a href="#deh_02_0022__table13112134716015">Table 6</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_02_0022__row1496019231710"><td class="cellrowborder" valign="top" width="17.97179717971797%" headers="mcps1.3.4.3.2.4.1.1 "><p id="deh_02_0022__p1496022181717">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.83218321832183%" headers="mcps1.3.4.3.2.4.1.2 "><p id="deh_02_0022__p4960323173">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60.196019601960195%" headers="mcps1.3.4.3.2.4.1.3 "><p id="deh_02_0022__p6960172191711">Specifies the ECS ID in UUID format.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_02_0022__row29611322174"><td class="cellrowborder" valign="top" width="17.97179717971797%" headers="mcps1.3.4.3.2.4.1.1 "><p id="deh_02_0022__p1596015212172">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.83218321832183%" headers="mcps1.3.4.3.2.4.1.2 "><p id="deh_02_0022__p1096052181712">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60.196019601960195%" headers="mcps1.3.4.3.2.4.1.3 "><p id="deh_02_0022__p13960921174">Specifies the ECS name.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_02_0022__row2096119220176"><td class="cellrowborder" valign="top" width="17.97179717971797%" headers="mcps1.3.4.3.2.4.1.1 "><p id="deh_02_0022__p29611127173">status</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.83218321832183%" headers="mcps1.3.4.3.2.4.1.2 "><p id="deh_02_0022__p129616215179">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60.196019601960195%" headers="mcps1.3.4.3.2.4.1.3 "><p id="deh_02_0022__p149611329175">Specifies the ECS status.</p>
|
|
<p id="deh_02_0022__p59611322174">Options:</p>
|
|
<p id="deh_02_0022__p189611211713"><strong id="deh_02_0022__b45471440141818">ACTIVE</strong>, <strong id="deh_02_0022__b11548640121810">BUILD</strong>, <strong id="deh_02_0022__b1854924061820">DELETED</strong>, <strong id="deh_02_0022__b15552240121819">ERROR</strong>, <strong id="deh_02_0022__b155531440101814">HARD_REBOOT</strong>, <strong id="deh_02_0022__b355413405185">MIGRATING</strong>, <strong id="deh_02_0022__b9555174011188">PASSWORD</strong>, <strong id="deh_02_0022__b755654061816">PAUSED</strong>, <strong id="deh_02_0022__b185571140191819">REBOOT</strong>, <strong id="deh_02_0022__b1155864071814">REBUILD</strong>, <strong id="deh_02_0022__b16559144011183">RESIZE</strong>, <strong id="deh_02_0022__b856014051812">REVERT_RESIZE</strong>, <strong id="deh_02_0022__b256184081816">SHUTOFF</strong>, <strong id="deh_02_0022__b856219409187">SHELVED</strong>, <strong id="deh_02_0022__b6563184071811">SHELVED_OFFLOADED</strong>, <strong id="deh_02_0022__b95641940141820">SOFT_DELETED</strong>, <strong id="deh_02_0022__b65652401188">SUSPENDED</strong>, and <strong id="deh_02_0022__b115661403187">VERIFY_RESIZE</strong></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_02_0022__row20961162191715"><td class="cellrowborder" valign="top" width="17.97179717971797%" headers="mcps1.3.4.3.2.4.1.1 "><p id="deh_02_0022__p29619216178">tenant_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.83218321832183%" headers="mcps1.3.4.3.2.4.1.2 "><p id="deh_02_0022__p996111219172">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60.196019601960195%" headers="mcps1.3.4.3.2.4.1.3 "><p id="deh_02_0022__p19611220173">Specifies the ECS tenant ID in UUID format.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_02_0022__row496120219178"><td class="cellrowborder" valign="top" width="17.97179717971797%" headers="mcps1.3.4.3.2.4.1.1 "><p id="deh_02_0022__p69611291710">updated</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.83218321832183%" headers="mcps1.3.4.3.2.4.1.2 "><p id="deh_02_0022__p1796116214174">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60.196019601960195%" headers="mcps1.3.4.3.2.4.1.3 "><p id="deh_02_0022__p169611829179">Specifies the time when the ECS was updated last time.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_02_0022__row119612211711"><td class="cellrowborder" valign="top" width="17.97179717971797%" headers="mcps1.3.4.3.2.4.1.1 "><p id="deh_02_0022__p179616291716">user_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.83218321832183%" headers="mcps1.3.4.3.2.4.1.2 "><p id="deh_02_0022__p2961132131717">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60.196019601960195%" headers="mcps1.3.4.3.2.4.1.3 "><p id="deh_02_0022__p89612291711">Specifies the ID of the user who has created the ECS. The value is in UUID format.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_02_0022__row69621524178"><td class="cellrowborder" valign="top" width="17.97179717971797%" headers="mcps1.3.4.3.2.4.1.1 "><p id="deh_02_0022__p796232101717">task_state</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.83218321832183%" headers="mcps1.3.4.3.2.4.1.2 "><p id="deh_02_0022__p896213241711">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60.196019601960195%" headers="mcps1.3.4.3.2.4.1.3 "><p id="deh_02_0022__p196202141710">Specifies the ECS task status.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_02_0022__row79623220176"><td class="cellrowborder" valign="top" width="17.97179717971797%" headers="mcps1.3.4.3.2.4.1.1 "><p id="deh_02_0022__p1296217241712">image</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.83218321832183%" headers="mcps1.3.4.3.2.4.1.2 "><p id="deh_02_0022__p6962182181714">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60.196019601960195%" headers="mcps1.3.4.3.2.4.1.3 "><p id="deh_02_0022__p1296222191714">Specifies the ECS image. For details, see <a href="#deh_02_0022__table92838016115">Table 7</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_02_0022__row149623218170"><td class="cellrowborder" valign="top" width="17.97179717971797%" headers="mcps1.3.4.3.2.4.1.1 "><p id="deh_02_0022__p1996216271713">metadata</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.83218321832183%" headers="mcps1.3.4.3.2.4.1.2 "><p id="deh_02_0022__p19962162111720">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60.196019601960195%" headers="mcps1.3.4.3.2.4.1.3 "><p id="deh_02_0022__p19962323177">Specifies the ECS metadata. For details, see <a href="#deh_02_0022__table74181471712">Table 8</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="deh_02_0022__table08001321809"></a><a name="table08001321809"></a><table cellpadding="4" cellspacing="0" summary="" id="deh_02_0022__table08001321809" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Data structure of the network to which an ECS accesses</caption><thead align="left"><tr id="deh_02_0022__row9802152119018"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.4.2.4.1.1"><p id="deh_02_0022__p52754665210"><strong id="deh_02_0022__b1698674418183">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.4.2.4.1.2"><p id="deh_02_0022__p6271468526"><strong id="deh_02_0022__b9204222">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.4.2.4.1.3"><p id="deh_02_0022__p727144625212"><strong id="deh_02_0022__b166671440133518">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="deh_02_0022__row1380213219015"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.4.2.4.1.1 "><p id="deh_02_0022__p14285469521">addr</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.4.2.4.1.2 "><p id="deh_02_0022__p17281146195218">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.4.2.4.1.3 "><p id="deh_02_0022__p22894645218">Specifies the IP address.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_02_0022__row1977712338019"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.4.2.4.1.1 "><p id="deh_02_0022__p122854610525">version</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.4.2.4.1.2 "><p id="deh_02_0022__p72844695218">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.4.2.4.1.3 "><p id="deh_02_0022__p6281446125213">Specifies the type of an IP address. The value of this parameter can be <strong id="deh_02_0022__b17246456131811">4</strong> or <strong id="deh_02_0022__b1724835618181">6</strong>.</p>
|
|
<ul id="deh_02_0022__ul192824665220"><li id="deh_02_0022__li528174635219"><strong id="deh_02_0022__b3880175820185">4</strong>: The type of the IP address is IPv4.</li><li id="deh_02_0022__li228124635214"><strong id="deh_02_0022__b11788174842315">6</strong>: The type of the IP address is IPv6.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_02_0022__row1313913419527"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.4.2.4.1.1 "><p id="deh_02_0022__p122810467529">OS-EXT-IPS-MAC:mac_addr</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.4.2.4.1.2 "><p id="deh_02_0022__p328204615219">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.4.2.4.1.3 "><p id="deh_02_0022__p1028046135211">Specifies the MAC address. This is an extended attribute.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="deh_02_0022__row114013417527"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.4.2.4.1.1 "><p id="deh_02_0022__p162854625216">OS-EXT-IPS:type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.4.2.4.1.2 "><p id="deh_02_0022__p22874619524">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.4.2.4.1.3 "><p id="deh_02_0022__p182820462528">Specifies the IP address assignment mode. This is an extended attribute.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="deh_02_0022__table13112134716015"></a><a name="table13112134716015"></a><table cellpadding="4" cellspacing="0" summary="" id="deh_02_0022__table13112134716015" frame="border" border="1" rules="all"><caption><b>Table 6 </b><strong id="deh_02_0022__b5364155616369">flavor</strong> field description</caption><thead align="left"><tr id="deh_02_0022__row11114947902"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.5.2.4.1.1"><p id="deh_02_0022__p141314496013"><strong id="deh_02_0022__b781915103518">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.5.2.4.1.2"><p id="deh_02_0022__p2137491013"><strong id="deh_02_0022__b281814514">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.5.2.4.1.3"><p id="deh_02_0022__p111316491309"><strong id="deh_02_0022__b088020103713">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="deh_02_0022__row911412471007"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.5.2.4.1.1 "><p id="deh_02_0022__p171313491019">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.5.2.4.1.2 "><p id="deh_02_0022__p6133491406">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.5.2.4.1.3 "><p id="deh_02_0022__p1513204910012">Specifies the flavor ID.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="deh_02_0022__table92838016115"></a><a name="table92838016115"></a><table cellpadding="4" cellspacing="0" summary="" id="deh_02_0022__table92838016115" frame="border" border="1" rules="all"><caption><b>Table 7 </b><strong id="deh_02_0022__b3319111373715">image</strong> field description</caption><thead align="left"><tr id="deh_02_0022__row16285401918"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.6.2.4.1.1"><p id="deh_02_0022__p10455322015"><strong id="deh_02_0022__b17828171143513">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.6.2.4.1.2"><p id="deh_02_0022__p114561215116"><strong id="deh_02_0022__b1330946604">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.6.2.4.1.3"><p id="deh_02_0022__p84566220119"><strong id="deh_02_0022__b1267501653714">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="deh_02_0022__row15285150219"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.6.2.4.1.1 "><p id="deh_02_0022__p8456921619">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.6.2.4.1.2 "><p id="deh_02_0022__p6456625110">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.6.2.4.1.3 "><p id="deh_02_0022__p194565211119">Specifies the image UUID.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="deh_02_0022__table74181471712"></a><a name="table74181471712"></a><table cellpadding="4" cellspacing="0" summary="" id="deh_02_0022__table74181471712" frame="border" border="1" rules="all"><caption><b>Table 8 </b><strong id="deh_02_0022__b1879092023713">metadata</strong> field description</caption><thead align="left"><tr id="deh_02_0022__row6420871711"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.7.2.4.1.1"><p id="deh_02_0022__p1167510141414"><strong id="deh_02_0022__b383719110359">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.7.2.4.1.2"><p id="deh_02_0022__p1367541417112"><strong id="deh_02_0022__b2009797320">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.7.2.4.1.3"><p id="deh_02_0022__p9675151414116"><strong id="deh_02_0022__b4413122410379">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="deh_02_0022__row1542037612"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.7.2.4.1.1 "><p id="deh_02_0022__p166759141616">os_type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.7.2.4.1.2 "><p id="deh_02_0022__p15675814618">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.7.2.4.1.3 "><p id="deh_02_0022__p18675111415110">Specifies the OS type.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="deh_02_0022__section1746403315253"><h4 class="sectiontitle">Example Request</h4><p id="deh_02_0022__p942562611810">Query ECSs on the DeH <strong id="deh_02_0022__b1762882662418">ab910cf0daebca90c4001</strong>.</p>
|
|
<pre class="screen" id="deh_02_0022__screen193606312093">GET https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-hosts/ab910cf0daebca90c4001/servers</pre>
|
|
</div>
|
|
<div class="section" id="deh_02_0022__section6263164742514"><h4 class="sectiontitle">Example Response</h4><pre class="screen" id="deh_02_0022__screen10438909154110">{
|
|
"servers": [
|
|
{
|
|
"addresses": {
|
|
"68269e6e-4a27-441b-8029-35373ad50bd9": [
|
|
{
|
|
"addr": "192.168.0.3",
|
|
"version": 4,
|
|
"OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:1b:35:78",
|
|
"OS-EXT-IPS:type": "fixed"
|
|
}
|
|
]
|
|
},
|
|
"created": "2012-09-07T16:56:37Z",
|
|
"flavor": {
|
|
"id": "1"
|
|
},
|
|
"id": "05184ba3-00ba-4fbc-b7a2-03b62b884931",
|
|
"metadata": {
|
|
"os_type": "Linux"
|
|
},
|
|
"name": "new-server-test",
|
|
"status": "ACTIVE",
|
|
"tenant_id": "a90b2728805d4240a72cc2eeb4e1244d",
|
|
"updated": "2012-09-07T16:56:37Z",
|
|
"user_id": "fake",
|
|
"task_state": "",
|
|
"image": {
|
|
"id": "1ce5800a-e487-4c1b-b264-3353a39e2b4b"
|
|
}
|
|
}
|
|
]
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="deh_02_0022__section56925253"><h4 class="sectiontitle">Status Code</h4><p id="deh_02_0022__p5847780">See <a href="deh_02_0016.html">Status Codes</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="deh_02_0017.html">API</a></div>
|
|
</div>
|
|
</div>
|
|
|