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** Parameter 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

**Table 2** Query parameters
Parameter	Location	Type	Mandatory	Description
limit	query	String	No	Specifies the number of records displayed per page.
marker	query	String	No	Specifies the DeH type of the last record on the previous page. If the marker value is invalid, status code 400 is returned.

Response

**Table 3** Response parameters
Parameter	Location	Type	Description
dedicated_host_types	body	Array of objects	Specifies the available DeH types. For details, see Table 4.

**Table 4** **dedicated_host_types** field description
Parameter	Type	Description
host_type	String	Specifies the DeH type. For details, see Categories and Types > 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"
          }
     ]
}