You need to enable JavaScript to run this app.
导航

DescribeDedicatedHostClusters

最近更新时间2023.10.10 15:49:30

首次发布时间2023.09.08 16:31:01

调用 DescribeDedicatedHostClusters 接口查询一个或多个有宿主机集群的详细信息。

请求参数

名称
类型是否必填
示例值
描述

Action

String

DescribeDedicatedHostClusters

要执行的操作,取值:DescribeDedicatedHostClusters。

VersionString2020-04-01API的版本,取值:2020-04-01。

DedicatedHostClusterIds.N

String

DedicatedHostClusterIds.1=dc-ycle6b76kgv2wrsm****&DedicatedHostClusterIds.2=dc-yclc1jr9j4arsp3j****

专有宿主机集群的ID,最多支持10个。

  • 参数 - N:表示专有宿主机集群的序号。

  • 多个集群ID之间用&分隔。

DedicatedHostClusterName

String

DDH-Cluster01

专有宿主机集群的名称。

  • 不能以数字、中划线、下划线开头。

  • 只能包含中文、字母、数字、下划线和中划线。

  • 长度限制为1~128个字符。

  • 暂不支持特殊字符。

ZoneIdStringcn-beijing-a专有宿主机集群所在的可用区ID。
可以调用DescribeZones查询一个地域下的可用区信息。

NextToken

String

-

分页查询凭证,用于标记分页的位置,初次调用该接口时无需设置。下次查询时,取值为上一次API调用返回的NextToken参数值。

MaxResults

Integer

10

分页查询时设置的每页行数:

  • 最大值:100

  • 默认值:10

返回数据

名称
类型
示例值
描述
DedicatedHostClusters
Array of Struct
-
专有宿主机集群信息。
NextToken
String
eWNsYTg0b2s1Y3Yyd3Jzb2do****
本次调用返回的查询凭证值,返回为空表示该页为末页。

请求示例

GET /?Action=DescribeDedicatedHostClusters&Version=2020-04-01
Region: cn-beijing
Service: ecs

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2023071716274123B73A705E255110****",
        "Action": "DescribeDedicatedHostClusters",
        "Version": "2020-04-01",
        "Service": "ecs",
        "Region": "cn-beijing"
    },
    "Result": {
        "DedicatedHostClusters": [
            {
                "CreatedAt": "2023-08-11T10:30:25+08:00",
                "UpdatedAt": "2023-08-11T10:30:25+08:00",
                "DedicatedHostClusterId": "dc-ycle6b76kgv2wrsm****",
                "ZoneId": "cn-beijing-a",
                "DedicatedHostClusterName": "DDH-Cluster01",
                "Description": "用于测试的专有宿主机集群",
                "DedicatedHostIds": [
                    "dh-3tigy72q3u3vj0x2***"
                ],
                "DedicatedHostClusterCapacity": {
                    "TotalVcpus": 448,
                    "AvailableVcpus": 441,
                    "TotalMemory": 972800,
                    "AvailableMemory": 951296,
                    "AvailableInstanceTypes": [
                        {
                            "InstanceType": "ecs.ddhr2s.define.c4m16",
                            "AvailableCapacity": 58
                        },
                        {
                            "InstanceType": "ecs.ddhr2s.define.c8m16",
                            "AvailableCapacity": 55
                        }
                    ]
                }
            }
        ],
        "NextToken": "eWNsYTg0b2s1Y3Yyd3Jzb2do****"
    }
}

错误码

HttpCode错误码错误信息描述
400InvalidArgumentThe specified argument is invalid.指定的参数不合法。
400LimitExceeded.MaximumDedicatedHostClusterIdsThe number of specified DedicatedHostClusterIds exceeds the maximum limit.指定的DedicatedHostClusterIds超过最大限制。
500InternalErrorAn internal error has occurred.内部错误,请重试。如果多次尝试失败,请提交工单。