：DescribeDedicatedHostClusters

Description

You can specify multiple request parameters to be queried. Specified parameters have logical AND relations. Only the specified parameters are included in the filter conditions. However, if DedicatedHostClusterIds is set to an empty JSON array ([]), it is regarded as a valid filter condition and an empty result is returned.

Request parameters

Response parameters

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=DescribeDedicatedHostClusters
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-f
&DedicatedHostClusterName=myDDHCluster
&PageNumber=1
&PageSize=5
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDedicatedHostClustersResponse>
    <PageSize>5</PageSize>
    <RequestId>214A2187-B06F-4E49-A081-4D053466A8C7</RequestId>
    <PageNumber>1</PageNumber>
    <TotalCount>2</TotalCount>
    <DedicatedHostClusters>
        <Description>This-is-my-DDHCluster</Description>
        <DedicatedHostClusterId>dc-bp12wlf6am0vz9v2****</DedicatedHostClusterId>
        <ResourceGroupId>rg-bp67acfmxazb4p****</ResourceGroupId>
        <ZoneId>cn-hangzhou-f</ZoneId>
        <RegionId>cn-hangzhou</RegionId>
        <DedicatedHostClusterName>myDDHCluster</DedicatedHostClusterName>
        <Tags>
            <TagValue>TestValue</TagValue>
            <TagKey>TestKey</TagKey>
        </Tags>
        <DedicatedHostIds>dh-bp181e5064b5sotr****</DedicatedHostIds>
        <DedicatedHostClusterCapacity>
            <AvailableVcpus>2</AvailableVcpus>
            <AvailableMemory>4</AvailableMemory>
            <TotalMemory>8</TotalMemory>
            <TotalVcpus>4</TotalVcpus>
            <LocalStorageCapacities>
                <DataDiskCategory>cloud</DataDiskCategory>
                <AvailableDisk>20</AvailableDisk>
                <TotalDisk>40</TotalDisk>
            </LocalStorageCapacities>
            <AvailableInstanceTypes>
                <InstanceType>ecs.c6.26xlarge</InstanceType>
                <AvailableInstanceCapacity>0</AvailableInstanceCapacity>
            </AvailableInstanceTypes>
        </DedicatedHostClusterCapacity>
    </DedicatedHostClusters>
</DescribeDedicatedHostClustersResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PageSize" : 5,
  "RequestId" : "214A2187-B06F-4E49-A081-4D053466A8C7",
  "PageNumber" : 1,
  "TotalCount" : 2,
  "DedicatedHostClusters" : [ {
    "Description" : "This-is-my-DDHCluster",
    "DedicatedHostClusterId" : "dc-bp12wlf6am0vz9v2****",
    "ResourceGroupId" : "rg-bp67acfmxazb4p****",
    "ZoneId" : "cn-hangzhou-f",
    "RegionId" : "cn-hangzhou",
    "DedicatedHostClusterName" : "myDDHCluster",
    "Tags" : [ {
      "TagValue" : "TestValue",
      "TagKey" : "TestKey"
    } ],
    "DedicatedHostIds" : [ "dh-bp181e5064b5sotr****" ],
    "DedicatedHostClusterCapacity" : {
      "AvailableVcpus" : 2,
      "AvailableMemory" : 4,
      "TotalMemory" : 8,
      "TotalVcpus" : 4,
      "LocalStorageCapacities" : [ {
        "DataDiskCategory" : "cloud",
        "AvailableDisk" : 20,
        "TotalDisk" : 40
      } ],
      "AvailableInstanceTypes" : [ {
        "InstanceType" : "ecs.c6.26xlarge",
        "AvailableInstanceCapacity" : 0
      } ]
    }
  } ]
}

Error codes

For a list of error codes, visit the API Error Center.