CreateDedicatedHostCluster - Elastic Compute Service - Alibaba Cloud Documentation Center

Creates a dedicated host cluster.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The ID of the region in which to create the dedicated host cluster. You can call the DescribeRegions operation to query the most recent region list.	cn-hangzhou
DryRun	boolean	No	Specifies whether to perform only a dry run, without performing the actual request. Valid values: true: performs only a dry run. The system checks the request for potential issues, including invalid AccessKey pairs, unauthorized RAM users, and missing parameter values. If the request fails the dry run, an error message is returned. If the request passes the dry run, the `DryRunOperation` error code is returned. false: performs a dry run and performs the actual request. If the request passes the dry run, a 2xx HTTP status code is returned and the operation is performed. Default value: false.	false
Tag	array<object>	No	The tags to add to the dedicated host cluster.
	object	No
Key	string	No	The key of tag N to add to the dedicated host cluster. Valid values of N: 1 to 20. The tag key cannot be an empty string. The tag key can be up to 64 characters in length and cannot contain `http://` or `https://`. The tag key cannot start with `acs:` or `aliyun`.	TestKey
Value	string	No	The value of tag N to add to the dedicated host cluster. Valid values of N: 1 to 20. The tag value cannot be an empty string. The tag value can be up to 64 characters in length and cannot contain `http://` or `https://`. The tag value cannot start with `acs:` or `aliyun`.	TestValue
ResourceGroupId	string	No	The ID of the resource group to which to assign the dedicated host cluster.	rg-bp67acfmxazb4p****
ZoneId	string	Yes	The ID of the zone in which to create the dedicated host cluster. You can call the DescribeZones operation to query the most recent zone list.	cn-hangzhou-f
DedicatedHostClusterName	string	No	The name of the dedicated host cluster. The name must be 2 to 128 characters in length, and can contain letters, digits, periods (.), underscores (_), and hyphens (-). The name must start with a letter. The name cannot contain `http://` or `https://`. This parameter is left empty by default.	myDDHCluster
Description	string	No	The description of the dedicated host cluster. The description must be 2 to 256 characters in length and cannot start with `http://` or `https://`. This parameter is left empty by default.	This-is-my-DDHCluster

Response parameters

Parameter	Type	Description	Example
	object
DedicatedHostClusterId	string	The ID of the dedicated host cluster.	dc-bp12wlf6bw0vz9v2****
RequestId	string	The request ID.	E2A664A6-2933-4C64-88AE-5033D003****

Examples

Sample success responses

JSONformat

{
  "DedicatedHostClusterId": "dc-bp12wlf6bw0vz9v2****",
  "RequestId": "E2A664A6-2933-4C64-88AE-5033D003****"
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	The specified Tag.N.Key parameter is invalid.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	The specified tag value is invalid.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	The specified tag key already exists. Tag keys must be unique.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	The specified resource group does not exist.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	The RegionId provided does not exist
404	InvalidZone.NotFound	The ZoneId provided does not exist in our records.	The specified zone ID does not exist.
404	QuotaExceed.Region	The maximum region quota of Dedicated Host Cluster has exceeded.	-
404	QuotaExceed.Zone	The maximum zone quota of Dedicated Host Cluster has exceeded.	-
404	InvalidParam.Zone	The specified zone not match region.	-

For a list of error codes, visit the Service error codes.

Change history

Change time	Summary of changes	Operation
2023-06-13	The Error code has changed	View Change Details