Call the CreateDedicatedHostCluster operation to create a DDH cluster.

Usage notes

A DDH cluster is a logical group at the availability zone level. You can use a DDH cluster to group and manage DDHs, or specify a cluster when you create instances.

Debugging

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Go to debug

Request parameters

Only the request parameters specific to this operation and some common parameters are listed below. For more information, refer to Common parameters.

Action string required Sample value: CreateDedicatedHostCluster

The action that you want to perform. Value: CreateDedicatedHostCluster.

Version string requiredSample value: 2020-04-01

The API version. Valid value: 2020-04-01.

ClientToken string Optional Sample value: 23fa21A8823nfasd7f****

The ClientToken is used to ensure the request idempotency. You can use the client to automatically generate a token, but you must make sure that the token is unique among different requests. This prevents repeated actions due to multiple client retries when the call of the API operation times out or an internal server error occurs.

Value: Only ASCII characters are supported. The length is no more than 64 ASCII characters.

DedicatedHostClusterName string required Sample value: DDH-Cluster01

The name of the dedicated host cluster.

Can not start with a number, a hyphen (-), or an underscore (_).

Only Chinese, letters, numbers, underscores and hyphens are allowed.

The length limit is 1 to 128 characters.

Special characters are currently not supported.

Description string Optional Sample value: DDH cluster for testing

Description of the DDH cluster. Default value: empty string.

Start with a letter or a Chinese character only.

Only Chinese characters, letters, numbers, dots (.), spaces, underscores (_), hyphen (-), equal signs (=), English comma (,), Chinese comma (，), and Chinese period (。) are allowed.

The length is limited to 255 characters.

ZoneId string requiredSample value: cn-beijing-a

The ID of the availability zone where the DDH cluster is deployed.

You can call DescribeZones to query the availability zone information within a region.

Response parameters

Only the response parameters specific to this operation are listed below. For more information, refer to the response structure.

DedicatedHostClusterId string Sample value: dc-ycle6b76kgv2wrsm****

The ID of the dedicated host cluster.

Sample request

Sample response

Error codes

The table below lists the business-related error codes of the operation. For more information, refer to Common error codes.

Status code	Error code	Error message	Description
400	IdempotentParameterMismatch	The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.	The idempotent parameters are inconsistent.
400	InvalidClientToken.Malformed	The specified ClientToken is malformed.	The specified ClientToken is invalid.
400	InvalidDedicatedHostClusterName.Malformed	The specified DedicatedHostClusterName is malformed.	The specified DedicatedHostClusterName is invalid.
400	InvalidDescription.Malformed	The specified Description is malformed.	The specified description is invalid.
400	MissingParameter.DedicatedHostClusterName	The required parameter DedicatedHostClusterName is not supplied.	The DedicatedHostClusterName parameter cannot be empty.
400	MissingParameter.ZoneId	The required parameter ZoneId is not supplied.	Availability zone ID can not be empty.
404	InvalidZone.NotFound	The specified zone does not exist.	The specified availability zone does not exist.
412	IdempotentProcessing	The request uses the same client token as a previous one that is still in process.	The previous idempotent request is still being processed. Please try again later.
500	InternalError	An internal error has occurred.	An internal error occurred. Try again. If multiple attempts fail, submit a ticket.

Elastic Compute Service