• Workspace

workspace
  1. Help Center
  2. Workspace
  3. API Reference
  4. Desktop Dedicated Hosts
  5. Querying the Types of Available Desktop Dedicated Hosts in an AZ

Querying the Types of Available Desktop Dedicated Hosts in an AZ

Function

This interface is used to query the types of available desktop dedicated hosts in a region.

URI

  • URI format

    GET /v1.0/{project_id}/workspace-dedicated-hosts/availability-zone/{availability_zone}/dedicated-host-types

  • URI parameter description

    Parameter

    Mandatory

    Type

    Description

    project_id

    Yes

    string

    Specifies the user ID.

    availability_zone

    Yes

    string

    Specifies an AZ.

Request

  • Request example
    GET /v1.0/29dfe82ada564ac2b927e1ff036d9a9b/workspace-dedicated-hosts/availability-zone/eu-de-01/dedicated-host-types

Response

  • Description

    Name

    Type

    Description

    dedicated_host_types

    List data structure [1]

    Specifies the information list of desktop dedicated host types.

[1] dedicated_host_types field data structure description

Name

Type

Description

host_type

string

Specifies the type of a desktop dedicated host.

host_type_name

string

Specifies the type name of a desktop dedicated host.

  • Response example
    { 
        "dedicated_host_types":  [
           { 
                  "host_type": "general", 
                  "host_type_name": "General computing" 
           }, 
           { 
                  "host_type": "h1", 
                  "host_type_name": "High performance" 
           }
     ] 
    }

Returned Values

  • Normal

    200

  • Abnormal

    Returned Value

    Description

    400 Bad Request

    The request syntax is incorrect and cannot be understood by the server.

    401 Unauthorized

    Authentication fails.

    403 Forbidden

    You are not authorized to perform the operation.

    404 Not Found

    The requested resource is not found.

    405 Method Not Allowed

    The method specified in the request is not allowed.

    500 Internal Server Error

    Internal service error. For details about error codes, see Error Code Description.

    503 Service Unavailable

    The service is unavailable.