doc-exports/docs/deh/api-ref/deh_02_0021.html
Zaoxu, Li 1c7fe15e7b deh_api_1215
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>
2024-09-27 15:02:29 +00:00

130 lines
7.8 KiB
HTML

<a name="deh_02_0021"></a><a name="deh_02_0021"></a>
<h1 class="topictitle1">Querying Details About a DeH</h1>
<div id="body1512563929533"><div class="section" id="deh_02_0021__section32345284"><h4 class="sectiontitle">Function</h4><p id="deh_02_0021__p35690909">This API is used to query details about a DeH.</p>
</div>
<div class="section" id="deh_02_0021__section22672102"><h4 class="sectiontitle">URI</h4><p id="deh_02_0021__p119802117371">GET /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id}</p>
<p id="deh_02_0021__p12780113383713"><a href="#deh_02_0021__table572214121015">Table 1</a> describes the parameters.</p>
<div class="tablenoborder"><a name="deh_02_0021__table572214121015"></a><a name="table572214121015"></a><table cellpadding="4" cellspacing="0" summary="" id="deh_02_0021__table572214121015" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters description</caption><thead align="left"><tr id="deh_02_0021__row572516410109"><th align="left" class="cellrowborder" valign="top" width="21.23787621237876%" id="mcps1.3.2.4.2.5.1.1"><p id="deh_02_0021__p107252049107"><strong id="deh_02_0021__b7893101914414">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_0021__p726975522919"><strong id="deh_02_0021__b16213921114414">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_0021__p072564201017"><strong id="deh_02_0021__b13261102244413">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_0021__p47253421017"><strong id="deh_02_0021__b14400162364419">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="deh_02_0021__row107256481017"><td class="cellrowborder" valign="top" width="21.23787621237876%" headers="mcps1.3.2.4.2.5.1.1 "><p id="deh_02_0021__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_0021__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_0021__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_0021__p6725747104">Specifies the project ID.</p>
<p id="deh_02_0021__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_0021__row184436404555"><td class="cellrowborder" valign="top" width="21.23787621237876%" headers="mcps1.3.2.4.2.5.1.1 "><p id="deh_02_0021__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_0021__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_0021__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_0021__p1544524011550">Specifies the DeH ID.</p>
<p id="deh_02_0021__p127584489356">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_0021__section19182316"><h4 class="sectiontitle">Request</h4><p id="deh_02_0021__p122661441165310">None</p>
</div>
<div class="section" id="deh_02_0021__section38423121"><h4 class="sectiontitle">Response</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="deh_02_0021__table6655112918294" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response parameters</caption><thead align="left"><tr id="deh_02_0021__row1655132919292"><th align="left" class="cellrowborder" valign="top" width="21.65%" id="mcps1.3.4.2.2.5.1.1"><p id="deh_02_0021__p18427335192915"><strong id="deh_02_0021__b11491950174411">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20.75%" id="mcps1.3.4.2.2.5.1.2"><p id="deh_02_0021__p1242716351298"><strong id="deh_02_0021__b105665174411">In</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="26.950000000000003%" id="mcps1.3.4.2.2.5.1.3"><p id="deh_02_0021__p942717357298"><strong id="deh_02_0021__b4262175220449">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="30.65%" id="mcps1.3.4.2.2.5.1.4"><p id="deh_02_0021__p34273350297"><strong id="deh_02_0021__b687125319447">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="deh_02_0021__row7655429192918"><td class="cellrowborder" valign="top" width="21.65%" headers="mcps1.3.4.2.2.5.1.1 "><p id="deh_02_0021__p12427193592918">dedicated_host</p>
</td>
<td class="cellrowborder" valign="top" width="20.75%" headers="mcps1.3.4.2.2.5.1.2 "><p id="deh_02_0021__p11427235152917">body</p>
</td>
<td class="cellrowborder" valign="top" width="26.950000000000003%" headers="mcps1.3.4.2.2.5.1.3 "><p id="deh_02_0021__p6427435182915">Object</p>
</td>
<td class="cellrowborder" valign="top" width="30.65%" headers="mcps1.3.4.2.2.5.1.4 "><p id="deh_02_0021__p18427193532910">Specifies the DeH object.</p>
<p id="deh_02_0021__p692753612448">For details, see <a href="deh_02_0018.html#deh_02_0018__dedicated_host">Table 1</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="deh_02_0021__section1034482912415"><h4 class="sectiontitle">Example Request</h4><p id="deh_02_0021__p4154184776">Query details about the DeH <strong id="deh_02_0021__b1987852110232">ab910cf0daebca90c4001</strong>.</p>
<pre class="screen" id="deh_02_0021__screen74075110315">GET https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-hosts/ab910cf0daebca90c4001</pre>
</div>
<div class="section" id="deh_02_0021__section206210496244"><h4 class="sectiontitle">Example Response</h4><pre class="screen" id="deh_02_0021__screen38538118419">{
"dedicated_host": {
"dedicated_host_id": "d465d0ae-f859-4a83-a508-8db654c05e7e",
"name": "DEH001",
"auto_placement": "off",
"availability_zone": "eu-de-01",
"host_properties": {
"vcpus": 74,
"cores": 22,
"sockets": 2,
"memory": 303104,
"host_type": "c4",
"host_type_name": "dedicated_general_purpose",
"available_instance_capacities": [
{
"flavor": "c4.large.4"
},
{
"flavor": "c4.xlarge.4"
},
{
"flavor": "c4.2xlarge.4"
},
{
"flavor": "c4.3xlarge.4"
},
{
"flavor": "c4.6xlarge.4"
},
{
"flavor": "c4.16xlarge.4"
}
]
},
"state": "available",
"project_id": "9c53a566cb3443ab910cf0daebca90c4",
"available_vcpus": 20,
"available_memory": 81920,
"instance_total": 5,
"allocated_at": "2016-10-10T14:35:47Z",
"released_at": "",
"instance_uuids": [
"erf5th66cb3443ab912ff0daebca3456",
"23457h66cb3443ab912ff0daebcaer45"
]
}
}</pre>
</div>
<div class="section" id="deh_02_0021__section26059286"><h4 class="sectiontitle">Status Code</h4><p id="deh_02_0021__p60228670">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>