Help Center/ Dedicated Host/ API Reference/ API/ Querying Available DeH Types
Updated on 2025-11-20 GMT+08:00

Querying Available DeH Types

Function

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

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}/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.

For details, see Overview.

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": "c6",
               "host_type_name": "dedicated_general_purpose"
          },
          {
               "host_type": "m6",
               "host_type_name": "memory_optimized"
          }
     ]
}

Status Code

See Status Codes.