Help Center/ Dedicated Host/ API Reference/ API/ Querying Available DeH Types
Updated on 2024-04-16 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": "c6",
   "host_type_name": "dedicated_general_purpose"
  },
  {
   "host_type": "m6",
   "host_type_name": "memory_optimized"
  }
 ]
}

Status Code

See Status Codes.