All Products
Search
Document Center

Elastic Compute Service:CreateDedicatedHostCluster

Last Updated:May 29, 2024

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.

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 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
Tagobject []No

The tags to add to the dedicated host cluster.

KeystringNo

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
ValuestringNo

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

This parameter is left empty by default.

myDDHCluster
DescriptionstringNo

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

ParameterTypeDescriptionExample
object
DedicatedHostClusterIdstring

The ID of the dedicated host cluster.

dc-bp12wlf6bw0vz9v2****
RequestIdstring

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 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