Querying Details About a DeH

Function

This API is used to query details about a DeH.

Authorization

Your account has all of the permissions required to call all APIs, but IAM users must have the required permissions specifically assigned. For the specific permissions required, see Permissions and Supported Actions.

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": "d465d0ae-f859-4a83-a508-8db654c05e7e",
        "name": "DEH001",
        "auto_placement": "off",
        "availability_zone": "cn-east-3a",
        "host_properties": {
            "vcpus": 74,
            "cores": 22,
            "sockets": 2,
            "memory": 151552,
            "host_type": "c6",
            "host_type_name": "dedicated_general_purpose",
            "available_instance_capacities": [
                {
                    "flavor": "c6.large.2"
                },
                {
                    "flavor": "c6.xlarge.2"
                },
                {
                    "flavor": "c6.2xlarge.2"
                },
                {
                    "flavor": "c6.3xlarge.2"
                },
                {
                    "flavor": "c6.6xlarge.2"
                },
                {
                    "flavor": "c6.16xlarge.2"
                }
            ]
        },
        "state": "available",
        "project_id": "9c53a566cb3443ab910cf0daebca90c4",
        "available_vcpus": 20,
        "available_memory": 40960,
        "instance_total": 5,
        "allocated_at": "2016-10-10T14:35:47Z",
        "released_at": "",
        "instance_uuids": [
	    "erf5th66cb3443ab912ff0daebca3456",
	    "23457h66cb3443ab912ff0daebcaer45"
        ]
    }
}