Help Center/ Dedicated Host/ API Reference (Paris Region)/ API/ Querying Details About a DeH
Updated on 2024-02-29 GMT+08:00

Querying Details About a DeH

Function

This API is used to query details about a DeH.

URI

GET /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id}

Table 1 describes the parameters.

Table 1 Parameters description

Parameter

Type

Mandatory

Description

project_id

String

Yes

Specifies the project ID.

For details about how to obtain the project ID, see Obtaining a Project ID.

dedicated_host_id

String

Yes

Specifies the DeH ID.

You can obtain the value from the DeH console or using the API in Querying DeHs.

Request

None

Response

Table 2 Response parameters

Parameter

In

Type

Description

dedicated_host

body

Object

Specifies the DeH object.

For details, see Table 1.

Example Request

Query details about the DeH ab910cf0daebca90c4001.

GET https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-hosts/ab910cf0daebca90c4001

Example Response

{
    "dedicated_host": {
        "dedicated_host_id": "ab910cf0daebca90c4001",
        "name": "win_2008 servers",
        "auto_placement": "off",
        "availability_zone": "az1",
        "host_properties": {
            "vcpus": 36,
            "cores": 12,
            "sockets": 2,
            "memory": 1073741824,
            "host_type": "h1",
            "host_type_name": "High performance",
            "available_instance_capacities": [
                {
                    "flavor": "h1.large"
                },
                {
                    "flavor": "h1.2large"
                },
                {
                    "flavor": "h1.4large"
                },
                {
                    "flavor": "h1.8large"
                }
            ]
        },
        "state": "available",
        "project_id": "9c53a566cb3443ab910cf0daebca90c4",
        "available_vcpus": 20,
        "available_memory": 1073201821,
        "instance_total": 2,
        "allocated_at": "2016-10-10T14:35:47Z",
        "released_at": "",
        "instance_uuids": [
            "erf5th66cb3443ab912ff0daebca3456",
            "23457h66cb3443ab912ff0daebcaer45"
        ]
    }
}

Status Code

See Status Codes.