调用 DescribeDedicatedHosts 接口获取专有宿主机的详细信息，包括宿主机状态、到期时间和已创建的实例列表等。

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

请求示例

GET /?Action=DescribeDedicatedHosts&Version=2020-04-01 HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
Service: ecs

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230714173759DC17D8F861B10D4D****",
        "Action": "DescribeDedicatedHosts",
        "Version": "2020-04-01",
        "Service": "ecs",
        "Region": "cn-beijing"
    },
    "Result": {
        "DedicatedHosts": [
            {
                "CreatedAt": "2023-07-14T17:17:56+08:00",
                "UpdatedAt": "2023-07-14T17:17:58+08:00",
                "DedicatedHostId": "dh-ycje2rquioh9l3bn****",
                "ZoneId": "cn-beijing-a",
                "Status": "Available",
                "DedicatedHostName": "dedicated-host-test",
                "Description": "",
                "AutoPlacement": "Off",
                "HostRecovery": "Off",
                "HostMaintenance": "Off",
                "CpuOvercommitRatio": 4,
                "Instances": [],
                "Capacity": {
                    "TotalVcpus": 448,
                    "AvailableVcpus": 448,
                    "TotalMemory": 962560,
                    "AvailableMemory": 962560
                },
                "DedicatedHostTypeId": "ecs.ddhr2s",
                "ChargeType": "PrePaid",
                "ExpiredAt": "2023-08-14T23:59:59+08:00"
            }
        ],
        "NextToken": "eWNsYTg0b2s1Y3Yyd3Jzb2do****"
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。