All Products
Search
Document Center

Elastic Compute Service:CreateDedicatedHostCluster

Last Updated:May 14, 2024

You can call this operation to create 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.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

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
DryRunbooleanNo

Specifies whether to check the validity of the request without actually making the request. Valid values:

  • true: The validity of the request is checked but the request is not made. Check items include whether your AccessKey pair is valid, whether RAM users are authorized, and whether the required parameters are specified. If the check fails, the corresponding error is returned. If the check succeeds, the DryRunOperation error code is returned.
  • false: The validity of the request is checked. If the check succeeds, a 2XX HTTP status code is returned and the request is made.

Default value: false

false
Tagobject []No

The tags of the resource. You can enter most at 20 tags for the resource.

KeystringNo

The key of tag N of the dedicated host cluster. Valid values of N: 1 to 20. The tag key cannot be an empty string. It can be up to 64 characters in length and cannot start with acs: or aliyun. It cannot contain http:// or https://.

TestKey
ValuestringNo

The value of tag N of the dedicated host cluster. Valid values of N: 1 to 20. The tag value cannot be an empty string. It can be up to 64 characters in length and cannot start with acs: or aliyun. It cannot contain http:// or https://.

TestValue
ResourceGroupIdstringNo

The ID of the resource group to which to assign the dedicated host cluster.

rg-bp67acfmxazb4p****
ZoneIdstringYes

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
DedicatedHostClusterNamestringNo

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 (-). It must start with a letter. It cannot contain http:// or https://.

This parameter is empty by default.

myDDHCluster
DescriptionstringNo

The description of the dedicated host cluster. The description must be 2 to 256 characters in length. It cannot start with http:// or https://.

This parameter is empty by default.

This-is-my-DDHCluster

Response parameters

ParameterTypeDescriptionExample
object
DedicatedHostClusterIdstring

The ID of the dedicated host cluster.

dc-bp12wlf6bw0vz9v2****
RequestIdstring

The ID of the request.

E2A664A6-2933-4C64-88AE-5033D003****

Examples

Sample success responses

JSONformat

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

Error codes

HTTP status codeError codeError messageDescription
400InvalidTagKey.MalformedThe specified Tag.n.Key is not valid.The specified Tag.N.Key parameter is invalid.
400InvalidTagValue.MalformedThe specified Tag.n.Value is not valid.The specified tag value is invalid.
400Duplicate.TagKeyThe Tag.N.Key contain duplicate key.The specified tag key already exists. Tag keys must be unique.
404InvalidResourceGroup.NotFoundThe ResourceGroup provided does not exist in our records.The specified resource group does not exist.
404InvalidRegionId.NotFoundThe RegionId provided does not exist in our records.The RegionId provided does not exist
404InvalidZone.NotFoundThe ZoneId provided does not exist in our records.The specified zone ID does not exist.
404QuotaExceed.RegionThe maximum region quota of Dedicated Host Cluster has exceeded.-
404QuotaExceed.ZoneThe maximum zone quota of Dedicated Host Cluster has exceeded.-
404InvalidParam.ZoneThe specified zone not match region.-

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

Change history

Change timeSummary of changesOperation
2023-06-13The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    Error Codes 404 change
    delete Error Codes: 400