This topic provides the API reference of Alibaba Cloud Dedicated Host (DDH).


There are limits to the number and types of dedicated hosts you can create. For more information, see Limits.

If the API description, optional parameter values, or available specifications conflict with the resource or specification limits described in the Limits topic, the rules described in the Limits topic takes precedence.

Invocation Methods

You can call a DDH operation by using the following methods:
  • (Recommended) Programming language-specific SDKs for the DDH API.
  • Alibaba Cloud CLI
  • Alibaba Cloud OpenAPI Explorer
  • URL-based API request
    Note To initiate URL-based API requests, you must complete the authentication process and encode the URL for every request. For more information, see Request method.

In particular, you can skip the authentication process by using the SDK, CLI, and API Explorer to call the operations.

Note When you call an operation by using the Alibaba Cloud CLI and SDK, remove the periods (.) from request parameters before you use them. For example, use SystemDiskCategory for the request parameter instead of SystemDisk.Category.


The request URL consists of different parameters and has a fixed syntax. The URL contains common parameters, your signature, and operation-specific parameters. We provide URL request samples for every API. However, for better readability, the URLs of the samples in this API reference are not encoded. You must encode the URL before you initiate a request. For more information about how to encode a URL and call an operation, see Request method, Common parameters, and Signature method.

The system returns the request result based on your signature authentication. The response parameters are displayed if the authentication is successful, and the error message is displayed if the authentication fails. You can troubleshoot issues by referring to the common error codes and operation-specific error codes.

Currently, DDH shares the same endpoint with Elastic Compute Service (ECS). For more information, see Request structure.