Help Center/ Dedicated Host/ API Reference/ API/ Querying Details About a DeH
Updated on 2024-04-16 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": "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"
        ]
    }
}

Status Code

See Status Codes.