接口请求域名: cvm.tencentcloudapi.com 。
本接口 (DescribeHosts) 用于获取一个或多个CDH实例的详细信息。
默认接口请求频率限制:10次/秒。
注意:本接口支持金融区地域。由于金融区和非金融区是隔离不互通的,因此当公共参数 Region 为金融区地域(例如 ap-shanghai-fsi)时,需要同时指定带金融区地域的域名,最好和 Region 的地域保持一致,例如:cvm.ap-shanghai-fsi.tencentcloudapi.com。
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
Action | 是 | String | 公共参数,本接口取值:DescribeHosts。 |
Version | 是 | String | 公共参数,本接口取值:2017-03-12。 |
Region | 是 | String | 公共参数,详见产品支持的 地域列表。 |
Filters.N | 否 | Array of Filter | 按照【可用区】进行过滤。可用区形如:ap-guangzhou-1。 类型:String 必选:否 可选项:可用区列表 按照【项目ID】进行过滤,可通过调用DescribeProject查询已创建的项目列表或登录控制台进行查看;也可以调用AddProject创建新的项目。项目ID形如:1002189。 类型:Integer 必选:否 按照【CDH ID】进行过滤。CDH ID形如:host-xxxxxxxx。 类型:String 必选:否 按照【CDH实例名称】进行过滤。 类型:String 必选:否 按照【CDH实例状态】进行过滤。(PENDING:创建中 | LAUNCH_FAILURE:创建失败 | RUNNING:运行中 | EXPIRED:已过期) 类型:String 必选:否 每次请求的 Filters 的上限为10,Filter.Values 的上限为5。 |
Offset | 否 | Integer | 偏移量,默认为0。 |
Limit | 否 | Integer | 返回数量,默认为20,最大值为100。 |
参数名称 | 类型 | 描述 |
---|---|---|
TotalCount | Integer | 符合查询条件的cdh实例总数 |
HostSet | Array of HostItem | cdh实例详细信息列表 |
RequestId | String | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
查询一个或多个CDH实例的详细信息
GET https://cvm.tencentcloudapi.com/?Action=DescribeHosts
&Filters.0.Name=zone
&Filters.0.Values.0=ap-guangzhou-2
&Offset=0
&Limit=20
&<公共请求参数>
{
"Response": {
"TotalCount": 1,
"HostSet": [
{
"Placement": {
"Zone": "ap-guangzhou-2",
"ProjectId": 0
},
"HostId": "host-ey16rkyg",
"HostType": "HS1",
"HostName": "bibibibib-111",
"HostChargeType": "PREPAID",
"RenewFlag": "NOTIFY_AND_AUTO_RENEW",
"CreatedTime": "2018-01-04T09:45:39Z",
"ExpiredTime": "2025-05-04T09:45:42Z",
"InstanceIds": [],
"HostState": "RUNNING",
"HostResource": {
"CpuTotal": 24,
"CpuAvailable": 24,
"MemTotal": 56.0,
"MemAvailable": 56.0,
"DiskTotal": 1200,
"DiskAvailable": 1200,
"DiskType": "LOCAL_BASIC"
}
}
],
"RequestId": "6EF60BEC-0242-43AF-BB20-270359FB54A7"
}
}
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
InvalidFilter | 无效的过滤器。 |
InvalidHostId.Malformed | 无效CDH ID 。指定的CDH ID 格式错误。例如ID 长度错误host-1122 。 |
InvalidParameterValue | 参数取值错误。 |
InvalidZone.MismatchRegion | 指定的zone 不存在。 |
UnauthorizedOperation | 未授权操作。 |
3月24日,腾讯发布2020年Q4及全年财报,其中金融科技及企业服务第四季收入385亿...
客户简介 趣医网(quyiyuan.com)创立于2014年,为京颐集团重要成员企业之一,是...
排查思路 无法通过远程桌面连接裸金属服务器时,我们推荐您按照以下思路排查问题...
API风格说明 当前ECS服务对外开放两类风格的API: ECS服务自定义规范的API(以下...
客户简介 全民直播是一家涵盖游戏、娱乐、户外等多领域泛娱乐的直播平台。2015年...
注册了 域名 不备案可以吗?可以的。 注册域名 并不是一定要备案的,只有搭 建网...
云虚拟主机 可以干什么?云 虚拟主机 可以是搭 建网站 的重要产品,可用来存放网...
案例背景 高校健康打卡项目发起于北京大学软件与微电子学院,是该学院张齐勋老师...
公司介绍 我们公司是全球法律服务整合平台,已有的4万多名律师遍布全国359个城市...
??提到慕尼黑,大家第一个想到总是啤酒节,其实慕尼黑的文化同样闻名世界。慕尼...