查询主机信息
功能介绍
查询主机列表
URI
POST /v3/{project_id}/lts/host-list
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取方式请参见:获取项目ID,获取账号ID,日志组ID、日志流ID 最小长度:1 最大长度:64 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
从IAM服务获取的用户Token,获取方式请参见:获取用户Token 最小长度:1 最大长度:10000 |
Content-Type |
是 |
String |
该字段填为:application/json;charset=utf8。 最小长度:30 最大长度:30 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
host_id_list |
否 |
Array of strings |
主机ID列表。可以根据主机ID列表进行批量过滤 最小长度:36 最大长度:36 |
filter |
是 |
GetHostListFilter object |
查询主机信息过滤参数 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
host_name_list |
否 |
Array of strings |
主机名称列表。可以根据主机名称列表,进行批量过滤 最小长度:1 最大长度:128 |
host_ip_list |
否 |
Array of strings |
主机IP列表。可以根据主机IP列表,进行批量过滤。 最小长度:1 最大长度:16 |
host_status |
否 |
String |
主机状态。可以根据主机状态进行过滤。
|
host_version |
否 |
String |
主机版本。可以根据主机版本进行过滤。 最小长度:1 最大长度:16 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
result |
Array of GetHostListInfo objects |
主机列表 |
total |
Long |
主机信息总数量 |
参数 |
参数类型 |
描述 |
---|---|---|
host_id |
String |
主机ID |
host_ip |
String |
主机IP |
host_name |
String |
主机名称 |
host_status |
String |
主机状态。
|
host_type |
String |
主机类型。
|
host_version |
String |
主机版本 |
update_time |
Long |
更新时间 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
请求示例
查询主机信息,根据传入的Body体进行过滤。若是body体中无过滤参数,则查询全量数据。
POST https://{endpoint}/v3/{project_id}/lts/host-list { "host_id_list" : [ "713a9f81-574b-45aa-92df-24c4caxxxxxx", "c7085aa9-2142-4ada-9f78-bf81ffxxxxxx" ], "filter" : { "host_name_list" : [ "ecs-xxxx", "10.66.16xxx" ], "host_ip_list" : [ "192.168xxxx" ], "host_status" : "running", "host_version" : "5.13.xxxx" } }
响应示例
状态码:200
查询主机信息请求响应成功
{ "result" : [ { "host_id" : "dc1dab7e-b045-4e77-bda4-914xxxxxx", "host_ip" : "172.16.xxxx", "host_name" : "ecs-apmtexxxxxx", "host_status" : "running", "host_type" : "linux", "host_version" : "5.13.xx.x", "update_time" : 1637223314526 } ], "total" : 1 }
状态码:400
BadRequest 非法请求 建议根据error_msg直接修改该请求。
{ "error_code" : "LTS.1807", "error_msg" : "Invalid host id" }
状态码:500
表明服务端能被请求访问到,但是服务内部出错
{ "error_code" : "LTS.0010", "error_msg" : "Internal Server Error" }
状态码
状态码 |
描述 |
---|---|
200 |
查询主机信息请求响应成功 |
400 |
BadRequest 非法请求 建议根据error_msg直接修改该请求。 |
500 |
表明服务端能被请求访问到,但是服务内部出错 |
错误码
请参见错误码。