最近更新时间:2024.04.22 11:34:50
首次发布时间:2024.04.22 11:34:50
调用 DescribeDedicatedHostClusters 接口查询一个或多个有宿主机集群的详细信息。
名称 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeDedicatedHostClusters | 要执行的操作,取值:DescribeDedicatedHostClusters。 |
Version | String | 是 | 2020-04-01 | API的版本,取值:2020-04-01。 |
DedicatedHostClusterIds.N | String | 否 | DedicatedHostClusterIds.1=dc-ycle6b76kgv2wrsm****&DedicatedHostClusterIds.2=dc-yclc1jr9j4arsp3j**** | 专有宿主机集群的ID,最多支持10个。
|
DedicatedHostClusterName | String | 否 | DDH-Cluster01 | 专有宿主机集群的名称。
|
ZoneId | String | 否 | cn-beijing-a | 专有宿主机集群所在的可用区ID。 可以调用DescribeZones查询一个地域下的可用区信息。 |
NextToken | String | 否 | - | 分页查询凭证,用于标记分页的位置,初次调用该接口时无需设置。下次查询时,取值为上一次API调用返回的 |
MaxResults | Integer | 否 | 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 | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidArgument | The specified argument is invalid. | 指定的参数不合法。 |
400 | LimitExceeded.MaximumDedicatedHostClusterIds | The number of specified DedicatedHostClusterIds exceeds the maximum limit. | 指定的DedicatedHostClusterIds超过最大限制。 |
500 | InternalError | An internal error has occurred. | 内部错误,请重试。如果多次尝试失败,请提交工单。 |