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

Querying Available DeH Types

Function

This API is used to query available DeH types in an AZ.

URI

Get /v1.0/{project_id}/availability-zone/{availability_zone}/dedicated-host-types

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.

availability_zone

String

Yes

Specifies the AZ.

Request

None

Response

Table 2 Response parameters

Parameter

In

Type

Description

dedicated_host_types

body

Array of objects

Specifies the available DeH types. For details, see Table 3.

Table 3 dedicated_host_types field description

Parameter

Type

Description

host_type

String

Specifies the DeH type.

host_type_name

String

Specifies the name of the DeH type.

Example Request

Query the DeH types available in az1.

GET https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/availability-zone/az1/dedicated-host-types

Example Response

{
    "dedicated_host_types": [
        {
            "host_type": "General",
            "host_type_name": "General Computing"
        },
        {
            "host_type": "m1",
            "host_type_name": "Memory-optimized"
        },
        {
            "host_type": "h2",
            "host_type_name": "High performance"
        },
        {
            "host_type": "d1",
            "host_type_name": "Disk intensive"
        }
    ]
}

Status Code

See Status Codes.